]>
Commit | Line | Data |
---|---|---|
0e320a79 DW |
1 | ///////////////////////////////////////////////////////////////////////////// |
2 | // Name: dc.h | |
3 | // Purpose: wxDC class | |
f0a56ab0 | 4 | // Author: David Webster |
0e320a79 | 5 | // Modified by: |
f0a56ab0 | 6 | // Created: 08/26/99 |
0e320a79 | 7 | // RCS-ID: $Id$ |
f0a56ab0 | 8 | // Copyright: (c) David Webster |
77ffb593 | 9 | // Licence: wxWidgets licence |
0e320a79 DW |
10 | ///////////////////////////////////////////////////////////////////////////// |
11 | ||
12 | #ifndef _WX_DC_H_ | |
13 | #define _WX_DC_H_ | |
14 | ||
fb46a9a6 | 15 | #include "wx/defs.h" |
d7e1a322 | 16 | //#include "wx/dc.h" |
0e320a79 | 17 | |
fb46a9a6 DW |
18 | // --------------------------------------------------------------------------- |
19 | // macros | |
20 | // --------------------------------------------------------------------------- | |
21 | ||
22 | // Logical to device | |
23 | // Absolute | |
24 | #define XLOG2DEV(x) (x) | |
25 | #define YLOG2DEV(y) (y) | |
26 | ||
27 | // Relative | |
28 | #define XLOG2DEVREL(x) (x) | |
29 | #define YLOG2DEVREL(y) (y) | |
30 | ||
31 | // Device to logical | |
32 | // Absolute | |
33 | #define XDEV2LOG(x) (x) | |
34 | ||
35 | #define YDEV2LOG(y) (y) | |
36 | ||
37 | // Relative | |
38 | #define XDEV2LOGREL(x) (x) | |
39 | #define YDEV2LOGREL(y) (y) | |
40 | ||
41 | /* | |
42 | * Have the same macros as for XView but not for every operation: | |
43 | * just for calculating window/viewport extent (a better way of scaling). | |
44 | */ | |
45 | ||
46 | // Logical to device | |
47 | // Absolute | |
48 | #define MS_XLOG2DEV(x) LogicalToDevice(x) | |
49 | ||
50 | #define MS_YLOG2DEV(y) LogicalToDevice(y) | |
51 | ||
52 | // Relative | |
53 | #define MS_XLOG2DEVREL(x) LogicalToDeviceXRel(x) | |
54 | #define MS_YLOG2DEVREL(y) LogicalToDeviceYRel(y) | |
55 | ||
56 | // Device to logical | |
57 | // Absolute | |
58 | #define MS_XDEV2LOG(x) DeviceToLogicalX(x) | |
59 | ||
60 | #define MS_YDEV2LOG(y) DeviceToLogicalY(y) | |
0e320a79 | 61 | |
fb46a9a6 DW |
62 | // Relative |
63 | #define MS_XDEV2LOGREL(x) DeviceToLogicalXRel(x) | |
64 | #define MS_YDEV2LOGREL(y) DeviceToLogicalYRel(y) | |
0e320a79 | 65 | |
fb46a9a6 | 66 | #define YSCALE(y) (yorigin - (y)) |
0e320a79 | 67 | |
fb46a9a6 | 68 | #define wx_round(a) (int)((a)+.5) |
0e320a79 | 69 | |
6835592c DW |
70 | #if wxUSE_DC_CACHEING |
71 | /* | |
72 | * Cached blitting, maintaining a cache | |
73 | * of bitmaps required for transparent blitting | |
74 | * instead of constant creation/deletion | |
75 | */ | |
76 | ||
77 | class wxDCCacheEntry : public wxObject | |
78 | { | |
79 | public: | |
80 | wxDCCacheEntry( WXHBITMAP hBitmap | |
81 | ,int nWidth | |
82 | ,int nHeight | |
83 | ,int nDepth | |
84 | ); | |
85 | wxDCCacheEntry( HPS hPS | |
86 | ,int nDepth | |
87 | ); | |
88 | ~wxDCCacheEntry(); | |
89 | ||
90 | WXHBITMAP m_hBitmap; | |
91 | HPS m_hPS; | |
92 | int m_nWidth; | |
93 | int m_nHeight; | |
94 | int m_nDepth; | |
95 | }; // end of CLASS wxDCCacheEntry | |
96 | #endif | |
97 | ||
fb46a9a6 | 98 | class WXDLLEXPORT wxDC : public wxDCBase |
54da4255 | 99 | { |
fb46a9a6 | 100 | DECLARE_DYNAMIC_CLASS(wxDC) |
54da4255 | 101 | |
fb46a9a6 | 102 | public: |
d7e1a322 | 103 | wxDC(void); |
fb46a9a6 DW |
104 | ~wxDC(); |
105 | ||
106 | // implement base class pure virtuals | |
107 | // ---------------------------------- | |
108 | ||
f6bcfd97 BP |
109 | virtual void Clear(void); |
110 | ||
111 | virtual bool StartDoc(const wxString& rsMessage); | |
112 | virtual void EndDoc(void); | |
113 | ||
114 | virtual void StartPage(void); | |
115 | virtual void EndPage(void); | |
116 | ||
117 | virtual void SetFont(const wxFont& rFont); | |
118 | virtual void SetPen(const wxPen& rPen); | |
119 | virtual void SetBrush(const wxBrush& rBrush); | |
120 | virtual void SetBackground(const wxBrush& rBrush); | |
121 | virtual void SetBackgroundMode(int nMode); | |
122 | virtual void SetPalette(const wxPalette& rPalette); | |
123 | ||
124 | virtual void DestroyClippingRegion(void); | |
125 | ||
126 | virtual wxCoord GetCharHeight(void) const; | |
127 | virtual wxCoord GetCharWidth(void) const; | |
128 | virtual void DoGetTextExtent( const wxString& rsString | |
129 | ,wxCoord* pX | |
130 | ,wxCoord* pY | |
131 | ,wxCoord* pDescent = NULL | |
132 | ,wxCoord* pExternalLeading = NULL | |
133 | ,wxFont* pTheFont = NULL | |
134 | ) const; | |
135 | virtual bool CanDrawBitmap(void) const; | |
136 | virtual bool CanGetTextExtent(void) const; | |
137 | virtual int GetDepth(void) const; | |
138 | virtual wxSize GetPPI(void) const; | |
139 | ||
140 | virtual void SetMapMode(int nMode); | |
141 | virtual void SetUserScale( double dX | |
142 | ,double dY | |
143 | ); | |
144 | virtual void SetSystemScale( double dX | |
145 | ,double dY | |
146 | ); | |
147 | virtual void SetLogicalScale( double dX | |
148 | ,double dY | |
149 | ); | |
150 | virtual void SetLogicalOrigin( wxCoord vX | |
151 | ,wxCoord vY | |
152 | ); | |
153 | virtual void SetDeviceOrigin( wxCoord vX | |
154 | ,wxCoord vY | |
155 | ); | |
156 | virtual void SetAxisOrientation( bool bXLeftRight | |
157 | ,bool bYBottomUp | |
158 | ); | |
159 | virtual void SetLogicalFunction(int nFunction); | |
1408104d | 160 | |
fb46a9a6 DW |
161 | // implementation from now on |
162 | // -------------------------- | |
54da4255 | 163 | |
f6bcfd97 BP |
164 | virtual void SetRop(WXHDC hCdc); |
165 | virtual void SelectOldObjects(WXHDC hDc); | |
ce44c50e | 166 | |
f6bcfd97 BP |
167 | wxWindow* GetWindow(void) const { return m_pCanvas; } |
168 | void SetWindow(wxWindow* pWin) { m_pCanvas = pWin; } | |
ce44c50e | 169 | |
f6bcfd97 BP |
170 | WXHDC GetHDC(void) const { return m_hDC; } |
171 | void SetHDC( WXHDC hDc | |
172 | ,bool bOwnsDC = FALSE | |
173 | ) | |
ce44c50e | 174 | { |
f6bcfd97 | 175 | m_hDC = hDc; |
ce44c50e DW |
176 | m_bOwnsDC = bOwnsDC; |
177 | } | |
178 | ||
d8fcb5e8 DW |
179 | HPS GetHPS(void) const { return m_hPS; } |
180 | void SetHPS(HPS hPS) | |
181 | { | |
d8fcb5e8 DW |
182 | m_hPS = hPS; |
183 | } | |
f6bcfd97 BP |
184 | const wxBitmap& GetSelectedBitmap(void) const { return m_vSelectedBitmap; } |
185 | wxBitmap& GetSelectedBitmap(void) { return m_vSelectedBitmap; } | |
186 | ||
210a651b DW |
187 | void UpdateClipBox(); |
188 | ||
6835592c DW |
189 | #if wxUSE_DC_CACHEING |
190 | static wxDCCacheEntry* FindBitmapInCache( HPS hPS | |
191 | ,int nWidth | |
192 | ,int nHeight | |
193 | ); | |
194 | static wxDCCacheEntry* FindDCInCache( wxDCCacheEntry* pNotThis | |
195 | ,HPS hPS | |
196 | ); | |
197 | ||
198 | static void AddToBitmapCache(wxDCCacheEntry* pEntry); | |
199 | static void AddToDCCache(wxDCCacheEntry* pEntry); | |
200 | static void ClearCache(void); | |
201 | #endif | |
202 | ||
1408104d | 203 | protected: |
1d0edc0f | 204 | virtual bool DoFloodFill( wxCoord vX |
f6bcfd97 BP |
205 | ,wxCoord vY |
206 | ,const wxColour& rCol | |
207 | ,int nStyle = wxFLOOD_SURFACE | |
208 | ); | |
209 | ||
210 | virtual bool DoGetPixel( wxCoord vX | |
211 | ,wxCoord vY | |
212 | ,wxColour* pCol | |
213 | ) const; | |
214 | ||
215 | virtual void DoDrawPoint( wxCoord vX | |
216 | ,wxCoord vY | |
217 | ); | |
218 | virtual void DoDrawLine( wxCoord vX1 | |
219 | ,wxCoord vY1 | |
220 | ,wxCoord vX2 | |
221 | ,wxCoord vY2 | |
222 | ); | |
223 | ||
224 | virtual void DoDrawArc( wxCoord vX1 | |
225 | ,wxCoord vY1 | |
226 | ,wxCoord vX2 | |
227 | ,wxCoord vY2 | |
228 | ,wxCoord vXc | |
229 | ,wxCoord vYc | |
230 | ); | |
231 | virtual void DoDrawCheckMark( wxCoord vX | |
232 | ,wxCoord vY | |
233 | ,wxCoord vWidth | |
234 | ,wxCoord vHeight | |
235 | ); | |
236 | virtual void DoDrawEllipticArc( wxCoord vX | |
237 | ,wxCoord vY | |
238 | ,wxCoord vW | |
239 | ,wxCoord vH | |
240 | ,double dSa | |
241 | ,double dEa | |
242 | ); | |
243 | ||
244 | virtual void DoDrawRectangle( wxCoord vX | |
245 | ,wxCoord vY | |
246 | ,wxCoord vWidth | |
247 | ,wxCoord vHeight | |
248 | ); | |
249 | virtual void DoDrawRoundedRectangle( wxCoord vX | |
250 | ,wxCoord vY | |
251 | ,wxCoord vWidth | |
252 | ,wxCoord vHeight | |
253 | ,double dRadius | |
254 | ); | |
255 | virtual void DoDrawEllipse( wxCoord vX | |
256 | ,wxCoord vY | |
257 | ,wxCoord vWidth | |
258 | ,wxCoord vHeight | |
259 | ); | |
260 | ||
261 | virtual void DoCrossHair( wxCoord vX | |
262 | ,wxCoord vY | |
263 | ); | |
264 | ||
265 | virtual void DoDrawIcon( const wxIcon& rIcon | |
266 | ,wxCoord vX | |
267 | ,wxCoord vY | |
268 | ); | |
269 | virtual void DoDrawBitmap( const wxBitmap& rBmp | |
270 | ,wxCoord vX | |
271 | ,wxCoord vY | |
272 | ,bool bUseMask = FALSE | |
273 | ); | |
274 | ||
275 | virtual void DoDrawText( const wxString& rsText | |
276 | ,wxCoord vX | |
277 | ,wxCoord vY | |
278 | ); | |
279 | virtual void DoDrawRotatedText( const wxString& rsText | |
280 | ,wxCoord vX | |
281 | ,wxCoord vY | |
282 | ,double dAngle | |
283 | ); | |
284 | ||
285 | virtual bool DoBlit( wxCoord vXdest | |
286 | ,wxCoord vYdest | |
287 | ,wxCoord vWidth | |
288 | ,wxCoord vHeight | |
289 | ,wxDC* pSource | |
290 | ,wxCoord vXsrc | |
291 | ,wxCoord vYsrc | |
292 | ,int nRop = wxCOPY | |
293 | ,bool bUseMask = FALSE | |
6835592c DW |
294 | ,wxCoord vXsrcMask = -1 |
295 | ,wxCoord vYsrcMask = -1 | |
f6bcfd97 BP |
296 | ); |
297 | ||
298 | virtual void DoSetClippingRegionAsRegion(const wxRegion& rRegion); | |
299 | virtual void DoSetClippingRegion( wxCoord vX | |
300 | ,wxCoord vY | |
301 | ,wxCoord vWidth | |
302 | ,wxCoord vHeight | |
303 | ); | |
304 | virtual void DoGetClippingRegion( wxCoord* pX | |
305 | ,wxCoord* pY | |
306 | ,wxCoord* pWidth | |
307 | ,wxCoord* pHeight) | |
fb46a9a6 | 308 | { |
f6bcfd97 BP |
309 | GetClippingBox( pX |
310 | ,pY | |
311 | ,pWidth | |
312 | ,pHeight | |
313 | ); | |
fb46a9a6 | 314 | } |
1408104d | 315 | |
f6bcfd97 BP |
316 | virtual void DoGetSize( int* pWidth |
317 | ,int* pHeight | |
318 | ) const; | |
319 | virtual void DoGetSizeMM( int* pWidth | |
320 | ,int* pHeight | |
321 | ) const; | |
322 | ||
323 | virtual void DoDrawLines( int n | |
324 | ,wxPoint vaPoints[] | |
325 | ,wxCoord vXoffset | |
326 | ,wxCoord yYoffset | |
327 | ); | |
328 | virtual void DoDrawPolygon( int n | |
329 | ,wxPoint vaPoints[] | |
330 | ,wxCoord vXoffset | |
331 | ,wxCoord vYoffset | |
332 | ,int nFillStyle = wxODDEVEN_RULE | |
333 | ); | |
fb46a9a6 | 334 | |
938aa9c4 DW |
335 | #if wxUSE_PALETTE |
336 | void DoSelectPalette(bool bRealize = FALSE); | |
337 | void InitializePalette(void); | |
338 | #endif // wxUSE_PALETTE | |
fb46a9a6 | 339 | |
f6bcfd97 BP |
340 | // |
341 | // common part of DoDrawText() and DoDrawRotatedText() | |
342 | // | |
343 | void DrawAnyText( const wxString& rsText | |
344 | ,wxCoord vX | |
345 | ,wxCoord vY | |
346 | ); | |
fb46a9a6 | 347 | |
f6bcfd97 BP |
348 | // OS2-specific member variables ?? do we even need this under OS/2? |
349 | int m_nWindowExtX; | |
350 | int m_nWindowExtY; | |
1408104d | 351 | |
f6bcfd97 BP |
352 | // |
353 | // the window associated with this DC (may be NULL) | |
354 | // | |
355 | wxWindow* m_pCanvas; | |
356 | wxBitmap m_vSelectedBitmap; | |
1408104d | 357 | |
d7e1a322 DW |
358 | public: |
359 | // PM specific stuff | |
360 | HPS m_hPS; | |
361 | HPS m_hOldPS; // old hPS, if any | |
362 | bool m_bIsPaintTime;// True at Paint Time | |
363 | ||
364 | RECTL m_vRclPaint; // Bounding rectangle at Paint time etc. | |
f6bcfd97 | 365 | // |
fb46a9a6 | 366 | // TRUE => DeleteDC() in dtor, FALSE => only ReleaseDC() it |
f6bcfd97 BP |
367 | // |
368 | bool m_bOwnsDC:1; | |
fb46a9a6 | 369 | |
f6bcfd97 | 370 | // |
ac7fb818 | 371 | // our HDC |
f6bcfd97 BP |
372 | // |
373 | WXHDC m_hDC; | |
1408104d | 374 | |
f6bcfd97 | 375 | // |
1408104d DW |
376 | // Store all old GDI objects when do a SelectObject, so we can select them |
377 | // back in (this unselecting user's objects) so we can safely delete the | |
378 | // DC. | |
f6bcfd97 BP |
379 | // |
380 | WXHBITMAP m_hOldBitmap; | |
381 | WXHPEN m_hOldPen; | |
382 | WXHBRUSH m_hOldBrush; | |
383 | WXHFONT m_hOldFont; | |
384 | WXHPALETTE m_hOldPalette; | |
6835592c DW |
385 | |
386 | #if wxUSE_DC_CACHEING | |
387 | static wxList m_svBitmapCache; | |
388 | static wxList m_svDCCache; | |
389 | #endif | |
390 | }; // end of CLASS wxDC | |
0e320a79 DW |
391 | #endif |
392 | // _WX_DC_H_ |