Chapter 634: XRHandPrimitiveModel

Core Idea

Represents one of the hand model types XRHandModelFactory might produce depending on the selected profile. XRHandPrimitiveModel represents a hand with sphere or box primitives according to the selected primitive option.

Key Concepts

• controller : Group: The WebXR controller.
• envMap : Texture: The model's environment map.
• handModel : XRHandModel: The hand model.

Code Examples

import { XRHandPrimitiveModel } from 'three/addons/webxr/XRHandPrimitiveModel.js';

• What it demonstrates: Typical usage of XRHandPrimitiveModel.

Reference Tables

Constructor

Signature
new XRHandPrimitiveModel( handModel : XRHandModel, controller : Group, path : string, handedness : XRHandedness, options : XRHandPrimitiveModel~Options )

Properties

Property	Description
.controller : Group	The WebXR controller.
.envMap : Texture	The model's environment map.
.handModel : XRHandModel	The hand model.

Methods

Method	Description
.updateMesh()	Updates the mesh based on the tracked XR joints data.

Key Takeaways

1. Most relevant properties: controller, envMap, handModel.
2. Key methods: updateMesh.

Connects To

• Source: examples/jsm/webxr/XRHandPrimitiveModel.js