Node Operators

bpy.ops.node.add_file(filepath="", filter_blender=False, filter_image=True, filter_movie=False, filter_python=False, filter_font=False, filter_sound=False, filter_text=False, filter_btx=False, filter_collada=False, filter_folder=True, filemode=9, name="Image")

Add a file node to the current node editor

Parameters:
  • filepath (string, (optional)) – File Path, Path to file
  • filter_blender (boolean, (optional)) – Filter .blend files
  • filter_image (boolean, (optional)) – Filter image files
  • filter_movie (boolean, (optional)) – Filter movie files
  • filter_python (boolean, (optional)) – Filter python files
  • filter_font (boolean, (optional)) – Filter font files
  • filter_sound (boolean, (optional)) – Filter sound files
  • filter_text (boolean, (optional)) – Filter text files
  • filter_btx (boolean, (optional)) – Filter btx files
  • filter_collada (boolean, (optional)) – Filter COLLADA files
  • filter_folder (boolean, (optional)) – Filter folders
  • filemode (int in [1, 9], (optional)) – File Browser Mode, The setting for the file browser mode to load a .blend file, a library or a special file
  • name (string, (optional)) – Name, Datablock name to assign.
bpy.ops.node.backimage_move()

Move Node backdrop

bpy.ops.node.backimage_sample()

Undocumented (contribute)

bpy.ops.node.backimage_zoom(factor=1.2)

Undocumented (contribute)

Parameters:factor (float in [0, 10], (optional)) – Factor
bpy.ops.node.delete()

Delete selected nodes

bpy.ops.node.delete_reconnect()

Delete nodes; will reconnect nodes as if deletion was muted

bpy.ops.node.duplicate(keep_inputs=False)

Duplicate the nodes

Parameters:keep_inputs (boolean, (optional)) – Keep Inputs, Keep the input links to duplicated nodes
bpy.ops.node.duplicate_move(NODE_OT_duplicate=None, TRANSFORM_OT_translate=None)

Undocumented (contribute)

Parameters:
  • NODE_OT_duplicate (NODE_OT_duplicate, (optional)) – Duplicate Nodes, Duplicate the nodes
  • TRANSFORM_OT_translate (TRANSFORM_OT_translate, (optional)) – Translate, Translate selected items
bpy.ops.node.duplicate_move_keep_inputs(NODE_OT_duplicate=None, TRANSFORM_OT_translate=None)

Undocumented (contribute)

Parameters:
  • NODE_OT_duplicate (NODE_OT_duplicate, (optional)) – Duplicate Nodes, Duplicate the nodes
  • TRANSFORM_OT_translate (TRANSFORM_OT_translate, (optional)) – Translate, Translate selected items
bpy.ops.node.group_edit()

Edit node group

bpy.ops.node.group_make()

Make group from selected nodes

bpy.ops.node.group_socket_add(in_out='SOCK_IN', name="", type='VALUE')

Add node group socket

Parameters:
  • in_out (enum in [‘SOCK_IN’, ‘SOCK_OUT’], (optional)) – Socket Type, Input or Output
  • name (string, (optional)) – Name, Group socket name
  • type (enum in [‘VALUE’, ‘VECTOR’, ‘RGBA’], (optional)) – Type, Type of the group socket
bpy.ops.node.group_socket_move_down(index=0, in_out='SOCK_IN')

Move down node group socket

Parameters:
  • index (int in [0, inf], (optional)) – Index
  • in_out (enum in [‘SOCK_IN’, ‘SOCK_OUT’], (optional)) – Socket Type, Input or Output
bpy.ops.node.group_socket_move_up(index=0, in_out='SOCK_IN')

Move up node group socket

Parameters:
  • index (int in [0, inf], (optional)) – Index
  • in_out (enum in [‘SOCK_IN’, ‘SOCK_OUT’], (optional)) – Socket Type, Input or Output
bpy.ops.node.group_socket_remove(index=0, in_out='SOCK_IN')

Removed node group socket

Parameters:
  • index (int in [0, inf], (optional)) – Index
  • in_out (enum in [‘SOCK_IN’, ‘SOCK_OUT’], (optional)) – Socket Type, Input or Output
bpy.ops.node.group_ungroup()

Ungroup selected nodes

bpy.ops.node.hide_socket_toggle()

Toggle unused node socket display

bpy.ops.node.hide_toggle()

Toggle hiding of selected nodes

Undocumented (contribute)

Makes a link between selected output in input sockets

Parameters:replace (boolean, (optional)) – Replace, Replace socket connections with the new links

Link to Viewer Node

Undocumented (contribute)

Parameters:
  • path (bpy_prop_collection of OperatorMousePath, (optional)) – path
  • cursor (int in [0, inf], (optional)) – Cursor
bpy.ops.node.mute_toggle()

Toggle muting of the nodes

bpy.ops.node.new_node_tree(type='COMPOSITING', name="NodeTree")

Undocumented (contribute)

Parameters:
  • type (enum in [‘MATERIAL’, ‘TEXTURE’, ‘COMPOSITING’], (optional)) –

    Tree Type

    • MATERIAL Material, Material nodes.
    • TEXTURE Texture, Texture nodes.
    • COMPOSITING Compositing, Compositing nodes.
  • name (string, (optional)) – Name
bpy.ops.node.preview_toggle()

Toggle preview display for selected nodes

bpy.ops.node.properties()

Toggles the properties panel display

bpy.ops.node.read_fullsamplelayers()

Undocumented (contribute)

bpy.ops.node.read_renderlayers()

Undocumented (contribute)

bpy.ops.node.render_changed()

Undocumented (contribute)

bpy.ops.node.resize()

Undocumented (contribute)

bpy.ops.node.select(mouse_x=0, mouse_y=0, extend=False)

Select node under cursor

Parameters:
  • mouse_x (int in [-inf, inf], (optional)) – Mouse X
  • mouse_y (int in [-inf, inf], (optional)) – Mouse Y
  • extend (boolean, (optional)) – Extend
bpy.ops.node.select_all()

(De)select all nodes

bpy.ops.node.select_border(gesture_mode=0, xmin=0, xmax=0, ymin=0, ymax=0, tweak=False)

Use box selection to select nodes

Parameters:
  • gesture_mode (int in [-inf, inf], (optional)) – Gesture Mode
  • xmin (int in [-inf, inf], (optional)) – X Min
  • xmax (int in [-inf, inf], (optional)) – X Max
  • ymin (int in [-inf, inf], (optional)) – Y Min
  • ymax (int in [-inf, inf], (optional)) – Y Max
  • tweak (boolean, (optional)) – Tweak, Only activate when mouse is not over a node - useful for tweak gesture

Undocumented (contribute)

Parameters:
  • NODE_OT_select (NODE_OT_select, (optional)) – Select, Select node under cursor
  • NODE_OT_link_viewer (NODE_OT_link_viewer, (optional)) – Link to Viewer Node, Link to Viewer Node
bpy.ops.node.select_linked_from()

Select nodes linked from the selected ones

bpy.ops.node.select_linked_to()

Select nodes linked to the selected ones

bpy.ops.node.select_same_type()

Select all the same type

bpy.ops.node.select_same_type_next()

Select the next node of the same type.

bpy.ops.node.select_same_type_prev()

Select the prev node of the same type.

bpy.ops.node.show_cyclic_dependencies()

Sort the nodes and show the cyclic dependencies between the nodes

bpy.ops.node.view_all()

Resize view so you can see all nodes

bpy.ops.node.visibility_toggle(mouse_x=0, mouse_y=0)

Handle clicks on node header buttons

Parameters:
  • mouse_x (int in [-inf, inf], (optional)) – Mouse X
  • mouse_y (int in [-inf, inf], (optional)) – Mouse Y

Previous topic

Nla Operators

Next topic

Object Operators