Class ApplyXRHandRig

A behavior that applies the hand tracked bone structure to a rigged mesh.

Zicon

back_hand

Zparents

three/Object3D/GLTF

Hierarchy

  • Behavior<GLTF>
    • ApplyXRHandRig

Accessors

disposed

Constructors

constructor

Methods

dispose getZComponentInstance register unregister

Properties - Behavior

enabled

Properties - Other

blenderFix contextManager enabledResolved hand influence instance onDispose

Accessors

disposed

  • get disposed(): boolean

  • Gets the disposed status of the entity.

    Returns boolean

    The disposed status.

Constructors

constructor

  • new ApplyXRHandRig(contextManager, instance, constructorProps): ApplyXRHandRig

  • Constructs a new MorphTarget Behavior.

    Parameters

    • contextManager: ContextManager

      The context manager.

    • instance: GLTF

      The GLTF instance.

    • constructorProps: ApplyXRHandRigConstructorProps

      The properties required to construct the MorphTarget Behavior.

    Returns ApplyXRHandRig

Methods

dispose

  • dispose(): never

  • Returns never

getZComponentInstance

  • getZComponentInstance<T>(type?): T

  • Get the instance of the ZComponent that constructed this entity.

    If you pass the class of a ZComponent as the type parameter, this function will ensure that it returns an instance of that ZComponent. If this component or behavior was constructed by a different ZComponent class, or by a different entity altogether, the function with throw an error.

    Type Parameters

    • T extends ZComponent<any, T> = ZComponent<any>

    Parameters

    • Optionaltype: ConstructorForComponent<T>

      The ZComponent class that you are expecting to receive

    Returns T

    The instance of the ZComponent that constructed this component or behavior

register

  • register<Args>(evt, fn, priority?): any

  • Register a function to be called when an Event is fired, or an Observable's value changes. The function will only be bound to the underlying Event or Observable while this entity is enabled.

    Using this function, rather than attaching your handler directly to the Event or Observable, ensures your handler is automatically released when this entity is disposed.

    Type Parameters

    • Args extends any[]

    Parameters

    • evt: Event<Args>

      The Event or Observable to listen to

    • fn: ((...args: Args) => void)

      A function that will be called when the event fires, or the Observable value changes

        • (...args): void

        • Parameters

          Returns void

    • Optionalpriority: number

    Returns any

  • register<Args>(evt, fn, options?): any

  • Type Parameters

    • Args extends any[]

    Parameters

    Returns any

  • register<Type>(observable, fn, priority?): any

  • Type Parameters

    • Type

    Parameters

    • observable: Observable<Type, never>
    • fn: ((v: Type) => void)
        • (v): void

        • Parameters

          Returns void

    • Optionalpriority: number

    Returns any

  • register<Type>(observable, fn, options?): any

  • Type Parameters

    • Type

    Parameters

    Returns any

unregister

  • unregister<Args>(evt, fn): any

  • Unregisters a function that was previously registered to an Event or Observable.

    Type Parameters

    • Args extends any[]

    Parameters

    • evt: Event<Args>

      The Event or Observable

    • fn: ((...args: Args) => void)

      The function that was passed in the call to register

        • (...args): void

        • Parameters

          Returns void

    Returns any

  • unregister<Type>(observable, fn): any

  • Type Parameters

    • Type

    Parameters

    • observable: Observable<Type, never>
    • fn: ((v: Type) => void)
        • (v): void

        • Parameters

          Returns void

    Returns any

Properties - Behavior

Readonlyenabled

enabled: Observable<boolean, never>

If false, this entity and its children will no longer participate in the experience.

Note - to read this value, you may wish to use enabledResolved which will be false if this entity, or any of its parents, have enabled set to false.

The precise implications of enabled being false will vary between entities, but in general disabled entities:

  • should not emit any events,
  • should not take any action, e.g. navigate the user to a different page,
  • should not perform any network communication,
  • should not make changes to other behaviors or components in the experience,
  • should minimise any runtime performance cost (e.g. detach from any frame handlers).

Zprop

Zdefault

true

Zgrouppriority

10

Properties - Other

blenderFix

blenderFix: Observable<boolean, never> = ...

Blender represents bones at 90 degree offset to GLTF. Set this to true to automatically apply a 90 degree rotation to address this, simplifying export from Blender.

Zprop

Zdefault

false

ReadonlycontextManager

contextManager: ContextManager

ReadonlyenabledResolved

enabledResolved: Observable<boolean, never>

This will have value false if this entity, or any of its parents, have enabled set to false.

To change the enabled status of this entity, use the enabled property instead.

The precise implications of enabled being false will vary between entities, but in general disabled entities:

  • should not emit any events,
  • should not take any action, e.g. navigate the user to a different page,
  • should not perform any network communication,
  • should not make changes to other behaviors or components in the experience,
  • should minimise any runtime performance cost.

Disabled entities will typically remain visible (if they have a visible appearance).

hand

hand: Observable<"left" | "right", never> = ...

Which hand to apply the map to the model.

Zprop

Zdefault

right

influence

influence: Observable<number, never> = ...

Zprop

Ztype

proportion

Zdefault

1

Readonlyinstance

instance: GLTF

ReadonlyonDispose

onDispose: Event<[]>

An event that is fired as the last act of this entity being destroyed.

Settings

Member Visibility

On This Page

disposedconstructordisposegetZComponentInstanceregisterunregisterenabledblenderFixcontextManagerenabledResolvedhandinfluenceinstanceonDispose