wx.Colour

A colour is an object representing a combination of Red, Green, and Blue (RGB) intensity values and an Alpha value, and is used to determine drawing colours.

See the entry for wx.ColourDatabase for how a pointer to a predefined, named colour may be returned instead of creating a new colour.

Valid RGB values are in the range 0 to 255.

You can retrieve the current system colour settings with wx.SystemSettings.

Channel Accessor Functions

Note that this class provides pairs of functions for each of the colour channels, i.e. red, green, blue and alpha values. The one word functions Red, Green, Blue and Alpha return the values of type unsigned char , while GetRed, GetGreen, GetBlue and GetAlpha returns the same value as unsigned int . According to the C++ integer promotion rules, the result of any arithmetic expression involving the former will be (signed) int , while that of the latter will be unsigned , which is what would be commonly expected, so the latter family of functions should be typically preferred (but they are only available since wxWidgets 3.1.6).

See also

wx.ColourDatabase, wx.Pen, wx.Brush, wx.ColourDialog, wx.SystemSettings

Class Hierarchy

Inheritance diagram for class Colour:

Methods Summary

__init__	Default constructor.
Alpha	Returns the alpha value, on platforms where alpha is not yet supported, this always returns wx.ALPHA_OPAQUE.
AlphaBlend	Blend colour, taking alpha into account.
Blue	Returns the blue intensity.
ChangeLightness	wx.Colour wrapper for ChangeLightness(r,g,b,ialpha).
Get	Returns the RGB intensity values as a tuple, optionally the alpha value as well.
GetAlpha	Returns the alpha value, on platforms where alpha is not yet supported, this always returns wx.ALPHA_OPAQUE.
GetAsString	Converts this colour to a String using the given flags.
GetBlue	Returns the blue intensity as int.
GetGreen	Returns the green intensity as int.
GetIM	Returns an immutable representation of the wx.Colour object, based on namedtuple.
GetLuminance	Return the perceived brightness of the colour.
GetPixel
GetRGB	Gets the RGB or RGBA colour values as a single 32 bit value.
GetRGBA	Gets the RGB or RGBA colour values as a single 32 bit value.
GetRed	Returns the red intensity as int.
Green	Returns the green intensity.
IsOk	Returns True if the colour object is valid (the colour has been initialised with RGB values).
IsSolid	Returns True if the color can be described using RGB values, i.e.
MakeDisabled	Make a disabled version of this colour.
MakeGrey	Create a grey colour from (in/out) rgb parameters using integer arithmetic.
MakeMono	Assigns the same value to r, g, b: 0 if on is false , 255 otherwise.
Red	Returns the red intensity.
Set	Sets the RGB intensity values using the given values (first overload), extracting them from the packed long (second overload), using the given string (third overload).
SetRGB	Sets the RGB or RGBA colour values from a single 32 bit value.
SetRGBA	Sets the RGB or RGBA colour values from a single 32 bit value.
__bool__
__getitem__
__len__
__nonzero__
__reduce__
__repr__
__setitem__
__str__
_copyFrom	For internal use only.
__ne__	Tests the inequality of two colours by comparing individual red, green, blue intensities and alpha values.
__eq__	Tests the equality of two colours by comparing individual red, green, blue intensities and alpha values.

Properties Summary

Pixel	See GetPixel
RGB	See GetRGB and SetRGB
RGBA	See GetRGBA and SetRGBA
alpha	See Alpha
blue	See Blue
green	See Green
red	See Red

Class API

class wx.Colour(Object)

Possible constructors:

Colour() -> None

Colour(red, green, blue, alpha=ALPHA_OPAQUE) -> None

Colour(colRGB) -> None

Colour(colour) -> None

A colour is an object representing a combination of Red, Green, and Blue (RGB) intensity values and an Alpha value, and is used to determine drawing colours.

Methods

__init__(self, *args, **kw)

Overloaded Implementations:

---

__init__ (self)

Default constructor.

Return type:

None

---

__init__ (self, red, green, blue, alpha=ALPHA_OPAQUE)

Parameters:

• red (int) – The red value.

• green (int) – The green value.

• blue (int) – The blue value.

• alpha (int) – The alpha value. Alpha values range from 0 (wx``wx.ALPHA_TRANSPARENT``) to 255 (wx``wx.ALPHA_OPAQUE``).

Return type:

None

---

__init__ (self, colRGB)

Parameters:

colRGB (long) – A packed RGB value.

Return type:

None

---

__init__ (self, colour)

Copy constructor.

Parameters:

colour (wx.Colour)

Return type:

None

---

---

Alpha(self)

Returns the alpha value, on platforms where alpha is not yet supported, this always returns wx.ALPHA_OPAQUE.

Return type:

int

See also

GetAlpha

---

static AlphaBlend(fg, bg, alpha)

Blend colour, taking alpha into account.

Parameters:

• fg (int)

• bg (int)

• alpha (float)

Return type:

int

Added in version 2.9.0.

---

Blue(self)

Returns the blue intensity.

Return type:

int

See also

GetBlue

---

ChangeLightness(self, *args, **kw)

Overloaded Implementations:

---

ChangeLightness (self, ialpha)

wx.Colour wrapper for ChangeLightness(r,g,b,ialpha).

Parameters:

ialpha (int)

Return type:

wx.Colour

Added in version 2.9.0.

---

ChangeLightness (r, g, b, ialpha)

Utility function that simply darkens or lightens a color, based on the specified percentage ialpha.

ialpha of 0 would be make the color completely black, 200 completely white and 100 would not change the color.

Parameters:

• r (int)

• g (int)

• b (int)

• ialpha (int)

Return type:

Tuple[int, int, int]

Added in version 2.9.0.

---

---

Get(self, includeAlpha=True)

Returns the RGB intensity values as a tuple, optionally the alpha value as well.

Return type:

Any

---

GetAlpha(self)

Returns the alpha value, on platforms where alpha is not yet supported, this always returns wx.ALPHA_OPAQUE.

Return type:

int

Added in version 4.1/wxWidgets-3.1.6.

---

GetAsString(self, flags=C2S_NAME | C2S_CSS_SYNTAX)

Converts this colour to a String using the given flags.

The supported flags are C2S_NAME , to obtain the colour name (e.g. wx.Colour == “red”), C2S_CSS_SYNTAX , to obtain the colour in the “rgb(r,g,b)” or “rgba(r,g,b,a)” syntax (e.g. wx.Colour == “rgba(255,0,0,0.333)”), and C2S_HTML_SYNTAX , to obtain the colour as “#” followed by 6 hexadecimal digits (e.g. wx.Colour == “#``FF0000``”).

This function returns empty string if the colour is not initialized (see IsOk ). Otherwise, the returned string is always non-empty, but the function asserts if the colour has alpha channel (i.e. is non opaque) but C2S_CSS_SYNTAX (which is the only one supporting alpha) is not specified in flags.

Parameters:

flags (long)

Return type:

str

Added in version 2.7.0.

Note

For non-solid (i.e. non-RGB) colour this function returns “rgb(??, ?? ??)” or “#??????”.

---

GetBlue(self)

Returns the blue intensity as int.

Return type:

int

Added in version 4.1/wxWidgets-3.1.6.

---

GetGreen(self)

Returns the green intensity as int.

Return type:

int

Added in version 4.1/wxWidgets-3.1.6.

---

GetIM(self)

Returns an immutable representation of the wx.Colour object, based on namedtuple.

This new object is hashable and can be used as a dictionary key, be added to sets, etc. It can be converted back into a real wx.Colour with a simple statement like this: obj = wx.Colour(imObj).

---

GetLuminance(self)

Return the perceived brightness of the colour.

This value is computed using the simple:

( 0.299*R + 0.587*G + 0.114*B )

formula with the coefficients taken from the RGB to YIQ conversion formula and R , G and B being the values of the corresponding colour channels normalized to 0..1 range, so that the return value is 0 for black and 1 for white.

Return type:

float

Added in version 4.1/wxWidgets-3.1.3.

---

GetPixel(self)

Return type:

wx.IntPtr

---

GetRGB(self)

Gets the RGB or RGBA colour values as a single 32 bit value.

The returned value is of the same form as expected by SetRGB and SetRGBA .

Notice that GetRGB returns the value with 0 as its highest byte independently of the value actually returned by Alpha . So for a fully opaque colour, the return value of GetRGBA is 0xFFBBGGRR while that of GetRGB is 0x00BBGGRR .

Return type:

wx.int

Added in version 2.9.1.

---

GetRGBA(self)

Gets the RGB or RGBA colour values as a single 32 bit value.

The returned value is of the same form as expected by SetRGB and SetRGBA .

Notice that GetRGB returns the value with 0 as its highest byte independently of the value actually returned by Alpha . So for a fully opaque colour, the return value of GetRGBA is 0xFFBBGGRR while that of GetRGB is 0x00BBGGRR .

Return type:

wx.int

Added in version 2.9.1.

---

GetRed(self)

Returns the red intensity as int.

Return type:

int

Added in version 4.1/wxWidgets-3.1.6.

---

Green(self)

Returns the green intensity.

Return type:

int

See also

GetGreen

---

IsOk(self)

Returns True if the colour object is valid (the colour has been initialised with RGB values).

Return type:

bool

---

IsSolid(self)

Returns True if the color can be described using RGB values, i.e.

is solid, False if it is a pattern (currently only possible on macOS)

Return type:

bool

Added in version 4.1/wxWidgets-3.1.2.

---

MakeDisabled(self, *args, **kw)

Overloaded Implementations:

---

MakeDisabled (self, brightness=255)

Make a disabled version of this colour.

This method modifies the object in place and returns the object itself.

Parameters:

brightness (int)

Return type:

wx.Colour

Added in version 2.9.5.

---

MakeDisabled (r, g, b, brightness=255)

Create a disabled (dimmed) colour from (in/out) rgb parameters.

Parameters:

• r (int)

• g (int)

• b (int)

• brightness (int)

Return type:

Tuple[int, int, int]

Added in version 2.9.0.

---

---

static MakeGrey(*args, **kw)

Overloaded Implementations:

---

MakeGrey (r, g, b)

Create a grey colour from (in/out) rgb parameters using integer arithmetic.

Parameters:

• r (int)

• g (int)

• b (int)

Return type:

Tuple[int, int, int]

Added in version 2.9.0.

---

MakeGrey (r, g, b, weight_r, weight_g, weight_b)

Create a grey colour from (in/out) rgb parameters using floating point arithmetic.

Defaults to using the standard ITU-T BT.601 when converting to YUV, where every pixel equals (R weight_r) + (G weight_g) + (B weight_b).

Parameters:

• r (int)

• g (int)

• b (int)

• weight_r (float)

• weight_g (float)

• weight_b (float)

Return type:

Tuple[int, int, int]

Added in version 2.9.0.

---

---

static MakeMono(on)

Assigns the same value to r, g, b: 0 if on is false , 255 otherwise.

Parameters:

on (bool)

Return type:

Tuple[int, int, int]

Added in version 2.9.0.

---

Red(self)

Returns the red intensity.

Return type:

int

See also

GetRed

---

Set(self, *args, **kw)

Sets the RGB intensity values using the given values (first overload), extracting them from the packed long (second overload), using the given string (third overload).

When using third form, Set accepts: colour names (those listed in wx.ColourDatabase), the CSS-like "rgb(r,g,b)" or "rgba(r,g,b,a)" syntax (case insensitive) and the HTML-like syntax: "#" followed by 6 hexadecimal digits for red, green, blue components.

Returns True if the conversion was successful, False otherwise.

Added in version 2.7.0.

Overloaded Implementations:

---

Set (self, red, green, blue, alpha=ALPHA_OPAQUE)

Parameters:

• red (int)

• green (int)

• blue (int)

• alpha (int)

Return type:

None

---

Set (self, RGB)

Parameters:

RGB (long)

Return type:

None

---

Set (self, str)

Parameters:

str (string)

Return type:

bool

---

---

SetRGB(self, colRGB)

Sets the RGB or RGBA colour values from a single 32 bit value.

The arguments colRGB and colRGBA should be of the form 0x00BBGGRR and 0xAABBGGRR respectively where 0xRR , 0xGG , 0xBB and 0xAA are the values of the red, green, blue and alpha components.

Notice the right-to-left order of components!

Parameters:

colRGB (wx.int)

Return type:

None

Added in version 2.9.1.

See also

GetRGB , GetRGBA

---

SetRGBA(self, colRGBA)

Sets the RGB or RGBA colour values from a single 32 bit value.

The arguments colRGB and colRGBA should be of the form 0x00BBGGRR and 0xAABBGGRR respectively where 0xRR , 0xGG , 0xBB and 0xAA are the values of the red, green, blue and alpha components.

Notice the right-to-left order of components!

Parameters:

colRGBA (wx.int)

Return type:

None

Added in version 2.9.1.

See also

GetRGB , GetRGBA

---

__bool__(self)

Return type:

bool

---

__getitem__(self, idx)

---

__len__(self)

---

__nonzero__(self)

Return type:

bool

---

__reduce__(self)

---

__repr__(self)

---

__setitem__(self, idx, val)

---

__str__(self)

---

_copyFrom(self, other)

For internal use only.

Return type:

None

---

__ne__(self, colour)

Tests the inequality of two colours by comparing individual red, green, blue intensities and alpha values.

Parameters:

colour (wx.Colour)

Return type:

bool

---

__eq__(self, colour)

Tests the equality of two colours by comparing individual red, green, blue intensities and alpha values.

Parameters:

colour (wx.Colour)

Return type:

bool

Properties

Pixel

See GetPixel

---

RGB

See GetRGB and SetRGB

---

RGBA

See GetRGBA and SetRGBA

---

alpha

See Alpha

---

blue

See Blue

---

green

See Green

---

red

See Red