Up to date
This page is up to date for Godot 4.2.
If you still find outdated information, please open an issue.
VisualShaderNodeCustom¶
Inherits: VisualShaderNode < Resource < RefCounted < Object
Virtual class to define custom VisualShaderNodes for use in the Visual Shader Editor.
Description¶
By inheriting this class you can create a custom VisualShader script addon which will be automatically added to the Visual Shader Editor. The VisualShaderNode's behavior is defined by overriding the provided virtual methods.
In order for the node to be registered as an editor addon, you must use the @tool annotation and provide a class_name for your custom script. For example:
@tool
extends VisualShaderNodeCustom
class_name VisualShaderNodeNoise
Tutorials¶
Methods¶
_get_category ( ) virtual const |
|
_get_code ( String[] input_vars, String[] output_vars, Mode mode, Type type ) virtual const |
|
_get_default_input_port ( PortType type ) virtual const |
|
_get_description ( ) virtual const |
|
_get_func_code ( Mode mode, Type type ) virtual const |
|
_get_global_code ( Mode mode ) virtual const |
|
_get_input_port_count ( ) virtual const |
|
_get_input_port_default_value ( int port ) virtual const |
|
_get_input_port_name ( int port ) virtual const |
|
_get_input_port_type ( int port ) virtual const |
|
_get_name ( ) virtual const |
|
_get_output_port_count ( ) virtual const |
|
_get_output_port_name ( int port ) virtual const |
|
_get_output_port_type ( int port ) virtual const |
|
_get_property_count ( ) virtual const |
|
_get_property_default_index ( int index ) virtual const |
|
_get_property_name ( int index ) virtual const |
|
_get_property_options ( int index ) virtual const |
|
_get_return_icon_type ( ) virtual const |
|
_is_available ( Mode mode, Type type ) virtual const |
|
_is_highend ( ) virtual const |
|
get_option_index ( int option ) const |
Method Descriptions¶
String _get_category ( ) virtual const
Override this method to define the path to the associated custom node in the Visual Shader Editor's members dialog. The path may look like "MyGame/MyFunctions/Noise".
Defining this method is optional. If not overridden, the node will be filed under the "Addons" category.
String _get_code ( String[] input_vars, String[] output_vars, Mode mode, Type type ) virtual const
Override this method to define the actual shader code of the associated custom node. The shader code should be returned as a string, which can have multiple lines (the """ multiline string construct can be used for convenience).
The input_vars and output_vars arrays contain the string names of the various input and output variables, as defined by _get_input_* and _get_output_* virtual methods in this class.
The output ports can be assigned values in the shader code. For example, return output_vars[0] + " = " + input_vars[0] + ";".
You can customize the generated code based on the shader mode (see Mode) and/or type (see Type).
Defining this method is required.
int _get_default_input_port ( PortType type ) virtual const
Override this method to define the input port which should be connected by default when this node is created as a result of dragging a connection from an existing node to the empty space on the graph.
Defining this method is optional. If not overridden, the connection will be created to the first valid port.
String _get_description ( ) virtual const
Override this method to define the description of the associated custom node in the Visual Shader Editor's members dialog.
Defining this method is optional.
String _get_func_code ( Mode mode, Type type ) virtual const
Override this method to add a shader code to the beginning of each shader function (once). The shader code should be returned as a string, which can have multiple lines (the """ multiline string construct can be used for convenience).
If there are multiple custom nodes of different types which use this feature the order of each insertion is undefined.
You can customize the generated code based on the shader mode (see Mode) and/or type (see Type).
Defining this method is optional.
String _get_global_code ( Mode mode ) virtual const
Override this method to add shader code on top of the global shader, to define your own standard library of reusable methods, varyings, constants, uniforms, etc. The shader code should be returned as a string, which can have multiple lines (the """ multiline string construct can be used for convenience).
Be careful with this functionality as it can cause name conflicts with other custom nodes, so be sure to give the defined entities unique names.
You can customize the generated code based on the shader mode (see