Matrix Class

classMatrix : SystemIDisposable

Namespace:Datalogics::PDFL

Inherits from:: SystemIDisposable

Detailed Description

A transformation matrix in a PDF file is specified by six numbers.

The matrix is usually in the form of an array containing the six elements [a b c d h v].

A translation is specified as [ 1 0 0 1 tx ty], where tx and ty are the distance to translate from the origin of the coordinate system in the horizontal and vertical dimension, respectively.

A scaling is obtained by [sx 0 0 sy 0 0]. This scales the coordinates so that 1 unit in the horizontal and vertical dimension of the new coordinate system is the same size as sx and sy units, respectively, as in the previous coordinate system.

A rotation is produced by [ cos T sin T -sin T cos T 0 0 ], which has the effect of rotating the coordinate system axes by an angle T (degrees) counterclockwise.

This material indicates that the matrix specifying a transformation is premultiplied with the current transformation matrix, i.e.,

M' = Mt * M

The implementation of the Scale, Rotate, and Translate convenience functions of Matrix reflect the same order of operations, so that they are consistent with the PDF Reference manual. They are also consistent with the scale, rotate, and translate operators in PostScript, from which the coordinate system model in PDF is derived.

Referenced by

Container Content DrawParams Element Form Group Image Matrix Page Path Point PostScript Quad Rect Shading Text TextRun

Uses types

Matrix

Constructor & Destructor Documentation

Matrix(Matrixrhs, InternalConstructsignifier)

Parameters

rhs: Matrix
signifier: InternalConstruct

Matrix()

the default constructor creates a transformation matrix to translate the rectangle 1 element (1/72nd of an inch) from the origin.

Matrix(doublena, doublenb, doublenc, doublend, doublenh, doublenv)

Parameters

na: double
nb: double
nc: double
nd: double
nh: double
nv: double

~Matrix()

Property Documentation

doubleA[get, set]

doubleB[get, set]

doubleC[get, set]

doubleD[get, set]

doubleH[get, set]

doubleV[get, set]

Member Function Documentation

MatrixConcat(MatrixMt)

Parameters

Mt: Matrix

Returns:

the transformed matrix

Concatenate a matrix onto an existing matrix.

The product returned is:

M' = Mt * M

This corresponds to the action of the cm operator.

static MatrixConstructorRetrieve(System.IntPtrignored)

Parameters

ignored: System.IntPtr

Returns:

Matrix

voidDispose()

Returns:

void

voidDisposeChildren()

Returns:

void

override boolEquals(objectobj)

Parameters

obj: object

Returns:

override bool

MatrixInvert()

Returns:

Matrix

Invert the Matrix object and return a new Matrix object.

static MatrixMultiply(Matrixm1, Matrixm2)

Parameters

m1: Matrix: a matrix
m2: Matrix: a matrix

Returns:

the matrix product m1 x m2

Multiply two transformation matrices.

MatrixRotate(doubleT)

Parameters

T: double: The rotation, counterclockwise

Returns:

the result [cos T sin T -sin T 0 0] * M

Rotate a matrix by T degrees counterclockwise units.

Rotation is done by creating the matrix [ cos T sin T -sin T cos T 0 0 ], and calling the Concat function with that matrix.

boolSameTypeEquals(Matrixrhs)

Parameters

rhs: Matrix

Returns:

bool

MatrixScale(doublesx, doublesy)

Parameters

sx: double: X scaling factor
sy: double: Y scaling factor

Returns:

the result [sx 0 0 sy 0 0] * M

Scale a matrix by (sx,sy) units.

Scaling is done by creating the matrix [sx 0 0 sy 0 0], and calling the Concat function with that matrix.

override stringToString()

Returns:

override string

MatrixTranslate(doubletx, doublety)

Parameters

tx: double: X translation distance
ty: double: Y translation distance

Returns:

the result [1 0 0 1 tx ty] * M

Translate a matrix by (tx,ty) units.

Translation is done by creating the matrix [ 1 0 0 1 tx ty ], and calling the Concat function with that matrix.