Chapter 629: XRControllerModel

Core Idea

Represents a XR controller model.

Key Concepts

• envMap : Texture: The controller's environment map.
• motionController : MotionController: The motion controller.

Reference Tables

Constructor

Signature
new XRControllerModel()

Properties

Property	Description
.envMap : Texture	The controller's environment map.
.motionController : MotionController	The motion controller.

Methods

Method	Description
.setEnvironmentMap( envMap : Texture ) : XRControllerModel	Sets an environment map that is applied to the controller model.
.updateMatrixWorld( force : boolean )	Overwritten with a custom implementation. Polls data from the XRInputSource and updates the model's components to match the real world data.

Key Takeaways

1. XRControllerModel extends: EventDispatcher → Object3D
2. Most relevant properties: envMap, motionController.
3. Key methods: setEnvironmentMap, updateMatrixWorld.

Connects To

• EventDispatcher: parent class
• Object3D: parent class
• Source: examples/jsm/webxr/XRControllerModelFactory.js