OrientationSensor: populateMatrix() method

Limited availability

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

Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.

The populateMatrix() method of the OrientationSensor interface populates the given target matrix with the rotation matrix based on the latest sensor reading. The rotation matrix is shown below.

The formulas used to convert the sensor's quaternion to the provided matrix.

where:

  • W = cos(θ/2)
  • X = Vx * sin(θ/2)
  • Y = Vy * sin(θ/2)
  • Z = Vz * sin(θ/2)

Syntax

js
populateMatrix(targetMatrix)

Because OrientationSensor is a base class, populateMatrix may only be read from one of its derived classes.

Parameters

targetMatrix

TBD

Return value

None (undefined).

Examples

js
// TBD

Specifications

Specification
Orientation Sensor
# orientationsensor-populatematrix

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Opera Safari Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet WebView Android
populateMatrix 67 79 No 54 No 67 No 48 No 9.0 67

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/OrientationSensor/populateMatrix