Matrix Class

Definition

Namespace:

System.Drawing.Drawing2D

Assembly:

System.Drawing.Common.dll

Encapsulates a 3-by-3 affine matrix that represents a geometric transform. This class cannot be inherited.

public ref class Matrix sealed : MarshalByRefObject, IDisposable

public sealed class Matrix : MarshalByRefObject, IDisposable

type Matrix = class
    inherit MarshalByRefObject
    interface IDisposable

Public NotInheritable Class Matrix
Inherits MarshalByRefObject
Implements IDisposable

Inheritance

Object

MarshalByRefObject

Matrix

Implements

IDisposable

Remarks

For more information about this API, see Supplemental API remarks for Matrix.

Constructors

Matrix()	Initializes a new instance of the Matrix class as the identity matrix.
Matrix(Matrix3x2)	Constructs a Matrix utilizing the specified matrix.
Matrix(Rectangle, Point[])	Initializes a new instance of the Matrix class to the geometric transform defined by the specified rectangle and array of points.
Matrix(RectangleF, PointF[])	Initializes a new instance of the Matrix class to the geometric transform defined by the specified rectangle and array of points.
Matrix(Single, Single, Single, Single, Single, Single)	Initializes a new instance of the Matrix class with the specified elements.

Properties

Elements	Gets an array of floating-point values that represents the elements of this Matrix.
IsIdentity	Gets a value indicating whether this Matrix is the identity matrix.
IsInvertible	Gets a value indicating whether this Matrix is invertible.
MatrixElements	Gets or sets the elements for the matrix.
OffsetX	Gets the x translation value (the dx value, or the element in the third row and first column) of this Matrix.
OffsetY	Gets the y translation value (the dy value, or the element in the third row and second column) of this Matrix.

Methods

Clone()	Creates an exact copy of this Matrix.
CreateObjRef(Type)	Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object. (Inherited from MarshalByRefObject)
Dispose()	Releases all resources used by this Matrix.
Equals(Object)	Tests whether the specified object is a Matrix and is identical to this Matrix.
Finalize()	Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.
GetHashCode()	Returns a hash code.
GetLifetimeService()	Retrieves the current lifetime service object that controls the lifetime policy for this instance. (Inherited from MarshalByRefObject)
GetType()	Gets the Type of the current instance. (Inherited from Object)
InitializeLifetimeService()	Obtains a lifetime service object to control the lifetime policy for this instance. (Inherited from MarshalByRefObject)
Invert()	Inverts this Matrix, if it is invertible.
MemberwiseClone()	Creates a shallow copy of the current Object. (Inherited from Object)
MemberwiseClone(Boolean)	Creates a shallow copy of the current MarshalByRefObject object. (Inherited from MarshalByRefObject)
Multiply(Matrix, MatrixOrder)	Multiplies this Matrix by the matrix specified in the matrix parameter, and in the order specified in the order parameter.
Multiply(Matrix)	Multiplies this Matrix by the matrix specified in the matrix parameter, by prepending the specified Matrix.
Reset()	Resets this Matrix to have the elements of the identity matrix.
Rotate(Single, MatrixOrder)	Applies a clockwise rotation of an amount specified in the angle parameter, around the origin (zero x and y coordinates) for this Matrix.
Rotate(Single)	Prepend to this Matrix a clockwise rotation, around the origin and by the specified angle.
RotateAt(Single, PointF, MatrixOrder)	Applies a clockwise rotation about the specified point to this Matrix in the specified order.
RotateAt(Single, PointF)	Applies a clockwise rotation to this Matrix around the point specified in the point parameter, and by prepending the rotation.
Scale(Single, Single, MatrixOrder)	Applies the specified scale vector (scaleX and scaleY) to this Matrix using the specified order.
Scale(Single, Single)	Applies the specified scale vector to this Matrix by prepending the scale vector.
Shear(Single, Single, MatrixOrder)	Applies the specified shear vector to this Matrix in the specified order.
Shear(Single, Single)	Applies the specified shear vector to this Matrix by prepending the shear transformation.
ToString()	Returns a string that represents the current object. (Inherited from Object)
TransformPoints(Point[])	Applies the geometric transform represented by this Matrix to a specified array of points.
TransformPoints(PointF[])	Applies the geometric transform represented by this Matrix to a specified array of points.
TransformVectors(Point[])	Applies only the scale and rotate components of this Matrix to the specified array of points.
TransformVectors(PointF[])	Multiplies each vector in an array by the matrix. The translation elements of this matrix (third row) are ignored.
Translate(Single, Single, MatrixOrder)	Applies the specified translation vector to this Matrix in the specified order.
Translate(Single, Single)	Applies the specified translation vector (offsetX and offsetY) to this Matrix by prepending the translation vector.
VectorTransformPoints(Point[])	Multiplies each vector in an array by the matrix. The translation elements of this matrix (third row) are ignored.

See also

• Coordinate Systems and Transformations