include/wx/mac/dc.h

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        dc.h
   3 // Purpose:     wxDC class
   4 // Author:      AUTHOR
   5 // Modified by:
   6 // Created:     ??/??/98
   7 // RCS-ID:      $Id$
   8 // Copyright:   (c) AUTHOR
   9 // Licence:     wxWindows licence
  10 /////////////////////////////////////////////////////////////////////////////
  11
  12 #ifndef _WX_DC_H_
  13 #define _WX_DC_H_
  14
  15 #ifdef __GNUG__
  16 #pragma interface "dc.h"
  17 #endif
  18
  19 #include "wx/pen.h"
  20 #include "wx/brush.h"
  21 #include "wx/icon.h"
  22 #include "wx/font.h"
  23 #include "wx/gdicmn.h"
  24
  25 //-----------------------------------------------------------------------------
  26 // constants
  27 //-----------------------------------------------------------------------------
  28
  29 #ifndef MM_TEXT
  30 #define MM_TEXT                 0
  31 #define MM_ISOTROPIC    1
  32 #define MM_ANISOTROPIC  2
  33 #define MM_LOMETRIC             3
  34 #define MM_HIMETRIC             4
  35 #define MM_TWIPS                5
  36 #define MM_POINTS               6
  37 #define MM_METRIC               7
  38 #endif
  39
  40 //-----------------------------------------------------------------------------
  41 // global variables
  42 //-----------------------------------------------------------------------------
  43
  44 extern int wxPageNumber;
  45
  46 //-----------------------------------------------------------------------------
  47 // wxDC
  48 //-----------------------------------------------------------------------------
  49
  50 class WXDLLEXPORT wxDC: public wxObject
  51 {
  52   DECLARE_ABSTRACT_CLASS(wxDC)
  53
  54   public:
  55
  56     wxDC(void);
  57     ~wxDC(void);
  58
  59     void BeginDrawing(void) {};
  60     void EndDrawing(void) {};
  61
  62     virtual bool Ok(void) const { return m_ok; };
  63
  64     virtual void FloodFill( long x1, long y1, const wxColour& col, int style=wxFLOOD_SURFACE );
  65     inline void FloodFill(const wxPoint& pt, const wxColour& col, int style=wxFLOOD_SURFACE)
  66     {
  67         FloodFill(pt.x, pt.y, col, style);
  68     }
  69
  70     virtual bool GetPixel( long x1, long y1, wxColour *col ) const ;
  71     inline bool GetPixel(const wxPoint& pt, wxColour *col) const
  72     {
  73         return GetPixel(pt.x, pt.y, col);
  74     }
  75
  76     virtual void DrawLine( long x1, long y1, long x2, long y2 );
  77     inline void DrawLine(const wxPoint& pt1, const wxPoint& pt2)
  78     {
  79         DrawLine(pt1.x, pt1.y, pt2.x, pt2.y);
  80     }
  81
  82     virtual void CrossHair( long x, long y );
  83     inline void CrossHair(const wxPoint& pt)
  84     {
  85         CrossHair(pt.x, pt.y);
  86     }
  87
  88     virtual void DrawArc( long x1, long y1, long x2, long y2, long xc, long yc );
  89     inline void DrawArc(const wxPoint& pt1, const wxPoint& pt2, const wxPoint& centre)
  90     {
  91         DrawArc(pt1.x, pt1.y, pt2.x, pt2.y, centre.x, centre.y);
  92     }
  93
  94     virtual void DrawEllipticArc( long x, long y, long width, long height, double sa, double ea );
  95     virtual void DrawEllipticArc (const wxPoint& pt, const wxSize& sz, double sa, double ea)
  96     {
  97         DrawEllipticArc(pt.x, pt.y, sz.x, sz.y, sa, ea);
  98     }
  99
 100     virtual void DrawPoint( long x, long y );
 101     virtual void DrawPoint( wxPoint& point );
 102
 103     virtual void DrawLines( int n, wxPoint points[], long xoffset = 0, long yoffset = 0 );
 104     virtual void DrawLines( wxList *points, long xoffset = 0, long yoffset = 0 );
 105     virtual void DrawPolygon( int n, wxPoint points[], long xoffset = 0, long yoffset = 0,
 106                               int fillStyle=wxODDEVEN_RULE );
 107     virtual void DrawPolygon( wxList *lines, long xoffset = 0, long yoffset = 0,
 108                               int fillStyle=wxODDEVEN_RULE );
 109
 110     virtual void DrawRectangle( long x, long y, long width, long height );
 111     inline void DrawRectangle(const wxPoint& pt, const wxSize& sz)
 112     {
 113         DrawRectangle(pt.x, pt.y, sz.x, sz.y);
 114     }
 115     inline void DrawRectangle(const wxRect& rect)
 116     {
 117         DrawRectangle(rect.x, rect.y, rect.width, rect.height);
 118     }
 119     virtual void DrawRoundedRectangle( long x, long y, long width, long height, double radius = 20.0 );
 120     inline void DrawRoundedRectangle(const wxPoint& pt, const wxSize& sz, double radius = 20.0)
 121     {
 122         DrawRoundedRectangle(pt.x, pt.y, sz.x, sz.y, radius);
 123     }
 124     inline void DrawRoundedRectangle(const wxRect& rect, double radius = 20.0)
 125     {
 126         DrawRoundedRectangle(rect.x, rect.y, rect.width, rect.height, radius);
 127     }
 128
 129     virtual void DrawEllipse( long x, long y, long width, long height );
 130     inline void DrawEllipse(const wxPoint& pt, const wxSize& sz)
 131     {
 132         DrawEllipse(pt.x, pt.y, sz.x, sz.y);
 133     }
 134     inline void DrawEllipse(const wxRect& rect)
 135     {
 136         DrawEllipse(rect.x, rect.y, rect.width, rect.height);
 137     }
 138
 139     virtual void DrawSpline( long x1, long y1, long x2, long y2, long x3, long y3 );
 140     virtual void DrawSpline( wxList *points );
 141     virtual void DrawSpline( int n, wxPoint points[] );
 142
 143     virtual bool CanDrawBitmap(void) const ;
 144
 145     virtual void DrawIcon( const wxIcon &icon, long x, long y, bool useMask=FALSE );
 146     inline void DrawIcon(const wxIcon& icon, const wxPoint& pt)
 147     {
 148         DrawIcon(icon, pt.x, pt.y);
 149     }
 150
 151     void DrawBitmap( const wxBitmap &bmp, long x, long y, bool useMask=FALSE ) ;
 152
 153     virtual bool Blit( long xdest, long ydest, long width, long height,
 154        wxDC *source, long xsrc, long ysrc, int logical_func = wxCOPY, bool useMask=FALSE );
 155     inline bool Blit(const wxPoint& destPt, const wxSize& sz,
 156             wxDC *source, const wxPoint& srcPt, int rop = wxCOPY, bool useMask = FALSE)
 157     {
 158         return Blit(destPt.x, destPt.y, sz.x, sz.y, source, srcPt.x, srcPt.y, rop, useMask);
 159     }
 160
 161     virtual void DrawText( const wxString &text, long x, long y, bool use16 = FALSE );
 162     inline void DrawText(const wxString& text, const wxPoint& pt, bool use16bit = FALSE)
 163     {
 164         DrawText(text, pt.x, pt.y, use16bit);
 165     }
 166
 167     virtual bool CanGetTextExtent(void) const ;
 168     virtual void GetTextExtent( const wxString &string, long *width, long *height,
 169                      long *descent = NULL, long *externalLeading = NULL,
 170                      wxFont *theFont = NULL, bool use16 = FALSE ) const ;
 171     virtual void GetTextExtent( const wxString &string, int *width, int *height,
 172                      int *descent = NULL, int *externalLeading = NULL,
 173                      wxFont *theFont = NULL, bool use16 = FALSE ) const
 174     {
 175         long lwidth,lheight,ldescent,lexternal ;
 176         GetTextExtent( string, &lwidth,&lheight,&ldescent,&lexternal,theFont,use16 ) ;
 177         *width = lwidth ;
 178         *height = lheight ;
 179         if (descent) *descent = ldescent ;
 180         if (externalLeading) *externalLeading = lexternal ;
 181     }
 182     virtual wxCoord GetCharWidth(void) const;
 183     virtual wxCoord GetCharHeight(void) const;
 184
 185     virtual void Clear(void);
 186
 187     virtual void SetFont( const wxFont &font );
 188     virtual wxFont& GetFont(void) const { return (wxFont&) m_font; };
 189
 190     virtual void SetPen( const wxPen &pen );
 191     virtual wxPen& GetPen(void) const { return (wxPen&) m_pen; };
 192
 193     virtual void SetBrush( const wxBrush &brush );
 194     virtual wxBrush& GetBrush(void) const { return (wxBrush&) m_brush; };
 195
 196     virtual void SetBackground( const wxBrush &brush );
 197     virtual wxBrush& GetBackground(void) const { return (wxBrush&) m_backgroundBrush; };
 198
 199     virtual void SetLogicalFunction( int function );
 200     virtual int GetLogicalFunction(void) const { return m_logicalFunction; };
 201
 202     virtual void SetTextForeground( const wxColour &col );
 203     virtual void SetTextBackground( const wxColour &col );
 204     virtual wxColour& GetTextBackground(void) const { return (wxColour&)m_textBackgroundColour; };
 205     virtual wxColour& GetTextForeground(void) const { return (wxColour&)m_textForegroundColour; };
 206
 207     virtual void SetBackgroundMode( int mode );
 208     virtual int GetBackgroundMode(void) const { return m_backgroundMode; };
 209
 210     virtual void SetPalette( const wxPalette& palette );
 211     void SetColourMap( const wxPalette& palette ) { SetPalette(palette); };
 212
 213     // the first two must be overridden and called
 214     virtual void SetClippingRegion( wxCoord x, wxCoord y, wxCoord width, wxCoord height );
 215     virtual void SetClippingRegion( const wxRect& rect );
 216     virtual void DestroyClippingRegion(void);
 217     virtual void GetClippingBox( wxCoord *x, wxCoord *y, wxCoord *width, wxCoord *height ) const;
 218     virtual void GetClippingBox( long *x, long *y, long *width, long *height ) const;
 219     virtual void GetClippingBox(wxRect& rect) const;
 220
 221     virtual inline long MinX(void) const { return m_minX; }
 222     virtual inline long MaxX(void) const { return m_maxX; }
 223     virtual inline long MinY(void) const { return m_minY; }
 224     virtual inline long MaxY(void) const { return m_maxY; }
 225
 226     virtual void GetSize( int* width, int* height ) const;
 227     inline wxSize GetSize(void) const { int w, h; GetSize(&w, &h); return wxSize(w, h); }
 228     virtual void GetSizeMM( long* width, long* height ) const;
 229
 230     virtual bool StartDoc( const wxString& WXUNUSED(message) ) { return TRUE; };
 231     virtual void EndDoc(void) {};
 232     virtual void StartPage(void) {};
 233     virtual void EndPage(void) {};
 234
 235     virtual void SetMapMode( int mode );
 236     virtual int GetMapMode(void) const { return m_mappingMode; };
 237
 238     virtual void SetUserScale( double x, double y );
 239     virtual void GetUserScale( double *x, double *y );
 240     virtual void SetLogicalScale( double x, double y );
 241     virtual void GetLogicalScale( double *x, double *y );
 242
 243     virtual void SetLogicalOrigin( long x, long y );
 244     virtual void GetLogicalOrigin( long *x, long *y );
 245     virtual void SetDeviceOrigin( long x, long y );
 246     virtual void GetDeviceOrigin( long *x, long *y );
 247     virtual void SetInternalDeviceOrigin( long x, long y );
 248     virtual void GetInternalDeviceOrigin( long *x, long *y );
 249
 250     virtual void SetAxisOrientation( bool xLeftRight, bool yBottomUp );
 251
 252     virtual void SetOptimization( bool WXUNUSED(optimize) ) {};
 253     virtual bool GetOptimization(void) { return m_optimize; };
 254
 255     virtual long DeviceToLogicalX(long x) const;
 256     virtual long DeviceToLogicalY(long y) const;
 257     virtual long DeviceToLogicalXRel(long x) const;
 258     virtual long DeviceToLogicalYRel(long y) const;
 259     virtual long LogicalToDeviceX(long x) const;
 260     virtual long LogicalToDeviceY(long y) const;
 261     virtual long LogicalToDeviceXRel(long x) const;
 262     virtual long LogicalToDeviceYRel(long y) const;
 263
 264   public:
 265
 266     void CalcBoundingBox( long x, long y );
 267     void ComputeScaleAndOrigin(void);
 268
 269     long XDEV2LOG(long x) const
 270         {
 271           long new_x = x - m_deviceOriginX;
 272           if (new_x > 0)
 273             return (long)((double)(new_x) / m_scaleX + 0.5) * m_signX + m_logicalOriginX;
 274           else
 275             return (long)((double)(new_x) / m_scaleX - 0.5) * m_signX + m_logicalOriginX;
 276         }
 277     long XDEV2LOGREL(long x) const
 278         {
 279           if (x > 0)
 280             return (long)((double)(x) / m_scaleX + 0.5);
 281           else
 282             return (long)((double)(x) / m_scaleX - 0.5);
 283         }
 284     long YDEV2LOG(long y) const
 285         {
 286           long new_y = y - m_deviceOriginY;
 287           if (new_y > 0)
 288             return (long)((double)(new_y) / m_scaleY + 0.5) * m_signY + m_logicalOriginY;
 289           else
 290             return (long)((double)(new_y) / m_scaleY - 0.5) * m_signY + m_logicalOriginY;
 291         }
 292     long YDEV2LOGREL(long y) const
 293         {
 294           if (y > 0)
 295             return (long)((double)(y) / m_scaleY + 0.5);
 296           else
 297             return (long)((double)(y) / m_scaleY - 0.5);
 298         }
 299     long XLOG2DEV(long x) const
 300         {
 301           long new_x = x - m_logicalOriginX;
 302           if (new_x > 0)
 303             return (long)((double)(new_x) * m_scaleX + 0.5) * m_signX + m_deviceOriginX;
 304           else
 305             return (long)((double)(new_x) * m_scaleX - 0.5) * m_signX + m_deviceOriginX;
 306         }
 307     long XLOG2DEVREL(long x) const
 308         {
 309           if (x > 0)
 310             return (long)((double)(x) * m_scaleX + 0.5);
 311           else
 312             return (long)((double)(x) * m_scaleX - 0.5);
 313         }
 314     long YLOG2DEV(long y) const
 315         {
 316           long new_y = y - m_logicalOriginY;
 317           if (new_y > 0)
 318             return (long)((double)(new_y) * m_scaleY + 0.5) * m_signY + m_deviceOriginY;
 319           else
 320             return (long)((double)(new_y) * m_scaleY - 0.5) * m_signY + m_deviceOriginY;
 321         }
 322     long YLOG2DEVREL(long y) const
 323         {
 324           if (y > 0)
 325             return (long)((double)(y) * m_scaleY + 0.5);
 326           else
 327             return (long)((double)(y) * m_scaleY - 0.5);
 328         }
 329
 330   public:
 331
 332     bool         m_ok;
 333     bool         m_colour;
 334
 335     // not sure, what these mean
 336     bool         m_clipping;      // Is clipping on right now ?
 337     bool         m_isInteractive; // Is GetPixel possible ?
 338     bool         m_autoSetting;   // wxMSW only ?
 339     bool         m_dontDelete;    // wxMSW only ?
 340     bool         m_optimize;      // wxMSW only ?
 341     wxString     m_filename;      // Not sure where this belongs.
 342
 343     wxPen        m_pen;
 344     wxBrush      m_brush;
 345     wxBrush      m_backgroundBrush;
 346     wxColour     m_textForegroundColour;
 347     wxColour     m_textBackgroundColour;
 348     wxFont       m_font;
 349
 350     int          m_logicalFunction;
 351     int          m_backgroundMode;
 352     int          m_textAlignment;    // gone in wxWin 2.0 ?
 353
 354     int          m_mappingMode;
 355
 356     // not sure what for, but what is a mm on a screen you don't know the size of?
 357     double       m_mm_to_pix_x,m_mm_to_pix_y;
 358
 359     long         m_internalDeviceOriginX,m_internalDeviceOriginY;   // If un-scrolled is non-zero or
 360                                                                     // d.o. changes with scrolling.
 361                                                                     // Set using SetInternalDeviceOrigin().
 362
 363     long         m_externalDeviceOriginX,m_externalDeviceOriginY;   // To be set by external classes
 364                                                                     // such as wxScrolledWindow
 365                                                                     // using SetDeviceOrigin()
 366
 367     long         m_deviceOriginX,m_deviceOriginY;                   // Sum of the two above.
 368
 369     long         m_logicalOriginX,m_logicalOriginY;                 // User defined.
 370
 371     double       m_scaleX,m_scaleY;
 372     double       m_logicalScaleX,m_logicalScaleY;
 373     double       m_userScaleX,m_userScaleY;
 374     long         m_signX,m_signY;
 375
 376     bool         m_needComputeScaleX,m_needComputeScaleY;         // not yet used
 377
 378     float        m_scaleFactor;  // wxPSDC wants to have this. Will disappear.
 379
 380     long         m_clipX1,m_clipY1,m_clipX2,m_clipY2;
 381     long         m_minX,m_maxX,m_minY,m_maxY;
 382
 383 //begin wxmac
 384         GrafPtr                         m_macPort ;
 385         GWorldPtr                       m_macMask ;
 386
 387         // in order to preserve the const inheritance of the virtual functions, we have to
 388         // use mutable variables starting from CWPro 5
 389
 390         void                                    MacInstallFont() const ;
 391         void                                    MacInstallPen() const ;
 392         void                                    MacInstallBrush() const ;
 393
 394         mutable bool    m_macFontInstalled ;
 395         mutable bool    m_macPenInstalled ;
 396         mutable bool    m_macBrushInstalled ;
 397
 398         mutable long    m_macPortId ;
 399         GrafPtr                         m_macOrigPort ;
 400         Rect                                    m_macClipRect ;
 401         Point                                   m_macLocalOrigin ;
 402
 403         void                                    MacSetupPort() const ;
 404         void                                    MacVerifySetup() const { if ( m_macPortId != m_macCurrentPortId ) MacSetupPort() ; }
 405
 406         static long m_macCurrentPortId ;
 407 };
 408
 409 #endif
 410     // _WX_DC_H_