1%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
2%% Name:        graphicsmatrix.tex
3%% Purpose:     wxGraphicsMatrix class documentation
4%% Author:      Stefan Csomor
5%% Modified by:
6%% Created:     08.06.2004
7%% RCS-ID:      $Id: graphicsmatrix.tex 50200 2007-11-23 20:45:59Z VS $
8%% Copyright:   (c) Stefan Csomor
9%% License:     wxWindows license
10%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
11
12\section{\class{wxGraphicsMatrix}}\label{wxgraphicsmatrix}
13
14A 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.
15
16\wxheading{Derived from}
17
18\helpref{wxGraphicsObject}{wxgraphicsobject}
19
20\wxheading{Include files}
21
22<wx/graphics.h>
23
24\latexignore{\rtfignore{\wxheading{Members}}}
25
26\membersection{wxGraphicsMatrix::Concat}\label{wxgraphicsmatrixconcat}
27
28\func{void}{Concat}{\param{const wxGraphicsMatrix* }{t}}
29
30Concatenates the matrix passed with the current matrix.
31
32\func{void}{Concat}{\param{const wxGraphicsMatrix\& }{t}}
33
34
35\membersection{wxGraphicsMatrix::Get}\label{wxgraphicsmatrixget}
36
37\constfunc{void }{Get}{\param{wxDouble* }{a=NULL}, 
38                       \param{wxDouble* }{b=NULL}, 
39                       \param{wxDouble* }{c=NULL}, 
40                       \param{wxDouble* }{d=NULL}, 
41                       \param{wxDouble* }{tx=NULL}, 
42                       \param{wxDouble* }{ty=NULL}}
43
44Returns the component values of the matrix via the argument pointers.
45
46\membersection{wxGraphicsMatrix::GetNativeMatrix}\label{wxgraphicsmatrixgetnativematrix}
47
48\constfunc{void *}{GetNativeMatrix}{\void}
49
50Returns 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.
51
52\membersection{wxGraphicsMatrix::Invert}\label{wxgraphicsmatrixinvert}
53
54\func{void}{Invert}{\void}
55
56Inverts the matrix.
57
58\membersection{wxGraphicsMatrix::IsEqual}\label{wxgraphicsmatrixisequal}
59
60\constfunc{bool}{IsEqual}{\param{const wxGraphicsMatrix\& }{t}}
61
62Returns true if the elements of the transformation matrix are equal.
63
64\membersection{wxGraphicsMatrix::IsIdentity}\label{wxgraphicsmatrixisidentity}
65
66\constfunc{bool}{IsIdentity}{\void}
67
68Return true if this is the identity matrix.
69
70\membersection{wxGraphicsMatrix::Rotate}\label{wxgraphicsmatrixrotate}
71
72\func{void}{Rotate}{\param{wxDouble }{angle}}
73
74Rotates this matrix (radians).
75
76\membersection{wxGraphicsMatrix::Scale}\label{wxgraphicsmatrixscale}
77
78\func{void}{Scale}{\param{wxDouble }{xScale}, \param{wxDouble }{yScale}}
79
80Scales this matrix.
81
82\membersection{wxGraphicsMatrix::Translate}\label{wxgraphicsmatrixtranslate}
83
84\func{void}{Translate}{\param{wxDouble }{dx}, \param{wxDouble }{dy}}
85
86Translates this matrix.
87
88\membersection{wxGraphicsMatrix::Set}\label{wxgraphicsmatrixset}
89
90\func{void}{Set}{\param{wxDouble }{a = 1.0}, \param{wxDouble }{b = 0.0}, \param{wxDouble }{c = 0.0}, \param{wxDouble }{d = 1.0}, \param{wxDouble }{tx = 0.0}, \param{wxDouble }{ty = 0.0}}
91
92Sets the matrix to the respective values (default values are the identity matrix)
93
94\membersection{wxGraphicsMatrix::TransformPoint}\label{wxgraphicsmatrixtransformpoint}
95
96\constfunc{void}{TransformPoint}{\param{wxDouble* }{x}, \param{wxDouble* }{y}}
97
98Applies this matrix to a point.
99
100\membersection{wxGraphicsMatrix::TransformDistance}\label{wxgraphicsmatrixtransformdistance}
101
102\constfunc{void}{TransformDistance}{\param{wxDouble* }{dx}, \param{wxDouble* }{dy}}
103
104Applies this matrix to a distance (ie. performs all transforms except translations)
105
106
107
108