Matrix class

Matrix class

Replaces the GDI+ Matrix.

The Matrix type exposes the following members:

Constructors

ConstructorDescription
initInitializes a new instance of the Matrix class as the identity matrix.
initInitializes a new instance of the Matrix class.
initInitializes a new instance of the Matrix class to the geometric transform defined by the specified rectangle and array of points.
initInitializes a new instance of the Matrix class to the geometric transform defined by the specified rectangle and array of points.

Properties

PropertyDescription
elementsGets an array of floating-point values that represents the elements of this Matrix.
m11Gets the matrix element at first row first column. Represents scale along X axis.
m12Gets the matrix element at first row second column. Represents shear along Y axis.
m21Gets the matrix element at second row first column. Represents shear along X axis.
m22Gets the matrix element at second row second column. Represents scale along Y axis.
m31Gets the matrix element at third row first column. Represents translation along X axis.
m32Gets the matrix element at third row first column. Represents translation along Y axis.
TYPE_IDENTITYAn identity transform is one in which the output coordinates are
always the same as the input coordinates.
If this transform is anything other than the identity transform,
the type will either be the constant GENERAL_TRANSFORM or a
combination of the appropriate flag bits for the various coordinate
conversions that this transform performs.
TYPE_TRANSLATIONA translation moves the coordinates by a constant amount in x
and y without changing the length or angle of vectors.
TYPE_UNIFORM_SCALEA uniform scale multiplies the length of vectors by the same amount
in both the x and y directions without changing the angle between
vectors.
This flag bit is mutually exclusive with the TypeGeneralScale flag.
TYPE_GENERAL_SCALEA general scale multiplies the length of vectors by different
amounts in the x and y directions without changing the angle
between perpendicular vectors.
This flag bit is mutually exclusive with the TypeUniformScale flag.
TYPE_MASK_SCALEThis constant is a bit mask for any of the scale flag bits.
TYPE_FLIPThis flag bit indicates that the transform defined by this object
performs a mirror image flip about some axis which changes the
normally right handed coordinate system into a left handed
system in addition to the conversions indicated by other flag bits.
A right handed coordinate system is one where the positive X
axis rotates counterclockwise to overlay the positive Y axis
similar to the direction that the fingers on your right hand
curl when you stare end on at your thumb.
A left handed coordinate system is one where the positive X
axis rotates clockwise to overlay the positive Y axis similar
to the direction that the fingers on your left hand curl.
There is no mathematical way to determine the angle of the
original flipping or mirroring transformation since all angles
of flip are identical given an appropriate adjusting rotation.
NOTE: TypeFlip was added after GENERAL_TRANSFORM was in public
circulation and the flag bits could no longer be conveniently
renumbered without introducing binary incompatibility in outside
code.
TYPE_QUADRANT_ROTATIONThis flag bit indicates that the transform defined by this object
performs a quadrant rotation by some multiple of 90 degrees in
addition to the conversions indicated by other flag bits.
A rotation changes the angles of vectors by the same amount
regardless of the original direction of the vector and without
changing the length of the vector.
This flag bit is mutually exclusive with the TypeGeneralRotation flag.
TYPE_GENERAL_ROTATIONThis flag bit indicates that the transform defined by this object
performs a rotation by an arbitrary angle in addition to the
conversions indicated by other flag bits.
A rotation changes the angles of vectors by the same amount
regardless of the original direction of the vector and without
changing the length of the vector.
This flag bit is mutually exclusive with the
TYPE_MASK_ROTATIONThis constant is a bit mask for any of the rotation flag bits.
TYPE_GENERAL_TRANSFORMThis constant indicates that the transform defined by this object
performs an arbitrary conversion of the input coordinates.
If this transform can be classified by any of the above constants,
the type will either be the constant TypeIdentity or a
combination of the appropriate flag bits for the various coordinate
conversions that this transform performs.

Methods

MethodDescription
scaleApplies the specified scale vector (scaleX and scaleY) to this Matrix using the specified order.
scaleApplies the specified scale vector (scaleX and scaleY) to this Matrix using (default) Prepend order.
translateApplies the specified translation vector to this Matrix in the specified order.
translateApplies the specified translation vector to this Matrix using (default) Prepend order.
multiplyMultiplies this Matrix by the matrix specified in the matrix parameter, and in the order specified in the order parameter.
multiplyMultiplies this Matrix by the matrix specified in the matrix parameter using (default) Prepend order.
rotateApplies a clockwise rotation of an amount specified in the angle parameter, around the origin (zero x and y coordinates) for this Matrix in the specified order.
rotateApplies a clockwise rotation of an amount specified in the angle parameter, around the origin (zero x and y coordinates) for this Matrix in the default (Prepend) order.
rotate_atApplies a clockwise rotation about the specified point to this Matrix in the specified order.
rotate_atApplies a clockwise rotation about the specified point to this Matrix in the default (Prepend) order.
get_elementsGets the copy of matrix elements.
transform_pointsApplies the geometric transform represented by this Matrix to a specified array of points.
resetResets this Matrix to have the elements of the identity matrix.
equalsDetermines whether two matrixes are equal.

Remarks

Most algorithms taken from Sun’s AffineTransform.java. Java’s names for matrix elements used internally. Map of java names to .net ones to description: m00 M11 Scale X m10 M12 Shear Y m01 M21 Shear X m11 M22 Scale Y m02 M31 Translate X m12 M32 Translate Y

See Also