include/wx/cocoa/bitmap.h

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        include/wx/cocoa/bitmap.h
   3 // Purpose:     wxBitmap class
   4 // Author:      David Elliott
   5 // Modified by:
   6 // Created:     2003/07/19
   7 // RCS-ID:      $Id$
   8 // Copyright:   (c) 2003 David Elliott
   9 // Licence:     wxWindows licence
  10 /////////////////////////////////////////////////////////////////////////////
  11
  12 #ifndef __WX_COCOA_BITMAP_H__
  13 #define __WX_COCOA_BITMAP_H__
  14
  15 #include "wx/palette.h"
  16
  17 // Bitmap
  18 class WXDLLEXPORT wxBitmap;
  19 class WXDLLEXPORT wxIcon;
  20 class WXDLLEXPORT wxCursor;
  21 class WXDLLEXPORT wxImage;
  22 class WXDLLEXPORT wxPixelDataBase;
  23
  24 // ========================================================================
  25 // wxMask
  26 // ========================================================================
  27
  28 // A mask is a 1-bit alpha bitmap used for drawing bitmaps transparently.
  29 class WXDLLEXPORT wxMask: public wxObject
  30 {
  31     DECLARE_DYNAMIC_CLASS(wxMask)
  32 public:
  33     wxMask();
  34
  35     // Construct a mask from a bitmap and a colour indicating
  36     // the transparent area
  37     wxMask(const wxBitmap& bitmap, const wxColour& colour);
  38
  39     // Construct a mask from a bitmap and a palette index indicating
  40     // the transparent area
  41     wxMask(const wxBitmap& bitmap, int paletteIndex);
  42
  43     // Construct a mask from a mono bitmap (copies the bitmap).
  44     wxMask(const wxBitmap& bitmap);
  45
  46     ~wxMask();
  47
  48     bool Create(const wxBitmap& bitmap, const wxColour& colour);
  49     bool Create(const wxBitmap& bitmap, int paletteIndex);
  50     bool Create(const wxBitmap& bitmap);
  51
  52     // wxCocoa
  53     inline WX_NSBitmapImageRep GetNSBitmapImageRep()
  54     {   return m_cocoaNSBitmapImageRep; }
  55 protected:
  56     WX_NSBitmapImageRep m_cocoaNSBitmapImageRep;
  57 };
  58
  59 // ========================================================================
  60 // wxBitmap
  61 // ========================================================================
  62 class WXDLLEXPORT wxBitmap: public wxGDIObject
  63 {
  64     DECLARE_DYNAMIC_CLASS(wxBitmap)
  65 // ------------------------------------------------------------------------
  66 // initialization
  67 // ------------------------------------------------------------------------
  68 public:
  69     // Platform-specific default constructor
  70     wxBitmap();
  71     // Copy constructors
  72     wxBitmap(const wxBitmap& bitmap)
  73     :   wxGDIObject()
  74     {   Ref(bitmap); }
  75     // Initialize with raw data.
  76     wxBitmap(const char bits[], int width, int height, int depth = 1);
  77     // Initialize with XPM data
  78     wxBitmap(const char **bits) { CreateFromXpm(bits); }
  79     wxBitmap(char **bits) { CreateFromXpm((const char**)bits); }
  80     // Load a file or resource
  81     wxBitmap(const wxString& name, wxBitmapType type = wxBITMAP_TYPE_BMP_RESOURCE);
  82     // Constructor for generalised creation from data
  83     wxBitmap(void *data, wxBitmapType type, int width, int height, int depth = 1);
  84     // If depth is omitted, will create a bitmap compatible with the display
  85     wxBitmap(int width, int height, int depth = -1);
  86     // Convert from wxImage:
  87     wxBitmap(const wxImage& image, int depth = -1)
  88     {   CreateFromImage(image, depth); }
  89     // destructor
  90     ~wxBitmap();
  91
  92 // ------------------------------------------------------------------------
  93 // Implementation
  94 // ------------------------------------------------------------------------
  95 public:
  96     // Initialize with XPM data
  97     bool CreateFromXpm(const char **bits);
  98     // Initialize from wxImage
  99     bool CreateFromImage(const wxImage& image, int depth=-1);
 100
 101     virtual bool Create(int width, int height, int depth = -1);
 102     virtual bool Create(void *data, wxBitmapType type, int width, int height, int depth = 1);
 103     virtual bool LoadFile(const wxString& name, wxBitmapType type = wxBITMAP_TYPE_BMP_RESOURCE);
 104     virtual bool SaveFile(const wxString& name, wxBitmapType type, const wxPalette *cmap = NULL) const;
 105
 106     // copies the contents and mask of the given (colour) icon to the bitmap
 107     virtual bool CopyFromIcon(const wxIcon& icon);
 108
 109     wxImage ConvertToImage() const;
 110
 111     // get the given part of bitmap
 112     wxBitmap GetSubBitmap( const wxRect& rect ) const;
 113
 114     bool Ok() const;
 115     int GetWidth() const;
 116     int GetHeight() const;
 117     int GetDepth() const;
 118     int GetQuality() const;
 119     void SetWidth(int w);
 120     void SetHeight(int h);
 121     void SetDepth(int d);
 122     void SetQuality(int q);
 123     void SetOk(bool isOk);
 124
 125     // raw bitmap access support functions
 126     void *GetRawData(wxPixelDataBase& data, int bpp);
 127     void UngetRawData(wxPixelDataBase& data);
 128
 129     wxPalette* GetPalette() const;
 130     void SetPalette(const wxPalette& palette);
 131
 132     wxMask *GetMask() const;
 133     void SetMask(wxMask *mask) ;
 134
 135     int GetBitmapType() const;
 136
 137     inline wxBitmap& operator = (const wxBitmap& bitmap)
 138     {   if (*this == bitmap) return (*this); Ref(bitmap); return *this; }
 139     inline bool operator == (const wxBitmap& bitmap) const
 140     {   return m_refData == bitmap.m_refData; }
 141     inline bool operator != (const wxBitmap& bitmap) const
 142     {   return m_refData != bitmap.m_refData; }
 143
 144     // wxObjectRefData
 145     wxObjectRefData *CreateRefData() const;
 146     wxObjectRefData *CloneRefData(const wxObjectRefData *data) const;
 147
 148     // wxCocoa
 149     WX_NSBitmapImageRep GetNSBitmapImageRep();
 150     void SetNSBitmapImageRep(WX_NSBitmapImageRep bitmapImageRep);
 151     WX_NSImage GetNSImage(bool useMask) const;
 152
 153     static void InitStandardHandlers() { }
 154     static void CleanUpHandlers() { }
 155 };
 156
 157 #endif // __WX_COCOA_BITMAP_H__