NodeSocket(bpy_struct)

base class — bpy_struct

subclasses — NodeSocketStandard

class bpy.types.NodeSocket(bpy_struct)

Input or output socket of a node

bl_idname
Type

string, default “”, (never None)

bl_label

Label to display for the socket type in the UI

Type

string, default “”, (never None)

bl_subtype_label

Label to display for the socket subtype in the UI

Type

string, default “”, (never None)

description

Socket tooltip

Type

string, default “”, (never None)

display_shape

Socket shape

Type

enum in ['CIRCLE', 'SQUARE', 'DIAMOND', 'CIRCLE_DOT', 'SQUARE_DOT', 'DIAMOND_DOT'], default "'CIRCLE'"

enabled

Enable the socket

Type

boolean, default False

hide

Hide the socket

Type

boolean, default False

hide_value

Hide the socket input value

Type

boolean, default False

identifier

Unique identifier for mapping sockets

Type

string, default “”, (readonly, never None)

inferred_structure_type

Best known structure type of the socket. This may not match the socket shape, e.g. for unlinked input sockets

Type

enum in Node Socket Structure Type Items, default "'AUTO'", (readonly)

is_icon_visible

Socket is drawn as interactive icon in the node editor

Type

boolean, default False, (readonly)

is_inactive

Socket is grayed out because it has been detected to not have any effect on the output

Type

boolean, default False, (readonly)

is_linked

True if the socket is connected

Type

boolean, default False, (readonly)

is_multi_input

True if the socket can accept multiple ordered input links

Type

boolean, default False, (readonly)

is_output

True if the socket is an output, otherwise input

Type

boolean, default False, (readonly)

is_unavailable

True if the socket is unavailable

Type

boolean, default False, (readonly)

label

Custom dynamic defined socket label

Type

string, default “”, (readonly, never None)

Max number of links allowed for this socket

Type

int in [1, 4095], default 0

name

Socket name

Type

string, default “”, (never None)

node

Node owning this socket

Type

Node, (readonly)

pin_gizmo

Keep gizmo visible even when the node is not selected

Type

boolean, default False

select

True if the socket is selected

Type

boolean, default False, (readonly)

show_expanded

Socket links are expanded in the user interface

Type

boolean, default False

type

Data type

Type

enum in Node Socket Type Items, default "'VALUE'"

List of node links from or to this socket.

Type

NodeLinks

Note

Takes O(len(nodetree.links)) time.

(readonly)

bl_system_properties_get(*, do_create=False)

DEBUG ONLY. Internal access to runtime-defined RNA data storage, intended solely for testing and debugging purposes. Do not access it in regular scripting work, and in particular, do not assume that it contains writable data

Parameters

do_create (boolean, (optional)) – Ensure that system properties are created if they do not exist yet

Returns

The system properties root container, or None if there are no system properties stored in this data yet, and its creation was not requested

Return type

PropertyGroup

draw(context, layout, node, text)

Draw socket

Parameters
  • layout (UILayout, (never None)) – Layout, Layout in the UI

  • node (Node, (never None)) – Node, Node the socket belongs to

  • text (string, (never None)) – Text, Text label to draw alongside properties

draw_color(context, node)

Color of the socket icon

Parameters

node (Node, (never None)) – Node, Node the socket belongs to

Returns

Color

Return type

float array of 4 items in [0, 1]

classmethod draw_color_simple()

Color of the socket icon. Used to draw sockets in places where the socket does not belong to a node, like the node interface panel. Also used to draw node sockets if draw_color is not defined.

Returns

Color

Return type

float array of 4 items in [0, 1]

classmethod bl_rna_get_subclass(id, default=None, /)
Parameters

id (str) – The RNA type identifier.

Returns

The RNA type or default when not found.

Return type

bpy.types.Struct subclass

classmethod bl_rna_get_subclass_py(id, default=None, /)
Parameters

id (str) – The RNA type identifier.

Returns

The class or default when not found.

Return type

type

Inherited Properties

Inherited Functions

References