Skip to main content

ShaderNodeGraph

14 tools in this family (folder Editor/Tools/ShaderNodeGraph/ in the bridge package). Effect: writes changes the project or the scene, read-only does not, destructive deletes or overwrites and the client asks before running it.

ToolEffectDescription
shader_node_add_nodewritesAdd a node to the working graph. Specify a 'kind' from the registry (use shader_node_list_nodes
shader_node_apply_templatewritesReplace the working graph with a built-in template: Dissolve, Hologram, Burn, Frozen, Water,
shader_node_apply_to_materialwritesGenerate a shader from the working graph and assign it to the given Material. If the Material
shader_node_connectwritesConnect a node output to another node's input. Validates that both endpoints exist, that the
shader_node_create_graphwritesCreate a new shader node graph in the session, seeded with a master output node
shader_node_export_graphwritesSerialise the working graph to a portable JSON document. If 'output_path' is supplied the JSON
shader_node_generate_shaderwritesTopologically emit the working graph as a complete .shader file at 'output_path'. Performs
shader_node_graph_statsread-onlyReturn summary statistics for the working graph: node count, connection count, distribution per
shader_node_import_graphwritesLoad a graph from a JSON document and install it at 'session_key' (replacing whatever was there).
shader_node_list_nodesread-onlyList every shader node kind discovered by ShaderNodeRegistry, grouped by category
shader_node_previewwritesRender a preview thumbnail of the current working graph to a PNG file. Generates a throwaway
shader_node_remove_nodewritesRemove a node and every connection that touches it (incoming and outgoing). Refuses to remove
shader_node_set_propertywritesSet a single per-instance parameter on a node (e.g. 'property' name, 'default' value, 'label').
shader_node_validate_graphread-onlyValidate the working graph. Reports cycles, unknown node kinds, dangling connections, missing