<html> <head><title>Gtk-- Reference: Gtk::Preview</title></head> <body bgcolor="#F0F0F0" text="#000000" link="#0000FF" vlink="#000077" alink="#FF0000"> <table align=center border=0 cellspacing=10> <tr> <td><a href="class_index.html">Class Index</a></td> <td><a href="cross_index.html">Cross Index</a></td> <td><a href="name_index.html">Namespace Index</a></td> </table> <h1 align=center>Class Gtk::Preview</h1><p> <b> A widget to display RGB or grayscale data.</b><br> Contained in: <a href="Gtk.html">Gtk</a><br> Derived from: <a href="Gtk%3A%3AWidget.html">Gtk::Widget</a> <br> Derived by: <i>none</i> <p> #include <gtk--/preview.h> <p> <hr noshade> <table border=0> <tr><td colspan=3><h3>public function member index:</h3></td> <tr valign=top><td align=right><tt><tt>explicit</tt> </tt> </td><td align=right><a href="Gtk%3A%3APreview.html#2431"><tt><font color=blue><b>Preview</b></font></tt></a></td><td><tt>(<tt><font color=navy>GtkPreviewType</font></tt> <tt><font color=blue>type</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3APreview.html#2434"><tt><font color=blue><b>draw_row</b></font></tt></a></td><td><tt>(<tt>const</tt> <tt><font color=navy>guchar</font></tt>* <tt><font color=blue>data</font></tt>, <tt><font color=purple>gint</font></tt> <tt><font color=blue>x</font></tt>, <tt><font color=purple>gint</font></tt> <tt><font color=blue>y</font></tt>, <tt><font color=purple>gint</font></tt> <tt><font color=blue>w</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt>static</tt> <tt><font color=navy>Gdk_Colormap</font></tt></tt> </td><td align=right><a href="Gtk%3A%3APreview.html#2441"><tt><font color=blue><b>get_cmap</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt><tt>static</tt> <tt><font color=navy>GtkPreviewInfo</font></tt>*</tt> </td><td align=right><a href="Gtk%3A%3APreview.html#2442"><tt><font color=blue><b>get_info</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt><tt>static</tt> <tt><font color=navy>Gdk_Visual</font></tt></tt> </td><td align=right><a href="Gtk%3A%3APreview.html#2440"><tt><font color=blue><b>get_visual</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=navy>GtkPreview</font></tt>*</tt> </td><td align=right><a href="Gtk%3A%3APreview.html#2427"><tt><font color=blue><b>gtkobj</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt><tt>const</tt> <tt><font color=navy>GtkPreview</font></tt>*</tt> </td><td align=right><a href="Gtk%3A%3APreview.html#2428"><tt><font color=blue><b>gtkobj</b></font></tt></a></td><td><tt>() <tt>const</tt></tt>;</td> <tr valign=top><td align=right><tt><tt>static</tt> <tt><font color=purple>bool</font></tt></tt> </td><td align=right><a href="Gtk%3A%3APreview.html#2429"><tt><font color=blue><b>isA</b></font></tt></a></td><td><tt>(<a href="Gtk%3A%3AObject.html"><tt><font color=navy><b>Object</b></font></tt></a>* <tt><font color=blue>object</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3APreview.html#2433"><tt><font color=blue><b>put</b></font></tt></a></td><td><tt>(<tt><font color=navy>Gdk_Window</font></tt>& <tt><font color=blue>window</font></tt>, <tt><font color=navy>Gdk_GC</font></tt>& <tt><font color=blue>gc</font></tt>, <tt><font color=purple>gint</font></tt> <tt><font color=blue>srcx</font></tt>, <tt><font color=purple>gint</font></tt> <tt><font color=blue>srcy</font></tt>, <tt><font color=purple>gint</font></tt> <tt><font color=blue>destx</font></tt>, <tt><font color=purple>gint</font></tt> <tt><font color=blue>desty</font></tt>, <tt><font color=purple>gint</font></tt> <tt><font color=blue>width</font></tt>, <tt><font color=purple>gint</font></tt> <tt><font color=blue>height</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt>static</tt> <tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3APreview.html#2443"><tt><font color=blue><b>reset</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt><tt>static</tt> <tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3APreview.html#2437"><tt><font color=blue><b>set_color_cube</b></font></tt></a></td><td><tt>(<tt><font color=purple>guint</font></tt> <tt><font color=blue>nred_shades</font></tt>, <tt><font color=purple>guint</font></tt> <tt><font color=blue>ngreen_shades</font></tt>, <tt><font color=purple>guint</font></tt> <tt><font color=blue>nblue_shades</font></tt>, <tt><font color=purple>guint</font></tt> <tt><font color=blue>ngray_shades</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3APreview.html#2445"><tt><font color=blue><b>set_dither</b></font></tt></a></td><td><tt>(<tt><font color=navy>GdkRgbDither</font></tt> <tt><font color=blue>dither</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3APreview.html#2435"><tt><font color=blue><b>set_expand</b></font></tt></a></td><td><tt>(<tt><font color=purple>bool</font></tt> <tt><font color=blue>expand</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt>static</tt> <tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3APreview.html#2436"><tt><font color=blue><b>set_gamma</b></font></tt></a></td><td><tt>(<tt><font color=purple>double</font></tt> <tt><font color=blue>gamma</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt>static</tt> <tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3APreview.html#2438"><tt><font color=blue><b>set_install_cmap</b></font></tt></a></td><td><tt>(<tt><font color=purple>bool</font></tt> <tt><font color=blue>install_cmap</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt>static</tt> <tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3APreview.html#2439"><tt><font color=blue><b>set_reserved</b></font></tt></a></td><td><tt>(<tt><font color=purple>gint</font></tt> <tt><font color=blue>nreserved</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3APreview.html#2432"><tt><font color=blue><b>size</b></font></tt></a></td><td><tt>(<tt><font color=purple>gint</font></tt> <tt><font color=blue>width</font></tt>, <tt><font color=purple>gint</font></tt> <tt><font color=blue>height</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt>static</tt> <tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3APreview.html#2444"><tt><font color=blue><b>uninit</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt><tt>virtual</tt> </tt> </td><td align=right><a href="Gtk%3A%3APreview.html#2430"><tt><font color=blue><b>~Preview</b></font></tt></a></td><td><tt>()</tt>;</td> <tr><td> </td></table> <hr noshade> <h2>Description:</h2> <br> <p> <hr noshade> <h2>Function Member Descriptions:</h2> <a name="2434"><font size=+1><b>Gtk::Preview::draw_row</b></font></a> - Sets the data for a portion of a row.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3APreview.html#2434"><tt><font color=blue><b>draw_row</b></font></tt></a><tt>(<tt>const</tt> <tt><font color=navy>guchar</font></tt>* <tt><font color=blue>data</font></tt>, <tt><font color=purple>gint</font></tt> <tt><font color=blue>x</font></tt>, <tt><font color=purple>gint</font></tt> <tt><font color=blue>y</font></tt>, <tt><font color=purple>gint</font></tt> <tt><font color=blue>w</font></tt>)</tt>;<br><blockquote> data: The new data for the portion. It should contain w bytes of data if the preview is of type <tt><font color=green>GTK_TYPE_GRAYSCALE</font></tt>, and 3*w bytes of data if the preview is of type <tt><font color=green>GTK_TYPE_COLOR</font></tt>. <P> x: The starting value on the row to set. <P> y: The row to change. <P> w: The number of pixels in the row to change.</blockquote> <br><br> <a name="2427"><font size=+1><b>Gtk::Preview::gtkobj</b></font></a> - Returns the underlaying gtk+ object.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=navy>GtkPreview</font></tt>*</tt> <a href="Gtk%3A%3APreview.html#2427"><tt><font color=blue><b>gtkobj</b></font></tt></a><tt>()</tt>;<br><br> <a name="2429"><font size=+1><b>Gtk::Preview::isA</b></font></a> - Returns true if object is this type.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt>static</tt> <tt><font color=purple>bool</font></tt></tt> <a href="Gtk%3A%3APreview.html#2429"><tt><font color=blue><b>isA</b></font></tt></a><tt>(<a href="Gtk%3A%3AObject.html"><tt><font color=navy><b>Object</b></font></tt></a>* <tt><font color=blue>object</font></tt>)</tt>;<br><br> <a name="2443"><font size=+1><b>Gtk::Preview::reset</b></font></a> - This function is deprecated and does nothing. It was once used for changing the colormap and visual on the fly.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt>static</tt> <tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3APreview.html#2443"><tt><font color=blue><b>reset</b></font></tt></a><tt>()</tt>;<br><br> <a name="2437"><font size=+1><b>Gtk::Preview::set_color_cube</b></font></a> - This function is deprecated and does nothing. <tt><font color=navy><b>Gdk:::RGB</b></font></tt> automatically picks an optimium color cube for the display.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt>static</tt> <tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3APreview.html#2437"><tt><font color=blue><b>set_color_cube</b></font></tt></a><tt>(<tt><font color=purple>guint</font></tt> <tt><font color=blue>nred_shades</font></tt>, <tt><font color=purple>guint</font></tt> <tt><font color=blue>ngreen_shades</font></tt>, <tt><font color=purple>guint</font></tt> <tt><font color=blue>nblue_shades</font></tt>, <tt><font color=purple>guint</font></tt> <tt><font color=blue>ngray_shades</font></tt>)</tt>;<br><br> <a name="2445"><font size=+1><b>Gtk::Preview::set_dither</b></font></a> - Set the dithering mode for the display.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3APreview.html#2445"><tt><font color=blue><b>set_dither</b></font></tt></a><tt>(<tt><font color=navy>GdkRgbDither</font></tt> <tt><font color=blue>dither</font></tt>)</tt>;<br><blockquote> dither: The dithering mode. There are three values: <P> <tt><font color=green>GDK_RGB_DITHER_NONE</font></tt>: Never use dithering. <P> <tt><font color=green>GDK_RGB_DITHER_NORMAL</font></tt>: Use dithering in 8 bits per pixel (and below) only. <P> <tt><font color=green>GDK_RGB_DITHER_MAX</font></tt>: Use dithering in 16 bits per pixel and below.</blockquote> <br><br> <a name="2435"><font size=+1><b>Gtk::Preview::set_expand</b></font></a> - Determines the way that the the preview widget behaves when the size it is allocated is larger than the requested size.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3APreview.html#2435"><tt><font color=blue><b>set_expand</b></font></tt></a><tt>(<tt><font color=purple>bool</font></tt> <tt><font color=blue>expand</font></tt>)</tt>;<br><blockquote> If expand is FALSE, then the preview's window and buffer will be no larger than the size set with <a href="Gtk%3A%3APreview.html#2432"><tt><font color=blue><b>size</b></font></tt></a>, and the data set will be centered in the allocation if it is larger. If expand is TRUE then the window and buffer will expand with the allocation; the application is responsible for catching the "size_allocate" signal and providing the data appropriate for this size. <P> expand: Whether the preview's window should expand or not.</blockquote> <br><br> <a name="2436"><font size=+1><b>Gtk::Preview::set_gamma</b></font></a> - Set the gamma-correction value for all preview widgets. (This function<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt>static</tt> <tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3APreview.html#2436"><tt><font color=blue><b>set_gamma</b></font></tt></a><tt>(<tt><font color=purple>double</font></tt> <tt><font color=blue>gamma</font></tt>)</tt>;<br><blockquote> will eventually be replaced with a function that sets a per-preview-widget gamma value). The resulting intensity is given by: destination_value * pow (source_value/255, 1/gamma). The gamma value is applied when the data is set with <a href="Gtk%3A%3APreview.html#2434"><tt><font color=blue><b>draw_row</b></font></tt></a> so changing this value will not affect existing data in preview widgets. <P> gamma: The new gamma value.</blockquote> <br><br> <a name="2438"><font size=+1><b>Gtk::Preview::set_install_cmap</b></font></a> - This function is deprecated and does nothing. <tt><font color=navy><b>Gdk::RGB</b></font></tt> will automatically pick a private colormap if it cannot allocate sufficient colors.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt>static</tt> <tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3APreview.html#2438"><tt><font color=blue><b>set_install_cmap</b></font></tt></a><tt>(<tt><font color=purple>bool</font></tt> <tt><font color=blue>install_cmap</font></tt>)</tt>;<br><br> <a name="2439"><font size=+1><b>Gtk::Preview::set_reserved</b></font></a> - This function is deprecated and does nothing.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt>static</tt> <tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3APreview.html#2439"><tt><font color=blue><b>set_reserved</b></font></tt></a><tt>(<tt><font color=purple>gint</font></tt> <tt><font color=blue>nreserved</font></tt>)</tt>;<br><br> <a name="2432"><font size=+1><b>Gtk::Preview::size</b></font></a> - Set the size that the preview widget will request in response to a "size_request"<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3APreview.html#2432"><tt><font color=blue><b>size</b></font></tt></a><tt>(<tt><font color=purple>gint</font></tt> <tt><font color=blue>width</font></tt>, <tt><font color=purple>gint</font></tt> <tt><font color=blue>height</font></tt>)</tt>;<br><blockquote> signal. The drawing area may actually be allocated a size larger than this depending on how it is packed within the enclosing containers. The effect of this is determined by whether the preview is set to expand or not (see <a href="Gtk%3A%3APreview.html#2435"><tt><font color=blue><b>set_expand</b></font></tt></a>). <P> width: The new width. <P> height: The new height.</blockquote> <br><br> <a name="2444"><font size=+1><b>Gtk::Preview::uninit</b></font></a> - This function is deprecated and does nothing.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt>static</tt> <tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3APreview.html#2444"><tt><font color=blue><b>uninit</b></font></tt></a><tt>()</tt>;<br><br> <hr noshade> </html>