Blob Blame History Raw
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>XlibRGB: GDK-PixBuf Reference Manual</title>
<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
<link rel="home" href="index.html" title="GDK-PixBuf Reference Manual">
<link rel="up" href="rn01.html" title="API Reference">
<link rel="prev" href="gdk-pixbuf-X-Drawables-to-Pixbufs.html" title="X Drawables to Pixbufs">
<link rel="next" href="rn02.html" title="Tools Reference">
<meta name="generator" content="GTK-Doc V1.27 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
<td width="100%" align="left" class="shortcuts">
<a href="#" class="shortcut">Top</a><span id="nav_description">  <span class="dim">|</span> 
                  <a href="#gdk-pixbuf-XlibRGB.description" class="shortcut">Description</a></span>
</td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
<td><a accesskey="u" href="rn01.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
<td><a accesskey="p" href="gdk-pixbuf-X-Drawables-to-Pixbufs.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
<td><a accesskey="n" href="rn02.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
</tr></table>
<div class="refentry">
<a name="gdk-pixbuf-XlibRGB"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="gdk-pixbuf-XlibRGB.top_of_page"></a>XlibRGB</span></h2>
<p>XlibRGB — Rendering RGB buffers to X drawables.</p>
</td>
<td class="gallery_image" valign="top" align="right"></td>
</tr></table></div>
<div class="refsect1">
<a name="gdk-pixbuf-XlibRGB.functions"></a><h2>Functions</h2>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="functions_return">
<col class="functions_name">
</colgroup>
<tbody>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-rgb-init" title="xlib_rgb_init ()">xlib_rgb_init</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-rgb-init-with-depth" title="xlib_rgb_init_with_depth ()">xlib_rgb_init_with_depth</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">unsigned <span class="returnvalue">long</span>
</td>
<td class="function_name">
<a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-rgb-xpixel-from-rgb" title="xlib_rgb_xpixel_from_rgb ()">xlib_rgb_xpixel_from_rgb</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-rgb-gc-set-foreground" title="xlib_rgb_gc_set_foreground ()">xlib_rgb_gc_set_foreground</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-rgb-gc-set-background" title="xlib_rgb_gc_set_background ()">xlib_rgb_gc_set_background</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-draw-rgb-image" title="xlib_draw_rgb_image ()">xlib_draw_rgb_image</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-draw-rgb-image-dithalign" title="xlib_draw_rgb_image_dithalign ()">xlib_draw_rgb_image_dithalign</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-draw-rgb-32-image" title="xlib_draw_rgb_32_image ()">xlib_draw_rgb_32_image</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-draw-gray-image" title="xlib_draw_gray_image ()">xlib_draw_gray_image</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="gdk-pixbuf-XlibRGB.html#XlibRgbCmap" title="struct XlibRgbCmap"><span class="returnvalue">XlibRgbCmap</span></a> *
</td>
<td class="function_name">
<a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-rgb-cmap-new" title="xlib_rgb_cmap_new ()">xlib_rgb_cmap_new</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-rgb-cmap-free" title="xlib_rgb_cmap_free ()">xlib_rgb_cmap_free</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-draw-indexed-image" title="xlib_draw_indexed_image ()">xlib_draw_indexed_image</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">Bool</span>
</td>
<td class="function_name">
<a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-rgb-ditherable" title="xlib_rgb_ditherable ()">xlib_rgb_ditherable</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-rgb-set-verbose" title="xlib_rgb_set_verbose ()">xlib_rgb_set_verbose</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-rgb-set-install" title="xlib_rgb_set_install ()">xlib_rgb_set_install</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-rgb-set-min-colors" title="xlib_rgb_set_min_colors ()">xlib_rgb_set_min_colors</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">Colormap</span>
</td>
<td class="function_name">
<a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-rgb-get-cmap" title="xlib_rgb_get_cmap ()">xlib_rgb_get_cmap</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">Visual</span> *
</td>
<td class="function_name">
<a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-rgb-get-visual" title="xlib_rgb_get_visual ()">xlib_rgb_get_visual</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">XVisualInfo</span> *
</td>
<td class="function_name">
<a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-rgb-get-visual-info" title="xlib_rgb_get_visual_info ()">xlib_rgb_get_visual_info</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">int</span>
</td>
<td class="function_name">
<a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-rgb-get-depth" title="xlib_rgb_get_depth ()">xlib_rgb_get_depth</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">Display</span> *
</td>
<td class="function_name">
<a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-rgb-get-display" title="xlib_rgb_get_display ()">xlib_rgb_get_display</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">Screen</span> *
</td>
<td class="function_name">
<a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-rgb-get-screen" title="xlib_rgb_get_screen ()">xlib_rgb_get_screen</a> <span class="c_punctuation">()</span>
</td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="gdk-pixbuf-XlibRGB.other"></a><h2>Types and Values</h2>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="name">
<col class="description">
</colgroup>
<tbody>
<tr>
<td class="datatype_keyword">struct</td>
<td class="function_name"><a class="link" href="gdk-pixbuf-XlibRGB.html#XlibRgbCmap" title="struct XlibRgbCmap">XlibRgbCmap</a></td>
</tr>
<tr>
<td class="datatype_keyword">enum</td>
<td class="function_name"><a class="link" href="gdk-pixbuf-XlibRGB.html#XlibRgbDither" title="enum XlibRgbDither">XlibRgbDither</a></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="gdk-pixbuf-XlibRGB.includes"></a><h2>Includes</h2>
<pre class="synopsis">#include &lt;gdk-pixbuf/gdk-pixdata.h&gt;
</pre>
</div>
<div class="refsect1">
<a name="gdk-pixbuf-XlibRGB.description"></a><h2>Description</h2>
<p>The XlibRGB set of functions is a port of the <span class="type">GdkRGB</span> library to
use plain Xlib and X drawables.  You can use these functions to
render RGB buffers into drawables very quickly with high-quality
dithering.</p>
</div>
<div class="refsect1">
<a name="gdk-pixbuf-XlibRGB.functions_details"></a><h2>Functions</h2>
<div class="refsect2">
<a name="xlib-rgb-init"></a><h3>xlib_rgb_init ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
xlib_rgb_init (<em class="parameter"><code><span class="type">Display</span> *display</code></em>,
               <em class="parameter"><code><span class="type">Screen</span> *screen</code></em>);</pre>
<p>Initializes the XlibRGB machinery with the default depth.  If you use this
function XlibRGB will automatically pick the best visual available on your
display.  This function or <a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-rgb-init-with-depth" title="xlib_rgb_init_with_depth ()"><code class="function">xlib_rgb_init_with_depth()</code></a> must be called before
using any of the other functions in XlibRGB.</p>
<div class="refsect3">
<a name="xlib-rgb-init.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>display</p></td>
<td class="parameter_description"><p>X Display to use.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>screen</p></td>
<td class="parameter_description"><p>Screen to use.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="xlib-rgb-init-with-depth"></a><h3>xlib_rgb_init_with_depth ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
xlib_rgb_init_with_depth (<em class="parameter"><code><span class="type">Display</span> *display</code></em>,
                          <em class="parameter"><code><span class="type">Screen</span> *screen</code></em>,
                          <em class="parameter"><code><span class="type">int</span> prefDepth</code></em>);</pre>
<p>Initializes the XlibRGB machinery with a particular depth you specify,
instead of automatically picking the best depth in the display.  This
function or <a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-rgb-init" title="xlib_rgb_init ()"><code class="function">xlib_rgb_init()</code></a> must be called before using any of the other
functions in XlibRGB.</p>
<div class="refsect3">
<a name="xlib-rgb-init-with-depth.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>display</p></td>
<td class="parameter_description"><p>X display to use.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>screen</p></td>
<td class="parameter_description"><p>Screen to use.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>prefDepth</p></td>
<td class="parameter_description"><p>Visual depth to use for color substitution tables.  This must
be one of the supported visual depths in the specified <em class="parameter"><code>display</code></em>
.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="xlib-rgb-xpixel-from-rgb"></a><h3>xlib_rgb_xpixel_from_rgb ()</h3>
<pre class="programlisting">unsigned <span class="returnvalue">long</span>
xlib_rgb_xpixel_from_rgb (<em class="parameter"><code><span class="type">guint32</span> rgb</code></em>);</pre>
<p>Converts an RGB triplet into the closest color that XlibRGB visual can
handle.</p>
<div class="refsect3">
<a name="xlib-rgb-xpixel-from-rgb.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>rgb</p></td>
<td class="parameter_description"><p>32-bit representation of an RGB value, specified as 0x00RRGGBB.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="xlib-rgb-xpixel-from-rgb.returns"></a><h4>Returns</h4>
<p> X pixel value that corresponds to the closest color in the
XlibRGB visual and colormap.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="xlib-rgb-gc-set-foreground"></a><h3>xlib_rgb_gc_set_foreground ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
xlib_rgb_gc_set_foreground (<em class="parameter"><code><span class="type">GC</span> gc</code></em>,
                            <em class="parameter"><code><span class="type">guint32</span> rgb</code></em>);</pre>
<p>This is a convenience function to set the foreground of a GC from an RGB
triplet.  It calls <a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-rgb-xpixel-from-rgb" title="xlib_rgb_xpixel_from_rgb ()"><code class="function">xlib_rgb_xpixel_from_rgb()</code></a> internally and uses the
returned pixel value to set the GC's foreground.</p>
<div class="refsect3">
<a name="xlib-rgb-gc-set-foreground.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>gc</p></td>
<td class="parameter_description"><p>A graphic context.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>rgb</p></td>
<td class="parameter_description"><p>32-bit representation of an RGB value, specified as 0x00RRGGBB.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="xlib-rgb-gc-set-background"></a><h3>xlib_rgb_gc_set_background ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
xlib_rgb_gc_set_background (<em class="parameter"><code><span class="type">GC</span> gc</code></em>,
                            <em class="parameter"><code><span class="type">guint32</span> rgb</code></em>);</pre>
<p>This is a convenience function to set the background of a GC from an RGB
triplet.  It calls <a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-rgb-xpixel-from-rgb" title="xlib_rgb_xpixel_from_rgb ()"><code class="function">xlib_rgb_xpixel_from_rgb()</code></a> internally and uses the
returned pixel value to set the GC's background.</p>
<div class="refsect3">
<a name="xlib-rgb-gc-set-background.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>gc</p></td>
<td class="parameter_description"><p>A graphic context.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>rgb</p></td>
<td class="parameter_description"><p>32-bit representation of an RGB value, specified as 0x00RRGGBB.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="xlib-draw-rgb-image"></a><h3>xlib_draw_rgb_image ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
xlib_draw_rgb_image (<em class="parameter"><code><span class="type">Drawable</span> drawable</code></em>,
                     <em class="parameter"><code><span class="type">GC</span> gc</code></em>,
                     <em class="parameter"><code><span class="type">int</span> x</code></em>,
                     <em class="parameter"><code><span class="type">int</span> y</code></em>,
                     <em class="parameter"><code><span class="type">int</span> width</code></em>,
                     <em class="parameter"><code><span class="type">int</span> height</code></em>,
                     <em class="parameter"><code><a class="link" href="gdk-pixbuf-XlibRGB.html#XlibRgbDither" title="enum XlibRgbDither"><span class="type">XlibRgbDither</span></a> dith</code></em>,
                     <em class="parameter"><code>unsigned <span class="type">char</span> *rgb_buf</code></em>,
                     <em class="parameter"><code><span class="type">int</span> rowstride</code></em>);</pre>
<p>Renders an RGB buffer to a drawable.  Pixels are specified as RGB triplets
with 8 bits per channel.  An image will thus look like an RGBRGBRGBRGB
sequence of 8-bit values.  This function does not let you specify dither
offsets; applications that need to render partial regions of a buffer to
build the final image should use <a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-draw-rgb-image-dithalign" title="xlib_draw_rgb_image_dithalign ()"><code class="function">xlib_draw_rgb_image_dithalign()</code></a> instead.</p>
<div class="refsect3">
<a name="xlib-draw-rgb-image.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>drawable</p></td>
<td class="parameter_description"><p>Destination drawable.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>gc</p></td>
<td class="parameter_description"><p>A graphic context.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>x</p></td>
<td class="parameter_description"><p>Leftmost coordinate of the destination rectangle.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>y</p></td>
<td class="parameter_description"><p>Upper coordinate of the destination rectangle.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>width</p></td>
<td class="parameter_description"><p>Width of the destination rectangle, in pixels.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>height</p></td>
<td class="parameter_description"><p>Height of the destination rectangle, in pixels.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>dith</p></td>
<td class="parameter_description"><p>Dithering method to use.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>rgb_buf</p></td>
<td class="parameter_description"><p>Pointer to the pixel in the RGB buffer that corresponds to the
upper-left corner of the rectangular region to render.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>rowstride</p></td>
<td class="parameter_description"><p>Offset between pixel rows in the RGB buffer, in bytes.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="xlib-draw-rgb-image-dithalign"></a><h3>xlib_draw_rgb_image_dithalign ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
xlib_draw_rgb_image_dithalign (<em class="parameter"><code><span class="type">Drawable</span> drawable</code></em>,
                               <em class="parameter"><code><span class="type">GC</span> gc</code></em>,
                               <em class="parameter"><code><span class="type">int</span> x</code></em>,
                               <em class="parameter"><code><span class="type">int</span> y</code></em>,
                               <em class="parameter"><code><span class="type">int</span> width</code></em>,
                               <em class="parameter"><code><span class="type">int</span> height</code></em>,
                               <em class="parameter"><code><a class="link" href="gdk-pixbuf-XlibRGB.html#XlibRgbDither" title="enum XlibRgbDither"><span class="type">XlibRgbDither</span></a> dith</code></em>,
                               <em class="parameter"><code>unsigned <span class="type">char</span> *rgb_buf</code></em>,
                               <em class="parameter"><code><span class="type">int</span> rowstride</code></em>,
                               <em class="parameter"><code><span class="type">int</span> xdith</code></em>,
                               <em class="parameter"><code><span class="type">int</span> ydith</code></em>);</pre>
<p>Renders an RGB buffer to a drawable.  Pixels are specified as RGB triplets
with 8 bits per channel.  An image will thus look like an RGBRGBRGBRGB
sequence of 8-bit values.  This function lets you specify a pair of dither
offsets.  It should be used when you need to render regions of an RGB buffer
separately to form the final image; the dither offsets let you align the
dither mask appropriately.</p>
<div class="refsect3">
<a name="xlib-draw-rgb-image-dithalign.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>drawable</p></td>
<td class="parameter_description"><p>Destination drawable.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>gc</p></td>
<td class="parameter_description"><p>A graphic context.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>x</p></td>
<td class="parameter_description"><p>Leftmost coordinate of the destination rectangle.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>y</p></td>
<td class="parameter_description"><p>Upper coordinate of the destination rectangle.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>width</p></td>
<td class="parameter_description"><p>Width of the destination rectangle, in pixels.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>height</p></td>
<td class="parameter_description"><p>Height of the destination rectangle, in pixels.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>dith</p></td>
<td class="parameter_description"><p>Dithering method to use.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>rgb_buf</p></td>
<td class="parameter_description"><p>Pointer to the pixel in the RGB buffer that corresponds to the
upper-left corner of the rectangular region to render.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>rowstride</p></td>
<td class="parameter_description"><p>Offset between pixel rows in the RGB buffer, in bytes.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>xdith</p></td>
<td class="parameter_description"><p>X offset for the dither mask.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>ydith</p></td>
<td class="parameter_description"><p>Y offset for the dither mask.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="xlib-draw-rgb-32-image"></a><h3>xlib_draw_rgb_32_image ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
xlib_draw_rgb_32_image (<em class="parameter"><code><span class="type">Drawable</span> drawable</code></em>,
                        <em class="parameter"><code><span class="type">GC</span> gc</code></em>,
                        <em class="parameter"><code><span class="type">int</span> x</code></em>,
                        <em class="parameter"><code><span class="type">int</span> y</code></em>,
                        <em class="parameter"><code><span class="type">int</span> width</code></em>,
                        <em class="parameter"><code><span class="type">int</span> height</code></em>,
                        <em class="parameter"><code><a class="link" href="gdk-pixbuf-XlibRGB.html#XlibRgbDither" title="enum XlibRgbDither"><span class="type">XlibRgbDither</span></a> dith</code></em>,
                        <em class="parameter"><code>unsigned <span class="type">char</span> *buf</code></em>,
                        <em class="parameter"><code><span class="type">int</span> rowstride</code></em>);</pre>
<p>This function is analogous to <a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-draw-rgb-image" title="xlib_draw_rgb_image ()"><code class="function">xlib_draw_rgb_image()</code></a>, but it lets you use
32-bit RGB buffers with pixels specified as 0xRRGGBB00.  The
least-significant 8 bits are actually discarded.  This function can lead to
faster results than <a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-draw-rgb-image" title="xlib_draw_rgb_image ()"><code class="function">xlib_draw_rgb_image()</code></a> since the pixels are aligned on
32-bit boundaries.</p>
<div class="refsect3">
<a name="xlib-draw-rgb-32-image.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>drawable</p></td>
<td class="parameter_description"><p>Destination drawable.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>gc</p></td>
<td class="parameter_description"><p>A graphic context.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>x</p></td>
<td class="parameter_description"><p>Leftmost coordinate of the destination rectangle.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>y</p></td>
<td class="parameter_description"><p>Upper coordinate of the destination rectangle.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>width</p></td>
<td class="parameter_description"><p>Width of the destination rectangle, in pixels.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>height</p></td>
<td class="parameter_description"><p>Height of the destination rectangle, in pixels.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>dith</p></td>
<td class="parameter_description"><p>Dithering method to use.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>buf</p></td>
<td class="parameter_description"><p>Pointer to the pixel in the RGB buffer that corresponds to the
upper-left corner of the rectangular region to render.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>rowstride</p></td>
<td class="parameter_description"><p>Offset between pixel rows in the RGB buffer, in bytes.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="xlib-draw-gray-image"></a><h3>xlib_draw_gray_image ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
xlib_draw_gray_image (<em class="parameter"><code><span class="type">Drawable</span> drawable</code></em>,
                      <em class="parameter"><code><span class="type">GC</span> gc</code></em>,
                      <em class="parameter"><code><span class="type">int</span> x</code></em>,
                      <em class="parameter"><code><span class="type">int</span> y</code></em>,
                      <em class="parameter"><code><span class="type">int</span> width</code></em>,
                      <em class="parameter"><code><span class="type">int</span> height</code></em>,
                      <em class="parameter"><code><a class="link" href="gdk-pixbuf-XlibRGB.html#XlibRgbDither" title="enum XlibRgbDither"><span class="type">XlibRgbDither</span></a> dith</code></em>,
                      <em class="parameter"><code>unsigned <span class="type">char</span> *buf</code></em>,
                      <em class="parameter"><code><span class="type">int</span> rowstride</code></em>);</pre>
<p>Renders a grayscale buffer to a drawable.  Pixels are specified as 8-bit
intensity values.  An image will thus look as a GGGGGG sequence of 8-bit
values.</p>
<div class="refsect3">
<a name="xlib-draw-gray-image.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>drawable</p></td>
<td class="parameter_description"><p>Destination drawable.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>gc</p></td>
<td class="parameter_description"><p>A graphic context.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>x</p></td>
<td class="parameter_description"><p>Leftmost coordinate of the destination rectangle.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>y</p></td>
<td class="parameter_description"><p>Upper coordinate of the destination rectangle.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>width</p></td>
<td class="parameter_description"><p>Width of the destination rectangle, in pixels.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>height</p></td>
<td class="parameter_description"><p>Height of thd destination rectangle, in pixels.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>dith</p></td>
<td class="parameter_description"><p>Dithering method to use.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>buf</p></td>
<td class="parameter_description"><p>Pointer to the pixel in the grayscale buffer that corresponds to the
upper-left corner of the rectangular region to render.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>rowstride</p></td>
<td class="parameter_description"><p>Offset between pixel rows in the grayscale buffer, in pixels.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="xlib-rgb-cmap-new"></a><h3>xlib_rgb_cmap_new ()</h3>
<pre class="programlisting"><a class="link" href="gdk-pixbuf-XlibRGB.html#XlibRgbCmap" title="struct XlibRgbCmap"><span class="returnvalue">XlibRgbCmap</span></a> *
xlib_rgb_cmap_new (<em class="parameter"><code><span class="type">guint32</span> *colors</code></em>,
                   <em class="parameter"><code><span class="type">int</span> n_colors</code></em>);</pre>
<p>FIXME</p>
<div class="refsect3">
<a name="xlib-rgb-cmap-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>colors</p></td>
<td class="parameter_description"><p>FIXME</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>n_colors</p></td>
<td class="parameter_description"><p>FIXME</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="xlib-rgb-cmap-new.returns"></a><h4>Returns</h4>
<p> FIXME</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="xlib-rgb-cmap-free"></a><h3>xlib_rgb_cmap_free ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
xlib_rgb_cmap_free (<em class="parameter"><code><a class="link" href="gdk-pixbuf-XlibRGB.html#XlibRgbCmap" title="struct XlibRgbCmap"><span class="type">XlibRgbCmap</span></a> *cmap</code></em>);</pre>
<p>Frees an XlibRGB colormap.</p>
<div class="refsect3">
<a name="xlib-rgb-cmap-free.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>cmap</p></td>
<td class="parameter_description"><p>An XlibRGB colormap.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="xlib-draw-indexed-image"></a><h3>xlib_draw_indexed_image ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
xlib_draw_indexed_image (<em class="parameter"><code><span class="type">Drawable</span> drawable</code></em>,
                         <em class="parameter"><code><span class="type">GC</span> gc</code></em>,
                         <em class="parameter"><code><span class="type">int</span> x</code></em>,
                         <em class="parameter"><code><span class="type">int</span> y</code></em>,
                         <em class="parameter"><code><span class="type">int</span> width</code></em>,
                         <em class="parameter"><code><span class="type">int</span> height</code></em>,
                         <em class="parameter"><code><a class="link" href="gdk-pixbuf-XlibRGB.html#XlibRgbDither" title="enum XlibRgbDither"><span class="type">XlibRgbDither</span></a> dith</code></em>,
                         <em class="parameter"><code>unsigned <span class="type">char</span> *buf</code></em>,
                         <em class="parameter"><code><span class="type">int</span> rowstride</code></em>,
                         <em class="parameter"><code><a class="link" href="gdk-pixbuf-XlibRGB.html#XlibRgbCmap" title="struct XlibRgbCmap"><span class="type">XlibRgbCmap</span></a> *cmap</code></em>);</pre>
<p>FIXME</p>
<div class="refsect3">
<a name="xlib-draw-indexed-image.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>drawable</p></td>
<td class="parameter_description"><p>FIXME</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>gc</p></td>
<td class="parameter_description"><p>FIXME</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>x</p></td>
<td class="parameter_description"><p>FIXME</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>y</p></td>
<td class="parameter_description"><p>FIXME</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>width</p></td>
<td class="parameter_description"><p>FIXME</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>height</p></td>
<td class="parameter_description"><p>FIXME</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>dith</p></td>
<td class="parameter_description"><p>FIXME</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>buf</p></td>
<td class="parameter_description"><p>FIXME</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>rowstride</p></td>
<td class="parameter_description"><p>FIXME</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>cmap</p></td>
<td class="parameter_description"><p>FIXME</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="xlib-rgb-ditherable"></a><h3>xlib_rgb_ditherable ()</h3>
<pre class="programlisting"><span class="returnvalue">Bool</span>
xlib_rgb_ditherable (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
<p>Queries whether XlibRGB supports dithering for its chosen visual.</p>
<div class="refsect3">
<a name="xlib-rgb-ditherable.returns"></a><h4>Returns</h4>
<p> TRUE if dithering can be performed for the visual that XlibRGB
is using, FALSE otherwise.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="xlib-rgb-set-verbose"></a><h3>xlib_rgb_set_verbose ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
xlib_rgb_set_verbose (<em class="parameter"><code><span class="type">Bool</span> verbose</code></em>);</pre>
<p>Enables/disables debug spew.</p>
<div class="refsect3">
<a name="xlib-rgb-set-verbose.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>verbose</p></td>
<td class="parameter_description"><p>True to be verbose</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="xlib-rgb-set-install"></a><h3>xlib_rgb_set_install ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
xlib_rgb_set_install (<em class="parameter"><code><span class="type">Bool</span> install</code></em>);</pre>
<p>Sets whether we install an RGB colormap.</p>
<div class="refsect3">
<a name="xlib-rgb-set-install.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>install</p></td>
<td class="parameter_description"><p>True to install a colormap</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="xlib-rgb-set-min-colors"></a><h3>xlib_rgb_set_min_colors ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
xlib_rgb_set_min_colors (<em class="parameter"><code><span class="type">int</span> min_colors</code></em>);</pre>
<p>Sets the minimum number of colors in the color cube.</p>
<div class="refsect3">
<a name="xlib-rgb-set-min-colors.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>min_colors</p></td>
<td class="parameter_description"><p>minimum colors to use</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="xlib-rgb-get-cmap"></a><h3>xlib_rgb_get_cmap ()</h3>
<pre class="programlisting"><span class="returnvalue">Colormap</span>
xlib_rgb_get_cmap (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
<p>Queries the X colormap that XlibRGB is using.</p>
<div class="refsect3">
<a name="xlib-rgb-get-cmap.returns"></a><h4>Returns</h4>
<p> An X colormap.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="xlib-rgb-get-visual"></a><h3>xlib_rgb_get_visual ()</h3>
<pre class="programlisting"><span class="returnvalue">Visual</span> *
xlib_rgb_get_visual (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
<p>Queries the visual that XlibRGB is using.</p>
<div class="refsect3">
<a name="xlib-rgb-get-visual.returns"></a><h4>Returns</h4>
<p> An X visual.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="xlib-rgb-get-visual-info"></a><h3>xlib_rgb_get_visual_info ()</h3>
<pre class="programlisting"><span class="returnvalue">XVisualInfo</span> *
xlib_rgb_get_visual_info (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
<p>Queries the visual info structure for the visual that XlibRGB is using.</p>
<div class="refsect3">
<a name="xlib-rgb-get-visual-info.returns"></a><h4>Returns</h4>
<p> An XVisualInfo structure.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="xlib-rgb-get-depth"></a><h3>xlib_rgb_get_depth ()</h3>
<pre class="programlisting"><span class="returnvalue">int</span>
xlib_rgb_get_depth (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
<p>Queries the depth of the visual that XlibRGB is using.</p>
<div class="refsect3">
<a name="xlib-rgb-get-depth.returns"></a><h4>Returns</h4>
<p> Bit depth.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="xlib-rgb-get-display"></a><h3>xlib_rgb_get_display ()</h3>
<pre class="programlisting"><span class="returnvalue">Display</span> *
xlib_rgb_get_display (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
<p>Queries the X display that XlibRGB is using.</p>
<div class="refsect3">
<a name="xlib-rgb-get-display.returns"></a><h4>Returns</h4>
<p> An X display.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="xlib-rgb-get-screen"></a><h3>xlib_rgb_get_screen ()</h3>
<pre class="programlisting"><span class="returnvalue">Screen</span> *
xlib_rgb_get_screen (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
<p>Queries the screen that XlibRGB is using.</p>
<div class="refsect3">
<a name="xlib-rgb-get-screen.returns"></a><h4>Returns</h4>
<p> An X screen.</p>
</div>
</div>
</div>
<div class="refsect1">
<a name="gdk-pixbuf-XlibRGB.other_details"></a><h2>Types and Values</h2>
<div class="refsect2">
<a name="XlibRgbCmap"></a><h3>struct XlibRgbCmap</h3>
<pre class="programlisting">struct XlibRgbCmap {
  unsigned int colors[256];
  unsigned char lut[256]; /* for 8-bit modes */
};
</pre>
<p>FIXME: Describe this.</p>
<div class="refsect3">
<a name="XlibRgbCmap.members"></a><h4>Members</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="300px" class="struct_members_name">
<col class="struct_members_description">
<col width="200px" class="struct_members_annotations">
</colgroup>
<tbody>
<tr>
<td class="struct_member_name"><p>unsigned <span class="type">int</span> <em class="structfield"><code><a name="XlibRgbCmap.colors"></a>colors</code></em>[256];</p></td>
<td class="struct_member_description"><p>FIXME.</p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<td class="struct_member_name"><p>unsigned <span class="type">char</span> <em class="structfield"><code><a name="XlibRgbCmap.lut"></a>lut</code></em>[256];</p></td>
<td class="struct_member_description"><p>FIXME.</p></td>
<td class="struct_member_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="XlibRgbDither"></a><h3>enum XlibRgbDither</h3>
<p>These values are used to specify which dithering method should be
used.  &lt;symbol&gt;XLIB_RGB_DITHER_NONE&lt;/symbol&gt; will use no dithering
and simply map the colors in an RGB buffer to the closest colors
that the display can provide.
&lt;symbol&gt;XLIB_RGB_DITHER_NORMAL&lt;/symbol&gt; will provide dithering
only on pseudocolor displays.
&lt;symbol&gt;XLIB_RGB_DITHER_MAX&lt;/symbol&gt; will provide dithering on
pseudocolor and 16-bit truecolor or “high color”
displays.</p>
<div class="refsect3">
<a name="XlibRgbDither.members"></a><h4>Members</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="300px" class="enum_members_name">
<col class="enum_members_description">
<col width="200px" class="enum_members_annotations">
</colgroup>
<tbody>
<tr>
<td class="enum_member_name"><p><a name="XLIB-RGB-DITHER-NONE:CAPS"></a>XLIB_RGB_DITHER_NONE</p></td>
<td class="enum_member_description">
<p>Specifies no dithering.</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="XLIB-RGB-DITHER-NORMAL:CAPS"></a>XLIB_RGB_DITHER_NORMAL</p></td>
<td class="enum_member_description">
<p>Specifies dithering only on pseudocolor
 displays.</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="XLIB-RGB-DITHER-MAX:CAPS"></a>XLIB_RGB_DITHER_MAX</p></td>
<td class="enum_member_description">
<p>Specifies dithering on high color displays.</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
</div>
<div class="refsect1">
<a name="gdk-pixbuf-XlibRGB.see-also"></a><h2>See Also</h2>
<p>GdkRGB</p>
</div>
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.27</div>
</body>
</html>