wxgraphicsmatrix

a wxgraphicsmatrix is a native representation of an affine matrix. the contents are specific and private to the respective renderer. instances are ref counted and can therefore be assigned as usual. the only way to get a valid instance is via a creatematrix call on the graphics context or the renderer instance.

derived from

wxgraphicsobject

include files

<wx/graphics.h>

members

wxgraphicsmatrix::concat
wxgraphicsmatrix::get
wxgraphicsmatrix::getnativematrix
wxgraphicsmatrix::invert
wxgraphicsmatrix::isequal
wxgraphicsmatrix::isidentity
wxgraphicsmatrix::rotate
wxgraphicsmatrix::scale
wxgraphicsmatrix::translate
wxgraphicsmatrix::set
wxgraphicsmatrix::transformpoint
wxgraphicsmatrix::transformdistance

wxgraphicsmatrix::concat

void concat(const wxgraphicsmatrix* t)

concatenates the matrix passed with the current matrix.

void concat(const wxgraphicsmatrix& t)

wxgraphicsmatrix::get

void get(wxdouble* a=null, wxdouble* b=null, wxdouble* c=null, wxdouble* d=null, wxdouble* tx=null, wxdouble* ty=null) const

returns the component values of the matrix via the argument pointers.

wxgraphicsmatrix::getnativematrix

void * getnativematrix() const

returns the native representation of the matrix. for coregraphics this is a cfaffinematrix pointer. for gdiplus a matrix pointer and for cairo a cairo_matrix_t pointer.

wxgraphicsmatrix::invert

void invert()

inverts the matrix.

wxgraphicsmatrix::isequal

bool isequal(const wxgraphicsmatrix& t) const

returns true if the elements of the transformation matrix are equal.

wxgraphicsmatrix::isidentity

bool isidentity() const

return true if this is the identity matrix.

wxgraphicsmatrix::rotate

void rotate(wxdouble angle)

rotates this matrix (radians).

wxgraphicsmatrix::scale

void scale(wxdouble xscale, wxdouble yscale)

scales this matrix.

wxgraphicsmatrix::translate

void translate(wxdouble dx, wxdouble dy)

translates this matrix.

wxgraphicsmatrix::set

void set(wxdouble a = 1.0, wxdouble b = 0.0, wxdouble c = 0.0, wxdouble d = 1.0, wxdouble tx = 0.0, wxdouble ty = 0.0)

sets the matrix to the respective values (default values are the identity matrix)

wxgraphicsmatrix::transformpoint

void transformpoint(wxdouble* x, wxdouble* y) const

applies this matrix to a point.

wxgraphicsmatrix::transformdistance

void transformdistance(wxdouble* dx, wxdouble* dy) const

applies this matrix to a distance (ie. performs all transforms except translations)