pytqt/sip/qt/qcolor.sip

// This is the SIP interface definition for TQColor.
//
// Copyright (c) 2007
// 	Riverbank Computing Limited <info@riverbankcomputing.co.uk>
// 
// This file is part of PyTQt.
// 
// This copy of PyTQt 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.
// 
// PyTQt 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
// PyTQt; 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>TQColor</Title>
<Para>
The Python <Literal>==</Literal> and <Literal>!=</Literal> operators are
supported.
</Para>

<FuncSynopsis>
	<FuncDef>void <Function>getHsv</Function></FuncDef>
	<ParamDef>int *<Parameter>h</Parameter></ParamDef>
	<ParamDef>int *<Parameter>s</Parameter></ParamDef>
	<ParamDef>int *<Parameter>v</Parameter></ParamDef>
</FuncSynopsis>
<Para>
This takes no parameters and returns the <Literal>h</Literal>,
<Literal>s</Literal> and <Literal>v</Literal> values as a tuple.
</Para>

<FuncSynopsis>
	<FuncDef>void <Function>getRgb</Function></FuncDef>
	<ParamDef>int *<Parameter>r</Parameter></ParamDef>
	<ParamDef>int *<Parameter>g</Parameter></ParamDef>
	<ParamDef>int *<Parameter>b</Parameter></ParamDef>
</FuncSynopsis>
<Para>
This takes no parameters and returns the <Literal>r</Literal>,
<Literal>g</Literal> and <Literal>b</Literal> values as a tuple.
</Para>

<FuncSynopsis>
	<FuncDef>void <Function>hsv</Function></FuncDef>
	<ParamDef>int *<Parameter>h</Parameter></ParamDef>
	<ParamDef>int *<Parameter>s</Parameter></ParamDef>
	<ParamDef>int *<Parameter>v</Parameter></ParamDef>
</FuncSynopsis>
<Para>
This takes no parameters and returns the <Literal>h</Literal>,
<Literal>s</Literal> and <Literal>v</Literal> values as a tuple.
</Para>

<FuncSynopsis>
	<FuncDef>void <Function>rgb</Function></FuncDef>
	<ParamDef>int *<Parameter>r</Parameter></ParamDef>
	<ParamDef>int *<Parameter>g</Parameter></ParamDef>
	<ParamDef>int *<Parameter>b</Parameter></ParamDef>
</FuncSynopsis>
<Para>
This takes no parameters and returns the <Literal>r</Literal>,
<Literal>g</Literal> and <Literal>b</Literal> values as a tuple.
</Para>
</Sect2>
%End


%ModuleHeaderCode
#include <tqcolor.h>
%End


%If (- TQt_2_00)
// The global colours.

TQColor color0;
TQColor color1;
TQColor black;
TQColor white;
TQColor darkGray;
TQColor gray;
TQColor lightGray;
TQColor red;
TQColor green;
TQColor blue;
TQColor cyan;
TQColor magenta;
TQColor yellow;
TQColor darkRed;
TQColor darkGreen;
TQColor darkBlue;
TQColor darkCyan;
TQColor darkMagenta;
TQColor darkYellow;
%End


// Related functions.

int tqRed(TQRgb);
int tqGreen(TQRgb);
int tqBlue(TQRgb);
TQRgb tqRgb(int,int,int);
int tqGray(int,int,int);
int tqGray(TQRgb);

%If (TQt_2_00 -)
int tqAlpha(TQRgb);
TQRgb tqRgba(int,int,int,int);
%End


class TQColor
{
%TypeHeaderCode
#include <tqcolor.h>
%End

public:
	enum Spec {
		Rgb,
		Hsv
	};

	TQColor();
	TQColor(int,int,int);
	TQColor(int,int,int,Spec);
	TQColor(TQRgb,uint = 0xffffffff);
%If (TQt_2_00 -)
	TQColor(const TQString &);
%End
	TQColor(const char *);
	TQColor(const TQColor &);

	bool isValid() const;
	bool isDirty() const;
%If (- TQt_2_00)
	void setNamedColor(const char *);
%End
%If (TQt_2_1_0 -)
	TQString name() const;
%End
%If (TQt_2_00 -)
	void setNamedColor(const TQString &);
%End

	TQRgb rgb() const;
	void setRgb(int,int,int);
	void setRgb(TQRgb);
%If (TQt_3_2_0 -)
	void getRgb(int *,int *,int *) const;
%End

	// Obsolete and is hidden anyway by the overload above.
	//void rgb(int *,int *,int *) const;

	int red() const;
	int green() const;
	int blue() const;

	void setHsv(int,int,int);

%If (TQt_3_2_0 -)
	void getHsv(int *,int *,int *) const;
%End
%If (- TQt_3_2_0)
	void getHsv(int &,int &,int &) const;
%End

	// Obsolete.
	void hsv(int *,int *,int *) const;

	TQColor light(int = 150) const;
	TQColor dark(int = 200) const;
%If (- TQt_3_0_0)
	static bool lazyAlloc();
	static void setLazyAlloc(bool);
%End

	bool operator==(const TQColor &) const;
	bool operator!=(const TQColor &) const;

	uint alloc();
	uint pixel() const;
	static int maxColors();
	static int numBitPlanes();
	static int enterAllocContext();
	static void leaveAllocContext();
	static int currentAllocContext();
	static void destroyAllocContext(int);
%If (TQt_3_0_0 -)
%End
	static void initialize();
	static void cleanup();
%If (TQt_3_2_0 -)
	static TQStringList colorNames();
%End
};