Back to Content

GamepadPose: position property

files/en-us/web/api/gamepadpose/position/index.md

latest921 B
Original Source

{{APIRef("WebVR API")}}{{SeeCompatTable}}

The position read-only property of the {{domxref("GamepadPose")}} interface returns the position of the {{domxref("Gamepad")}} as a 3D vector.

The coordinate system is as follows:

  • Positive X is to the user's right.
  • Positive Y is up.
  • Positive Z is behind the user.

Positions are measured in meters from an origin point — this point is the position the sensor was first read at.

Value

A {{jsxref("Float32Array")}}, or null if the gamepad is not able to provide position data.

[!NOTE] User agents may provide emulated position values through certain techniques; when doing so they should still report {{domxref("GamepadPose.hasPosition")}} as false.

Examples

TBD

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also