<div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><p><span class="term"><em class="parameter"><code>image</code></em>&#160;:</span></p></td><td> a <a class="link" href="gdk-Images.html#GdkImage"><span class="type">GdkImage</span></a></td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td><td> the image</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id3136158"></a><h3><a name="gdk-image-unref"></a>gdk_image_unref ()</h3><a class="indexterm" name="id3136173"></a><pre class="programlisting">void                gdk_image_unref                     (<a class="link" href="gdk-Images.html#GdkImage">GdkImage</a> *image);</pre><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p><code class="literal">gdk_image_unref</code> is deprecated and should not be used in newly-written code.</p></div><p>Deprecated function; use <ahref="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> instead.</p><p></p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><p><span class="term"><em class="parameter"><code>image</code></em>&#160;:</span></p></td><td> a <a class="link" href="gdk-Images.html#GdkImage"><span class="type">GdkImage</span></a></td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id3136254"></a><h3><a name="gdk-image-destroy"></a>gdk_image_destroy</h3><a class="indexterm" name="id3136269"></a><pre class="programlisting">#define gdk_image_destroy              gdk_image_unref</pre><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p><code class="literal">gdk_image_destroy</code> is deprecated and should not be used in newly-written code.</p></div><p>Destroys a <a class="link" href="gdk-Images.html#GdkImage"><span class="type">GdkImage</span></a>, freeing any resources allocated for it.</p></div><hr><div class="refsect2" lang="en"><a name="id3136306"></a><h3><a name="gdk-image-get-colormap"></a>gdk_image_get_colormap ()</h3><a class="indexterm" name="id3136320"></a><pre class="programlisting"><a class="link" href="gdk-Colormaps-and-Colors.html#GdkColormap">GdkColormap</a>*        gdk_image_get_colormap              (<a class="link" href="gdk-Images.html#GdkImage">GdkImage</a> *image);</pre><p>Retrieves the colormap for a given image, if it exists.  An imagewill have a colormap if the drawable from which it was created hasa colormap, or if a colormap was set explicitely with<a class="link" href="gdk-Images.html#gdk-image-set-colormap"><code class="function">gdk_image_set_colormap()</code></a>.</p><p></p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><p><span class="term"><em class="parameter"><code>image</code></em>&#160;:</span></p></td><td> a <a class="link" href="gdk-Images.html#GdkImage"><span class="type">GdkImage</span></a></td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td><td> colormap for the image</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id3136401"></a><h3><a name="gdk-image-set-colormap"></a>gdk_image_set_colormap ()</h3><a class="indexterm" name="id3136415"></a><pre class="programlisting">void                gdk_image_set_colormap              (<a class="link" href="gdk-Images.html#GdkImage">GdkImage</a> *image,                                                         <a class="link" href="gdk-Colormaps-and-Colors.html#GdkColormap">GdkColormap</a> *colormap);</pre><p>Sets the colormap for the image to the given colormap.  Normallythere's no need to use this function, images are created with thecorrect colormap if you get the image from a drawable. If youcreate the image from scratch, use the colormap of the drawable youintend to render the image to.</p><p></p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><p><span class="term"><em class="parameter"><code>image</code></em>&#160;:</span></p></td><td> a <a class="link" href="gdk-Images.html#GdkImage"><span class="type">GdkImage</span></a></td></tr><tr><td><p><span class="term"><em class="parameter"><code>colormap</code></em>&#160;:</span></p></td><td> a <a class="link" href="gdk-Colormaps-and-Colors.html#GdkColormap"><span class="type">GdkColormap</span></a></td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id3136506"></a><h3><a name="gdk-image-put-pixel"></a>gdk_image_put_pixel ()</h3><a class="indexterm" name="id3136519"></a><pre class="programlisting">void                gdk_image_put_pixel                 (<a class="link" href="gdk-Images.html#GdkImage">GdkImage</a> *image,                                                         <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> x,                                                         <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> y,                                                         <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32">guint32</a> pixel);</pre><p>Sets a pixel in a <a class="link" href="gdk-Images.html#GdkImage"><span class="type">GdkImage</span></a> to a given pixel value.</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><p><span class="term"><em class="parameter"><code>image</code></em>&#160;:</span></p></td><td>a <a class="link" href="gdk-Images.html#GdkImage"><span class="type">GdkImage</span></a>.</td></tr><tr><td><p><span class="term"><em class="parameter"><code>x</code></em>&#160;:</span></p></td><td>the x coordinate of the pixel to set.</td></tr><tr><td><p><span class="term"><em class="parameter"><code>y</code></em>&#160;:</span></p></td><td>the y coordinate of the pixel to set.</td></tr><tr><td><p><span class="term"><em class="parameter"><code>pixel</code></em>&#160;:</span></p></td><td>the pixel value to set.</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id3136647"></a><h3><a name="gdk-image-get-pixel"></a>gdk_image_get_pixel ()</h3><a class="indexterm" name="id3136660"></a><pre class="programlisting"><ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32">guint32</a>             gdk_image_get_pixel                 (<a class="link" href="gdk-Images.html#GdkImage">GdkImage</a> *image,                                                         <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> x,                                                         <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> y);</pre><p>Gets a pixel value at a specified position in a <a class="link" href="gdk-Images.html#GdkImage"><span class="type">GdkImage</span></a>.</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><p><span class="term"><em class="parameter"><code>image</code></em>&#160;:</span></p></td><td>a <a class="link" href="gdk-Images.html#GdkImage"><span class="type">GdkImage</span></a>.</td></tr><tr><td><p><span class="term"><em class="parameter"><code>x</code></em>&#160;:</span></p></td><td>the x coordinate of the pixel to get.</td></tr><tr><td><p><span class="term"><em class="parameter"><code>y</code></em>&#160;:</span></p></td><td>the y coordinate of the pixel to get.</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td><td>the pixel value at the given position.</td></tr></tbody></table></div></div></div><div class="refsect1" lang="en"><a name="id3136778"></a><h2>See Also</h2><p></p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><p><span class="term"><a class="link" href="gdk-Bitmaps-and-Pixmaps.html" title="Bitmaps and Pixmaps">Bitmaps and Pixmaps</a></span></p></td><td><p>Graphics which are stored on the X Windows server.Since these are stored on the server they can be drawn very quickly, and allof the <a class="link" href="gdk-Drawing-Primitives.html" title="Drawing Primitives">Drawing Primitives</a> can beused to draw on them. Their main disadvantage is that manipulating individualpixels can be very slow.</p></td></tr><tr><td><p><span class="term"><a class="link" href="gdk-GdkRGB.html" title="GdkRGB">GdkRGB</a></span></p></td><td><p>Built on top of <a class="link" href="gdk-Images.html#GdkImage"><span class="type">GdkImage</span></a>, this provides much more functionality,including the dithering of colors to produce better output on low-colordisplays.</p></td></tr></tbody></table></div><p></p></div><div class="refsect1" lang="en"><a name="id3136846"></a><div class="refsect2" lang="en"><a name="id3136847"></a></div><hr><div class="refsect2" lang="en"><a name="id3136848"></a></div></div></div></body></html>