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$
   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     wxDECLARE_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     GtkPrintOperation* GetPrintJob() { return m_job; }
 200
 201     GtkPrintContext *GetPrintContext() { return m_context; }
 202     void SetPrintContext(GtkPrintContext *context) {m_context = context; }
 203
 204
 205     GtkPageSetup* GetPageSetupFromSettings(GtkPrintSettings* settings);
 206     void SetPageSetupToSettings(GtkPrintSettings* settings, GtkPageSetup* page_setup);
 207
 208 private:
 209     GtkPrintSettings    *m_config;
 210     GtkPrintOperation   *m_job;
 211     GtkPrintContext     *m_context;
 212
 213     DECLARE_DYNAMIC_CLASS(wxGtkPrintNativeData)
 214 };
 215
 216 //-----------------------------------------------------------------------------
 217 // wxGtkPrinterDC
 218 //-----------------------------------------------------------------------------
 219
 220 class WXDLLIMPEXP_CORE wxGtkPrinterDCImpl : public wxDCImpl
 221 {
 222 public:
 223     wxGtkPrinterDCImpl( wxPrinterDC *owner, const wxPrintData& data );
 224     virtual ~wxGtkPrinterDCImpl();
 225
 226     bool Ok() const { return IsOk(); }
 227     bool IsOk() const;
 228
 229     virtual void* GetCairoContext() const;
 230     virtual void* GetHandle() 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     // overridden 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     wxDECLARE_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_