Pango.Color

Fields

Name

Type

Access

Description

blue

int

r/w

value of blue component

green

int

r/w

value of green component

red

int

r/w

value of red component

Methods

copy ()

free ()

parse (spec)

parse_with_alpha (spec)

to_string ()

Details

class Pango.Color

The PangoColor structure is used to represent a color in an uncalibrated RGB color-space.

copy()[source]
Returns:

the newly allocated PangoColor, which should be freed with [method`Pango`.Color.free]

Return type:

Pango.Color or None

Creates a copy of self.

The copy should be freed with [method`Pango`.Color.free]. Primarily used by language bindings, not that useful otherwise (since colors can just be copied by assignment in C).

free()[source]

Frees a color allocated by [method`Pango`.Color.copy].

parse(spec)[source]
Parameters:

spec (str) – a string specifying the new color

Returns:

True if parsing of the specifier succeeded, otherwise False

Return type:

bool

Fill in the fields of a color from a string specification.

The string can either one of a large set of standard names. (Taken from the CSS Color specification, or it can be a value in the form #rgb, #rrggbb, #rrrgggbbb or #rrrrggggbbbb, where r, g and b are hex digits of the red, green, and blue components of the color, respectively. (White in the four forms is #fff, #ffffff, #fffffffff and #ffffffffffff.)

parse_with_alpha(spec)[source]
Parameters:

spec (str) – a string specifying the new color

Returns:

True if parsing of the specifier succeeded, otherwise False

alpha:

return location for alpha

Return type:

(bool, alpha: int)

Fill in the fields of a color from a string specification.

The string can either one of a large set of standard names. (Taken from the CSS Color specification, or it can be a hexadecimal value in the form #rgb, #rrggbb, #rrrgggbbb or #rrrrggggbbbb where r, g and b are hex digits of the red, green, and blue components of the color, respectively. (White in the four forms is #fff, #ffffff, #fffffffff and #ffffffffffff.)

Additionally, parse strings of the form #rgba, #rrggbbaa, #rrrrggggbbbbaaaa, if alpha is not None, and set alpha to the value specified by the hex digits for a. If no alpha component is found in spec, alpha is set to 0xffff (for a solid color).

New in version 1.46.

to_string()[source]
Returns:

a newly-allocated text string that must be freed with GLib.free().

Return type:

str

Returns a textual specification of self.

The string is in the hexadecimal form #rrrrggggbbbb, where r, g and b are hex digits representing the red, green, and blue components respectively.

New in version 1.16.