include/wx/x11/region.h

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        region.h
   3 // Purpose:     wxRegion class
   4 // Author:      Julian Smart
   5 // Modified by:
   6 // Created:     17/09/98
   7 // RCS-ID:      $Id$
   8 // Copyright:   (c) Julian Smart, Robert Roebling
   9 // Licence:     wxWindows licence
  10 /////////////////////////////////////////////////////////////////////////////
  11
  12 #ifndef _WX_REGION_H_
  13 #define _WX_REGION_H_
  14
  15 #ifdef __GNUG__
  16 #pragma interface "region.h"
  17 #endif
  18
  19 #include "wx/list.h"
  20 #include "wx/gdiobj.h"
  21 #include "wx/gdicmn.h"
  22
  23 //-----------------------------------------------------------------------------
  24 // classes
  25 //-----------------------------------------------------------------------------
  26
  27 class wxRegion;
  28
  29 //-----------------------------------------------------------------------------
  30 // constants
  31 //-----------------------------------------------------------------------------
  32
  33 enum wxRegionContain
  34 {
  35     wxOutRegion = 0,
  36     wxPartRegion = 1,
  37     wxInRegion = 2
  38 };
  39
  40 // So far, for internal use only
  41 enum wxRegionOp
  42 {
  43    wxRGN_AND,          // Creates the intersection of the two combined regions.
  44    wxRGN_COPY,         // Creates a copy of the region identified by hrgnSrc1.
  45    wxRGN_DIFF,         // Combines the parts of hrgnSrc1 that are not part of hrgnSrc2.
  46    wxRGN_OR,           // Creates the union of two combined regions.
  47    wxRGN_XOR           // Creates the union of two combined regions except for any overlapping areas.
  48 };
  49
  50 // ----------------------------------------------------------------------------
  51 // wxRegion
  52 // ----------------------------------------------------------------------------
  53
  54 class wxRegion : public wxGDIObject
  55 {
  56 public:
  57     wxRegion() { }
  58
  59     wxRegion( wxCoord x, wxCoord y, wxCoord w, wxCoord h )
  60     {
  61         InitRect(x, y, w, h);
  62     }
  63
  64     wxRegion( const wxPoint& topLeft, const wxPoint& bottomRight )
  65     {
  66         InitRect(topLeft.x, topLeft.y,
  67                  bottomRight.x - topLeft.x, bottomRight.y - topLeft.y);
  68     }
  69
  70     wxRegion( const wxRect& rect )
  71     {
  72         InitRect(rect.x, rect.y, rect.width, rect.height);
  73     }
  74
  75     wxRegion( size_t n, const wxPoint *points, int fillStyle = wxODDEVEN_RULE );
  76     ~wxRegion();
  77
  78     wxRegion( const wxRegion& region ) { Ref(region); }
  79     wxRegion& operator = ( const wxRegion& region ) { Ref(region); return *this; }
  80
  81     bool Ok() const { return m_refData != NULL; }
  82
  83     bool operator == ( const wxRegion& region );
  84     bool operator != ( const wxRegion& region ) { return !(*this == region); }
  85
  86     void Clear();
  87
  88     bool Offset( wxCoord x, wxCoord y );
  89
  90     bool Union( wxCoord x, wxCoord y, wxCoord width, wxCoord height );
  91     bool Union( const wxRect& rect );
  92     bool Union( const wxRegion& region );
  93
  94     bool Intersect( wxCoord x, wxCoord y, wxCoord width, wxCoord height );
  95     bool Intersect( const wxRect& rect );
  96     bool Intersect( const wxRegion& region );
  97
  98     bool Subtract( wxCoord x, wxCoord y, wxCoord width, wxCoord height );
  99     bool Subtract( const wxRect& rect );
 100     bool Subtract( const wxRegion& region );
 101
 102     bool Xor( wxCoord x, wxCoord y, wxCoord width, wxCoord height );
 103     bool Xor( const wxRect& rect );
 104     bool Xor( const wxRegion& region );
 105
 106     void GetBox( wxCoord& x, wxCoord& y, wxCoord&w, wxCoord &h ) const;
 107     wxRect GetBox() const ;
 108
 109     bool Empty() const;
 110     bool IsEmpty() const { return Empty(); }
 111
 112     wxRegionContain Contains( wxCoord x, wxCoord y ) const;
 113     wxRegionContain Contains( wxCoord x, wxCoord y, wxCoord w, wxCoord h ) const;
 114     wxRegionContain Contains(const wxPoint& pt) const;
 115     wxRegionContain Contains(const wxRect& rect) const;
 116
 117 public:
 118     WXRegion *GetX11Region() const;
 119
 120 protected:
 121     // ref counting code
 122     virtual wxObjectRefData *CreateRefData() const;
 123     virtual wxObjectRefData *CloneRefData(const wxObjectRefData *data) const;
 124
 125     // common part of ctors for a rectangle region
 126     void InitRect(wxCoord x, wxCoord y, wxCoord w, wxCoord h);
 127
 128 private:
 129     DECLARE_DYNAMIC_CLASS(wxRegion);
 130 };
 131
 132 // ----------------------------------------------------------------------------
 133 // wxRegionIterator: decomposes a region into rectangles
 134 // ----------------------------------------------------------------------------
 135
 136 class wxRegionIterator: public wxObject
 137 {
 138 public:
 139     wxRegionIterator();
 140     wxRegionIterator(const wxRegion& region);
 141
 142     void Reset() { m_current = 0u; }
 143     void Reset(const wxRegion& region);
 144
 145     operator bool () const;
 146     bool HaveRects() const;
 147
 148     void operator ++ ();
 149     void operator ++ (int);
 150
 151     wxCoord GetX() const;
 152     wxCoord GetY() const;
 153     wxCoord GetW() const;
 154     wxCoord GetWidth() const { return GetW(); }
 155     wxCoord GetH() const;
 156     wxCoord GetHeight() const { return GetH(); }
 157     wxRect GetRect() const;
 158
 159 private:
 160     size_t   m_current;
 161     wxRegion m_region;
 162
 163 private:
 164     DECLARE_DYNAMIC_CLASS(wxRegionIterator);
 165 };
 166
 167 #endif
 168 // _WX_REGION_H_