include/wx/x11/bitmap.h

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        x11/bitmap.h
   3 // Purpose:     wxBitmap class
   4 // Author:      Julian Smart, Robert Roebling
   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_BITMAP_H_
  13 #define _WX_BITMAP_H_
  14
  15 #include "wx/defs.h"
  16 #include "wx/object.h"
  17 #include "wx/string.h"
  18 #include "wx/palette.h"
  19 #include "wx/gdiobj.h"
  20
  21 //-----------------------------------------------------------------------------
  22 // classes
  23 //-----------------------------------------------------------------------------
  24
  25 class WXDLLIMPEXP_FWD_CORE wxMask;
  26 class WXDLLIMPEXP_FWD_CORE wxBitmap;
  27 class WXDLLIMPEXP_FWD_CORE wxImage;
  28
  29 //-----------------------------------------------------------------------------
  30 // wxMask
  31 //-----------------------------------------------------------------------------
  32
  33 class WXDLLIMPEXP_CORE wxMask: public wxObject
  34 {
  35 public:
  36     wxMask();
  37     wxMask( const wxBitmap& bitmap, const wxColour& colour );
  38     wxMask( const wxBitmap& bitmap, int paletteIndex );
  39     wxMask( const wxBitmap& bitmap );
  40     virtual ~wxMask();
  41
  42     bool Create( const wxBitmap& bitmap, const wxColour& colour );
  43     bool Create( const wxBitmap& bitmap, int paletteIndex );
  44     bool Create( const wxBitmap& bitmap );
  45
  46     // implementation
  47     WXPixmap GetBitmap() const              { return m_bitmap; }
  48     void SetBitmap( WXPixmap bitmap )       { m_bitmap = bitmap; }
  49
  50     WXDisplay *GetDisplay() const           { return m_display; }
  51     void SetDisplay( WXDisplay *display )   { m_display = display; }
  52
  53 private:
  54     WXPixmap    m_bitmap;
  55     WXDisplay  *m_display;
  56
  57 private:
  58     DECLARE_DYNAMIC_CLASS(wxMask)
  59 };
  60
  61 //-----------------------------------------------------------------------------
  62 // wxBitmap
  63 //-----------------------------------------------------------------------------
  64
  65 class WXDLLIMPEXP_CORE wxBitmap: public wxBitmapBase
  66 {
  67 public:
  68     wxBitmap();
  69     wxBitmap( int width, int height, int depth = -1 );
  70     wxBitmap( const char bits[], int width, int height, int depth = 1 );
  71     wxBitmap( const char* const* bits );
  72 #ifdef wxNEEDS_CHARPP
  73     // needed for old GCC
  74     wxBitmap(char** data)
  75     {
  76         *this = wxBitmap(const_cast<const char* const*>(data));
  77     }
  78 #endif
  79     wxBitmap( const wxString &filename, wxBitmapType type = wxBITMAP_DEFAULT_TYPE );
  80     virtual ~wxBitmap();
  81
  82     static void InitStandardHandlers();
  83
  84     bool Create(int width, int height, int depth = -1);
  85     bool Create(const void* data, wxBitmapType type,
  86                 int width, int height, int depth = -1);
  87     // create the wxBitmap using a _copy_ of the pixmap
  88     bool Create(WXPixmap pixmap);
  89
  90     int GetHeight() const;
  91     int GetWidth() const;
  92     int GetDepth() const;
  93
  94 #if wxUSE_IMAGE
  95     wxBitmap( const wxImage& image, int depth = -1 ) { (void)CreateFromImage(image, depth); }
  96     wxImage ConvertToImage() const;
  97     bool CreateFromImage(const wxImage& image, int depth = -1);
  98 #endif // wxUSE_IMAGE
  99
 100     // copies the contents and mask of the given (colour) icon to the bitmap
 101     virtual bool CopyFromIcon(const wxIcon& icon);
 102
 103     wxMask *GetMask() const;
 104     void SetMask( wxMask *mask );
 105
 106     wxBitmap GetSubBitmap( const wxRect& rect ) const;
 107
 108     bool SaveFile( const wxString &name, wxBitmapType type, const wxPalette *palette = (wxPalette *) NULL ) const;
 109     bool LoadFile( const wxString &name, wxBitmapType type = wxBITMAP_DEFAULT_TYPE );
 110
 111     wxPalette *GetPalette() const;
 112     wxPalette *GetColourMap() const
 113         { return GetPalette(); };
 114     virtual void SetPalette(const wxPalette& palette);
 115
 116     // implementation
 117     // --------------
 118
 119     void SetHeight( int height );
 120     void SetWidth( int width );
 121     void SetDepth( int depth );
 122     void SetPixmap( WXPixmap pixmap );
 123     void SetBitmap( WXPixmap bitmap );
 124
 125     WXPixmap GetPixmap() const;
 126     WXPixmap GetBitmap() const;
 127
 128     WXPixmap GetDrawable() const;
 129
 130     WXDisplay *GetDisplay() const;
 131
 132 protected:
 133     virtual wxGDIRefData *CreateGDIRefData() const;
 134     virtual wxGDIRefData *CloneGDIRefData(const wxGDIRefData *data) const;
 135
 136 private:
 137     DECLARE_DYNAMIC_CLASS(wxBitmap)
 138 };
 139
 140 #endif // _WX_BITMAP_H_