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
Gets whether the gizmo has been properly set up and initialized.
True if the gizmo is set up, false otherwise
Gets the current visibility state of the gizmo
True if the gizmo is visible, false otherwise
Sets the visibility state of the gizmo
True to make the gizmo visible, false to hide it
Gets the current length of the axis lines displayed by the gizmo.
The current axis line length
Sets the length of the axis lines displayed by the gizmo.
The length value for the axis lines
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
Destroys the gizmo and cleans up its resources. Removes the gizmo entity and frees associated memory.
InternalSets up the gizmo entities and mesh if not already done. Creates the coordinate axis visualization with colored lines representing X, Y, and Z axes.
InternalUpdates the gizmo's transform properties to match the target object. Positions the gizmo at the target's center point and scales it based on the target's bounding box.
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
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 resets static members so that gizmos can be recreated with a new Engine. 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
Locator Gizmo class that provides visual coordinate axes for 3D objects. Displays X (red), Y (green), and Z (blue) axis lines to help visualize object orientation and position.