Memory-managed wrapper type.

Construct a Matrix struct initialized to zero.

Changes the transformation represented by matrix to be the transformation given by first applying transformation given by newMatrix then applying the original transformation.

Since: 1.6

Copies a Matrix.

Since: 1.6

Free a Matrix created with matrixCopy.

Since: 1.6

Returns the scale factor of a matrix on the height of the font. That is, the scale factor in the direction perpendicular to the vector that the X coordinate is mapped to. If the scale in the X coordinate is needed as well, use matrixGetFontScaleFactors.

Since: 1.12

Calculates the scale factor of a matrix on the width and height of the font. That is, xscale is the scale factor in the direction of the X coordinate, and yscale is the scale factor in the direction perpendicular to the vector that the X coordinate is mapped to.

Note that output numbers will always be non-negative.

Since: 1.38

Changes the transformation represented by matrix to be the transformation given by first rotating by degrees degrees counter-clockwise then applying the original transformation.

Since: 1.6

Changes the transformation represented by matrix to be the transformation given by first scaling by sx in the X direction and sy in the Y direction then applying the original transformation.

Since: 1.6

Transforms the distance vector (dx,dy) by matrix. This is similar to matrixTransformPoint except that the translation components of the transformation are ignored. The calculation of the returned vector is as follows:

<programlisting> dx2 = dx1 * xx + dy1 * xy; dy2 = dx1 * yx + dy1 * yy; </programlisting>

Affine transformations are position invariant, so the same vector always transforms to the same vector. If (x1,y1) transforms to (x2,y2) then (x1+dx1,y1+dy1) will transform to (x1+dx2,y1+dy2) for all values of x1 and x2.

Since: 1.16

First transforms the rect using matrix, then calculates the bounding box of the transformed rectangle. The rectangle should be in device units (pixels).

This function is useful for example when you want to draw a rotated pangoLayout to an image buffer, and want to know how large the image should be and how much you should shift the layout when rendering.

For better accuracy, you should use matrixTransformRectangle on original rectangle in Pango units and convert to pixels afterward using extentsToPixels's first argument.

Since: 1.16

Transforms the point (x, y) by matrix.

Since: 1.16

Changes the transformation represented by matrix to be the transformation given by first translating by (tx, ty) then applying the original transformation.

Since: 1.6

Get the value of the “x0” field. When overloading is enabled, this is equivalent to

get matrix #x0

Set the value of the “x0” field. When overloading is enabled, this is equivalent to

set matrix [ #x0 := value ]

Get the value of the “xx” field. When overloading is enabled, this is equivalent to

get matrix #xx

Set the value of the “xx” field. When overloading is enabled, this is equivalent to

set matrix [ #xx := value ]

Get the value of the “xy” field. When overloading is enabled, this is equivalent to

get matrix #xy

Set the value of the “xy” field. When overloading is enabled, this is equivalent to

set matrix [ #xy := value ]

Get the value of the “y0” field. When overloading is enabled, this is equivalent to

get matrix #y0

Set the value of the “y0” field. When overloading is enabled, this is equivalent to

set matrix [ #y0 := value ]

Get the value of the “yx” field. When overloading is enabled, this is equivalent to

get matrix #yx

Set the value of the “yx” field. When overloading is enabled, this is equivalent to

set matrix [ #yx := value ]

Get the value of the “yy” field. When overloading is enabled, this is equivalent to

get matrix #yy

Set the value of the “yy” field. When overloading is enabled, this is equivalent to

set matrix [ #yy := value ]