AGSTransformationMatrix Class Reference

Description

A class for holding a translation and quaternion array. This is used for camera movement while preventing gimbal lock.

Since

100.6

Inheritance diagram for AGSTransformationMatrix:

Instance Methods
(AGSTransformationMatrix *)	- addTransformation:
(AGSTransformationMatrix *)	- subtractTransformation:

Class Methods
(AGSTransformationMatrix *)	+ transformationMatrixWithQuaternionX:quaternionY:quaternionZ:quaternionW:translationX:translationY:translationZ:

Properties
AGSTransformationMatrix *	identityMatrix
double	quaternionW
double	quaternionX
double	quaternionY
double	quaternionZ
double	translationX
double	translationY
double	translationZ

Method Documentation

addTransformation:

- (AGSTransformationMatrix *) addTransformation:

(AGSTransformationMatrix *)

transformation

Adds this AGSTransformationMatrix object and the transformation parameter together and returns the result.

Parameters

transformation

The AGSTransformationMatrix to be added onto this AGSTransformationMatrix.

Returns

A new AGSTransformationMatrix object which is the result of adding two AGSTransformationMatrix objects.

Since

100.6

subtractTransformation:

- (AGSTransformationMatrix *) subtractTransformation:

(AGSTransformationMatrix *)

transformation

Subtracts the parameter from this AGSTransformationMatrix object and returns the result.

Parameters

transformation

The AGSTransformationMatrix to be subtracted from this AGSTransformationMatrix object.

Returns

A new AGSTransformationMatrix object which is the result of subtracting two AGSTransformationMatrix objects.

Since

100.6

transformationMatrixWithQuaternionX:quaternionY:quaternionZ:quaternionW:translationX:translationY:translationZ:

+ (AGSTransformationMatrix*) transformationMatrixWithQuaternionX:		(double)	quaternionX
quaternionY:		(double)	quaternionY
quaternionZ:		(double)	quaternionZ
quaternionW:		(double)	quaternionW
translationX:		(double)	translationX
translationY:		(double)	translationY
translationZ:		(double)	translationZ

Create an AGSTransformationMatrix object using x, y, z, w quaternion and x, y, z translations.

Parameters

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.

Since

100.6

Property Documentation

identityMatrix

- (AGSTransformationMatrix*) identityMatrix

readatomicstrong

Creates an AGSTransformationMatrix object with an identity transform. Subtracting an AGSTransformationMatrix from an identity matrix is useful for getting the inverse of that transformation matrix, i.e. identity matrix - other matrix = inverse(other matrix).

Returns

An AGSTransformationMatrix.

Since

100.6

quaternionW

- (double) quaternionW

readnonatomicassign

The w quaternion of the transformation matrix.

Since

100.6

quaternionX

- (double) quaternionX

readnonatomicassign

The x quaternion of the transformation matrix.

Since

100.6

quaternionY

- (double) quaternionY

readnonatomicassign

The y quaternion of the transformation matrix.

Since

100.6

quaternionZ

- (double) quaternionZ

readnonatomicassign

The z quaternion of the transformation matrix.

Since

100.6

translationX

- (double) translationX

readnonatomicassign

The x translation of the transformation matrix.

Since

100.6

translationY

- (double) translationY

readnonatomicassign

The y translation of the transformation matrix.

Since

100.6

translationZ

- (double) translationZ

readnonatomicassign

The z translation of the transformation matrix.

Since

100.6