GamepadPose: orientation property

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The orientation read-only property of the GamepadPose interface returns the orientation of the Gamepad, as a quarternion value.

The value is a Float32Array, made up of the following values:

  • pitch — rotation around the X axis.
  • yaw — rotation around the Y axis.
  • roll — rotation around the Z axis.
  • w — the fourth dimension (usually 1).

The orientation yaw (rotation around the y axis) is relative to the initial yaw of the sensor when it was first read.

Value

A Float32Array, or null if the VR sensor is not able to provide orientation data.

Examples

TBD

Note: An orientation of { x: 0, y: 0, z: 0, w: 1 } is considered to be "forward".

Specifications

Specification
Gamepad Extensions
# dom-gamepadpose-orientation

Browser compatibility

BCD tables only load in the browser

See also