gdkgc.h

Go to the documentation of this file.

/* GDK - The GIMP Drawing Kit
 * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
 *
 * 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 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., 59 Temple Place - Suite 330,
 * Boston, MA 02111-1307, USA.
 */
 
/*
 * Modified by the GTK+ Team and others 1997-2000.  See the AUTHORS
 * file for a list of people on the GTK+ Team.  See the ChangeLog
 * files for a list of changes.  These files are distributed with
 * GTK+ at ftp://ftp.gtk.org/pub/gtk/.
 */
 
#ifndef __GDK_GC_H__
#define __GDK_GC_H__
 
#if defined(GTK_DISABLE_SINGLE_INCLUDES) && !defined (__GDK_H_INSIDE__) && !defined (GDK_COMPILATION)
#error "Only <gdk/gdk.h> can be included directly."
#endif
 
#include <gdk/gdkcolor.h>
#include <gdk/gdktypes.h>
 
G_BEGIN_DECLS
 
typedef struct _GdkGCValues           GdkGCValues;
typedef struct _GdkGCClass            GdkGCClass;
 
/* GC cap styles
 *  CapNotLast:
 *  CapButt:
 *  CapRound:
 *  CapProjecting:
 */
typedef enum
{
  GDK_CAP_NOT_LAST,
  GDK_CAP_BUTT,
  GDK_CAP_ROUND,
  GDK_CAP_PROJECTING
} GdkCapStyle;
 
/* GC fill types.
 *  Solid:
 *  Tiled:
 *  Stippled:
 *  OpaqueStippled:
 */
typedef enum
{
  GDK_SOLID,
  GDK_TILED,
  GDK_STIPPLED,
  GDK_OPAQUE_STIPPLED
} GdkFill;
 
/* GC function types.
 *   Copy: Overwrites destination pixels with the source pixels.
 *   Invert: Inverts the destination pixels.
 *   Xor: Xor's the destination pixels with the source pixels.
 *   Clear: set pixels to 0
 *   And: source AND destination
 *   And Reverse: source AND (NOT destination)
 *   And Invert: (NOT source) AND destination
 *   Noop: destination
 *   Or: source OR destination
 *   Nor: (NOT source) AND (NOT destination)
 *   Equiv: (NOT source) XOR destination
 *   Xor Reverse: source OR (NOT destination)
 *   Copy Inverted: NOT source
 *   Xor Inverted: (NOT source) OR destination
 *   Nand: (NOT source) OR (NOT destination)
 *   Set: set pixels to 1
 */
typedef enum
{
  GDK_COPY,
  GDK_INVERT,
  GDK_XOR,
  GDK_CLEAR,
  GDK_AND,
  GDK_AND_REVERSE,
  GDK_AND_INVERT,
  GDK_NOOP,
  GDK_OR,
  GDK_EQUIV,
  GDK_OR_REVERSE,
  GDK_COPY_INVERT,
  GDK_OR_INVERT,
  GDK_NAND,
  GDK_NOR,
  GDK_SET
} GdkFunction;
 
/* GC join styles
 *  JoinMiter:
 *  JoinRound:
 *  JoinBevel:
 */
typedef enum
{
  GDK_JOIN_MITER,
  GDK_JOIN_ROUND,
  GDK_JOIN_BEVEL
} GdkJoinStyle;
 
/* GC line styles
 *  Solid:
 *  OnOffDash:
 *  DoubleDash:
 */
typedef enum
{
  GDK_LINE_SOLID,
  GDK_LINE_ON_OFF_DASH,
  GDK_LINE_DOUBLE_DASH
} GdkLineStyle;
 
typedef enum
{
  GDK_CLIP_BY_CHILDREN  = 0,
  GDK_INCLUDE_INFERIORS = 1
} GdkSubwindowMode;
 
typedef enum
{
  GDK_GC_FOREGROUND    = 1 << 0,
  GDK_GC_BACKGROUND    = 1 << 1,
  GDK_GC_FONT          = 1 << 2,
  GDK_GC_FUNCTION      = 1 << 3,
  GDK_GC_FILL          = 1 << 4,
  GDK_GC_TILE          = 1 << 5,
  GDK_GC_STIPPLE       = 1 << 6,
  GDK_GC_CLIP_MASK     = 1 << 7,
  GDK_GC_SUBWINDOW     = 1 << 8,
  GDK_GC_TS_X_ORIGIN   = 1 << 9,
  GDK_GC_TS_Y_ORIGIN   = 1 << 10,
  GDK_GC_CLIP_X_ORIGIN = 1 << 11,
  GDK_GC_CLIP_Y_ORIGIN = 1 << 12,
  GDK_GC_EXPOSURES     = 1 << 13,
  GDK_GC_LINE_WIDTH    = 1 << 14,
  GDK_GC_LINE_STYLE    = 1 << 15,
  GDK_GC_CAP_STYLE     = 1 << 16,
  GDK_GC_JOIN_STYLE    = 1 << 17
} GdkGCValuesMask;
 
struct _GdkGCValues
{
  GdkColor          foreground;
  GdkColor          background;
  GdkFont          *font;
  GdkFunction       function;
  GdkFill           fill;
  GdkPixmap        *tile;
  GdkPixmap        *stipple;
  GdkPixmap        *clip_mask;
  GdkSubwindowMode  subwindow_mode;
  gint              ts_x_origin;
  gint              ts_y_origin;
  gint              clip_x_origin;
  gint              clip_y_origin;
  gint              graphics_exposures;
  gint              line_width;
  GdkLineStyle      line_style;
  GdkCapStyle       cap_style;
  GdkJoinStyle      join_style;
};
 
#define GDK_TYPE_GC              (gdk_gc_get_type ())
#define GDK_GC(object)           (G_TYPE_CHECK_INSTANCE_CAST ((object), GDK_TYPE_GC, GdkGC))
#define GDK_GC_CLASS(klass)      (G_TYPE_CHECK_CLASS_CAST ((klass), GDK_TYPE_GC, GdkGCClass))
#define GDK_IS_GC(object)        (G_TYPE_CHECK_INSTANCE_TYPE ((object), GDK_TYPE_GC))
#define GDK_IS_GC_CLASS(klass)   (G_TYPE_CHECK_CLASS_TYPE ((klass), GDK_TYPE_GC))
#define GDK_GC_GET_CLASS(obj)    (G_TYPE_INSTANCE_GET_CLASS ((obj), GDK_TYPE_GC, GdkGCClass))
 
struct _GdkGC
{
  GObject parent_instance;
 
  gint GSEAL (clip_x_origin);
  gint GSEAL (clip_y_origin);
  gint GSEAL (ts_x_origin);
  gint GSEAL (ts_y_origin);
 
  GdkColormap *GSEAL (colormap);
};
 
struct _GdkGCClass 
{
  GObjectClass parent_class;
  
  void (*get_values)     (GdkGC          *gc,
                          GdkGCValues    *values);
  void (*set_values)     (GdkGC          *gc,
                          GdkGCValues    *values,
                          GdkGCValuesMask mask);
  void (*set_dashes)     (GdkGC          *gc,
                          gint            dash_offset,
                          gint8           dash_list[],
                          gint            n);
  
  /* Padding for future expansion */
  void         (*_gdk_reserved1)  (void);
  void         (*_gdk_reserved2)  (void);
  void         (*_gdk_reserved3)  (void);
  void         (*_gdk_reserved4)  (void);
};
 
 
#ifndef GDK_DISABLE_DEPRECATED
GType  gdk_gc_get_type            (void) G_GNUC_CONST;
GdkGC *gdk_gc_new                 (GdkDrawable      *drawable);
GdkGC *gdk_gc_new_with_values     (GdkDrawable      *drawable,
                                   GdkGCValues      *values,
                                   GdkGCValuesMask   values_mask);
 
GdkGC *gdk_gc_ref                 (GdkGC            *gc);
void   gdk_gc_unref               (GdkGC            *gc);
 
void   gdk_gc_get_values          (GdkGC            *gc,
                                   GdkGCValues      *values);
void   gdk_gc_set_values          (GdkGC           *gc,
                                   GdkGCValues     *values,
                                   GdkGCValuesMask  values_mask);
void   gdk_gc_set_foreground      (GdkGC            *gc,
                                   const GdkColor   *color);
void   gdk_gc_set_background      (GdkGC            *gc,
                                   const GdkColor   *color);
void   gdk_gc_set_font            (GdkGC            *gc,
                                   GdkFont          *font);
void   gdk_gc_set_function        (GdkGC            *gc,
                                   GdkFunction       function);
void   gdk_gc_set_fill            (GdkGC            *gc,
                                   GdkFill           fill);
void   gdk_gc_set_tile            (GdkGC            *gc,
                                   GdkPixmap        *tile);
void   gdk_gc_set_stipple         (GdkGC            *gc,
                                   GdkPixmap        *stipple);
void   gdk_gc_set_ts_origin       (GdkGC            *gc,
                                   gint              x,
                                   gint              y);
void   gdk_gc_set_clip_origin     (GdkGC            *gc,
                                   gint              x,
                                   gint              y);
void   gdk_gc_set_clip_mask       (GdkGC            *gc,
                                   GdkBitmap        *mask);
void   gdk_gc_set_clip_rectangle  (GdkGC            *gc,
                                   const GdkRectangle *rectangle);
void   gdk_gc_set_clip_region     (GdkGC            *gc,
                                   const GdkRegion  *region);
void   gdk_gc_set_subwindow       (GdkGC            *gc,
                                   GdkSubwindowMode  mode);
void   gdk_gc_set_exposures       (GdkGC            *gc,
                                   gboolean          exposures);
void   gdk_gc_set_line_attributes (GdkGC            *gc,
                                   gint              line_width,
                                   GdkLineStyle      line_style,
                                   GdkCapStyle       cap_style,
                                   GdkJoinStyle      join_style);
void   gdk_gc_set_dashes          (GdkGC            *gc,
                                   gint              dash_offset,
                                   gint8             dash_list[],
                                   gint              n);
void   gdk_gc_offset              (GdkGC            *gc,
                                   gint              x_offset,
                                   gint              y_offset);
void   gdk_gc_copy                (GdkGC            *dst_gc,
                                   GdkGC            *src_gc);
 
 
void         gdk_gc_set_colormap     (GdkGC          *gc,
                                      GdkColormap    *colormap);
GdkColormap *gdk_gc_get_colormap     (GdkGC          *gc);
void         gdk_gc_set_rgb_fg_color (GdkGC          *gc,
                                      const GdkColor *color);
void         gdk_gc_set_rgb_bg_color (GdkGC          *gc,
                                      const GdkColor *color);
GdkScreen *  gdk_gc_get_screen       (GdkGC          *gc);
 
#define gdk_gc_destroy                 g_object_unref
#endif /* GDK_DISABLE_DEPRECATED */
 
G_END_DECLS
 
#endif /* __GDK_DRAWABLE_H__ */