mirror of
https://gitlab.gnome.org/GNOME/gtk.git
synced 2024-12-29 06:51:10 +00:00
d1f256ac30
This commit adds gdk_window_get_display gdk_window_get_screen gdk_window_get_visual gdk_window_get_width gdk_window_get_height and deprecates the corresponding GdkDrawable APIs. This will make it easier to prepare the port to GTK+ 3
435 lines
14 KiB
C
435 lines
14 KiB
C
/* 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/.
|
|
*/
|
|
|
|
#if defined(GTK_DISABLE_SINGLE_INCLUDES) && !defined (__GDK_H_INSIDE__) && !defined (GDK_COMPILATION)
|
|
#error "Only <gdk/gdk.h> can be included directly."
|
|
#endif
|
|
|
|
#ifndef __GDK_DRAWABLE_H__
|
|
#define __GDK_DRAWABLE_H__
|
|
|
|
#include <gdk/gdktypes.h>
|
|
#include <gdk/gdkgc.h>
|
|
#include <gdk/gdkrgb.h>
|
|
#include <gdk-pixbuf/gdk-pixbuf.h>
|
|
|
|
#include <cairo.h>
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
typedef struct _GdkDrawableClass GdkDrawableClass;
|
|
typedef struct _GdkTrapezoid GdkTrapezoid;
|
|
|
|
#define GDK_TYPE_DRAWABLE (gdk_drawable_get_type ())
|
|
#define GDK_DRAWABLE(object) (G_TYPE_CHECK_INSTANCE_CAST ((object), GDK_TYPE_DRAWABLE, GdkDrawable))
|
|
#define GDK_DRAWABLE_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), GDK_TYPE_DRAWABLE, GdkDrawableClass))
|
|
#define GDK_IS_DRAWABLE(object) (G_TYPE_CHECK_INSTANCE_TYPE ((object), GDK_TYPE_DRAWABLE))
|
|
#define GDK_IS_DRAWABLE_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GDK_TYPE_DRAWABLE))
|
|
#define GDK_DRAWABLE_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), GDK_TYPE_DRAWABLE, GdkDrawableClass))
|
|
|
|
struct _GdkDrawable
|
|
{
|
|
GObject parent_instance;
|
|
};
|
|
|
|
struct _GdkDrawableClass
|
|
{
|
|
GObjectClass parent_class;
|
|
|
|
GdkGC *(*create_gc) (GdkDrawable *drawable,
|
|
GdkGCValues *values,
|
|
GdkGCValuesMask mask);
|
|
void (*draw_rectangle) (GdkDrawable *drawable,
|
|
GdkGC *gc,
|
|
gboolean filled,
|
|
gint x,
|
|
gint y,
|
|
gint width,
|
|
gint height);
|
|
void (*draw_arc) (GdkDrawable *drawable,
|
|
GdkGC *gc,
|
|
gboolean filled,
|
|
gint x,
|
|
gint y,
|
|
gint width,
|
|
gint height,
|
|
gint angle1,
|
|
gint angle2);
|
|
void (*draw_polygon) (GdkDrawable *drawable,
|
|
GdkGC *gc,
|
|
gboolean filled,
|
|
GdkPoint *points,
|
|
gint npoints);
|
|
void (*draw_text) (GdkDrawable *drawable,
|
|
GdkFont *font,
|
|
GdkGC *gc,
|
|
gint x,
|
|
gint y,
|
|
const gchar *text,
|
|
gint text_length);
|
|
void (*draw_text_wc) (GdkDrawable *drawable,
|
|
GdkFont *font,
|
|
GdkGC *gc,
|
|
gint x,
|
|
gint y,
|
|
const GdkWChar *text,
|
|
gint text_length);
|
|
void (*draw_drawable) (GdkDrawable *drawable,
|
|
GdkGC *gc,
|
|
GdkDrawable *src,
|
|
gint xsrc,
|
|
gint ysrc,
|
|
gint xdest,
|
|
gint ydest,
|
|
gint width,
|
|
gint height);
|
|
void (*draw_points) (GdkDrawable *drawable,
|
|
GdkGC *gc,
|
|
GdkPoint *points,
|
|
gint npoints);
|
|
void (*draw_segments) (GdkDrawable *drawable,
|
|
GdkGC *gc,
|
|
GdkSegment *segs,
|
|
gint nsegs);
|
|
void (*draw_lines) (GdkDrawable *drawable,
|
|
GdkGC *gc,
|
|
GdkPoint *points,
|
|
gint npoints);
|
|
|
|
void (*draw_glyphs) (GdkDrawable *drawable,
|
|
GdkGC *gc,
|
|
PangoFont *font,
|
|
gint x,
|
|
gint y,
|
|
PangoGlyphString *glyphs);
|
|
|
|
void (*draw_image) (GdkDrawable *drawable,
|
|
GdkGC *gc,
|
|
GdkImage *image,
|
|
gint xsrc,
|
|
gint ysrc,
|
|
gint xdest,
|
|
gint ydest,
|
|
gint width,
|
|
gint height);
|
|
|
|
gint (*get_depth) (GdkDrawable *drawable);
|
|
void (*get_size) (GdkDrawable *drawable,
|
|
gint *width,
|
|
gint *height);
|
|
|
|
void (*set_colormap) (GdkDrawable *drawable,
|
|
GdkColormap *cmap);
|
|
|
|
GdkColormap* (*get_colormap) (GdkDrawable *drawable);
|
|
GdkVisual* (*get_visual) (GdkDrawable *drawable);
|
|
GdkScreen* (*get_screen) (GdkDrawable *drawable);
|
|
|
|
GdkImage* (*get_image) (GdkDrawable *drawable,
|
|
gint x,
|
|
gint y,
|
|
gint width,
|
|
gint height);
|
|
|
|
GdkRegion* (*get_clip_region) (GdkDrawable *drawable);
|
|
GdkRegion* (*get_visible_region) (GdkDrawable *drawable);
|
|
|
|
GdkDrawable* (*get_composite_drawable) (GdkDrawable *drawable,
|
|
gint x,
|
|
gint y,
|
|
gint width,
|
|
gint height,
|
|
gint *composite_x_offset,
|
|
gint *composite_y_offset);
|
|
|
|
void (*draw_pixbuf) (GdkDrawable *drawable,
|
|
GdkGC *gc,
|
|
GdkPixbuf *pixbuf,
|
|
gint src_x,
|
|
gint src_y,
|
|
gint dest_x,
|
|
gint dest_y,
|
|
gint width,
|
|
gint height,
|
|
GdkRgbDither dither,
|
|
gint x_dither,
|
|
gint y_dither);
|
|
GdkImage* (*_copy_to_image) (GdkDrawable *drawable,
|
|
GdkImage *image,
|
|
gint src_x,
|
|
gint src_y,
|
|
gint dest_x,
|
|
gint dest_y,
|
|
gint width,
|
|
gint height);
|
|
|
|
void (*draw_glyphs_transformed) (GdkDrawable *drawable,
|
|
GdkGC *gc,
|
|
PangoMatrix *matrix,
|
|
PangoFont *font,
|
|
gint x,
|
|
gint y,
|
|
PangoGlyphString *glyphs);
|
|
void (*draw_trapezoids) (GdkDrawable *drawable,
|
|
GdkGC *gc,
|
|
GdkTrapezoid *trapezoids,
|
|
gint n_trapezoids);
|
|
|
|
cairo_surface_t *(*ref_cairo_surface) (GdkDrawable *drawable);
|
|
|
|
GdkDrawable *(*get_source_drawable) (GdkDrawable *drawable);
|
|
|
|
void (*set_cairo_clip) (GdkDrawable *drawable,
|
|
cairo_t *cr);
|
|
|
|
cairo_surface_t * (*create_cairo_surface) (GdkDrawable *drawable,
|
|
int width,
|
|
int height);
|
|
|
|
void (*draw_drawable_with_src) (GdkDrawable *drawable,
|
|
GdkGC *gc,
|
|
GdkDrawable *src,
|
|
gint xsrc,
|
|
gint ysrc,
|
|
gint xdest,
|
|
gint ydest,
|
|
gint width,
|
|
gint height,
|
|
GdkDrawable *original_src);
|
|
|
|
/* Padding for future expansion */
|
|
void (*_gdk_reserved7) (void);
|
|
void (*_gdk_reserved9) (void);
|
|
void (*_gdk_reserved10) (void);
|
|
void (*_gdk_reserved11) (void);
|
|
void (*_gdk_reserved12) (void);
|
|
void (*_gdk_reserved13) (void);
|
|
void (*_gdk_reserved14) (void);
|
|
void (*_gdk_reserved15) (void);
|
|
};
|
|
|
|
struct _GdkTrapezoid
|
|
{
|
|
double y1, x11, x21, y2, x12, x22;
|
|
};
|
|
|
|
GType gdk_drawable_get_type (void) G_GNUC_CONST;
|
|
|
|
/* Manipulation of drawables
|
|
*/
|
|
|
|
#ifndef GDK_DISABLE_DEPRECATED
|
|
void gdk_drawable_set_data (GdkDrawable *drawable,
|
|
const gchar *key,
|
|
gpointer data,
|
|
GDestroyNotify destroy_func);
|
|
gpointer gdk_drawable_get_data (GdkDrawable *drawable,
|
|
const gchar *key);
|
|
#endif /* GDK_DISABLE_DEPRECATED */
|
|
|
|
void gdk_drawable_set_colormap (GdkDrawable *drawable,
|
|
GdkColormap *colormap);
|
|
GdkColormap* gdk_drawable_get_colormap (GdkDrawable *drawable);
|
|
gint gdk_drawable_get_depth (GdkDrawable *drawable);
|
|
|
|
#ifndef GDK_DISABLE_DEPRECATED
|
|
void gdk_drawable_get_size (GdkDrawable *drawable,
|
|
gint *width,
|
|
gint *height);
|
|
GdkVisual* gdk_drawable_get_visual (GdkDrawable *drawable);
|
|
GdkScreen* gdk_drawable_get_screen (GdkDrawable *drawable);
|
|
GdkDisplay* gdk_drawable_get_display (GdkDrawable *drawable);
|
|
|
|
GdkDrawable* gdk_drawable_ref (GdkDrawable *drawable);
|
|
void gdk_drawable_unref (GdkDrawable *drawable);
|
|
#endif /* GDK_DISABLE_DEPRECATED */
|
|
|
|
/* Drawing
|
|
*/
|
|
#ifndef GDK_DISABLE_DEPRECATED
|
|
void gdk_draw_point (GdkDrawable *drawable,
|
|
GdkGC *gc,
|
|
gint x,
|
|
gint y);
|
|
void gdk_draw_line (GdkDrawable *drawable,
|
|
GdkGC *gc,
|
|
gint x1_,
|
|
gint y1_,
|
|
gint x2_,
|
|
gint y2_);
|
|
void gdk_draw_rectangle (GdkDrawable *drawable,
|
|
GdkGC *gc,
|
|
gboolean filled,
|
|
gint x,
|
|
gint y,
|
|
gint width,
|
|
gint height);
|
|
void gdk_draw_arc (GdkDrawable *drawable,
|
|
GdkGC *gc,
|
|
gboolean filled,
|
|
gint x,
|
|
gint y,
|
|
gint width,
|
|
gint height,
|
|
gint angle1,
|
|
gint angle2);
|
|
void gdk_draw_polygon (GdkDrawable *drawable,
|
|
GdkGC *gc,
|
|
gboolean filled,
|
|
const GdkPoint *points,
|
|
gint n_points);
|
|
void gdk_draw_string (GdkDrawable *drawable,
|
|
GdkFont *font,
|
|
GdkGC *gc,
|
|
gint x,
|
|
gint y,
|
|
const gchar *string);
|
|
void gdk_draw_text (GdkDrawable *drawable,
|
|
GdkFont *font,
|
|
GdkGC *gc,
|
|
gint x,
|
|
gint y,
|
|
const gchar *text,
|
|
gint text_length);
|
|
void gdk_draw_text_wc (GdkDrawable *drawable,
|
|
GdkFont *font,
|
|
GdkGC *gc,
|
|
gint x,
|
|
gint y,
|
|
const GdkWChar *text,
|
|
gint text_length);
|
|
void gdk_draw_drawable (GdkDrawable *drawable,
|
|
GdkGC *gc,
|
|
GdkDrawable *src,
|
|
gint xsrc,
|
|
gint ysrc,
|
|
gint xdest,
|
|
gint ydest,
|
|
gint width,
|
|
gint height);
|
|
void gdk_draw_image (GdkDrawable *drawable,
|
|
GdkGC *gc,
|
|
GdkImage *image,
|
|
gint xsrc,
|
|
gint ysrc,
|
|
gint xdest,
|
|
gint ydest,
|
|
gint width,
|
|
gint height);
|
|
void gdk_draw_points (GdkDrawable *drawable,
|
|
GdkGC *gc,
|
|
const GdkPoint *points,
|
|
gint n_points);
|
|
void gdk_draw_segments (GdkDrawable *drawable,
|
|
GdkGC *gc,
|
|
const GdkSegment *segs,
|
|
gint n_segs);
|
|
void gdk_draw_lines (GdkDrawable *drawable,
|
|
GdkGC *gc,
|
|
const GdkPoint *points,
|
|
gint n_points);
|
|
void gdk_draw_pixbuf (GdkDrawable *drawable,
|
|
GdkGC *gc,
|
|
const GdkPixbuf *pixbuf,
|
|
gint src_x,
|
|
gint src_y,
|
|
gint dest_x,
|
|
gint dest_y,
|
|
gint width,
|
|
gint height,
|
|
GdkRgbDither dither,
|
|
gint x_dither,
|
|
gint y_dither);
|
|
|
|
void gdk_draw_glyphs (GdkDrawable *drawable,
|
|
GdkGC *gc,
|
|
PangoFont *font,
|
|
gint x,
|
|
gint y,
|
|
PangoGlyphString *glyphs);
|
|
void gdk_draw_layout_line (GdkDrawable *drawable,
|
|
GdkGC *gc,
|
|
gint x,
|
|
gint y,
|
|
PangoLayoutLine *line);
|
|
void gdk_draw_layout (GdkDrawable *drawable,
|
|
GdkGC *gc,
|
|
gint x,
|
|
gint y,
|
|
PangoLayout *layout);
|
|
|
|
void gdk_draw_layout_line_with_colors (GdkDrawable *drawable,
|
|
GdkGC *gc,
|
|
gint x,
|
|
gint y,
|
|
PangoLayoutLine *line,
|
|
const GdkColor *foreground,
|
|
const GdkColor *background);
|
|
void gdk_draw_layout_with_colors (GdkDrawable *drawable,
|
|
GdkGC *gc,
|
|
gint x,
|
|
gint y,
|
|
PangoLayout *layout,
|
|
const GdkColor *foreground,
|
|
const GdkColor *background);
|
|
|
|
void gdk_draw_glyphs_transformed (GdkDrawable *drawable,
|
|
GdkGC *gc,
|
|
const PangoMatrix *matrix,
|
|
PangoFont *font,
|
|
gint x,
|
|
gint y,
|
|
PangoGlyphString *glyphs);
|
|
void gdk_draw_trapezoids (GdkDrawable *drawable,
|
|
GdkGC *gc,
|
|
const GdkTrapezoid *trapezoids,
|
|
gint n_trapezoids);
|
|
|
|
#define gdk_draw_pixmap gdk_draw_drawable
|
|
#define gdk_draw_bitmap gdk_draw_drawable
|
|
|
|
GdkImage* gdk_drawable_get_image (GdkDrawable *drawable,
|
|
gint x,
|
|
gint y,
|
|
gint width,
|
|
gint height);
|
|
GdkImage *gdk_drawable_copy_to_image (GdkDrawable *drawable,
|
|
GdkImage *image,
|
|
gint src_x,
|
|
gint src_y,
|
|
gint dest_x,
|
|
gint dest_y,
|
|
gint width,
|
|
gint height);
|
|
#endif /* GDK_DISABLE_DEPRECATED */
|
|
|
|
GdkRegion *gdk_drawable_get_clip_region (GdkDrawable *drawable);
|
|
GdkRegion *gdk_drawable_get_visible_region (GdkDrawable *drawable);
|
|
|
|
G_END_DECLS
|
|
|
|
#endif /* __GDK_DRAWABLE_H__ */
|