---
name: "Gtk2::Gdk::Colormap"
section: "3pm"
platform: "linux"
package: "libgtk2-perl-doc"
version: "2:1.24992-1"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/Gtk2::Gdk::Colormap"
---

# Gtk2::Gdk::Colormap(3pm)

wrapper for GdkColormap

## NAME

Gtk2::Gdk::Colormap - wrapper for GdkColormap

## 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 `"$colormap->alloc_color"` and `"$colormap->alloc_colors"` 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 `"$colormap->free_colors"` to release those spots in the colormap allocated by `"alloc_color"` and `"alloc_colors"`.

## HIERARCHY

```
  Glib::Object
  +----Gtk2::Gdk::Colormap
```

## METHODS

### colormap = Gtk2::Gdk::Colormap-\>new ($visual, $allocate)

- •

  `$visual` (Gtk2::Gdk::Visual)

- •

  `$allocate` (boolean)

### boolean = $colormap-\>alloc\_color ($color, $writable, $best\_match)

- •

  `$color` (Gtk2::Gdk::Color)

- •

  `$writable` (boolean)

- •

  `$best_match` (boolean)

### list = $colormap-\>alloc\_colors ($writable, $best\_match, ...)

- •

  `$writable` (boolean)

- •

  `$best_match` (boolean)

- •

  ... (list) of Gtk2::Gdk::Color's to be allocated

Returns a list of boolean values, telling whether the color at the corresponding spot in *...* could be allocated.

### $colormap-\>free\_colors (...)

- •

  ... (list) of Gtk2::Gdk::Color's to be freed

### color = $colormap-\>query\_color ($pixel)

- •

  `$pixel` (unsigned)

### $colormap-\>rgb\_find\_color ($color)

- •

  `$color` (Gtk2::Gdk::Color)

### screen = $cmap-\>get\_screen

Since: gtk+ 2.2

### colormap = Gtk2::Gdk::Colormap-\>get\_system

### visual = $colormap-\>get\_visual

## SEE ALSO

Gtk2, Glib::Object

## COPYRIGHT

Copyright (C) 2003-2011 by the gtk2-perl team.

This software is licensed under the LGPL.  See Gtk2 for a full notice.