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