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)

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

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)

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#