Images
A client-side area for bit-mapped graphics
The #GdkImage type represents an area for drawing graphics.
It has now been superceded to a large extent by the much more flexible
GdkRGB functions.
To create an empty #GdkImage use gdk_image_new().
To create an image from part of a #GdkWindow use gdk_drawable_get_image().
The image can be manipulated with gdk_image_get_pixel() and
gdk_image_put_pixel(), or alternatively by changing the actual pixel data.
Though manipulating the pixel data requires complicated code to cope with
the different formats that may be used.
To draw a #GdkImage in a #GdkWindow or #GdkPixmap use gdk_draw_image().
To destroy a #GdkImage use g_object_unref().
Bitmaps and Pixmaps
Graphics which are stored on the X Windows server.
Since these are stored on the server they can be drawn very quickly, and all
of the Drawing Primitives can be
used to draw on them. Their main disadvantage is that manipulating individual
pixels can be very slow.
GdkRGB
Built on top of #GdkImage, this provides much more functionality,
including the dithering of colors to produce better output on low-color
displays.
The #GdkImage struct contains information on the image and the pixel data.
@parent_instance: the parent instance
Creates a new #GdkImage.
@type: the type of the #GdkImage, one of %GDK_IMAGE_NORMAL, %GDK_IMAGE_SHARED
and %GDK_IMAGE_FASTEST. %GDK_IMAGE_FASTEST is probably the best choice, since
it will try creating a %GDK_IMAGE_SHARED image first and if that fails it will
then use %GDK_IMAGE_NORMAL.
@visual: the #GdkVisual to use for the image.
@width: the width of the image in pixels.
@height: the height of the image in pixels.
@Returns: a new #GdkImage, or %NULL if the image could not be created.
Specifies the type of a #GdkImage.
@GDK_IMAGE_NORMAL: The original X image type, which is quite slow since the
image has to be transferred from the client to the server to display it.
@GDK_IMAGE_SHARED: A faster image type, which uses shared memory to transfer
the image data between client and server. However this will only be available
if client and server are on the same machine and the shared memory extension
is supported by the server.
@GDK_IMAGE_FASTEST: Specifies that %GDK_IMAGE_SHARED should be tried first,
and if that fails then %GDK_IMAGE_NORMAL will be used.
@image:
@Returns:
@image:
@colormap:
@image:
@Returns:
@image:
@Returns:
@image:
@Returns:
@image:
@Returns:
@image:
@Returns:
@image:
@Returns:
@image:
@Returns:
@image:
@Returns:
@image:
@Returns:
Sets a pixel in a #GdkImage to a given pixel value.
@image: a #GdkImage.
@x: the x coordinate of the pixel to set.
@y: the y coordinate of the pixel to set.
@pixel: the pixel value to set.
Gets a pixel value at a specified position in a #GdkImage.
@image: a #GdkImage.
@x: the x coordinate of the pixel to get.
@y: the y coordinate of the pixel to get.
@Returns: the pixel value at the given position.