Matrix

Wrapper for cairo's cairo_matrix_t. A cairo_matrix_t holds an affine transformation, such as a scale, rotation, shear, or a combination of those. The transformation of a point (x, y) is given by:

x_new = xx * x + xy * y + x0;
y_new = yx * x + yy * y + y0;

struct Matrix {

cairo_matrix_t nativeMatrix;

this(double xx, double yx, double xy, double yy, double x0, double y0);

void initIdentity();

void initTranslate(double tx, double ty);

void initScale(double sx, double sy);

void initScale(Point!double point);

void initRotate(double radians);

void translate(double tx, double ty);

void scale(double sx, double sy);

void scale(Point!double point);

void rotate(double radians);

void invert();

Matrix opBinary(Matrix rhs);

Point!double transformDistance(Point!double dist);

Point!double transformPoint(Point!double point);

}

Constructors

this this(double xx, double yx, double xy, double yy, double x0, double y0): Sets matrix to be the affine transformation given by xx, yx, xy, yy, x0, y0. The transformation is given by:

Alias This

nativeMatrix

Alias, so that cairo_matrix_t members also work with this Matrix struct

Members

Functions

initIdentity void initIdentity(): Modifies matrix to be an identity transformation.
initRotate void initRotate(double radians): Initialized matrix to a transformation that rotates by radians.
initScale void initScale(double sx, double sy)
void initScale(Point!double point): nitializes matrix to a transformation that scales by sx and sy in the X and Y dimensions, respectively.
initTranslate void initTranslate(double tx, double ty): Initializes matrix to a transformation that translates by tx and ty in the X and Y dimensions, respectively.
invert void invert(): Changes matrix to be the inverse of its original value. Not all transformation matrices have inverses; if the matrix collapses points together (it is degenerate), then it has no inverse and this function will fail.
opBinary Matrix opBinary(Matrix rhs): Multiplies the affine transformations in a and b together and returns the result. The effect of the resulting transformation is to first apply the transformation in a to the coordinates and then apply the transformation in b to the coordinates.
rotate void rotate(double radians): Applies rotation by radians to the transformation in matrix. The effect of the new transformation is to first rotate the coordinates by radians, then apply the original transformation to the coordinates.
scale void scale(double sx, double sy)
void scale(Point!double point): Applies scaling by sx, sy to the transformation in matrix. The effect of the new transformation is to first scale the coordinates by sx and sy, then apply the original transformation to the coordinates.
transformDistance Point!double transformDistance(Point!double dist): Transforms the distance vector (dx,dy) by matrix. This is similar to transformPoint except that the translation components of the transformation are ignored. The calculation of the returned vector is as follows:
transformPoint Point!double transformPoint(Point!double point): Transforms the point (x, y) by matrix.
translate void translate(double tx, double ty): Applies a translation by tx, ty to the transformation in matrix. The effect of the new transformation is to first translate the coordinates by tx and ty, then apply the original transformation to the coordinates.

Variables

nativeMatrix cairo_matrix_t nativeMatrix;: Cairo's cairo_matrix_t struct