):
gtk.gdk.Colormap(visual
, allocate
)
def alloc_color(color
, writeable
=False, best_match
=True)
def alloc_color(spec
, writeable
=False, best_match
=True)
def alloc_color(red
, green
, blue
, writeable
=False, best_match
=True)
def get_visual()
def get_screen()
def query_color(pixel
)
Functions
def gtk.gdk.colormap_get_system()
Constructor
gtk.gdk.Colormap(visual
, allocate
)
visual :
| the gtk.gdk.Visual to
use |
allocate :
| if True , the newly created
colormap will be a private colormap, and all colors in it will be allocated
for the applications use. |
Returns : | a gtk.gdk.Colormap
object |
Creates a new gtk.gdk.Colormap
for the gtk.gdk.Visual
specified by visual
. If
allocate
is True
the colormap will
be a private colormap for the sole use of the application.
Methods
gtk.gdk.Colormap.alloc_color
def alloc_color(color
, writeable
=False, best_match
=True)
color :
| an unallocated gtk.gdk.Color |
writeable :
| if True the colormap entry
is writeable. |
best_match :
| if True a best match to the
requested color can be used if needed. |
Returns : | a new gtk.gdk.Color
object |
The alloc_color
() method allocates the
color specified by color
in the colormap. The value
of color should be an unallocated gtk.gdk.Color
. If
writeable
is True
the color is
allocated writeable which means it can be changed after allocation but
cannot be shared with another application. If
best_match
is True
the closest
match to the color will be returned if the request could not be satisfied
exactly.
This method raises:
- the ValueError (TypeError prior to PyGTK 2.4) exception if
unable to parse the color specification
- the RuntimeError exception if the color could not be
allocated
gtk.gdk.Colormap.alloc_color
def alloc_color(spec
, writeable
=False, best_match
=True)
spec :
| a string containing a color
specification |
writeable :
| if True the colormap entry
is writeable. |
best_match :
| if True a best match to the
requested color can be used if needed. |
Returns : | a gtk.gdk.Color
object |
The alloc_color
() method allocates the
color specified by spec
in the colormap. The format
of spec
is a string containing the specification of
the color either as a name (e.g. "navajowhite") as specified in the X11
rgb.txt
file or as a hexadecimal string (e.g.
"#FF0078"). The hexadecimal string must start with '#' and must contain 3
sets of hexadecimal digits of the same length (i.e. 1, 2 ,3 or 4 digits).
For example the following specify the same color value: "#F0A", "#FF00AA",
"#FFF000AAA" and "#FFFF0000AAAA". If writeable
is
True
the color is allocated writeable which means it can
be changed after allocation but cannot be shared with another application.
If best_match
is True
the closest
match to the color will be returned if the request could not be satisfied
exactly.
This method raises:
- the ValueError (TypeError prior to PyGTK 2.4) exception if
unable to parse the color specification
- the RuntimeError exception if the color could not be
allocated
gtk.gdk.Colormap.alloc_color
def alloc_color(red
, green
, blue
, writeable
=False, best_match
=True)
red :
| the red component of the color in the range 0-65535 |
green :
| the green component of the color in the range 0-65535 |
blue :
| the blue component of the color in the range 0-65535 |
writeable :
| a gboolean |
best_match :
| a gboolean |
Returns : | a gtk.gdk.Color object |
The alloc_color
() method allocates the
color specified by the component values red
,
green
and blue
. If
writeable
is True
the color is
allocated writeable which means it can be changed after allocation but
cannot be shared with another application. If
best_match
is True
the closest
match to the color will be returned if the request could not be satisfied
exactly.
This method raises:
- the ValueError (TypeError prior to PyGTK 2.4) exception if
unable to parse the color specification
- the RuntimeError exception if the color could not be
allocated
gtk.gdk.Colormap.get_visual
def get_visual()
The get_visual
() method returns the
visual the colormap was created for. See the gtk.gdk.Colormap
constructor.
gtk.gdk.Colormap.get_screen
def get_screen()
The get_screen
() method returns the
gtk.gdk.Screen
the colormap was created for.
gtk.gdk.Colormap.query_color
def query_color()
pixel :
| a pixel value |
Returns : | the gtk.gdk.Color
corresponding to pixel |
Note
This method is available in PyGTK 2.4 and above.
The query_color
() method returns the
gtk.gdk.Color
corresponding to the hardware pixel value specified by
pixel
. pixel
must be a valid
pixel in the colormap. It's a programmer error to call this method with a
pixel which is not in the colormap. Hardware pixels are normally obtained
from the alloc_color
()
method, or from a gtk.gdk.Image
object. (A gtk.gdk.Image
contains image data in hardware format while a gtk.gdk.Pixbuf
contains image data in a canonical 24-bit RGB format.)