Creates a new NormalMatrixShaderNode instance.
Initializes the shader node with vertex stage shader code for both GLSL and WGSL, and sets up a Mat3 float output socket for the normal transformation matrix. The output matrix can be used to transform normal vectors from local space to world space while preserving their geometric properties under non-uniform transformations.
The node automatically retrieves the normal matrix from the rendering system's uniform buffer based on the current instance ID.
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
Gets the derivative shader function name for this node. By default, returns the same as the regular function name.
The derivative function name used in shader code
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 a function call statement for this shader node in the final shader code. This method constructs the appropriate function call syntax with proper parameter passing for both WebGL and WebGPU rendering approaches.
The engine instance
The index of this node in the execution order
The shader node to generate the call for
The name of the function to call
Array of input variable names for each node
Array of output variable names for each node
The generated function call statement string
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 provides access to the normal matrix for transforming normal vectors from local space to world space.
The normal matrix is derived from the inverse transpose of the upper-left 3x3 portion of the model matrix (world matrix). It ensures that normal vectors remain perpendicular to surfaces after non-uniform scaling transformations. This matrix is essential for proper lighting calculations in 3D rendering.
The node operates in the vertex shader stage and supports both WebGL (GLSL) and WebGPU (WGSL) rendering backends.
Example