Creates a new Gizmo instance
The entity that this gizmo will be associated with and manipulate
Protected__Protected__Protected__the target entity which this gizmo belong to
Protected Optional__The top entity of this gizmo group. A programmer who implements a gizmo class has to make this entity a child of the target entity's scene graph component that the gizmo will belong to manually.
Collection of tags associated with this object
StaticcurrentCurrent maximum object count for UID generation
Static ReadonlyInvalidInvalid object UID constant
Indicates whether the gizmo has been properly set up and initialized.
True if the gizmo is set up and ready to use, false otherwise
Gets the current visibility state of the gizmo.
True if the gizmo is currently visible, false otherwise
Sets the visibility of the gizmo and manages input event registration. When set to visible, registers pointer event handlers and adds the gizmo to the scene. When set to invisible, unregisters events and resets gizmo state.
True to show the gizmo, false to hide it
Gets the current length/scale of the gizmo axes.
The current length value of the gizmo axes
Sets the length/scale of the gizmo axes.
The length value for the gizmo axes
Gets the unique object identifier
The object's UID
Gets the unique name of this object
The unique name string
Protected__Internal method to set the visibility of the gizmo and all its child entities
True to show the gizmo, false to hide it
Protected__Determines whether the gizmo setup should be skipped
True if setup should be skipped, false otherwise
InternalCopies tag data from another RnObject instance to this object
The source RnObject to copy tags from
InternalDestroys the gizmo and cleans up its resources. Removes the gizmo from the scene and frees associated memory.
InternalSets up the gizmo entities and geometry if not already initialized. Creates the visual components (cubes for axes, planes for multi-axis movement) and configures their materials, positioning, and hierarchy.
InternalUpdates the gizmo's transform and visual state each frame. Positions the gizmo at the target's location, scales it appropriately, and applies any ongoing translation operations.
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
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
ProtectedsetApplies appropriate tags to the gizmo entities for identification and categorization This method ensures that all gizmo entities are properly tagged for rendering and processing pipelines
Sets the coordinate space for gizmo operations.
Either 'local' for object-relative coordinates or 'world' for global coordinates
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_InternalCleans up all static resources for a specific Engine. This removes the resources associated with the engine from the map. Called from Engine.destroy()
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
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
Translation Gizmo class Provides an interactive 3D translation gizmo for manipulating object positions in 3D space. The gizmo displays colored axes (red for X, green for Y, blue for Z) that can be dragged to translate objects along specific axes or planes.