// This is the SIP interface definition for QPixmap.
//
// Copyright (c) 2007
// 	Riverbank Computing Limited <info@riverbankcomputing.co.uk>
// 
// This file is part of PyQt.
// 
// This copy of PyQt is free software; you can redistribute it and/or modify it
// under the terms of the GNU General Public License as published by the Free
// Software Foundation; either version 2, or (at your option) any later
// version.
// 
// PyQt is supplied in the hope that it will be useful, but WITHOUT ANY
// WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
// FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more
// details.
// 
// You should have received a copy of the GNU General Public License along with
// PyQt; see the file LICENSE.  If not, write to the Free Software Foundation,
// Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.


%ExportedDoc
<Sect2><Title>QPixmap</Title>
<FuncSynopsis>
        <FuncDef><Function>QPixmap</Function></FuncDef>
        <ParamDef>const char *<Parameter>xpm</Parameter>[]</ParamDef>
</FuncSynopsis>
<Para>
This takes a list of strings as its parameter.
</Para>

<FuncSynopsis>
        <FuncDef>bool <Function>loadFromData</Function></FuncDef>
        <ParamDef>const uchar *<Parameter>buf</Parameter></ParamDef>
        <ParamDef>uint <Parameter>len</Parameter></ParamDef>
        <ParamDef>const char *<Parameter>format</Parameter> = 0</ParamDef>
        <ParamDef>ColorMode <Parameter>mode</Parameter> = Auto</ParamDef>
</FuncSynopsis>
<Para>
<Literal>len</Literal> is derived from <Literal>buf</Literal> and not passed as
a parameter.
</Para>

<FuncSynopsis>
        <FuncDef>bool <Function>loadFromData</Function></FuncDef>
        <ParamDef>const uchar *<Parameter>buf</Parameter></ParamDef>
        <ParamDef>uint <Parameter>len</Parameter></ParamDef>
        <ParamDef>const char *<Parameter>format</Parameter></ParamDef>
        <ParamDef>int <Parameter>conversion_flags</Parameter></ParamDef>
</FuncSynopsis>
<Para>
Not implemented.
</Para>
</Sect2>
%End


%If (- Qt_2_00)

class QPixmap : QPaintDevice
{
%TypeHeaderCode
#include <qpixmap.h>
%End

public:
	enum ColorMode
	{
		Auto,
		Color,
		Mono
	};

	QPixmap();
	QPixmap(int,int,int = -1);
	QPixmap(const QSize &,int = -1);
	QPixmap(const char *,const char * = 0,ColorMode = Auto);
	QPixmap(const char *,const char *,int);

	QPixmap(SIP_PYLIST) [(const char **)];
%MethodCode
		// The Python interface is a list of strings that make up the
		// image.

		const char **str;

		if ((str = PyQt_qt_ListToArray(a0)) == NULL)
			sipIsErr = 1;
		else
		{
			Py_BEGIN_ALLOW_THREADS
			sipCpp = new sipQPixmap(str);
			Py_END_ALLOW_THREADS

			sipFree((ANY *)str);
		}
%End

	QPixmap(const QPixmap &);

	bool isNull() const;
	int width() const;
	int height() const;
	QSize size() const;
	QRect rect() const;
	int depth() const;
	static int defaultDepth();
	void fill(const QColor & = white);
	void fill(const QWidget *,int,int);
	void fill(const QWidget *,const QPoint &);
	void resize(int,int);
	void resize(const QSize &);
	const QBitmap *mask() const;
	void setMask(const QBitmap &);
	bool selfMask() const;
	QBitmap createHeuristicMask(bool = 1) const;
	static QPixmap grabWindow(WId,int = 0,int = 0,int = -1,int = -1);
	QPixmap xForm(const QWMatrix &) const;
	static QWMatrix trueMatrix(const QWMatrix &,int,int);
	QImage convertToImage() const;
	bool convertFromImage(const QImage &,ColorMode = Auto);
	bool convertFromImage(const QImage &,int);
	static const char *imageFormat(const char *);
	bool load(const char *,const char * = 0,ColorMode = Auto);
	bool load(const char *,const char *,int);
	bool loadFromData(const uchar * /Array/,uint /ArraySize/,
			  const char * = 0,ColorMode = Auto);
//	bool loadFromData(const uchar *,uint,const char *,int);
	bool loadFromData(QByteArray,const char * = 0,int = 0);
	bool save(const char *,const char *) const;
	int serialNumber() const;

	enum Optimization
	{
		NoOptim,
		NormalOptim,
		BestOptim
	};

	Optimization optimization() const;
	void setOptimization(Optimization);
	static Optimization defaultOptimization();
	static void setDefaultOptimization(Optimization);
	virtual void detach();
	bool isQBitmap() const;

protected:
	QPixmap(int,int,const uchar *,bool);
};

%End

%If (Qt_2_00 -)

class QPixmap : QPaintDevice, Qt
{
%TypeHeaderCode
#include <qpixmap.h>
%End

public:
	enum ColorMode
	{
		Auto,
		Color,
		Mono
	};

	enum Optimization
	{
		DefaultOptim,
		NoOptim,
		MemoryOptim,
		NormalOptim,
		BestOptim
	};

	QPixmap();
%If (Qt_3_0_0 -)
	QPixmap(const QImage &);
%End
	QPixmap(int,int,int = -1,Optimization = DefaultOptim);
	QPixmap(const QSize &,int = -1,Optimization = DefaultOptim);
	QPixmap(const QString &,const char * = 0,ColorMode = Auto);
	QPixmap(const QString &,const char *,int);

	QPixmap(SIP_PYLIST) [(const char **)];
%MethodCode
		// The Python interface is a list of strings that make up the
		// image.

		const char **str;

		if ((str = PyQt_qt_ListToArray(a0)) == NULL)
			sipIsErr = 1;
		else
		{
			Py_BEGIN_ALLOW_THREADS
			sipCpp = new sipQPixmap(str);
			Py_END_ALLOW_THREADS

			sipFree((ANY *)str);
		}
%End

	QPixmap(const QByteArray &);
	QPixmap(const QPixmap &);

	bool isNull() const;
	int width() const;
	int height() const;
	QSize size() const;
	QRect rect() const;
	int depth() const;
	static int defaultDepth();
	void fill(const QColor & = Qt::white);
	void fill(const QWidget *,int,int);
	void fill(const QWidget *,const QPoint &);
	void resize(int,int);
	void resize(const QSize &);
	const QBitmap *mask() const;
	void setMask(const QBitmap &);
	bool selfMask() const;
%If (Qt_3_1_0 -)
	bool hasAlpha() const;
%End
%If (Qt_3_2_0 -)
	bool hasAlphaChannel() const;
%End
	QBitmap createHeuristicMask(bool = 1) const;
%If (Qt_3_1_0 -)
	static QPixmap fromMimeSource(const QString &);
%End
	static QPixmap grabWindow(WId,int = 0,int = 0,int = -1,int = -1);
%If (Qt_2_1_0 -)
	static QPixmap grabWidget(QWidget *,int = 0,int = 0,int = -1,int = -1);
%End

	QPixmap xForm(const QWMatrix &) const;
	static QWMatrix trueMatrix(const QWMatrix &,int,int);
	QImage convertToImage() const;
	bool convertFromImage(const QImage &,ColorMode = Auto);
	bool convertFromImage(const QImage &,int);
	static const char *imageFormat(const QString &);
	bool load(const QString &,const char * = 0,ColorMode = Auto);
	bool load(const QString &,const char *,int);
	bool loadFromData(const uchar * /Array/,uint /ArraySize/,
			  const char * = 0,ColorMode = Auto);
//	bool loadFromData(const uchar *,uint,const char *,int);
	bool loadFromData(QByteArray,const char * = 0,int = 0);
%If (- Qt_3_0_0)
	bool save(const QString &,const char *) const;
%End
%If (Qt_2_2_0 - Qt_3_0_0)
	bool save(const QString &,const char *,int) const;
%End
%If (Qt_3_0_0 -)
	bool save(const QString &,const char *,int = -1) const;
%End
%If (Qt_3_2_0 -)
	bool save(QIODevice *,const char *,int = -1) const;
%End
	int serialNumber() const;
	Optimization optimization() const;
	void setOptimization(Optimization);
	static Optimization defaultOptimization();
	static void setDefaultOptimization(Optimization);
	virtual void detach();
	bool isQBitmap() const;

%If (Qt_3_0_0 -)
%If (WS_X11)
	static int x11SetDefaultScreen(int);
	void x11SetScreen(int);
%End
%End

protected:
	QPixmap(int,int,const uchar *,bool);
};

%End

%If (Qt_3_2_0 -)
void copyBlt(QPixmap *,int,int,const QPixmap *,int = 0,int = 0,int = -1,
	     int = -1);
%End
