Class TranslationGizmo

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.

Hierarchy (view full)

Constructors

constructor

Properties

__isVisible __target __topEntity? _tags InvalidObjectUID currentMaxObjectCount

Accessors

isSetup isVisible length objectUID uniqueName

Methods

__setVisible __toSkipSetup _copyFrom _destroy _setup _update getTag getTagValue hasTag matchTag matchTags matchTagsAsFreeStrings removeTag setGizmoTag setSpace tryToSetTag tryToSetUniqueName unregister validateTagString _reset getRnObject getRnObjectByName searchByTag

Constructors

constructor

Properties

Protected__isVisible

__isVisible: boolean = false

Protected__target

__target: ISceneGraphEntity

the target entity which this gizmo belong to

Protected Optional__topEntity

__topEntity?: ISceneGraphEntity | IMeshEntity

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.

_tags

_tags: RnTags = {}

Collection of tags associated with this object

Static ReadonlyInvalidObjectUID

InvalidObjectUID: -1 = -1

Invalid object UID constant

StaticcurrentMaxObjectCount

currentMaxObjectCount: number = 0

Current maximum object count for UID generation

Accessors

isSetup

  • get isSetup(): boolean

  • Indicates whether the gizmo has been properly set up and initialized.

    Returns boolean

    True if the gizmo is set up and ready to use, false otherwise

isVisible

  • get isVisible(): boolean

  • Gets the current visibility state of the gizmo.

    Returns boolean

    True if the gizmo is currently visible, false otherwise

  • set isVisible(flg): void

  • 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.

    Parameters

    • flg: boolean

      True to show the gizmo, false to hide it

    Returns void

length

objectUID

  • get objectUID(): number

  • Gets the unique object identifier

    Returns number

    The object's UID

uniqueName

  • get uniqueName(): string

  • Gets the unique name of this object

    Returns string

    The unique name string

Methods

Protected__setVisible

  • __setVisible(flg): void

  • Internal method to set the visibility of the gizmo and all its child entities

    Parameters

    • flg: boolean

      True to show the gizmo, false to hide it

    Returns void

Protected__toSkipSetup

_copyFrom

_destroy

_setup

  • _setup(): void
  • Internal

    Sets 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.

    Returns void

_update

  • _update(): void
  • Internal

    Updates 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.

    Returns void

getTag

  • getTag(tagName): Tag

  • Retrieves a complete tag object (name and value) for the specified tag name

    Parameters

    • tagName: string

      The name of the tag to retrieve

    Returns Tag

    A Tag object containing the name and value

getTagValue

  • getTagValue(tagName): any

  • Retrieves the value associated with a specific tag name

    Parameters

    • tagName: string

      The name of the tag whose value to retrieve

    Returns any

    The tag value, or undefined if the tag doesn't exist

hasTag

  • hasTag(tagName): boolean

  • Checks whether this object has a tag with the specified name

    Parameters

    • tagName: string

      The name of the tag to check for

    Returns boolean

    True if the tag exists (value is not null/undefined), false otherwise

matchTag

  • matchTag(tagName, tagValue): boolean

  • Checks if this object has a tag with the specified name and value

    Parameters

    • tagName: string

      The tag name to match

    • tagValue: string

      The tag value to match

    Returns boolean

    True if the object has a matching tag, false otherwise

matchTags

  • matchTags(tags): boolean

  • Checks if this object has all the specified tags with exactly matching values

    Parameters

    • tags: RnTags

      Object containing tag names as keys and expected values

    Returns boolean

    True if all specified tags exist with matching values, false otherwise

matchTagsAsFreeStrings

  • matchTagsAsFreeStrings(stringArray): boolean

  • Checks if the object's combined tag string contains all the provided search strings. This allows for flexible searching within tag names and values.

    Parameters

    • stringArray: string[]

      Array of strings that must all be present in the combined tag string

    Returns boolean

    True if all strings are found in the combined tag string, false otherwise

removeTag

ProtectedsetGizmoTag

  • setGizmoTag(): void

  • Applies 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

    Returns void

setSpace

  • setSpace(space): void

  • Sets the coordinate space for gizmo operations.

    Parameters

    • space: "local" | "world"

      Either 'local' for object-relative coordinates or 'world' for global coordinates

    Returns void

tryToSetTag

  • tryToSetTag(tag): boolean

  • Attempts to set a tag on this object. If the tag already exists, it will be replaced.

    Parameters

    • tag: Tag

      The tag object containing the name and value to set

    Returns boolean

    True if the tag was successfully set, false if the tag name contains invalid characters

tryToSetUniqueName

  • tryToSetUniqueName(name, toAddNameIfConflict): boolean

  • Attempts to set a unique name for this object

    Parameters

    • name: string

      The desired unique name

    • toAddNameIfConflict: boolean

      If true, appends UID to make name unique when conflicts occur; if false, fails on conflict

    Returns boolean

    True if the name was successfully set, false if there was a conflict and toAddNameIfConflict was false

unregister

validateTagString

  • validateTagString(val): boolean

  • Validates that a tag string contains only allowed characters (alphanumeric and underscore)

    Parameters

    • val: string

      The string to validate

    Returns boolean

    True if the string contains only valid characters, false if it contains invalid characters

Static_reset

StaticgetRnObject

  • getRnObject(objectUid): undefined | RnObject

  • Retrieves an RnObject instance by its unique identifier

    Parameters

    • objectUid: number

      The unique identifier of the object to retrieve

    Returns undefined | RnObject

    The RnObject instance or undefined if not found or garbage collected

StaticgetRnObjectByName

  • getRnObjectByName(uniqueName): undefined | RnObject

  • Retrieves an RnObject instance by its unique name

    Parameters

    • uniqueName: string

      The unique name of the object to retrieve

    Returns undefined | RnObject

    The RnObject instance or undefined if not found or garbage collected

StaticsearchByTag

  • searchByTag(tag, value): undefined | WeakRef<RnObject>

  • Searches for the first object that has a specific tag with the given value

    Parameters

    • tag: string

      The tag name to search for

    • value: string

      The tag value to match

    Returns undefined | WeakRef<RnObject>

    WeakRef to the first matching object, or undefined if not found

Settings

Member Visibility

On This Page

Constructors
Properties
Accessors
Methods