don't use annoying and unneeded in C++ casts of NULL to "T *" in all other files...
[wxWidgets.git] / include / wx / gtk / print.h
1 /////////////////////////////////////////////////////////////////////////////
2 // Name: wx/gtk/print.h
3 // Author: Anthony Bretaudeau
4 // Purpose: GTK printing support
5 // Created: 2007-08-25
6 // RCS-ID: $Id: print.h,v 1 2007-08-25 05:44:44 PC Exp $
7 // Copyright: (c) Anthony Bretaudeau
8 // Licence: wxWindows Licence
9 /////////////////////////////////////////////////////////////////////////////
10
11 #ifndef _WX_GTK_PRINT_H_
12 #define _WX_GTK_PRINT_H_
13
14 #include "wx/defs.h"
15
16 #if wxUSE_GTKPRINT
17
18 #include "wx/print.h"
19 #include "wx/printdlg.h"
20 #include "wx/prntbase.h"
21 #include "wx/dc.h"
22 #include "wx/cairo.h"
23
24
25 typedef struct _GtkPrintOperation GtkPrintOperation;
26 typedef struct _GtkPrintContext GtkPrintContext;
27 typedef struct _GtkPrintSettings GtkPrintSettings;
28 typedef struct _GtkPageSetup GtkPageSetup;
29
30 typedef struct _cairo cairo_t;
31
32 //----------------------------------------------------------------------------
33 // wxGtkPrintFactory
34 //----------------------------------------------------------------------------
35
36 class wxGtkPrintFactory: public wxPrintFactory
37 {
38 public:
39 virtual wxPrinterBase *CreatePrinter( wxPrintDialogData *data );
40
41 virtual wxPrintPreviewBase *CreatePrintPreview( wxPrintout *preview,
42 wxPrintout *printout = NULL,
43 wxPrintDialogData *data = NULL );
44 virtual wxPrintPreviewBase *CreatePrintPreview( wxPrintout *preview,
45 wxPrintout *printout,
46 wxPrintData *data );
47
48 virtual wxPrintDialogBase *CreatePrintDialog( wxWindow *parent,
49 wxPrintDialogData *data = NULL );
50 virtual wxPrintDialogBase *CreatePrintDialog( wxWindow *parent,
51 wxPrintData *data );
52
53 virtual wxPageSetupDialogBase *CreatePageSetupDialog( wxWindow *parent,
54 wxPageSetupDialogData * data = NULL );
55
56 virtual wxDCImpl* CreatePrinterDCImpl( wxPrinterDC *owner, const wxPrintData& data );
57
58 virtual bool HasPrintSetupDialog();
59 virtual wxDialog *CreatePrintSetupDialog( wxWindow *parent, wxPrintData *data );
60 virtual bool HasOwnPrintToFile();
61 virtual bool HasPrinterLine();
62 virtual wxString CreatePrinterLine();
63 virtual bool HasStatusLine();
64 virtual wxString CreateStatusLine();
65
66 virtual wxPrintNativeDataBase *CreatePrintNativeData();
67 };
68
69 //----------------------------------------------------------------------------
70 // wxGtkPrintDialog
71 //----------------------------------------------------------------------------
72
73 class WXDLLIMPEXP_CORE wxGtkPrintDialog: public wxPrintDialogBase
74 {
75 public:
76 wxGtkPrintDialog( wxWindow *parent,
77 wxPrintDialogData* data = NULL );
78 wxGtkPrintDialog( wxWindow *parent, wxPrintData* data);
79 virtual ~wxGtkPrintDialog();
80
81 wxPrintData& GetPrintData()
82 { return m_printDialogData.GetPrintData(); }
83 wxPrintDialogData& GetPrintDialogData()
84 { return m_printDialogData; }
85
86 wxDC *GetPrintDC() { return m_dc; }
87 void SetPrintDC(wxDC * printDC) { m_dc = printDC; }
88
89 virtual int ShowModal();
90
91 virtual bool Validate() { return true; }
92 virtual bool TransferDataToWindow() { return true; }
93 virtual bool TransferDataFromWindow() { return true; }
94
95 void SetShowDialog(bool show) { m_showDialog = show; }
96 bool GetShowDialog() { return m_showDialog; }
97
98 protected:
99 // Implement some base class methods to do nothing to avoid asserts and
100 // GTK warnings, since this is not a real wxDialog.
101 virtual void DoSetSize(int WXUNUSED(x), int WXUNUSED(y),
102 int WXUNUSED(width), int WXUNUSED(height),
103 int WXUNUSED(sizeFlags) = wxSIZE_AUTO) {}
104 virtual void DoMoveWindow(int WXUNUSED(x), int WXUNUSED(y),
105 int WXUNUSED(width), int WXUNUSED(height)) {}
106
107 private:
108 wxPrintDialogData m_printDialogData;
109 wxWindow *m_parent;
110 bool m_showDialog;
111 wxDC *m_dc;
112
113 DECLARE_DYNAMIC_CLASS(wxGtkPrintDialog)
114 };
115
116 //----------------------------------------------------------------------------
117 // wxGtkPageSetupDialog
118 //----------------------------------------------------------------------------
119
120 class WXDLLIMPEXP_CORE wxGtkPageSetupDialog: public wxPageSetupDialogBase
121 {
122 public:
123 wxGtkPageSetupDialog( wxWindow *parent,
124 wxPageSetupDialogData* data = NULL );
125 virtual ~wxGtkPageSetupDialog();
126
127 virtual wxPageSetupDialogData& GetPageSetupDialogData() { return m_pageDialogData; }
128
129 virtual int ShowModal();
130
131 virtual bool Validate() { return true; }
132 virtual bool TransferDataToWindow() { return true; }
133 virtual bool TransferDataFromWindow() { return true; }
134
135 protected:
136 // Implement some base class methods to do nothing to avoid asserts and
137 // GTK warnings, since this is not a real wxDialog.
138 virtual void DoSetSize(int WXUNUSED(x), int WXUNUSED(y),
139 int WXUNUSED(width), int WXUNUSED(height),
140 int WXUNUSED(sizeFlags) = wxSIZE_AUTO) {}
141 virtual void DoMoveWindow(int WXUNUSED(x), int WXUNUSED(y),
142 int WXUNUSED(width), int WXUNUSED(height)) {}
143
144 private:
145 wxPageSetupDialogData m_pageDialogData;
146 wxWindow *m_parent;
147
148 DECLARE_DYNAMIC_CLASS(wxGtkPageSetupDialog)
149 };
150
151 //----------------------------------------------------------------------------
152 // wxGtkPrinter
153 //----------------------------------------------------------------------------
154
155 class WXDLLIMPEXP_CORE wxGtkPrinter : public wxPrinterBase
156 {
157 public:
158 wxGtkPrinter(wxPrintDialogData *data = NULL);
159 virtual ~wxGtkPrinter();
160
161 virtual bool Print(wxWindow *parent,
162 wxPrintout *printout,
163 bool prompt = true);
164 virtual wxDC* PrintDialog(wxWindow *parent);
165 virtual bool Setup(wxWindow *parent);
166
167 GtkPrintContext *GetPrintContext() { return m_gpc; }
168 void SetPrintContext(GtkPrintContext *context) {m_gpc = context;}
169 void BeginPrint(wxPrintout *printout, GtkPrintOperation *operation, GtkPrintContext *context);
170 void DrawPage(wxPrintout *printout, GtkPrintOperation *operation, GtkPrintContext *context, int page_nr);
171
172 private:
173 GtkPrintContext *m_gpc;
174 wxDC *m_dc;
175
176 DECLARE_DYNAMIC_CLASS(wxGtkPrinter)
177 DECLARE_NO_COPY_CLASS(wxGtkPrinter)
178 };
179
180 //----------------------------------------------------------------------------
181 // wxGtkPrintNativeData
182 //----------------------------------------------------------------------------
183
184 class WXDLLIMPEXP_CORE wxGtkPrintNativeData : public wxPrintNativeDataBase
185 {
186 public:
187 wxGtkPrintNativeData();
188 virtual ~wxGtkPrintNativeData();
189
190 virtual bool TransferTo( wxPrintData &data );
191 virtual bool TransferFrom( const wxPrintData &data );
192
193 virtual bool Ok() const { return IsOk(); }
194 virtual bool IsOk() const { return true; }
195
196 GtkPrintSettings* GetPrintConfig() { return m_config; }
197 void SetPrintConfig( GtkPrintSettings * config );
198
199 void SetPrintJob( GtkPrintOperation *job ) { m_job = job; }
200 GtkPrintOperation* GetPrintJob() { return m_job; }
201
202 GtkPrintContext *GetPrintContext() { return m_context; }
203 void SetPrintContext(GtkPrintContext *context) {m_context = context; }
204
205
206 GtkPageSetup* GetPageSetupFromSettings(GtkPrintSettings* settings);
207 void SetPageSetupToSettings(GtkPrintSettings* settings, GtkPageSetup* page_setup);
208
209 private:
210 GtkPrintSettings *m_config;
211 GtkPrintOperation *m_job;
212 GtkPrintContext *m_context;
213
214 DECLARE_DYNAMIC_CLASS(wxGtkPrintNativeData)
215 };
216
217 //-----------------------------------------------------------------------------
218 // wxGtkPrinterDC
219 //-----------------------------------------------------------------------------
220
221 class WXDLLIMPEXP_CORE wxGtkPrinterDCImpl : public wxDCImpl
222 {
223 public:
224 wxGtkPrinterDCImpl( wxPrinterDC *owner, const wxPrintData& data );
225 virtual ~wxGtkPrinterDCImpl();
226
227 bool Ok() const { return IsOk(); }
228 bool IsOk() const;
229
230 virtual void* GetCairoContext() const;
231
232 bool CanDrawBitmap() const { return true; }
233 void Clear();
234 void SetFont( const wxFont& font );
235 void SetPen( const wxPen& pen );
236 void SetBrush( const wxBrush& brush );
237 void SetLogicalFunction( wxRasterOperationMode function );
238 void SetBackground( const wxBrush& brush );
239 void DestroyClippingRegion();
240 bool StartDoc(const wxString& message);
241 void EndDoc();
242 void StartPage();
243 void EndPage();
244 wxCoord GetCharHeight() const;
245 wxCoord GetCharWidth() const;
246 bool CanGetTextExtent() const { return true; }
247 wxSize GetPPI() const;
248 virtual int GetDepth() const { return 24; }
249 void SetBackgroundMode(int mode);
250 void SetPalette(const wxPalette& WXUNUSED(palette)) { }
251 void SetResolution(int ppi);
252
253 // overriden for wxPrinterDC Impl
254 virtual int GetResolution() const;
255 virtual wxRect GetPaperRect() const;
256
257 protected:
258 bool DoFloodFill(wxCoord x1, wxCoord y1, const wxColour &col,
259 wxFloodFillStyle style=wxFLOOD_SURFACE );
260 void DoGradientFillConcentric(const wxRect& rect, const wxColour& initialColour, const wxColour& destColour, const wxPoint& circleCenter);
261 void DoGradientFillLinear(const wxRect& rect, const wxColour& initialColour, const wxColour& destColour, wxDirection nDirection = wxEAST);
262 bool DoGetPixel(wxCoord x1, wxCoord y1, wxColour *col) const;
263 void DoDrawLine(wxCoord x1, wxCoord y1, wxCoord x2, wxCoord y2);
264 void DoCrossHair(wxCoord x, wxCoord y);
265 void DoDrawArc(wxCoord x1,wxCoord y1,wxCoord x2,wxCoord y2,wxCoord xc,wxCoord yc);
266 void DoDrawEllipticArc(wxCoord x,wxCoord y,wxCoord w,wxCoord h,double sa,double ea);
267 void DoDrawPoint(wxCoord x, wxCoord y);
268 void DoDrawLines(int n, wxPoint points[], wxCoord xoffset = 0, wxCoord yoffset = 0);
269 void DoDrawPolygon(int n, wxPoint points[], wxCoord xoffset = 0, wxCoord yoffset = 0, wxPolygonFillMode fillStyle=wxODDEVEN_RULE);
270 void DoDrawPolyPolygon(int n, int count[], wxPoint points[], wxCoord xoffset = 0, wxCoord yoffset = 0, wxPolygonFillMode fillStyle=wxODDEVEN_RULE);
271 void DoDrawRectangle(wxCoord x, wxCoord y, wxCoord width, wxCoord height);
272 void DoDrawRoundedRectangle(wxCoord x, wxCoord y, wxCoord width, wxCoord height, double radius = 20.0);
273 void DoDrawEllipse(wxCoord x, wxCoord y, wxCoord width, wxCoord height);
274 #if wxUSE_SPLINES
275 void DoDrawSpline(const wxPointList *points);
276 #endif
277 bool DoBlit(wxCoord xdest, wxCoord ydest, wxCoord width, wxCoord height,
278 wxDC *source, wxCoord xsrc, wxCoord ysrc,
279 wxRasterOperationMode rop = wxCOPY, bool useMask = false,
280 wxCoord xsrcMask = wxDefaultCoord, wxCoord ysrcMask = wxDefaultCoord);
281 void DoDrawIcon( const wxIcon& icon, wxCoord x, wxCoord y );
282 void DoDrawBitmap( const wxBitmap& bitmap, wxCoord x, wxCoord y, bool useMask = false );
283 void DoDrawText(const wxString& text, wxCoord x, wxCoord y );
284 void DoDrawRotatedText(const wxString& text, wxCoord x, wxCoord y, double angle);
285 void DoSetClippingRegion(wxCoord x, wxCoord y, wxCoord width, wxCoord height);
286 void DoSetDeviceClippingRegion( const wxRegion &WXUNUSED(clip) )
287 {
288 wxFAIL_MSG( "not implemented" );
289 }
290 void DoGetTextExtent(const wxString& string, wxCoord *x, wxCoord *y,
291 wxCoord *descent = NULL,
292 wxCoord *externalLeading = NULL,
293 const wxFont *theFont = NULL ) const;
294 void DoGetSize(int* width, int* height) const;
295 void DoGetSizeMM(int *width, int *height) const;
296
297 wxPrintData& GetPrintData() { return m_printData; }
298 void SetPrintData(const wxPrintData& data);
299
300 private:
301 wxPrintData m_printData;
302 PangoContext *m_context;
303 PangoLayout *m_layout;
304 PangoFontDescription *m_fontdesc;
305 cairo_t *m_cairo;
306
307 unsigned char m_currentRed;
308 unsigned char m_currentGreen;
309 unsigned char m_currentBlue;
310 unsigned char m_currentAlpha;
311
312 GtkPrintContext *m_gpc;
313 int m_resolution;
314 double m_PS2DEV;
315 double m_DEV2PS;
316
317 DECLARE_DYNAMIC_CLASS(wxGtkPrinterDCImpl)
318 DECLARE_NO_COPY_CLASS(wxGtkPrinterDCImpl)
319 };
320
321 // ----------------------------------------------------------------------------
322 // wxGtkPrintPreview: programmer creates an object of this class to preview a
323 // wxPrintout.
324 // ----------------------------------------------------------------------------
325
326 class WXDLLIMPEXP_CORE wxGtkPrintPreview : public wxPrintPreviewBase
327 {
328 public:
329 wxGtkPrintPreview(wxPrintout *printout,
330 wxPrintout *printoutForPrinting = NULL,
331 wxPrintDialogData *data = NULL);
332 wxGtkPrintPreview(wxPrintout *printout,
333 wxPrintout *printoutForPrinting,
334 wxPrintData *data);
335
336 virtual ~wxGtkPrintPreview();
337
338 virtual bool Print(bool interactive);
339 virtual void DetermineScaling();
340
341 private:
342 void Init(wxPrintout *printout,
343 wxPrintout *printoutForPrinting,
344 wxPrintData *data);
345
346 // resolution to use in DPI
347 int m_resolution;
348
349 DECLARE_CLASS(wxGtkPrintPreview)
350 };
351
352 #endif // wxUSE_GTKPRINT
353
354 #endif // _WX_GTK_PRINT_H_