* 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., 59 Temple Place - Suite 330,
- * Boston, MA 02111-1307, USA.
+ * License along with this library. If not, see <http://www.gnu.org/licenses/>.
*/
/*
* GTK+ at ftp://ftp.gtk.org/pub/gtk/.
*/
+#ifndef __GDK_COLOR_H__
+#define __GDK_COLOR_H__
+
#if !defined (__GDK_H_INSIDE__) && !defined (GDK_COMPILATION)
#error "Only <gdk/gdk.h> can be included directly."
#endif
-#ifndef __GDK_COLOR_H__
-#define __GDK_COLOR_H__
-
#include <cairo.h>
#include <gdk/gdktypes.h>
G_BEGIN_DECLS
-/* The color type.
- * A color consists of red, green and blue values in the
- * range 0-65535 and a pixel value. The pixel value is highly
- * dependent on the depth and colormap which this color will
- * be used to draw into. Therefore, sharing colors between
- * colormaps is a bad idea.
+
+/**
+ * GdkColor:
+ * @pixel: For allocated colors, the pixel value used to
+ * draw this color on the screen. Not used anymore.
+ * @red: The red component of the color. This is
+ * a value between 0 and 65535, with 65535 indicating
+ * full intensity
+ * @green: The green component of the color
+ * @blue: The blue component of the color
+ *
+ * The #GdkColor structure is used to describe a color,
+ * similar to the XColor struct used in the X11 drawing API.
*/
struct _GdkColor
{
guint16 blue;
};
-/* The colormap type.
- */
-
-typedef struct _GdkColormapClass GdkColormapClass;
-
-#define GDK_TYPE_COLORMAP (gdk_colormap_get_type ())
-#define GDK_COLORMAP(object) (G_TYPE_CHECK_INSTANCE_CAST ((object), GDK_TYPE_COLORMAP, GdkColormap))
-#define GDK_COLORMAP_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), GDK_TYPE_COLORMAP, GdkColormapClass))
-#define GDK_IS_COLORMAP(object) (G_TYPE_CHECK_INSTANCE_TYPE ((object), GDK_TYPE_COLORMAP))
-#define GDK_IS_COLORMAP_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GDK_TYPE_COLORMAP))
-#define GDK_COLORMAP_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), GDK_TYPE_COLORMAP, GdkColormapClass))
-
-#define GDK_TYPE_COLOR (gdk_color_get_type ())
-
-struct _GdkColormap
-{
- /*< private >*/
- GObject parent_instance;
-
- /*< public >*/
- gint GSEAL (size);
- GdkColor *GSEAL (colors);
-
- /*< private >*/
- GdkVisual *GSEAL (visual);
-
- gpointer GSEAL (windowing_data);
-};
-
-struct _GdkColormapClass
-{
- GObjectClass parent_class;
+#define GDK_TYPE_COLOR (gdk_color_get_type ())
-};
-
-GType gdk_colormap_get_type (void) G_GNUC_CONST;
-
-GdkColormap* gdk_colormap_new (GdkVisual *visual,
- gboolean allocate);
-
-#ifndef GDK_DISABLE_DEPRECATED
-GdkColormap* gdk_colormap_ref (GdkColormap *cmap);
-void gdk_colormap_unref (GdkColormap *cmap);
-#endif
-
-#ifndef GDK_MULTIHEAD_SAFE
-GdkColormap* gdk_colormap_get_system (void);
-#endif
-
-GdkScreen *gdk_colormap_get_screen (GdkColormap *cmap);
-
-#ifndef GDK_DISABLE_DEPRECATED
-gint gdk_colormap_get_system_size (void);
-#endif
-
-#if !defined (GDK_DISABLE_DEPRECATED) || defined (GDK_COMPILATION)
-/* Used by gdk_colors_store () */
-void gdk_colormap_change (GdkColormap *colormap,
- gint ncolors);
-#endif
-
-gint gdk_colormap_alloc_colors (GdkColormap *colormap,
- GdkColor *colors,
- gint n_colors,
- gboolean writeable,
- gboolean best_match,
- gboolean *success);
-gboolean gdk_colormap_alloc_color (GdkColormap *colormap,
- GdkColor *color,
- gboolean writeable,
- gboolean best_match);
-void gdk_colormap_free_colors (GdkColormap *colormap,
- const GdkColor *colors,
- gint n_colors);
-void gdk_colormap_query_color (GdkColormap *colormap,
- gulong pixel,
- GdkColor *result);
-
-GdkVisual *gdk_colormap_get_visual (GdkColormap *colormap);
+GType gdk_color_get_type (void) G_GNUC_CONST;
GdkColor *gdk_color_copy (const GdkColor *color);
void gdk_color_free (GdkColor *color);
-gboolean gdk_color_parse (const gchar *spec,
- GdkColor *color);
-guint gdk_color_hash (const GdkColor *colora);
-gboolean gdk_color_equal (const GdkColor *colora,
- const GdkColor *colorb);
-gchar * gdk_color_to_string (const GdkColor *color);
-GType gdk_color_get_type (void) G_GNUC_CONST;
+guint gdk_color_hash (const GdkColor *color);
+gboolean gdk_color_equal (const GdkColor *colora,
+ const GdkColor *colorb);
-/* The following functions are deprecated */
-#ifndef GDK_DISABLE_DEPRECATED
-void gdk_colors_store (GdkColormap *colormap,
- GdkColor *colors,
- gint ncolors);
-gint gdk_color_white (GdkColormap *colormap,
- GdkColor *color);
-gint gdk_color_black (GdkColormap *colormap,
- GdkColor *color);
-gint gdk_color_alloc (GdkColormap *colormap,
- GdkColor *color);
-gint gdk_color_change (GdkColormap *colormap,
- GdkColor *color);
-#endif /* GDK_DISABLE_DEPRECATED */
+gboolean gdk_color_parse (const gchar *spec,
+ GdkColor *color);
+gchar * gdk_color_to_string (const GdkColor *color);
-#if !defined (GDK_DISABLE_DEPRECATED) || defined (GDK_COMPILATION)
-/* Used by gdk_rgb_try_colormap () */
-gint gdk_colors_alloc (GdkColormap *colormap,
- gboolean contiguous,
- gulong *planes,
- gint nplanes,
- gulong *pixels,
- gint npixels);
-void gdk_colors_free (GdkColormap *colormap,
- gulong *pixels,
- gint npixels,
- gulong planes);
-#endif /* !GDK_DISABLE_DEPRECATED || GDK_COMPILATION */
G_END_DECLS