Node Operators#

bpy.ops.node.add_collection(name='', session_uid=0)#

Add a collection info node to the current node editor

Parameters:

  • name (string, (optional, never None)) – Name, Name of the data-block to use by the operator

  • session_uid (int in [-inf, inf], (optional)) – Session UID, Session UID of the data-block to use by the operator

bpy.ops.node.add_file(filepath='', directory='', files=None, hide_props_region=True, check_existing=False, filter_blender=False, filter_backup=False, filter_image=True, filter_movie=True, filter_python=False, filter_font=False, filter_sound=False, filter_text=False, filter_archive=False, filter_btx=False, filter_collada=False, filter_alembic=False, filter_usd=False, filter_obj=False, filter_volume=False, filter_folder=True, filter_blenlib=False, filemode=9, relative_path=True, show_multiview=False, use_multiview=False, display_type='DEFAULT', sort_method='', name='', session_uid=0)#

Add a file node to the current node editor

Parameters:

  • filepath (string, (optional, never None)) – File Path, Path to file

  • directory (string, (optional, never None)) – Directory, Directory of the file

  • files (bpy_prop_collection of OperatorFileListElement, (optional)) – Files

  • hide_props_region (boolean, (optional)) – Hide Operator Properties, Collapse the region displaying the operator settings

  • check_existing (boolean, (optional)) – Check Existing, Check and warn on overwriting existing files

  • filter_blender (boolean, (optional)) – Filter .blend files

  • filter_backup (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_archive (boolean, (optional)) – Filter archive files

  • filter_btx (boolean, (optional)) – Filter btx files

  • filter_collada (boolean, (optional)) – Filter COLLADA files

  • filter_alembic (boolean, (optional)) – Filter Alembic files

  • filter_usd (boolean, (optional)) – Filter USD files

  • filter_obj (boolean, (optional)) – Filter OBJ files

  • filter_volume (boolean, (optional)) – Filter OpenVDB volume files

  • filter_folder (boolean, (optional)) – Filter folders

  • filter_blenlib (boolean, (optional)) – Filter Blender IDs

  • 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

  • relative_path (boolean, (optional)) – Relative Path, Select the file relative to the blend file

  • show_multiview (boolean, (optional)) – Enable Multi-View

  • use_multiview (boolean, (optional)) – Use Multi-View

  • display_type (enum in ['DEFAULT', 'LIST_VERTICAL', 'LIST_HORIZONTAL', 'THUMBNAIL'], (optional)) –

    Display Type

    • DEFAULT Default – Automatically determine display type for files.

    • LIST_VERTICAL Short List – Display files as short list.

    • LIST_HORIZONTAL Long List – Display files as a detailed list.

    • THUMBNAIL Thumbnails – Display files as thumbnails.

  • sort_method (enum in ['DEFAULT', 'FILE_SORT_ALPHA', 'FILE_SORT_EXTENSION', 'FILE_SORT_TIME', 'FILE_SORT_SIZE'], (optional)) –

    File sorting mode

    • DEFAULT Default – Automatically determine sort method for files.

    • FILE_SORT_ALPHA Name – Sort the file list alphabetically.

    • FILE_SORT_EXTENSION Extension – Sort the file list by extension/type.

    • FILE_SORT_TIME Modified Date – Sort files by modification time.

    • FILE_SORT_SIZE Size – Sort files by size.

  • name (string, (optional, never None)) – Name, Name of the data-block to use by the operator

  • session_uid (int in [-inf, inf], (optional)) – Session UID, Session UID of the data-block to use by the operator

bpy.ops.node.add_group(name='', session_uid=0, show_datablock_in_node=True)#

Add an existing node group to the current node editor

Parameters:

  • name (string, (optional, never None)) – Name, Name of the data-block to use by the operator

  • session_uid (int in [-inf, inf], (optional)) – Session UID, Session UID of the data-block to use by the operator

  • show_datablock_in_node (boolean, (optional)) – Show the datablock selector in the node

bpy.ops.node.add_group_asset(asset_library_type='LOCAL', asset_library_identifier='', relative_asset_identifier='')#

Add a node group asset to the active node tree

Parameters:

  • asset_library_type (enum in Asset Library Type Items, (optional)) – Asset Library Type

  • asset_library_identifier (string, (optional, never None)) – Asset Library Identifier

  • relative_asset_identifier (string, (optional, never None)) – Relative Asset Identifier

bpy.ops.node.add_mask(name='', session_uid=0)#

Add a mask node to the current node editor

Parameters:

  • name (string, (optional, never None)) – Name, Name of the data-block to use by the operator

  • session_uid (int in [-inf, inf], (optional)) – Session UID, Session UID of the data-block to use by the operator

bpy.ops.node.add_material(name='', session_uid=0)#

Add a material node to the current node editor

Parameters:

  • name (string, (optional, never None)) – Name, Name of the data-block to use by the operator

  • session_uid (int in [-inf, inf], (optional)) – Session UID, Session UID of the data-block to use by the operator

bpy.ops.node.add_node(use_transform=False, settings=None, type='')#

Add a node to the active tree

Parameters:

  • use_transform (boolean, (optional)) – Use Transform, Start transform operator after inserting the node

  • settings (bpy_prop_collection of NodeSetting, (optional)) – Settings, Settings to be applied on the newly created node

  • type (string, (optional, never None)) – Node Type, Node type

File:

startup/bl_operators/node.py:145

bpy.ops.node.add_object(name='', session_uid=0)#

Add an object info node to the current node editor

Parameters:

  • name (string, (optional, never None)) – Name, Name of the data-block to use by the operator

  • session_uid (int in [-inf, inf], (optional)) – Session UID, Session UID of the data-block to use by the operator

bpy.ops.node.add_repeat_zone(use_transform=False, settings=None, offset=(150.0, 0.0))#

Add a repeat zone that allows executing nodes a dynamic number of times

Parameters:

  • use_transform (boolean, (optional)) – Use Transform, Start transform operator after inserting the node

  • settings (bpy_prop_collection of NodeSetting, (optional)) – Settings, Settings to be applied on the newly created node

  • offset (float array of 2 items in [-inf, inf], (optional)) – Offset, Offset of nodes from the cursor when added

File:

startup/bl_operators/node.py:177

bpy.ops.node.add_reroute(path=None, cursor=8)#

Add a reroute node

Parameters:

  • path (bpy_prop_collection of OperatorMousePath, (optional)) – Path

  • cursor (int in [0, inf], (optional)) – Cursor

bpy.ops.node.add_simulation_zone(use_transform=False, settings=None, offset=(150.0, 0.0))#

Add simulation zone input and output nodes to the active tree

Parameters:

  • use_transform (boolean, (optional)) – Use Transform, Start transform operator after inserting the node

  • settings (bpy_prop_collection of NodeSetting, (optional)) – Settings, Settings to be applied on the newly created node

  • offset (float array of 2 items in [-inf, inf], (optional)) – Offset, Offset of nodes from the cursor when added

File:

startup/bl_operators/node.py:177

bpy.ops.node.attach()#

Attach active node to a frame

bpy.ops.node.backimage_fit()#

Fit the background image to the view

bpy.ops.node.backimage_move()#

Move node backdrop

bpy.ops.node.backimage_sample()#

Use mouse to sample background image

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

Zoom in/out the background image

Parameters:

factor (float in [0, 10], (optional)) – Factor

bpy.ops.node.bake_node_item_add()#

Add bake item

bpy.ops.node.bake_node_item_move(direction='UP')#

Move active bake item

Parameters:

direction (enum in ['UP', 'DOWN'], (optional)) – Direction, Move direction

bpy.ops.node.bake_node_item_remove()#

Remove active bake item

bpy.ops.node.capture_attribute_item_add()#

Add capture attribute item

bpy.ops.node.capture_attribute_item_move(direction='UP')#

Move active capture attribute item

Parameters:

direction (enum in ['UP', 'DOWN'], (optional)) – Direction, Move direction

bpy.ops.node.capture_attribute_item_remove()#

Remove active capture attribute item

bpy.ops.node.clear_viewer_border()#

Clear the boundaries for viewer operations

bpy.ops.node.clipboard_copy()#

Copy the selected nodes to the internal clipboard

bpy.ops.node.clipboard_paste(offset=(0.0, 0.0))#

Paste nodes from the internal clipboard to the active node tree

Parameters:

offset (float array of 2 items in [-inf, inf], (optional)) – Location, The 2D view location for the center of the new nodes, or unchanged if not set

bpy.ops.node.collapse_hide_unused_toggle()#

Toggle collapsed nodes and hide unused sockets

File:

startup/bl_operators/node.py:235

bpy.ops.node.connect_to_output(run_in_geometry_nodes=True)#

Connect active node to the active output node of the node tree

Parameters:

run_in_geometry_nodes (boolean, (optional)) – Run in Geometry Nodes Editor

File:

startup/bl_operators/connect_to_output.py:242

bpy.ops.node.cryptomatte_layer_add()#

Add a new input layer to a Cryptomatte node

bpy.ops.node.cryptomatte_layer_remove()#

Remove layer from a Cryptomatte node

bpy.ops.node.deactivate_viewer()#

Deactivate selected viewer node in geometry nodes

bpy.ops.node.delete()#

Remove selected nodes

bpy.ops.node.delete_reconnect()#

Remove nodes and reconnect nodes as if deletion was muted

bpy.ops.node.detach()#

Detach selected nodes from parents

bpy.ops.node.detach_translate_attach(NODE_OT_detach=None, TRANSFORM_OT_translate=None, NODE_OT_attach=None)#

Detach nodes, move and attach to frame

Parameters:

  • NODE_OT_detach (NODE_OT_detach, (optional)) – Detach Nodes, Detach selected nodes from parents

  • TRANSFORM_OT_translate (TRANSFORM_OT_translate, (optional)) – Move, Move selected items

  • NODE_OT_attach (NODE_OT_attach, (optional)) – Attach Nodes, Attach active node to a frame

bpy.ops.node.duplicate(keep_inputs=False, linked=True)#

Duplicate selected nodes

Parameters:

  • keep_inputs (boolean, (optional)) – Keep Inputs, Keep the input links to duplicated nodes

  • linked (boolean, (optional)) – Linked, Duplicate node but not node trees, linking to the original data

bpy.ops.node.duplicate_move(NODE_OT_duplicate=None, NODE_OT_translate_attach=None)#

Duplicate selected nodes and move them

Parameters:

  • NODE_OT_duplicate (NODE_OT_duplicate, (optional)) – Duplicate Nodes, Duplicate selected nodes

  • NODE_OT_translate_attach (NODE_OT_translate_attach, (optional)) – Move and Attach, Move nodes and attach to frame

bpy.ops.node.duplicate_move_keep_inputs(NODE_OT_duplicate=None, NODE_OT_translate_attach=None)#

Duplicate selected nodes keeping input links and move them

Parameters:

  • NODE_OT_duplicate (NODE_OT_duplicate, (optional)) – Duplicate Nodes, Duplicate selected nodes

  • NODE_OT_translate_attach (NODE_OT_translate_attach, (optional)) – Move and Attach, Move nodes and attach to frame

bpy.ops.node.duplicate_move_linked(NODE_OT_duplicate=None, NODE_OT_translate_attach=None)#

Duplicate selected nodes, but not their node trees, and move them

Parameters:

  • NODE_OT_duplicate (NODE_OT_duplicate, (optional)) – Duplicate Nodes, Duplicate selected nodes

  • NODE_OT_translate_attach (NODE_OT_translate_attach, (optional)) – Move and Attach, Move nodes and attach to frame

bpy.ops.node.enum_definition_item_add()#

Add menu item

bpy.ops.node.enum_definition_item_move(direction='UP')#

Move active menu item

Parameters:

direction (enum in ['UP', 'DOWN'], (optional)) – Direction, Move direction

bpy.ops.node.enum_definition_item_remove()#

Remove active menu item

bpy.ops.node.find_node()#

Search for a node by name and focus and select it

bpy.ops.node.gltf_settings_node_operator()#

Add a node to the active tree for glTF export

File:

addons_core/io_scene_gltf2/blender/com/gltf2_blender_ui.py:35

bpy.ops.node.group_edit(exit=False)#

Edit node group

Parameters:

exit (boolean, (optional)) – Exit

bpy.ops.node.group_insert()#

Insert selected nodes into a node group

bpy.ops.node.group_make()#

Make group from selected nodes

bpy.ops.node.group_separate(type='COPY')#

Separate selected nodes from the node group

Parameters:

type (enum in ['COPY', 'MOVE'], (optional)) –

Type

  • COPY Copy – Copy to parent node tree, keep group intact.

  • MOVE Move – Move to parent node tree, remove from group.

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

bpy.ops.node.index_switch_item_add()#

Add bake item

bpy.ops.node.index_switch_item_remove(index=0)#

Remove an item from the index switch

Parameters:

index (int in [0, inf], (optional)) – Index, Index to remove

bpy.ops.node.insert_offset()#

Automatically offset nodes on insertion

bpy.ops.node.interface_item_duplicate()#

Add a copy of the active item to the interface

File:

startup/bl_operators/node.py:366

bpy.ops.node.interface_item_new(item_type='INPUT')#

Add a new item to the interface

Parameters:

item_type (enum in ['INPUT', 'OUTPUT', 'PANEL'], (optional)) – Item Type, Type of the item to create

File:

startup/bl_operators/node.py:321

bpy.ops.node.interface_item_remove()#

Remove active item from the interface

File:

startup/bl_operators/node.py:385

bpy.ops.node.join()#

Attach selected nodes to a new common frame

Use the mouse to create a link between two nodes

Parameters:

  • detach (boolean, (optional)) – Detach, Detach and redirect existing links

  • drag_start (float array of 2 items in [-6, 6], (optional)) – Drag Start, The position of the mouse cursor at the start of the operation

  • inside_padding (float in [0, 100], (optional)) – Inside Padding, Inside distance in UI units from the edge of the region within which to start panning

  • outside_padding (float in [0, 100], (optional)) – Outside Padding, Outside distance in UI units from the edge of the region at which to stop panning

  • speed_ramp (float in [0, 100], (optional)) – Speed Ramp, Width of the zone in UI units where speed increases with distance from the edge

  • max_speed (float in [0, 10000], (optional)) – Max Speed, Maximum speed in UI units per second

  • delay (float in [0, 10], (optional)) – Delay, Delay in seconds before maximum speed is reached

  • zoom_influence (float in [0, 1], (optional)) – Zoom Influence, Influence of the zoom factor on scroll speed

Make a link between selected output and input sockets

Parameters:

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

Link to viewer node

Use the mouse to cut (remove) some links

Parameters:

  • path (bpy_prop_collection of OperatorMousePath, (optional)) – Path

  • cursor (int in [0, inf], (optional)) – Cursor

Remove all links to selected nodes, and try to connect neighbor nodes together

Use the mouse to mute links

Parameters:

  • path (bpy_prop_collection of OperatorMousePath, (optional)) – Path

  • cursor (int in [0, inf], (optional)) – Cursor

Move a node to detach links

Parameters:

  • NODE_OT_links_detach (NODE_OT_links_detach, (optional)) – Detach Links, Remove all links to selected nodes, and try to connect neighbor nodes together

  • TRANSFORM_OT_translate (TRANSFORM_OT_translate, (optional)) – Move, Move selected items

Move a node to detach links

Parameters:

  • NODE_OT_links_detach (NODE_OT_links_detach, (optional)) – Detach Links, Remove all links to selected nodes, and try to connect neighbor nodes together

  • NODE_OT_translate_attach (NODE_OT_translate_attach, (optional)) – Move and Attach, Move nodes and attach to frame

bpy.ops.node.mute_toggle()#

Toggle muting of selected nodes

bpy.ops.node.new_geometry_node_group_assign()#

Create a new geometry node group and assign it to the active modifier

File:

startup/bl_operators/geometry_nodes.py:322

bpy.ops.node.new_geometry_node_group_tool()#

Create a new geometry node group for a tool

File:

startup/bl_operators/geometry_nodes.py:343

bpy.ops.node.new_geometry_nodes_modifier()#

Create a new modifier with a new geometry node group

File:

startup/bl_operators/geometry_nodes.py:299

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

Create a new node tree

Parameters:

  • type (enum in [], (optional)) – Tree Type

  • name (string, (optional, never None)) – Name

bpy.ops.node.node_color_preset_add(name='', remove_name=False, remove_active=False)#

Add or remove a Node Color Preset

Parameters:

  • name (string, (optional, never None)) – Name, Name of the preset, used to make the path name

  • remove_name (boolean, (optional)) – remove_name

  • remove_active (boolean, (optional)) – remove_active

File:

startup/bl_operators/presets.py:119

bpy.ops.node.node_copy_color()#

Copy color to all selected nodes

bpy.ops.node.options_toggle()#

Toggle option buttons display for selected nodes

bpy.ops.node.output_file_add_socket(file_path='Image')#

Add a new input to a file output node

Parameters:

file_path (string, (optional, never None)) – File Path, Subpath of the output file

bpy.ops.node.output_file_move_active_socket(direction='DOWN')#

Move the active input of a file output node up or down the list

Parameters:

direction (enum in ['UP', 'DOWN'], (optional)) – Direction

bpy.ops.node.output_file_remove_active_socket()#

Remove the active input from a file output node

bpy.ops.node.parent_set()#

Attach selected nodes

bpy.ops.node.preview_toggle()#

Toggle preview display for selected nodes

bpy.ops.node.read_viewlayers()#

Read all render layers of all used scenes

bpy.ops.node.render_changed()#

Render current scene, when input node’s layer has been changed

bpy.ops.node.repeat_zone_item_add()#

Add repeat zone item

bpy.ops.node.repeat_zone_item_move(direction='UP')#

Move active repeat zone item

Parameters:

direction (enum in ['UP', 'DOWN'], (optional)) – Direction, Move direction

bpy.ops.node.repeat_zone_item_remove()#

Remove active repeat zone item

bpy.ops.node.resize()#

Resize a node

bpy.ops.node.select(extend=False, deselect=False, toggle=False, deselect_all=False, select_passthrough=False, location=(0, 0), socket_select=False, clear_viewer=False)#

Select the node under the cursor

Parameters:

  • extend (boolean, (optional)) – Extend, Extend selection instead of deselecting everything first

  • deselect (boolean, (optional)) – Deselect, Remove from selection

  • toggle (boolean, (optional)) – Toggle Selection, Toggle the selection

  • deselect_all (boolean, (optional)) – Deselect On Nothing, Deselect all when nothing under the cursor

  • select_passthrough (boolean, (optional)) – Only Select Unselected, Ignore the select action when the element is already selected

  • location (int array of 2 items in [-inf, inf], (optional)) – Location, Mouse location

  • socket_select (boolean, (optional)) – Socket Select

  • clear_viewer (boolean, (optional)) – Clear Viewer, Deactivate geometry nodes viewer when clicking in empty space

bpy.ops.node.select_all(action='TOGGLE')#

(De)select all nodes

Parameters:

action (enum in ['TOGGLE', 'SELECT', 'DESELECT', 'INVERT'], (optional)) –

Action, Selection action to execute

  • TOGGLE Toggle – Toggle selection for all elements.

  • SELECT Select – Select all elements.

  • DESELECT Deselect – Deselect all elements.

  • INVERT Invert – Invert selection of all elements.

bpy.ops.node.select_box(tweak=False, xmin=0, xmax=0, ymin=0, ymax=0, wait_for_input=True, mode='SET')#

Use box selection to select nodes

Parameters:

  • tweak (boolean, (optional)) – Tweak, Only activate when mouse is not over a node (useful for tweak gesture)

  • 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

  • wait_for_input (boolean, (optional)) – Wait for Input

  • mode (enum in ['SET', 'ADD', 'SUB'], (optional)) –

    Mode

    • SET Set – Set a new selection.

    • ADD Extend – Extend existing selection.

    • SUB Subtract – Subtract existing selection.

bpy.ops.node.select_circle(x=0, y=0, radius=25, wait_for_input=True, mode='SET')#

Use circle selection to select nodes

Parameters:

  • x (int in [-inf, inf], (optional)) – X

  • y (int in [-inf, inf], (optional)) – Y

  • radius (int in [1, inf], (optional)) – Radius

  • wait_for_input (boolean, (optional)) – Wait for Input

  • mode (enum in ['SET', 'ADD', 'SUB'], (optional)) –

    Mode

    • SET Set – Set a new selection.

    • ADD Extend – Extend existing selection.

    • SUB Subtract – Subtract existing selection.

bpy.ops.node.select_grouped(extend=False, type='TYPE')#

Select nodes with similar properties

Parameters:

  • extend (boolean, (optional)) – Extend, Extend selection instead of deselecting everything first

  • type (enum in ['TYPE', 'COLOR', 'PREFIX', 'SUFFIX'], (optional)) – Type

bpy.ops.node.select_lasso(tweak=False, path=None, mode='SET')#

Select nodes using lasso selection

Parameters:

  • tweak (boolean, (optional)) – Tweak, Only activate when mouse is not over a node (useful for tweak gesture)

  • path (bpy_prop_collection of OperatorMousePath, (optional)) – Path

  • mode (enum in ['SET', 'ADD', 'SUB'], (optional)) –

    Mode

    • SET Set – Set a new selection.

    • ADD Extend – Extend existing selection.

    • SUB Subtract – Subtract existing selection.

Select node and link it to a viewer node

Parameters:

  • NODE_OT_select (NODE_OT_select, (optional)) – Select, Select the node under the 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_step(prev=False)#

Activate and view same node type, step by step

Parameters:

prev (boolean, (optional)) – Previous

bpy.ops.node.shader_script_update()#

Update shader script node with new sockets and options from the script

bpy.ops.node.simulation_zone_item_add()#

Add simulation zone item

bpy.ops.node.simulation_zone_item_move(direction='UP')#

Move active simulation zone item

Parameters:

direction (enum in ['UP', 'DOWN'], (optional)) – Direction, Move direction

bpy.ops.node.simulation_zone_item_remove()#

Remove active simulation zone item

bpy.ops.node.translate_attach(TRANSFORM_OT_translate=None, NODE_OT_attach=None)#

Move nodes and attach to frame

Parameters:

  • TRANSFORM_OT_translate (TRANSFORM_OT_translate, (optional)) – Move, Move selected items

  • NODE_OT_attach (NODE_OT_attach, (optional)) – Attach Nodes, Attach active node to a frame

bpy.ops.node.translate_attach_remove_on_cancel(TRANSFORM_OT_translate=None, NODE_OT_attach=None)#

Move nodes and attach to frame

Parameters:

  • TRANSFORM_OT_translate (TRANSFORM_OT_translate, (optional)) – Move, Move selected items

  • NODE_OT_attach (NODE_OT_attach, (optional)) – Attach Nodes, Attach active node to a frame

bpy.ops.node.tree_path_parent()#

Go to parent node tree

File:

startup/bl_operators/node.py:265

bpy.ops.node.view_all()#

Resize view so you can see all nodes

bpy.ops.node.view_selected()#

Resize view so you can see selected nodes

bpy.ops.node.viewer_border(xmin=0, xmax=0, ymin=0, ymax=0, wait_for_input=True)#

Set the boundaries for viewer operations

Parameters:

  • 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

  • wait_for_input (boolean, (optional)) – Wait for Input