Gdk.RGBA - Structures - Gdk 3.0 (original) (raw)
Fields¶
| Name | Type | Access | Description |
|---|---|---|---|
| alpha | float | r/w | The opacity of the color from 0.0 for completely translucent to 1.0 for opaque |
| blue | float | r/w | The intensity of the blue channel from 0.0 to 1.0 inclusive |
| green | float | r/w | The intensity of the green channel from 0.0 to 1.0 inclusive |
| red | float | r/w | The intensity of the red channel from 0.0 to 1.0 inclusive |
Methods¶
| class | from_color (color) |
|---|---|
| copy () | |
| equal (p2) | |
| free () | |
| hash () | |
| parse (spec) | |
| to_color () | |
| to_string () |
Details¶
class Gdk.RGBA(red=1.0, green=1.0, blue=1.0, alpha=1.0)¶
A Gdk.RGBA is used to represent a (possibly translucent) color, in a way that is compatible with cairo’s notion of color.
classmethod from_color(color)¶
Returns a new RGBA instance given a Color instance.
Returns:
A newly allocated Gdk.RGBA, with the same contents as self
Return type:
Makes a copy of a Gdk.RGBA.
The result must be freed through Gdk.RGBA.free().
New in version 3.0.
Parameters:
p2 (Gdk.RGBA) – another Gdk.RGBA pointer
Returns:
True if the two colors compare equal
Return type:
Compares two RGBA colors.
New in version 3.0.
Frees a Gdk.RGBA created with Gdk.RGBA.copy()
New in version 3.0.
Returns:
The hash value for self
Return type:
A hash function suitable for using for a hash table that stores Gdk.RGBAs.
New in version 3.0.
Parameters:
spec (str) – the string specifying the color
Returns:
True if the parsing succeeded
Return type:
Parses a textual representation of a color, filling in the red, green, blue and alpha fields of the self Gdk.RGBA.
The string can be either one of:
- A standard name (Taken from the X11 rgb.txt file).
- A hexadecimal value in the form “\#rgb”, “\#rrggbb”, “\#rrrgggbbb” or ”\#rrrrggggbbbb”
- A RGB color in the form “rgb(r,g,b)” (In this case the color will have full opacity)
- A RGBA color in the form “rgba(r,g,b,a)”
Where “r”, “g”, “b” and “a” are respectively the red, green, blue and alpha color values. In the last two cases, “r”, “g”, and “b” are either integers in the range 0 to 255 or percentage values in the range 0% to 100%, and a is a floating point value in the range 0 to 1.
New in version 3.0.
to_color()¶
Converts this RGBA into a Color instance which excludes alpha.
Returns:
A newly allocated text string
Return type:
Returns a textual specification of self in the formrgb(r,g,b) orrgba(r g,b,a), where “r”, “g”, “b” and “a” represent the red, green, blue and alpha values respectively. “r”, “g”, and “b” are represented as integers in the range 0 to 255, and “a” is represented as a floating point value in the range 0 to 1.
These string forms are string forms that are supported by the CSS3 colors module, and can be parsed by Gdk.RGBA.parse().
Note that this string representation may lose some precision, since “r”, “g” and “b” are represented as 8-bit integers. If this is a concern, you should use a different representation.
New in version 3.0.