wxPython/src/_image.i

/////////////////////////////////////////////////////////////////////////////
// Name:        _image.i
// Purpose:     SWIG definitions for wxImage and such
//
// Author:      Robin Dunn
//
// Created:     25-Sept-2000
// RCS-ID:      $Id$
// Copyright:   (c) 2003 by Total Control Software
// Licence:     wxWindows license
/////////////////////////////////////////////////////////////////////////////

// Not a %module


//---------------------------------------------------------------------------

%{
#include "wx/wxPython/pyistream.h"
%}

//---------------------------------------------------------------------------
%newgroup


class wxImageHandler : public wxObject {
public:
    // wxImageHandler();    Abstract Base Class
    wxString GetName();
    wxString GetExtension();
    long GetType();
    wxString GetMimeType();

    //bool LoadFile(wxImage* image, wxInputStream& stream);
    //bool SaveFile(wxImage* image, wxOutputStream& stream);
    //virtual int GetImageCount( wxInputStream& stream );
    //bool CanRead( wxInputStream& stream );

    bool CanRead( const wxString& name );

    void SetName(const wxString& name);
    void SetExtension(const wxString& extension);
    void SetType(long type);
    void SetMimeType(const wxString& mimetype);
};


//---------------------------------------------------------------------------

class wxImageHistogram /* : public wxImageHistogramBase */
{
public:
    wxImageHistogram();

    DocStr(MakeKey, "Get the key in the histogram for the given RGB values");
    static unsigned long MakeKey(unsigned char r,
                                 unsigned char g,
                                 unsigned char b);

    DocDeclAStr(
        bool, FindFirstUnusedColour(unsigned char *OUTPUT,
                                    unsigned char *OUTPUT,
                                    unsigned char *OUTPUT,
                                    unsigned char startR = 1,
                                    unsigned char startG = 0,
                                    unsigned char startB = 0 ) const,
        "FindFirstUnusedColour(int startR=1, int startG=0, int startB=0) -> (success, r, g, b)",
        "Find first colour that is not used in the image and has higher RGB values than\n"
        "startR, startG, startB.  Returns a tuple consisting of a success flag and rgb\n"
        "values.");
};


//---------------------------------------------------------------------------


class wxImage : public wxObject {
public:
    wxImage( const wxString& name, long type = wxBITMAP_TYPE_ANY, int index = -1 );
    ~wxImage();

    // Alternate constructors
    %name(ImageFromMime) wxImage(const wxString& name, const wxString& mimetype, int index = -1);
    %name(ImageFromStream) wxImage(wxInputStream& stream, long type = wxBITMAP_TYPE_ANY, int index = -1);
    %name(ImageFromStreamMime) wxImage(wxInputStream& stream, const wxString& mimetype, int index = -1 );


    %extend {

        %nokwargs wxImage(int width=0, int height=0, bool clear = True);
        %nokwargs wxImage(const wxSize& size, bool clear = True);
        %name(EmptyImage) wxImage(int width=0, int height=0, bool clear = True) {
            if (width > 0 && height > 0)
                return new wxImage(width, height, clear);
            else
                return new wxImage;
        }
        %name(EmptyImage) wxImage(const wxSize& size, bool clear = True) {
            return new wxImage(size.x, size.y, clear);
        }


        %name(ImageFromBitmap) wxImage(const wxBitmap &bitmap) {
            return new wxImage(bitmap.ConvertToImage());
        }

        %name(ImageFromData) wxImage(int width, int height, unsigned char* data) {
            // Copy the source data so the wxImage can clean it up later
            unsigned char* copy = (unsigned char*)malloc(width*height*3);
            if (copy == NULL) {
                PyErr_NoMemory();
                return NULL;
            }
            memcpy(copy, data, width*height*3);
            return new wxImage(width, height, copy, False);
        }
    }

    void Create( int width, int height );
    void Destroy();

    wxImage Scale( int width, int height );
    wxImage ShrinkBy( int xFactor , int yFactor ) const ;
    wxImage& Rescale(int width, int height);

    void SetRGB( int x, int y, unsigned char r, unsigned char g, unsigned char b );
    unsigned char GetRed( int x, int y );
    unsigned char GetGreen( int x, int y );
    unsigned char GetBlue( int x, int y );

    void SetAlpha(int x, int y, unsigned char alpha);
    unsigned char GetAlpha(int x, int y);
    bool HasAlpha();

    // find first colour that is not used in the image and has higher
    // RGB values than <startR,startG,startB>
    DocDeclAStr(
        bool, FindFirstUnusedColour( byte *OUTPUT, byte *OUTPUT, byte *OUTPUT,
                                     byte startR = 0, byte startG = 0, byte startB = 0 ) const,
        "FindFirstUnusedColour(int startR=1, int startG=0, int startB=0) -> (success, r, g, b)",
        "Find first colour that is not used in the image and has higher RGB values than\n"
        "startR, startG, startB.  Returns a tuple consisting of a success flag and rgb\n"
        "values.");


    // Set image's mask to the area of 'mask' that has <mr,mg,mb> colour
    bool SetMaskFromImage(const wxImage & mask,
                          byte mr, byte mg, byte mb);

//      void DoFloodFill (wxCoord x, wxCoord y,
//          const wxBrush & fillBrush,
//          const wxColour& testColour,
//          int style = wxFLOOD_SURFACE,
//          int LogicalFunction = wxCOPY /* currently unused */ ) ;

    static bool CanRead( const wxString& name );
    static int GetImageCount( const wxString& name, long type = wxBITMAP_TYPE_ANY );

    bool LoadFile( const wxString& name, long type = wxBITMAP_TYPE_ANY, int index = -1 );
    %name(LoadMimeFile)bool LoadFile( const wxString& name, const wxString& mimetype, int index = -1 );

    bool SaveFile( const wxString& name, int type );
    %name(SaveMimeFile)bool SaveFile( const wxString& name, const wxString& mimetype );

    %name(CanReadStream) static bool CanRead( wxInputStream& stream );
    %name(LoadStream) bool LoadFile( wxInputStream& stream, long type = wxBITMAP_TYPE_ANY, int index = -1 );
    %name(LoadMimeStream) bool LoadFile( wxInputStream& stream, const wxString& mimetype, int index = -1 );

    bool Ok();
    int GetWidth();
    int GetHeight();

    %extend {
        wxSize GetSize() {
            wxSize size(self->GetWidth(), self->GetHeight());
            return size;
        }
    }

    wxImage GetSubImage(const wxRect& rect);
    wxImage Copy();
    void Paste( const wxImage &image, int x, int y );

    //unsigned char *GetData();
    //void SetData( unsigned char *data );

    %extend {
        PyObject* GetData() {
            unsigned char* data = self->GetData();
            int len = self->GetWidth() * self->GetHeight() * 3;
            PyObject* rv;
            wxPyBLOCK_THREADS( rv = PyString_FromStringAndSize((char*)data, len));
            return rv;
        }
        void SetData(PyObject* data) {
            unsigned char* dataPtr;

            if (! PyString_Check(data)) {
                PyErr_SetString(PyExc_TypeError, "Expected string object");
                return /* NULL */ ;
            }

            size_t len = self->GetWidth() * self->GetHeight() * 3;
            dataPtr = (unsigned char*) malloc(len);
            wxPyBLOCK_THREADS( memcpy(dataPtr, PyString_AsString(data), len) );
            self->SetData(dataPtr);
            // wxImage takes ownership of dataPtr...
        }


        PyObject* GetDataBuffer() {
            unsigned char* data = self->GetData();
            int len = self->GetWidth() * self->GetHeight() * 3;
            PyObject* rv;
            wxPyBLOCK_THREADS( rv = PyBuffer_FromReadWriteMemory(data, len) );
            return rv;
        }
        void SetDataBuffer(PyObject* data) {
            unsigned char* buffer;
            int size;

            bool blocked = wxPyBeginBlockThreads();
            if (!PyArg_Parse(data, "t#", &buffer, &size))
                goto done;

            if (size != self->GetWidth() * self->GetHeight() * 3) {
                PyErr_SetString(PyExc_TypeError, "Incorrect buffer size");
                goto done;
            }
            self->SetData(buffer);
        done:
            wxPyEndBlockThreads(blocked);
        }


        PyObject* GetAlphaData() {
            unsigned char* data = self->GetAlpha();
            if (! data) {
                RETURN_NONE();
            } else {
                int len = self->GetWidth() * self->GetHeight();
                PyObject* rv;
                wxPyBLOCK_THREADS( rv = PyString_FromStringAndSize((char*)data, len) );
                return rv;
            }
        }
        void SetAlphaData(PyObject* data) {
            unsigned char* dataPtr;

            if (! PyString_Check(data)) {
                PyErr_SetString(PyExc_TypeError, "Expected string object");
                return /* NULL */ ;
            }

            size_t len = self->GetWidth() * self->GetHeight();
            dataPtr = (unsigned char*) malloc(len);
            wxPyBLOCK_THREADS( memcpy(dataPtr, PyString_AsString(data), len) );
            self->SetAlpha(dataPtr);
            // wxImage takes ownership of dataPtr...
        }


        PyObject* GetAlphaBuffer() {
            unsigned char* data = self->GetAlpha();
            int len = self->GetWidth() * self->GetHeight();
            PyObject* rv;
            wxPyBLOCK_THREADS( rv = PyBuffer_FromReadWriteMemory(data, len) );
            return rv;
        }
        void SetAlphaBuffer(PyObject* data) {
            unsigned char* buffer;
            int size;

            bool blocked = wxPyBeginBlockThreads();
            if (!PyArg_Parse(data, "t#", &buffer, &size))
                goto done;

            if (size != self->GetWidth() * self->GetHeight()) {
                PyErr_SetString(PyExc_TypeError, "Incorrect buffer size");
                goto done;
            }
            self->SetAlpha(buffer);
        done:
            wxPyEndBlockThreads(blocked);
        }
    }

    void SetMaskColour( unsigned char r, unsigned char g, unsigned char b );
    unsigned char GetMaskRed();
    unsigned char GetMaskGreen();
    unsigned char GetMaskBlue();
    void SetMask( bool mask = True );
    bool HasMask();

    wxImage Rotate(double angle, const wxPoint & centre_of_rotation,
                   bool interpolating = True, wxPoint * offset_after_rotation = NULL) const ;
    wxImage Rotate90( bool clockwise = True ) ;
    wxImage Mirror( bool horizontally = True ) ;

    void Replace( unsigned char r1, unsigned char g1, unsigned char b1,
                  unsigned char r2, unsigned char g2, unsigned char b2 );

    // convert to monochrome image (<r,g,b> will be replaced by white, everything else by black)
    wxImage ConvertToMono( unsigned char r, unsigned char g, unsigned char b ) const;

    void SetOption(const wxString& name, const wxString& value);
    %name(SetOptionInt)void SetOption(const wxString& name, int value);
    wxString GetOption(const wxString& name) const;
    int GetOptionInt(const wxString& name) const;
    bool HasOption(const wxString& name) const;

    unsigned long CountColours( unsigned long stopafter = (unsigned long) -1 );
    unsigned long ComputeHistogram( wxImageHistogram& h );

    static void AddHandler( wxImageHandler *handler );
    static void InsertHandler( wxImageHandler *handler );
    static bool RemoveHandler( const wxString& name );
    static wxString GetImageExtWildcard();


    %extend {
        wxBitmap ConvertToBitmap() {
            wxBitmap bitmap(*self);
            return bitmap;
        }

        wxBitmap ConvertToMonoBitmap( unsigned char red,
                                      unsigned char green,
                                      unsigned char blue ) {
            wxImage mono = self->ConvertToMono( red, green, blue );
            wxBitmap bitmap( mono, 1 );
            return bitmap;
        }
    }

    %pythoncode { def __nonzero__(self): return self.Ok() }
};


void wxInitAllImageHandlers();


// See also wxPy_ReinitStockObjects in helpers.cpp
%immutable;
const wxImage    wxNullImage;
%mutable;

//---------------------------------------------------------------------------


MAKE_CONST_WXSTRING(IMAGE_OPTION_BMP_FORMAT);
MAKE_CONST_WXSTRING(IMAGE_OPTION_CUR_HOTSPOT_X);
MAKE_CONST_WXSTRING(IMAGE_OPTION_CUR_HOTSPOT_Y);
MAKE_CONST_WXSTRING(IMAGE_OPTION_RESOLUTION);
MAKE_CONST_WXSTRING(IMAGE_OPTION_RESOLUTIONUNIT);

enum
{
    wxIMAGE_RESOLUTION_INCHES = 1,
    wxIMAGE_RESOLUTION_CM = 2
};


enum
{
    wxBMP_24BPP        = 24, // default, do not need to set
    //wxBMP_16BPP      = 16, // wxQuantize can only do 236 colors?
    wxBMP_8BPP         =  8, // 8bpp, quantized colors
    wxBMP_8BPP_GREY    =  9, // 8bpp, rgb averaged to greys
    wxBMP_8BPP_GRAY    =  wxBMP_8BPP_GREY,
    wxBMP_8BPP_RED     = 10, // 8bpp, red used as greyscale
    wxBMP_8BPP_PALETTE = 11, // 8bpp, use the wxImage's palette
    wxBMP_4BPP         =  4, // 4bpp, quantized colors
    wxBMP_1BPP         =  1, // 1bpp, quantized "colors"
    wxBMP_1BPP_BW      =  2  // 1bpp, black & white from red
};


class wxBMPHandler : public wxImageHandler {
public:
    wxBMPHandler();
};

class wxICOHandler : public wxBMPHandler {
public:
    wxICOHandler();
};

class wxCURHandler : public wxICOHandler {
public:
    wxCURHandler();
};

class wxANIHandler : public wxCURHandler {
public:
    wxANIHandler();
};


//---------------------------------------------------------------------------

class wxPNGHandler : public wxImageHandler {
public:
    wxPNGHandler();
};


class wxGIFHandler : public wxImageHandler {
public:
    wxGIFHandler();
};


class wxPCXHandler : public wxImageHandler {
public:
    wxPCXHandler();
};


class wxJPEGHandler : public wxImageHandler {
public:
    wxJPEGHandler();
};


class wxPNMHandler : public wxImageHandler {
public:
    wxPNMHandler();
};

class wxXPMHandler : public wxImageHandler {
public:
    wxXPMHandler();
};

class wxTIFFHandler : public wxImageHandler {
public:
    wxTIFFHandler();
};


#if wxUSE_IFF
class wxIFFHandler : public wxImageHandler {
public:
    wxIFFHandler();
};
#endif

//---------------------------------------------------------------------------
Commit	Line	Data
	1	/////////////////////////////////////////////////////////////////////////////
	2	// Name: _image.i
	3	// Purpose: SWIG definitions for wxImage and such
	4	//
	5	// Author: Robin Dunn
	6	//
	7	// Created: 25-Sept-2000
	8	// RCS-ID: $Id$
	9	// Copyright: (c) 2003 by Total Control Software
	10	// Licence: wxWindows license
	11	/////////////////////////////////////////////////////////////////////////////
	12
	13	// Not a %module
	14
	15
	16	//---------------------------------------------------------------------------
	17
	18	%{
	19	#include "wx/wxPython/pyistream.h"
	20	%}
	21
	22	//---------------------------------------------------------------------------
	23	%newgroup
	24
	25
	26	class wxImageHandler : public wxObject {
	27	public:
	28	// wxImageHandler(); Abstract Base Class
	29	wxString GetName();
	30	wxString GetExtension();
	31	long GetType();
	32	wxString GetMimeType();
	33
	34	//bool LoadFile(wxImage* image, wxInputStream& stream);
	35	//bool SaveFile(wxImage* image, wxOutputStream& stream);
	36	//virtual int GetImageCount( wxInputStream& stream );
	37	//bool CanRead( wxInputStream& stream );
	38
	39	bool CanRead( const wxString& name );
	40
	41	void SetName(const wxString& name);
	42	void SetExtension(const wxString& extension);
	43	void SetType(long type);
	44	void SetMimeType(const wxString& mimetype);
	45	};
	46
	47
	48	//---------------------------------------------------------------------------
	49
	50	class wxImageHistogram /* : public wxImageHistogramBase */
	51	{
	52	public:
	53	wxImageHistogram();
	54
	55	DocStr(MakeKey, "Get the key in the histogram for the given RGB values");
	56	static unsigned long MakeKey(unsigned char r,
	57	unsigned char g,
	58	unsigned char b);
	59
	60	DocDeclAStr(
	61	bool, FindFirstUnusedColour(unsigned char *OUTPUT,
	62	unsigned char *OUTPUT,
	63	unsigned char *OUTPUT,
	64	unsigned char startR = 1,
	65	unsigned char startG = 0,
	66	unsigned char startB = 0 ) const,
	67	"FindFirstUnusedColour(int startR=1, int startG=0, int startB=0) -> (success, r, g, b)",
	68	"Find first colour that is not used in the image and has higher RGB values than\n"
	69	"startR, startG, startB. Returns a tuple consisting of a success flag and rgb\n"
	70	"values.");
	71	};
	72
	73
	74	//---------------------------------------------------------------------------
	75
	76
	77	class wxImage : public wxObject {
	78	public:
	79	wxImage( const wxString& name, long type = wxBITMAP_TYPE_ANY, int index = -1 );
	80	~wxImage();
	81
	82	// Alternate constructors
	83	%name(ImageFromMime) wxImage(const wxString& name, const wxString& mimetype, int index = -1);
	84	%name(ImageFromStream) wxImage(wxInputStream& stream, long type = wxBITMAP_TYPE_ANY, int index = -1);
	85	%name(ImageFromStreamMime) wxImage(wxInputStream& stream, const wxString& mimetype, int index = -1 );
	86
	87
	88
	89	%extend {
	90
	91	%nokwargs wxImage(int width=0, int height=0, bool clear = True);
	92	%nokwargs wxImage(const wxSize& size, bool clear = True);
	93	%name(EmptyImage) wxImage(int width=0, int height=0, bool clear = True) {
	94	if (width > 0 && height > 0)
	95	return new wxImage(width, height, clear);
	96	else
	97	return new wxImage;
	98	}
	99	%name(EmptyImage) wxImage(const wxSize& size, bool clear = True) {
	100	return new wxImage(size.x, size.y, clear);
	101	}
	102
	103
	104	%name(ImageFromBitmap) wxImage(const wxBitmap &bitmap) {
	105	return new wxImage(bitmap.ConvertToImage());
	106	}
	107
	108	%name(ImageFromData) wxImage(int width, int height, unsigned char* data) {
	109	// Copy the source data so the wxImage can clean it up later
	110	unsigned char* copy = (unsigned char)malloc(widthheight*3);
	111	if (copy == NULL) {
	112	PyErr_NoMemory();
	113	return NULL;
	114	}
	115	memcpy(copy, data, widthheight3);
	116	return new wxImage(width, height, copy, False);
	117	}
	118	}
	119
	120	void Create( int width, int height );
	121	void Destroy();
	122
	123	wxImage Scale( int width, int height );
	124	wxImage ShrinkBy( int xFactor , int yFactor ) const ;
	125	wxImage& Rescale(int width, int height);
	126
	127	void SetRGB( int x, int y, unsigned char r, unsigned char g, unsigned char b );
	128	unsigned char GetRed( int x, int y );
	129	unsigned char GetGreen( int x, int y );
	130	unsigned char GetBlue( int x, int y );
	131
	132	void SetAlpha(int x, int y, unsigned char alpha);
	133	unsigned char GetAlpha(int x, int y);
	134	bool HasAlpha();
	135
	136	// find first colour that is not used in the image and has higher
	137	// RGB values than <startR,startG,startB>
	138	DocDeclAStr(
	139	bool, FindFirstUnusedColour( byte OUTPUT, byte OUTPUT, byte *OUTPUT,
	140	byte startR = 0, byte startG = 0, byte startB = 0 ) const,
	141	"FindFirstUnusedColour(int startR=1, int startG=0, int startB=0) -> (success, r, g, b)",
	142	"Find first colour that is not used in the image and has higher RGB values than\n"
	143	"startR, startG, startB. Returns a tuple consisting of a success flag and rgb\n"
	144	"values.");
	145
	146
	147	// Set image's mask to the area of 'mask' that has <mr,mg,mb> colour
	148	bool SetMaskFromImage(const wxImage & mask,
	149	byte mr, byte mg, byte mb);
	150
	151	// void DoFloodFill (wxCoord x, wxCoord y,
	152	// const wxBrush & fillBrush,
	153	// const wxColour& testColour,
	154	// int style = wxFLOOD_SURFACE,
	155	// int LogicalFunction = wxCOPY /* currently unused */ ) ;
	156
	157	static bool CanRead( const wxString& name );
	158	static int GetImageCount( const wxString& name, long type = wxBITMAP_TYPE_ANY );
	159
	160	bool LoadFile( const wxString& name, long type = wxBITMAP_TYPE_ANY, int index = -1 );
	161	%name(LoadMimeFile)bool LoadFile( const wxString& name, const wxString& mimetype, int index = -1 );
	162
	163	bool SaveFile( const wxString& name, int type );
	164	%name(SaveMimeFile)bool SaveFile( const wxString& name, const wxString& mimetype );
	165
	166	%name(CanReadStream) static bool CanRead( wxInputStream& stream );
	167	%name(LoadStream) bool LoadFile( wxInputStream& stream, long type = wxBITMAP_TYPE_ANY, int index = -1 );
	168	%name(LoadMimeStream) bool LoadFile( wxInputStream& stream, const wxString& mimetype, int index = -1 );
	169
	170	bool Ok();
	171	int GetWidth();
	172	int GetHeight();
	173
	174	%extend {
	175	wxSize GetSize() {
	176	wxSize size(self->GetWidth(), self->GetHeight());
	177	return size;
	178	}
	179	}
	180
	181	wxImage GetSubImage(const wxRect& rect);
	182	wxImage Copy();
	183	void Paste( const wxImage &image, int x, int y );
	184
	185	//unsigned char *GetData();
	186	//void SetData( unsigned char *data );
	187
	188	%extend {
	189	PyObject* GetData() {
	190	unsigned char* data = self->GetData();
	191	int len = self->GetWidth() * self->GetHeight() * 3;
	192	PyObject* rv;
	193	wxPyBLOCK_THREADS( rv = PyString_FromStringAndSize((char*)data, len));
	194	return rv;
	195	}
	196	void SetData(PyObject* data) {
	197	unsigned char* dataPtr;
	198
	199	if (! PyString_Check(data)) {
	200	PyErr_SetString(PyExc_TypeError, "Expected string object");
	201	return /* NULL */ ;
	202	}
	203
	204	size_t len = self->GetWidth() * self->GetHeight() * 3;
	205	dataPtr = (unsigned char*) malloc(len);
	206	wxPyBLOCK_THREADS( memcpy(dataPtr, PyString_AsString(data), len) );
	207	self->SetData(dataPtr);
	208	// wxImage takes ownership of dataPtr...
	209	}
	210
	211
	212
	213	PyObject* GetDataBuffer() {
	214	unsigned char* data = self->GetData();
	215	int len = self->GetWidth() * self->GetHeight() * 3;
	216	PyObject* rv;
	217	wxPyBLOCK_THREADS( rv = PyBuffer_FromReadWriteMemory(data, len) );
	218	return rv;
	219	}
	220	void SetDataBuffer(PyObject* data) {
	221	unsigned char* buffer;
	222	int size;
	223
	224	bool blocked = wxPyBeginBlockThreads();
	225	if (!PyArg_Parse(data, "t#", &buffer, &size))
	226	goto done;
	227
	228	if (size != self->GetWidth() * self->GetHeight() * 3) {
	229	PyErr_SetString(PyExc_TypeError, "Incorrect buffer size");
	230	goto done;
	231	}
	232	self->SetData(buffer);
	233	done:
	234	wxPyEndBlockThreads(blocked);
	235	}
	236
	237
	238
	239	PyObject* GetAlphaData() {
	240	unsigned char* data = self->GetAlpha();
	241	if (! data) {
	242	RETURN_NONE();
	243	} else {
	244	int len = self->GetWidth() * self->GetHeight();
	245	PyObject* rv;
	246	wxPyBLOCK_THREADS( rv = PyString_FromStringAndSize((char*)data, len) );
	247	return rv;
	248	}
	249	}
	250	void SetAlphaData(PyObject* data) {
	251	unsigned char* dataPtr;
	252
	253	if (! PyString_Check(data)) {
	254	PyErr_SetString(PyExc_TypeError, "Expected string object");
	255	return /* NULL */ ;
	256	}
	257
	258	size_t len = self->GetWidth() * self->GetHeight();
	259	dataPtr = (unsigned char*) malloc(len);
	260	wxPyBLOCK_THREADS( memcpy(dataPtr, PyString_AsString(data), len) );
	261	self->SetAlpha(dataPtr);
	262	// wxImage takes ownership of dataPtr...
	263	}
	264
	265
	266
	267	PyObject* GetAlphaBuffer() {
	268	unsigned char* data = self->GetAlpha();
	269	int len = self->GetWidth() * self->GetHeight();
	270	PyObject* rv;
	271	wxPyBLOCK_THREADS( rv = PyBuffer_FromReadWriteMemory(data, len) );
	272	return rv;
	273	}
	274	void SetAlphaBuffer(PyObject* data) {
	275	unsigned char* buffer;
	276	int size;
	277
	278	bool blocked = wxPyBeginBlockThreads();
	279	if (!PyArg_Parse(data, "t#", &buffer, &size))
	280	goto done;
	281
	282	if (size != self->GetWidth() * self->GetHeight()) {
	283	PyErr_SetString(PyExc_TypeError, "Incorrect buffer size");
	284	goto done;
	285	}
	286	self->SetAlpha(buffer);
	287	done:
	288	wxPyEndBlockThreads(blocked);
	289	}
	290	}
	291
	292	void SetMaskColour( unsigned char r, unsigned char g, unsigned char b );
	293	unsigned char GetMaskRed();
	294	unsigned char GetMaskGreen();
	295	unsigned char GetMaskBlue();
	296	void SetMask( bool mask = True );
	297	bool HasMask();
	298
	299	wxImage Rotate(double angle, const wxPoint & centre_of_rotation,
	300	bool interpolating = True, wxPoint * offset_after_rotation = NULL) const ;
	301	wxImage Rotate90( bool clockwise = True ) ;
	302	wxImage Mirror( bool horizontally = True ) ;
	303
	304	void Replace( unsigned char r1, unsigned char g1, unsigned char b1,
	305	unsigned char r2, unsigned char g2, unsigned char b2 );
	306
	307	// convert to monochrome image (<r,g,b> will be replaced by white, everything else by black)
	308	wxImage ConvertToMono( unsigned char r, unsigned char g, unsigned char b ) const;
	309
	310	void SetOption(const wxString& name, const wxString& value);
	311	%name(SetOptionInt)void SetOption(const wxString& name, int value);
	312	wxString GetOption(const wxString& name) const;
	313	int GetOptionInt(const wxString& name) const;
	314	bool HasOption(const wxString& name) const;
	315
	316	unsigned long CountColours( unsigned long stopafter = (unsigned long) -1 );
	317	unsigned long ComputeHistogram( wxImageHistogram& h );
	318
	319	static void AddHandler( wxImageHandler *handler );
	320	static void InsertHandler( wxImageHandler *handler );
	321	static bool RemoveHandler( const wxString& name );
	322	static wxString GetImageExtWildcard();
	323
	324
	325	%extend {
	326	wxBitmap ConvertToBitmap() {
	327	wxBitmap bitmap(*self);
	328	return bitmap;
	329	}
	330
	331	wxBitmap ConvertToMonoBitmap( unsigned char red,
	332	unsigned char green,
	333	unsigned char blue ) {
	334	wxImage mono = self->ConvertToMono( red, green, blue );
	335	wxBitmap bitmap( mono, 1 );
	336	return bitmap;
	337	}
	338	}
	339
	340	%pythoncode { def __nonzero__(self): return self.Ok() }
	341	};
	342
	343
	344
	345	void wxInitAllImageHandlers();
	346
	347
	348	// See also wxPy_ReinitStockObjects in helpers.cpp
	349	%immutable;
	350	const wxImage wxNullImage;
	351	%mutable;
	352
	353	//---------------------------------------------------------------------------
	354
	355
	356	MAKE_CONST_WXSTRING(IMAGE_OPTION_BMP_FORMAT);
	357	MAKE_CONST_WXSTRING(IMAGE_OPTION_CUR_HOTSPOT_X);
	358	MAKE_CONST_WXSTRING(IMAGE_OPTION_CUR_HOTSPOT_Y);
	359	MAKE_CONST_WXSTRING(IMAGE_OPTION_RESOLUTION);
	360	MAKE_CONST_WXSTRING(IMAGE_OPTION_RESOLUTIONUNIT);
	361
	362	enum
	363	{
	364	wxIMAGE_RESOLUTION_INCHES = 1,
	365	wxIMAGE_RESOLUTION_CM = 2
	366	};
	367
	368
	369	enum
	370	{
	371	wxBMP_24BPP = 24, // default, do not need to set
	372	//wxBMP_16BPP = 16, // wxQuantize can only do 236 colors?
	373	wxBMP_8BPP = 8, // 8bpp, quantized colors
	374	wxBMP_8BPP_GREY = 9, // 8bpp, rgb averaged to greys
	375	wxBMP_8BPP_GRAY = wxBMP_8BPP_GREY,
	376	wxBMP_8BPP_RED = 10, // 8bpp, red used as greyscale
	377	wxBMP_8BPP_PALETTE = 11, // 8bpp, use the wxImage's palette
	378	wxBMP_4BPP = 4, // 4bpp, quantized colors
	379	wxBMP_1BPP = 1, // 1bpp, quantized "colors"
	380	wxBMP_1BPP_BW = 2 // 1bpp, black & white from red
	381	};
	382
	383
	384	class wxBMPHandler : public wxImageHandler {
	385	public:
	386	wxBMPHandler();
	387	};
	388
	389	class wxICOHandler : public wxBMPHandler {
	390	public:
	391	wxICOHandler();
	392	};
	393
	394	class wxCURHandler : public wxICOHandler {
	395	public:
	396	wxCURHandler();
	397	};
	398
	399	class wxANIHandler : public wxCURHandler {
	400	public:
	401	wxANIHandler();
	402	};
	403
	404
	405	//---------------------------------------------------------------------------
	406
	407	class wxPNGHandler : public wxImageHandler {
	408	public:
	409	wxPNGHandler();
	410	};
	411
	412
	413	class wxGIFHandler : public wxImageHandler {
	414	public:
	415	wxGIFHandler();
	416	};
	417
	418
	419	class wxPCXHandler : public wxImageHandler {
	420	public:
	421	wxPCXHandler();
	422	};
	423
	424
	425	class wxJPEGHandler : public wxImageHandler {
	426	public:
	427	wxJPEGHandler();
	428	};
	429
	430
	431	class wxPNMHandler : public wxImageHandler {
	432	public:
	433	wxPNMHandler();
	434	};
	435
	436	class wxXPMHandler : public wxImageHandler {
	437	public:
	438	wxXPMHandler();
	439	};
	440
	441	class wxTIFFHandler : public wxImageHandler {
	442	public:
	443	wxTIFFHandler();
	444	};
	445
	446
	447	#if wxUSE_IFF
	448	class wxIFFHandler : public wxImageHandler {
	449	public:
	450	wxIFFHandler();
	451	};
	452	#endif
	453
	454	//---------------------------------------------------------------------------