forked from AuroraMiddleware/gtk
eacd03aef2
2001-10-02 Havoc Pennington <hp@redhat.com>
Throughout: assorted docs
* gdk/gdkwindow.h: deprecate gdk_window_set_hints(), it's broken,
gdk_window_set_geometry_hints() should be used instead.
* gdk/gdkimage.h: deprecate gdk_image_ref, gdk_image_unref, and
document them
* gdk/x11/gdkx.h: remove gdk_get_client_window() since it doesn't
seem to exist in any .c files
* gdk/x11/gdkcolor-x11.c (gdk_colormap_query_color): docs,
g_return_if_fail (pixel < colormap->size).
109 lines
3.1 KiB
C
109 lines
3.1 KiB
C
#ifndef __GDK_IMAGE_H__
|
|
#define __GDK_IMAGE_H__
|
|
|
|
#include <gdk/gdktypes.h>
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif /* __cplusplus */
|
|
|
|
/* Types of images.
|
|
* Normal: Normal X image type. These are slow as they involve passing
|
|
* the entire image through the X connection each time a draw
|
|
* request is required. On Win32, a bitmap.
|
|
* Shared: Shared memory X image type. These are fast as the X server
|
|
* and the program actually use the same piece of memory. They
|
|
* should be used with care though as there is the possibility
|
|
* for both the X server and the program to be reading/writing
|
|
* the image simultaneously and producing undesired results.
|
|
* On Win32, also a bitmap.
|
|
*/
|
|
typedef enum
|
|
{
|
|
GDK_IMAGE_NORMAL,
|
|
GDK_IMAGE_SHARED,
|
|
GDK_IMAGE_FASTEST
|
|
} GdkImageType;
|
|
|
|
typedef struct _GdkImageClass GdkImageClass;
|
|
|
|
#define GDK_TYPE_IMAGE (gdk_image_get_type ())
|
|
#define GDK_IMAGE(object) (G_TYPE_CHECK_INSTANCE_CAST ((object), GDK_TYPE_IMAGE, GdkImage))
|
|
#define GDK_IMAGE_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), GDK_TYPE_IMAGE, GdkImageClass))
|
|
#define GDK_IS_IMAGE(object) (G_TYPE_CHECK_INSTANCE_TYPE ((object), GDK_TYPE_IMAGE))
|
|
#define GDK_IS_IMAGE_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GDK_TYPE_IMAGE))
|
|
#define GDK_IMAGE_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), GDK_TYPE_IMAGE, GdkImageClass))
|
|
|
|
struct _GdkImage
|
|
{
|
|
GObject parent_instance;
|
|
|
|
GdkImageType type;
|
|
GdkVisual *visual; /* visual used to create the image */
|
|
GdkByteOrder byte_order;
|
|
gint width;
|
|
gint height;
|
|
guint16 depth;
|
|
guint16 bpp; /* bytes per pixel */
|
|
guint16 bpl; /* bytes per line */
|
|
guint16 bits_per_pixel; /* bits per pixel */
|
|
gpointer mem;
|
|
|
|
GdkColormap *colormap;
|
|
|
|
gpointer windowing_data;
|
|
};
|
|
|
|
struct _GdkImageClass
|
|
{
|
|
GObjectClass parent_class;
|
|
};
|
|
|
|
GType gdk_image_get_type (void) G_GNUC_CONST;
|
|
|
|
GdkImage* gdk_image_new (GdkImageType type,
|
|
GdkVisual *visual,
|
|
gint width,
|
|
gint height);
|
|
|
|
GdkImage* gdk_image_get (GdkDrawable *drawable,
|
|
gint x,
|
|
gint y,
|
|
gint width,
|
|
gint height);
|
|
|
|
#ifndef GDK_DISABLE_DEPRECATED
|
|
GdkImage * gdk_image_ref (GdkImage *image);
|
|
void gdk_image_unref (GdkImage *image);
|
|
#endif
|
|
|
|
void gdk_image_put_pixel (GdkImage *image,
|
|
gint x,
|
|
gint y,
|
|
guint32 pixel);
|
|
guint32 gdk_image_get_pixel (GdkImage *image,
|
|
gint x,
|
|
gint y);
|
|
|
|
void gdk_image_set_colormap (GdkImage *image,
|
|
GdkColormap *colormap);
|
|
GdkColormap* gdk_image_get_colormap (GdkImage *image);
|
|
|
|
|
|
#ifdef GDK_ENABLE_BROKEN
|
|
GdkImage* gdk_image_new_bitmap (GdkVisual *visual,
|
|
gpointer data,
|
|
gint width,
|
|
gint height);
|
|
#endif /* GDK_ENABLE_BROKEN */
|
|
|
|
#ifndef GDK_DISABLE_DEPRECATED
|
|
#define gdk_image_destroy gdk_image_unref
|
|
#endif /* GDK_DISABLE_DEPRECATED */
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif /* __cplusplus */
|
|
|
|
#endif /* __GDK_IMAGE_H__ */
|