/usr/include/gdkmm-2.4/gdkmm/colormap.h is in libgtkmm-2.4-dev 1:2.24.5-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 | // -*- c++ -*-
// Generated by gmmproc 2.45.3 -- DO NOT MODIFY!
#ifndef _GDKMM_COLORMAP_H
#define _GDKMM_COLORMAP_H
#include <gdkmmconfig.h>
#include <glibmm/ustring.h>
#include <sigc++/sigc++.h>
/* $Id: colormap.hg,v 1.7 2006/04/12 11:11:24 murrayc Exp $ */
/* box.h
*
* Copyright (C) 1998-2002 The gtkmm Development Team
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free
* Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
*/
// This is for including the config header before any code (such as
// the #ifndef GDKMM_DISABLE_DEPRECATED in deprecated classes) is generated:
#include <glibmm/object.h>
#include <gdkmm/visual.h>
#include <gdkmm/color.h>
#ifndef DOXYGEN_SHOULD_SKIP_THIS
typedef struct _GdkColormap GdkColormap;
typedef struct _GdkColormapClass GdkColormapClass;
#endif /* DOXYGEN_SHOULD_SKIP_THIS */
#ifndef DOXYGEN_SHOULD_SKIP_THIS
namespace Gdk
{ class Colormap_Class; } // namespace Gdk
#endif //DOXYGEN_SHOULD_SKIP_THIS
namespace Gdk
{
/** A Colormap is an object that contains the mapping between the color values stored in memory and the RGB values that are
* used to display color values. In general, colormaps only contain significant information for pseudo-color visuals, but
* even for other visual types, a colormap object is required in some circumstances.
*
* There are a couple of special colormaps that can be retrieved. The system colormap (retrieved with get_system()) is the
* default colormap of the system. If you are using GdkRGB, there is another colormap that is important - the colormap in
* which GdkRGB works, retrieved with Gdk::rgb_get_colormap(). However, when using GdkRGB, it is not generally necessary to
* allocate colors directly.
*/
class Colormap : public Glib::Object
{
#ifndef DOXYGEN_SHOULD_SKIP_THIS
public:
typedef Colormap CppObjectType;
typedef Colormap_Class CppClassType;
typedef GdkColormap BaseObjectType;
typedef GdkColormapClass BaseClassType;
private: friend class Colormap_Class;
static CppClassType colormap_class_;
private:
// noncopyable
Colormap(const Colormap&);
Colormap& operator=(const Colormap&);
protected:
explicit Colormap(const Glib::ConstructParams& construct_params);
explicit Colormap(GdkColormap* castitem);
#endif /* DOXYGEN_SHOULD_SKIP_THIS */
public:
virtual ~Colormap();
/** Get the GType for this class, for use with the underlying GObject type system.
*/
static GType get_type() G_GNUC_CONST;
#ifndef DOXYGEN_SHOULD_SKIP_THIS
static GType get_base_type() G_GNUC_CONST;
#endif
///Provides access to the underlying C GObject.
GdkColormap* gobj() { return reinterpret_cast<GdkColormap*>(gobject_); }
///Provides access to the underlying C GObject.
const GdkColormap* gobj() const { return reinterpret_cast<GdkColormap*>(gobject_); }
///Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs.
GdkColormap* gobj_copy();
private:
protected:
explicit Colormap(const Glib::RefPtr<Visual>& visual, bool allocate);
public:
static Glib::RefPtr<Colormap> create(const Glib::RefPtr<Visual>& visual, bool allocate);
/** Gets the system's default colormap for the default screen. (See
* gdk_colormap_get_system_for_screen())
*
* @return The default colormap.
*/
static Glib::RefPtr<Colormap> get_system();
//_WRAP_METHOD(void change(int ncolors), gdk_colormap_change)
#ifndef GDKMM_DISABLE_DEPRECATED
///@deprecated Use alloc_color().
int alloc_colors(ArrayHandle_Color& colors, int ncolors, bool writeable, bool best_match, Glib::ArrayHandle<bool>& success);
///@deprecated Use free_color()
void free_colors(Color& colors, int ncolors);
#endif // GDKMM_DISABLE_DEPRECATED
/** Allocates a single color from a colormap.
*
* @param color The color to allocate. On return the
* <tt>pixel</tt> field will be
* filled in if allocation succeeds.
* @param writeable If <tt>true</tt>, the color is allocated writeable
* (their values can later be changed using gdk_color_change()).
* Writeable colors cannot be shared between applications.
* @param best_match If <tt>true</tt>, GDK will attempt to do matching against
* existing colors if the color cannot be allocated as requested.
* @return <tt>true</tt> if the allocation succeeded.
*/
bool alloc_color(Color& color, bool writeable = false, bool best_match = true);
void free_color(Color& color);
/** Locates the RGB color in @a colormap corresponding to the given
* hardware pixel @a pixel. @a pixel must be a valid pixel in the
* colormap; it's a programmer error to call this function with a
* pixel which is not in the colormap. Hardware pixels are normally
* obtained from alloc_colors(), or from a Gdk::Image. (A
* Gdk::Image contains image data in hardware format, a Gdk::Pixbuf
* contains image data in a canonical 24-bit RGB format.)
*
* This function is rarely useful; it's used for example to
* implement the eyedropper feature in Gtk::ColorSelection.
*
* @param pixel Pixel value in hardware display format.
* @param result Gdk::Color with red, green, blue fields initialized.
*/
void query_color(gulong pixel, Color& result);
/** Returns the visual for which a given colormap was created.
*
* @return The visual of the colormap.
*/
Glib::RefPtr<Visual> get_visual();
/** Returns the visual for which a given colormap was created.
*
* @return The visual of the colormap.
*/
Glib::RefPtr<const Visual> get_visual() const;
/** Gets the screen for which this colormap was created.
*
* @newin{2,2}
*
* @return The screen for which this colormap was created.
*/
Glib::RefPtr<Screen> get_screen();
/** Gets the screen for which this colormap was created.
*
* @newin{2,2}
*
* @return The screen for which this colormap was created.
*/
Glib::RefPtr<const Screen> get_screen() const;
public:
public:
//C++ methods used to invoke GTK+ virtual functions:
protected:
//GTK+ Virtual Functions (override these to change behaviour):
//Default Signal Handlers::
};
} /* namespace Gdk */
namespace Glib
{
/** A Glib::wrap() method for this object.
*
* @param object The C instance.
* @param take_copy False if the result should take ownership of the C instance. True if it should take a new copy or ref.
* @result A C++ instance that wraps this C instance.
*
* @relates Gdk::Colormap
*/
Glib::RefPtr<Gdk::Colormap> wrap(GdkColormap* object, bool take_copy = false);
}
#endif /* _GDKMM_COLORMAP_H */
|