Skip to content

Pango.Color

record (struct)

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

Methods

copy

def copy(self) -> Color | None

Creates a copy of src.

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

free

def free(self) -> None

Frees a color allocated by Color.copy.

parse

def parse(self, spec: str) -> 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.)

Parameters:

  • spec — a string specifying the new color

parse_with_alpha

def parse_with_alpha(self, spec: str) -> tuple[bool, 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).

Parameters:

  • spec — a string specifying the new color

to_string

def to_string(self) -> str

Returns a textual specification of color.

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

Properties

red

red: int  # read/write

green

green: int  # read/write

blue

blue: int  # read/write