.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "Gtk2::Gdk::Colormap 3"
.TH Gtk2::Gdk::Colormap 3 2024-09-01 "perl v5.40.0" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAME
Gtk2::Gdk::Colormap \- wrapper for GdkColormap
.SH DESCRIPTION
.IX Header "DESCRIPTION"
Colormaps are used to store the mappings between the RGB values you ask for
and the actual, hardware-dependent values used to display those colors.
The \f(CW\*(C`$colormap\->alloc_color\*(C'\fR and \f(CW\*(C`$colormap\->alloc_colors\*(C'\fR methods
do the necessary work to allocate a color within the visual; this actually
has nothing to do with memory management, so it is important that you call
\&\f(CW\*(C`$colormap\->free_colors\*(C'\fR to release those spots in the colormap
allocated by \f(CW\*(C`alloc_color\*(C'\fR and \f(CW\*(C`alloc_colors\*(C'\fR.
.SH HIERARCHY
.IX Header "HIERARCHY"
.Vb 2
\&  Glib::Object
\&  +\-\-\-\-Gtk2::Gdk::Colormap
.Ve
.SH METHODS
.IX Header "METHODS"
.ie n .SS "colormap = Gtk2::Gdk::Colormap\->\fBnew\fP ($visual, $allocate)"
.el .SS "colormap = Gtk2::Gdk::Colormap\->\fBnew\fP ($visual, \f(CW$allocate\fP)"
.IX Subsection "colormap = Gtk2::Gdk::Colormap->new ($visual, $allocate)"
.IP \(bu 4
\&\f(CW$visual\fR (Gtk2::Gdk::Visual)
.IP \(bu 4
\&\f(CW$allocate\fR (boolean)
.ie n .SS "boolean = $colormap\->\fBalloc_color\fP ($color, $writeable, $best_match)"
.el .SS "boolean = \f(CW$colormap\fP\->\fBalloc_color\fP ($color, \f(CW$writeable\fP, \f(CW$best_match\fP)"
.IX Subsection "boolean = $colormap->alloc_color ($color, $writeable, $best_match)"
.IP \(bu 4
\&\f(CW$color\fR (Gtk2::Gdk::Color)
.IP \(bu 4
\&\f(CW$writeable\fR (boolean)
.IP \(bu 4
\&\f(CW$best_match\fR (boolean)
.ie n .SS "list = $colormap\->\fBalloc_colors\fP ($writeable, $best_match, ...)"
.el .SS "list = \f(CW$colormap\fP\->\fBalloc_colors\fP ($writeable, \f(CW$best_match\fP, ...)"
.IX Subsection "list = $colormap->alloc_colors ($writeable, $best_match, ...)"
.IP \(bu 4
\&\f(CW$writeable\fR (boolean)
.IP \(bu 4
\&\f(CW$best_match\fR (boolean)
.IP \(bu 4
\&... (list) of Gtk2::Gdk::Color's to be allocated
.PP
Returns a list of boolean values, telling whether the color at the
corresponding spot in \fI...\fR could be allocated.
.ie n .SS "$colormap\->\fBfree_colors\fP (...)"
.el .SS "\f(CW$colormap\fP\->\fBfree_colors\fP (...)"
.IX Subsection "$colormap->free_colors (...)"
.IP \(bu 4
\&... (list) of Gtk2::Gdk::Color's to be freed
.ie n .SS "color = $colormap\->\fBquery_color\fP ($pixel)"
.el .SS "color = \f(CW$colormap\fP\->\fBquery_color\fP ($pixel)"
.IX Subsection "color = $colormap->query_color ($pixel)"
.IP \(bu 4
\&\f(CW$pixel\fR (unsigned)
.ie n .SS "$colormap\->\fBrgb_find_color\fP ($color)"
.el .SS "\f(CW$colormap\fP\->\fBrgb_find_color\fP ($color)"
.IX Subsection "$colormap->rgb_find_color ($color)"
.IP \(bu 4
\&\f(CW$color\fR (Gtk2::Gdk::Color)
.ie n .SS "screen = $cmap\->\fBget_screen\fP"
.el .SS "screen = \f(CW$cmap\fP\->\fBget_screen\fP"
.IX Subsection "screen = $cmap->get_screen"
Since: gtk+ 2.2
.SS "colormap = Gtk2::Gdk::Colormap\->\fBget_system\fP"
.IX Subsection "colormap = Gtk2::Gdk::Colormap->get_system"
.ie n .SS "visual = $colormap\->\fBget_visual\fP"
.el .SS "visual = \f(CW$colormap\fP\->\fBget_visual\fP"
.IX Subsection "visual = $colormap->get_visual"
.SH "SEE ALSO"
.IX Header "SEE ALSO"
Gtk2, Glib::Object
.SH COPYRIGHT
.IX Header "COPYRIGHT"
Copyright (C) 2003\-2011 by the gtk2\-perl team.
.PP
This software is licensed under the LGPL.  See Gtk2 for a full notice.