Creates a new MergeVectorShaderNode instance.
The component type (Float, Int, or UnsignedInt). Defaults to Float.
Initializes the node with predefined inputs for various vector components and outputs for different vector sizes. The node supports multiple input combinations to create flexible vector merging operations.
Protected Optional__Protected__Protected__Protected__Protected__Protected__Collection of tags associated with this object
Static_StaticcurrentCurrent maximum object count for UID generation
Static ReadonlyInvalidInvalid object UID constant
Gets all input connections for this node.
An array of input connection configurations
Gets the unique object identifier
The object's UID
Gets the shader function name for this node.
The function name used in shader code
Gets the unique identifier for this shader node.
The unique node identifier
Gets the unique name of this object
The unique name string
InternalCopies tag data from another RnObject instance to this object
The source RnObject to copy tags from
Adds an input connection to this node from another shader node. This establishes a data flow connection between the output of one node and the input of this node.
The composition type enum
The component type enum
The source shader node to connect from
The output socket of the source node
The input socket of this node to connect to
Finds and returns an input socket by name.
The name of the input socket to find
The input socket if found, undefined otherwise
Gets all input sockets for this node.
An array of all input sockets
Finds and returns an output socket by name.
The name of the output socket to find
The output socket if found, undefined otherwise
Gets all output sockets for this node.
An array of all output sockets
Retrieves the shader code for the specified shader stage. Returns appropriate code based on the current rendering approach (WebGL/WebGPU).
The shader code string for the specified stage
Determines the appropriate shader function name based on connected inputs and component type.
This method analyzes which input connections are active and returns the corresponding shader function variant. Each combination of inputs requires a different shader function implementation to handle the vector merging logic. For WebGPU, type suffix (I32, U32) is added for non-float types.
Supported input combinations:
The engine instance
The derivative function name suffix for the shader
Gets the current shader stage of this node.
The current shader stage
Retrieves a complete tag object (name and value) for the specified tag name
The name of the tag to retrieve
A Tag object containing the name and value
Retrieves the value associated with a specific tag name
The name of the tag whose value to retrieve
The tag value, or undefined if the tag doesn't exist
Checks whether this object has a tag with the specified name
The name of the tag to check for
True if the tag exists (value is not null/undefined), false otherwise
Generates the shader function call statement for the merge vector operation. ShaderGraphResolver already orders varOutputNames to match output socket order and generates dummy variables for unconnected outputs, so we simply use them directly. This node only needs custom handling for selecting the correct input indices based on which inputs are connected.
The engine instance
The node index in the shader graph
The shader node instance (unused in this implementation)
The name of the shader function to call
Array of input variable names for each node
Array of output variable names for each node (already ordered by ShaderGraphResolver)
The generated shader code string for the function call
Checks if this object has a tag with the specified name and value
The tag name to match
The tag value to match
True if the object has a matching tag, false otherwise
Checks if this object has all the specified tags with exactly matching values
Object containing tag names as keys and expected values
True if all specified tags exist with matching values, false otherwise
Checks if the object's combined tag string contains all the provided search strings. This allows for flexible searching within tag names and values.
Array of strings that must all be present in the combined tag string
True if all strings are found in the combined tag string, false otherwise
Removes a tag from this object
The name of the tag to remove
Sets the shader stage for this node (Neutral, Vertex, or Fragment).
The shader stage to assign to this node
Attempts to set a tag on this object. If the tag already exists, it will be replaced.
The tag object containing the name and value to set
True if the tag was successfully set, false if the tag name contains invalid characters
Attempts to set a unique name for this object
The desired unique name
If true, appends UID to make name unique when conflicts occur; if false, fails on conflict
True if the name was successfully set, false if there was a conflict and toAddNameIfConflict was false
Unregisters this object from all tracking collections. Should be called when the object is being destroyed.
Validates that a tag string contains only allowed characters (alphanumeric and underscore)
The string to validate
True if the string contains only valid characters, false if it contains invalid characters
Static_InternalResets all static object tracking data. Used primarily for testing.
StaticgetRetrieves an RnObject instance by its unique identifier
The unique identifier of the object to retrieve
The RnObject instance or undefined if not found or garbage collected
StaticgetRetrieves an RnObject instance by its unique name
The unique name of the object to retrieve
The RnObject instance or undefined if not found or garbage collected
StaticgetRetrieves a shader node by its unique identifier.
The unique identifier of the shader node
The shader node with the specified UID
StaticsearchSearches for the first object that has a specific tag with the given value
The tag name to search for
The tag value to match
WeakRef to the first matching object, or undefined if not found
A shader node that merges vector components to create various vector outputs.
This node provides the capability to combine individual scalar components (x, y, z, w) or smaller vectors (xy, zw, xyz) into larger vector outputs (Vec2, Vec3, Vec4). It supports multiple input configurations and automatically selects the appropriate shader function based on which inputs are connected. Supports float, int, and uint component types.
Example