Module com.esri.arcgisruntime
Class TransformationMatrix
java.lang.Object
com.esri.arcgisruntime.mapping.view.TransformationMatrix
Represents a more precise way to represent
Camera
properties than using just heading, pitch and roll.
The quaternion is used to describe the camera angles and the translation vector is used to describe the camera position.- Since:
- 100.6.0
-
Method Summary
Modifier and TypeMethodDescriptionaddTransformation
(TransformationMatrix transformation) Creates a TransformationMatrix that is the sum of this instance and the provided one.static TransformationMatrix
Creates a TransformationMatrix object with an identity transform.static TransformationMatrix
createWithQuaternionAndTranslation
(double quaternionX, double quaternionY, double quaternionZ, double quaternionW, double translationX, double translationY, double translationZ) Creates a TransformationMatrix with the given arguments.double
Gets the quaternion W value.double
Gets the quaternion x value.double
Gets the quaternion y value.double
Gets the quaternion z value.double
Gets the translation x value.double
Gets the translation y value.double
Gets the translation z value.subtractTransformation
(TransformationMatrix transformation) Creates a TransformationMatrix that equals the provided transformation subtracted from this instance.
-
Method Details
-
createIdentityMatrix
Creates a TransformationMatrix object with an identity transform. Subtracting another TransformationMatrix from an identity matrix is useful for getting the inverse of that TransformationMatrix, i.e., identity matrix - other matrix = inverse(other matrix)- Returns:
- an identity TransformationMatrix
- Since:
- 100.6.0
-
createWithQuaternionAndTranslation
public static TransformationMatrix createWithQuaternionAndTranslation(double quaternionX, double quaternionY, double quaternionZ, double quaternionW, double translationX, double translationY, double translationZ) Creates a TransformationMatrix with the given arguments.- Parameters:
quaternionX
- the X quaternionquaternionY
- the Y quaternionquaternionZ
- the Z quaternionquaternionW
- the W quaterniontranslationX
- the X translationtranslationY
- the Y translationtranslationZ
- the Z translation- Returns:
- a TransformationMatrix with the given arguments
- Since:
- 100.6.0
-
getQuaternionX
public double getQuaternionX()Gets the quaternion x value.- Returns:
- the quaternion x value
- Since:
- 100.6.0
-
getQuaternionY
public double getQuaternionY()Gets the quaternion y value.- Returns:
- the quaternion y value
- Since:
- 100.6.0
-
getQuaternionZ
public double getQuaternionZ()Gets the quaternion z value.- Returns:
- the quaternion z value
- Since:
- 100.6.0
-
getQuaternionW
public double getQuaternionW()Gets the quaternion W value.- Returns:
- the quaternion W value
- Since:
- 100.6.0
-
getTranslationX
public double getTranslationX()Gets the translation x value.- Returns:
- the translation x value
- Since:
- 100.6.0
-
getTranslationY
public double getTranslationY()Gets the translation y value.- Returns:
- the translation y value
- Since:
- 100.6.0
-
getTranslationZ
public double getTranslationZ()Gets the translation z value.- Returns:
- the translation z value
- Since:
- 100.6.0
-
addTransformation
Creates a TransformationMatrix that is the sum of this instance and the provided one.- Parameters:
transformation
- the TransformationMatrix to sum with- Returns:
- a new TransformationMatrix that represents the calculated TransformationMatrix
- Throws:
IllegalArgumentException
- if transformation is null- Since:
- 100.6.0
-
subtractTransformation
Creates a TransformationMatrix that equals the provided transformation subtracted from this instance.- Parameters:
transformation
- the TransformationMatrix to subtract from this instance- Returns:
- a new TransformationMatrix that represents the calculated TransformationMatrix
- Throws:
IllegalArgumentException
- if transformation is null- Since:
- 100.6.0
-