Skip To Content ArcGIS for Developers Sign In Dashboard

TransformationMatrix QML Type

A transformation matrix consisting of a translation vector and a rotation quaternion. More...

Import Statement: import Esri.ArcGISRuntime 100.9
Since: Esri.ArcGISRuntime 100.6
Inherits:

Object

Properties

Signals

Methods

Detailed Description

After it is instantiated, the TransformationMatrix object is immutable.

The default transformation matrix is constucted using the values (0, 0, 0, 1) for x, y, z, w quaternion and (0, 0, 0) for x, y, z translations.

Property Documentation

quaternionW : double

The w quaternion of the transformation matrix.

You cannot change this property after the object is instantiated.


quaternionX : double

The x quaternion of the transformation matrix.

You cannot change this property after the object is instantiated.


quaternionY : double

The y quaternion of the transformation matrix.

You cannot change this property after the object is instantiated.


quaternionZ : double

The z quaternion of the transformation matrix.

You cannot change this property after the object is instantiated.


translationX : double

The x position of the transformation matrix.

You cannot change this property after the object is instantiated.


translationY : double

The y position of the transformation matrix.

You cannot change this property after the object is instantiated.


translationZ : double

The z position of the transformation matrix.

You cannot change this property after the object is instantiated.


Signal Documentation

quaternionWChanged()

Emitted when the quaternionW for the transformation matrix changes.

Note: The corresponding handler is onQuaternionWChanged.


quaternionXChanged()

Emitted when the quaternionX for the transformation matrix changes.

Note: The corresponding handler is onQuaternionXChanged.


quaternionYChanged()

Emitted when the quaternionY for the transformation matrix changes.

Note: The corresponding handler is onQuaternionYChanged.


quaternionZChanged()

Emitted when the quaternionZ for the transformation matrix changes.

Note: The corresponding handler is onQuaternionZChanged.


translationXChanged()

Emitted when the translationX for the transformation matrix changes.

Note: The corresponding handler is onTranslationXChanged.


translationYChanged()

Emitted when the translationY for the transformation matrix changes.

Note: The corresponding handler is onTranslationYChanged.


translationZChanged()

Emitted when the translationZ for the transformation matrix changes.

Note: The corresponding handler is onTranslationZChanged.


Method Documentation

TransformationMatrix addTransformation(transformation)

Adds another transformation matrix to this transformation matrix and returns the result.


TransformationMatrix createIdentityMatrix()

Creates a TransformationMatrix object with an identity transform.

This TransformationMatrix will have no transformation. The values are (0, 0, 0, 1) for x, y, z, w quaternion and (0, 0, 0) for x, y, z translations.

Subtracting a TransformationMatrix from an identity matrix is useful for getting the inverse of that transformation matrix, i.e. identity matrix - other matrix = inverse(other matrix) return_description: A TransformationMatrix.

This method can only be accessed via the Factory object now since the 100.9 release.

//TransformationMatrix.createIdentityMatrix(); // old code
Factory.TransformationMatrix.createIdentityMatrix(); // replacement code

TransformationMatrix createWithQuaternionAndTranslation(quaternionX, double quaternionY, double quaternionZ, double quaternionW, double translationX, double translationY, double translationZ)

Constructs a transformation matrix using x, y, z, w quaternion and x, y, z translations.

  • quaternionX - The x quaternion of the transformation matrix.
  • quaternionY - The y quaternion of the transformation matrix.
  • quaternionZ - The z quaternion of the transformation matrix.
  • quaternionW - The w quaternion of the transformation matrix.
  • translationX - The x position of the transformation matrix.
  • translationY - The y position of the transformation matrix.
  • translationZ - The z position of the transformation matrix.

This method can only be accessed via the Factory object now since the 100.9 release.

//TransformationMatrix.createWithQuaternionAndTranslation(...); // old code
Factory.TransformationMatrix.createWithQuaternionAndTranslation(...); // replacement code

TransformationMatrix subtractTransformation(transformation)

Subtracts another transformation matrix from this transformation matrix and returns the result.



Feedback on this topic?