|
Server : Apache/2.2.17 (Unix) mod_ssl/2.2.17 OpenSSL/0.9.8e-fips-rhel5 DAV/2 PHP/5.2.17 System : Linux localhost 2.6.18-419.el5 #1 SMP Fri Feb 24 22:47:42 UTC 2017 x86_64 User : nobody ( 99) PHP Version : 5.2.17 Disable Function : NONE Directory : /proc/21585/root/usr/share/gtk-doc/html/gtk/ |
Upload File : |
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>GtkPreview</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
<link rel="start" href="index.html" title="GTK+ Reference Manual">
<link rel="up" href="DeprecatedObjects.html" title="Deprecated">
<link rel="prev" href="GtkPixmap.html" title="GtkPixmap">
<link rel="next" href="GtkProgress.html" title="GtkProgress">
<meta name="generator" content="GTK-Doc V1.6 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
<link rel="part" href="gtk.html" title="Part I. GTK+ Overview">
<link rel="part" href="gtkbase.html" title="Part II. GTK+ Core Reference">
<link rel="part" href="gtkobjects.html" title="Part III. GTK+ Widgets and Objects">
<link rel="chapter" href="ch01.html" title="Object Hierarchy">
<link rel="chapter" href="ch02.html" title="Widget Gallery">
<link rel="chapter" href="WindowWidgets.html" title="Windows">
<link rel="chapter" href="DisplayWidgets.html" title="Display Widgets">
<link rel="chapter" href="ButtonWidgets.html" title="Buttons and Toggles">
<link rel="chapter" href="NumericEntry.html" title="Numeric/Text Data Entry">
<link rel="chapter" href="TextWidgetObjects.html" title="Multiline Text Editor">
<link rel="chapter" href="TreeWidgetObjects.html" title="Tree, List and Icon Grid Widgets">
<link rel="chapter" href="MenusAndCombos.html" title="Menus, Combo Box, Toolbar">
<link rel="chapter" href="Actions.html" title="Action-based menus and toolbars">
<link rel="chapter" href="SelectorWidgets.html" title="Selectors (File/Font/Color/Input Devices)">
<link rel="chapter" href="LayoutContainers.html" title="Layout Containers">
<link rel="chapter" href="Ornaments.html" title="Ornaments">
<link rel="chapter" href="ScrollingWidgets.html" title="Scrolling">
<link rel="chapter" href="Printing.html" title="Printing">
<link rel="chapter" href="MiscObjects.html" title="Miscellaneous">
<link rel="chapter" href="AbstractObjects.html" title="Abstract Base Classes">
<link rel="chapter" href="PlugSocket.html" title="Cross-process Embedding">
<link rel="chapter" href="SpecialObjects.html" title="Special-purpose features">
<link rel="chapter" href="RecentDocuments.html" title="Recently Used Documents">
<link rel="chapter" href="DeprecatedObjects.html" title="Deprecated">
<link rel="part" href="migrating.html" title="Part IV. Migrating from Previous Versions of GTK+">
<link rel="chapter" href="gtk-migrating-checklist.html" title="Migration Checklist">
<link rel="chapter" href="gtk-migrating-GtkFileChooser.html" title="Migrating from GtkFileSelection to GtkFileChooser">
<link rel="chapter" href="gtk-migrating-GtkAction.html" title="Migrating from old menu and toolbar systems to GtkAction">
<link rel="chapter" href="gtk-migrating-GtkComboBox.html" title="Migrating from GtkOptionMenu and GtkCombo to GtkComboBox and
GtkComboBoxEntry">
<link rel="chapter" href="gtk-migrating-GtkIconView.html" title="Migrating from GnomeIconList to GtkIconView">
<link rel="chapter" href="gtk-migrating-GtkAboutDialog.html" title="Migrating from GnomeAbout to GtkAboutDialog">
<link rel="chapter" href="gtk-migrating-GtkColorButton.html" title="Migrating from GnomeColorPicker to GtkColorButton">
<link rel="chapter" href="gtk-migrating-GtkAssistant.html" title="Migrating from GnomeDruid to GtkAssistant">
<link rel="chapter" href="gtk-migrating-GtkRecentChooser.html" title="Migrating from EggRecent to GtkRecentChooser">
<link rel="chapter" href="gtk-migrating-GtkLinkButton.html" title="Migrating from GnomeHRef to GtkLinkButton">
<link rel="part" href="pt05.html" title="Part V. GTK+ Tools">
<link rel="glossary" href="glossary.html" title="Glossary">
<link rel="index" href="ix01.html" title="Index">
<link rel="index" href="ix02.html" title="Index of deprecated symbols">
<link rel="index" href="ix03.html" title="Index of new symbols in 2.2">
<link rel="index" href="ix04.html" title="Index of new symbols in 2.4">
<link rel="index" href="ix05.html" title="Index of new symbols in 2.6">
<link rel="index" href="ix06.html" title="Index of new symbols in 2.8">
<link rel="index" href="ix07.html" title="Index of new symbols in 2.10">
</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="2">
<tr valign="middle">
<td><a accesskey="p" href="GtkPixmap.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="DeprecatedObjects.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">GTK+ Reference Manual</th>
<td><a accesskey="n" href="GtkProgress.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id3918581" class="shortcut">Top</a>
 | 
<a href="#id3919171" class="shortcut">Description</a>
 | 
<a href="#id3919069" class="shortcut">Object Hierarchy</a>
 | 
<a href="#id3919115" class="shortcut">Implemented Interfaces</a>
 | 
<a href="#id3919138" class="shortcut">Properties</a></nobr></td></tr>
</table>
<div class="refentry" lang="en">
<a name="GtkPreview"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2>
<a name="id3918581"></a><span class="refentrytitle">GtkPreview</span>
</h2>
<p>GtkPreview — A widget to display RGB or grayscale data</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<h2>Synopsis</h2>
<pre class="synopsis">
#include <gtk/gtk.h>
<a href="GtkPreview.html#GtkPreview-struct">GtkPreview</a>;
<a href="GtkPreview.html#GtkPreviewInfo">GtkPreviewInfo</a>;
union <a href="GtkPreview.html#GtkDitherInfo">GtkDitherInfo</a>;
void <a href="GtkPreview.html#gtk-preview-uninit">gtk_preview_uninit</a> (void);
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>* <a href="GtkPreview.html#gtk-preview-new">gtk_preview_new</a> (<a href="gtk-Standard-Enumerations.html#GtkPreviewType">GtkPreviewType</a> type);
void <a href="GtkPreview.html#gtk-preview-size">gtk_preview_size</a> (<a href="GtkPreview.html" title="GtkPreview">GtkPreview</a> *preview,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> width,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> height);
void <a href="GtkPreview.html#gtk-preview-put">gtk_preview_put</a> (<a href="GtkPreview.html" title="GtkPreview">GtkPreview</a> *preview,
<a
href="../gdk/gdk-Windows.html#GdkWindow"
>GdkWindow</a> *window,
<a
href="../gdk/gdk-Graphics-Contexts.html#GdkGC"
>GdkGC</a> *gc,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> srcx,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> srcy,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> destx,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> desty,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> width,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> height);
void <a href="GtkPreview.html#gtk-preview-draw-row">gtk_preview_draw_row</a> (<a href="GtkPreview.html" title="GtkPreview">GtkPreview</a> *preview,
<a
href="../glib/glib-Basic-Types.html#guchar"
>guchar</a> *data,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> x,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> y,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> w);
void <a href="GtkPreview.html#gtk-preview-set-expand">gtk_preview_set_expand</a> (<a href="GtkPreview.html" title="GtkPreview">GtkPreview</a> *preview,
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> expand);
void <a href="GtkPreview.html#gtk-preview-set-gamma">gtk_preview_set_gamma</a> (double gamma_);
void <a href="GtkPreview.html#gtk-preview-set-color-cube">gtk_preview_set_color_cube</a> (<a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> nred_shades,
<a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> ngreen_shades,
<a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> nblue_shades,
<a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> ngray_shades);
void <a href="GtkPreview.html#gtk-preview-set-install-cmap">gtk_preview_set_install_cmap</a> (<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> install_cmap);
void <a href="GtkPreview.html#gtk-preview-set-reserved">gtk_preview_set_reserved</a> (<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> nreserved);
void <a href="GtkPreview.html#gtk-preview-set-dither">gtk_preview_set_dither</a> (<a href="GtkPreview.html" title="GtkPreview">GtkPreview</a> *preview,
<a
href="../gdk/gdk-GdkRGB.html#GdkRgbDither"
>GdkRgbDither</a> dither);
<a
href="../gdk/gdk-Visuals.html#GdkVisual"
>GdkVisual</a>* <a href="GtkPreview.html#gtk-preview-get-visual">gtk_preview_get_visual</a> (void);
<a
href="../gdk/gdk-Colormaps-and-Colors.html#GdkColormap"
>GdkColormap</a>* <a href="GtkPreview.html#gtk-preview-get-cmap">gtk_preview_get_cmap</a> (void);
<a href="GtkPreview.html#GtkPreviewInfo">GtkPreviewInfo</a>* <a href="GtkPreview.html#gtk-preview-get-info">gtk_preview_get_info</a> (void);
void <a href="GtkPreview.html#gtk-preview-reset">gtk_preview_reset</a> (void);
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id3919069"></a><h2>Object Hierarchy</h2>
<pre class="synopsis">
<a
href="../gobject/gobject-The-Base-Object-Type.html#GObject"
>GObject</a>
+----<a
href="../gobject/gobject-The-Base-Object-Type.html#GInitiallyUnowned"
>GInitiallyUnowned</a>
+----<a href="GtkObject.html" title="GtkObject">GtkObject</a>
+----<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
+----GtkPreview
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id3919115"></a><h2>Implemented Interfaces</h2>
<p>
GtkPreview implements
AtkImplementorIface.</p>
</div>
<div class="refsect1" lang="en">
<a name="id3919138"></a><h2>Properties</h2>
<pre class="synopsis">
"<a href="GtkPreview.html#GtkPreview--expand">expand</a>" <a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> : Read / Write
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id3919171"></a><h2>Description</h2>
<p>
The <a href="GtkPreview.html" title="GtkPreview"><span class="type">GtkPreview</span></a> widget provides a simple interface
used to display images as RGB or grayscale data.
It's deprecated; just use a <a
href="../gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"
><span class="type">GdkPixbuf</span></a> displayed by a <a href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a>, or
perhaps a <a href="GtkDrawingArea.html" title="GtkDrawingArea"><span class="type">GtkDrawingArea</span></a>. <a href="GtkPreview.html" title="GtkPreview"><span class="type">GtkPreview</span></a> has no advantage over those
approaches.
</p>
</div>
<div class="refsect1" lang="en">
<a name="id3919228"></a><h2>Details</h2>
<div class="refsect2" lang="en">
<a name="id3919239"></a><h3>
<a name="GtkPreview-struct"></a>GtkPreview</h3>
<a class="indexterm" name="id3919252"></a><pre class="programlisting">typedef struct _GtkPreview GtkPreview;</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">GtkPreview</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
The <a href="GtkPreview.html#GtkPreview-struct"><span class="type">GtkPreview</span></a> struct contains private data only, and
should be accessed using the functions below.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3919290"></a><h3>
<a name="GtkPreviewInfo"></a>GtkPreviewInfo</h3>
<a class="indexterm" name="id3919304"></a><pre class="programlisting">typedef struct {
guchar *lookup;
gdouble gamma;
} GtkPreviewInfo;
</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">GtkPreviewInfo</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Contains information about global properties
of preview widgets.
The <a href="GtkPreview.html#GtkPreviewInfo"><span class="type">GtkPreviewInfo</span></a> struct contains the following fields.
(These fields should be considered read-only. They should never be set by
an application.)
</p>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td>
<a
href="../gdk/gdk-Visuals.html#GdkVisual"
><span class="type">GdkVisual</span></a> *visual;</td>
<td>the visual used by all previews.</td>
</tr>
<tr>
<td>
<a
href="../gdk/gdk-Colormaps-and-Colors.html#GdkColormap"
><span class="type">GdkColormap</span></a> *cmap;</td>
<td>the colormap used by all previews.</td>
</tr>
<tr>
<td>gdouble gamma;</td>
<td>the gamma correction value used by all previews (See <a href="GtkPreview.html#gtk-preview-set-gamma"><code class="function">gtk_preview_set_gamma()</code></a>).</td>
</tr>
</tbody>
</table></div>
<p>
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3919430"></a><h3>
<a name="GtkDitherInfo"></a>union GtkDitherInfo</h3>
<a class="indexterm" name="id3919445"></a><pre class="programlisting">union GtkDitherInfo
{
gushort s[2];
guchar c[4];
};
</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">GtkDitherInfo</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
This union not used in GTK+.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3919474"></a><h3>
<a name="gtk-preview-uninit"></a>gtk_preview_uninit ()</h3>
<a class="indexterm" name="id3919489"></a><pre class="programlisting">void gtk_preview_uninit (void);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_preview_uninit</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
This function is deprecated and does nothing.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3919524"></a><h3>
<a name="gtk-preview-new"></a>gtk_preview_new ()</h3>
<a class="indexterm" name="id3919539"></a><pre class="programlisting"><a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>* gtk_preview_new (<a href="gtk-Standard-Enumerations.html#GtkPreviewType">GtkPreviewType</a> type);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_preview_new</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Create a new preview widget.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>type</code></em> :</span></td>
<td>the type data contained by the widget.
(Grayscale or RGB)
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>a new <a href="GtkPreview.html" title="GtkPreview"><span class="type">GtkPreview</span></a>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3919617"></a><h3>
<a name="gtk-preview-size"></a>gtk_preview_size ()</h3>
<a class="indexterm" name="id3919632"></a><pre class="programlisting">void gtk_preview_size (<a href="GtkPreview.html" title="GtkPreview">GtkPreview</a> *preview,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> width,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> height);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_preview_size</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Set the size that the preview widget will request
in response to a "size_request" 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 <code class="function">gtk_preview_expand()</code>)
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>preview</code></em> :</span></td>
<td>a <a href="GtkPreview.html" title="GtkPreview"><span class="type">GtkPreview</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>width</code></em> :</span></td>
<td>the new width.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>height</code></em> :</span></td>
<td>the new height.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3919757"></a><h3>
<a name="gtk-preview-put"></a>gtk_preview_put ()</h3>
<a class="indexterm" name="id3919772"></a><pre class="programlisting">void gtk_preview_put (<a href="GtkPreview.html" title="GtkPreview">GtkPreview</a> *preview,
<a
href="../gdk/gdk-Windows.html#GdkWindow"
>GdkWindow</a> *window,
<a
href="../gdk/gdk-Graphics-Contexts.html#GdkGC"
>GdkGC</a> *gc,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> srcx,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> srcy,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> destx,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> desty,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> width,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> height);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_preview_put</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Takes a portion of the contents of a preview widget
and draws it onto the given drawable, <em class="parameter"><code>window</code></em>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>preview</code></em> :</span></td>
<td>a <a href="GtkPreview.html" title="GtkPreview"><span class="type">GtkPreview</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>window</code></em> :</span></td>
<td>a window or pixmap.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>gc</code></em> :</span></td>
<td>The graphics context for the operation. Only the
clip mask for this GC matters.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>srcx</code></em> :</span></td>
<td>the x coordinate of the upper left corner in the source image.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>srcy</code></em> :</span></td>
<td>the y coordinate of the upper left corner in the source image.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>destx</code></em> :</span></td>
<td>the x coordinate of the upper left corner in the destination image.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>desty</code></em> :</span></td>
<td>the y coordinate of the upper left corner in the destination image.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>width</code></em> :</span></td>
<td>the width of the rectangular portion to draw.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>height</code></em> :</span></td>
<td>the height of the rectangular portion to draw.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3920023"></a><h3>
<a name="gtk-preview-draw-row"></a>gtk_preview_draw_row ()</h3>
<a class="indexterm" name="id3920039"></a><pre class="programlisting">void gtk_preview_draw_row (<a href="GtkPreview.html" title="GtkPreview">GtkPreview</a> *preview,
<a
href="../glib/glib-Basic-Types.html#guchar"
>guchar</a> *data,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> x,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> y,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> w);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_preview_draw_row</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Sets the data for a portion of a row.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>preview</code></em> :</span></td>
<td>a <a href="GtkPreview.html" title="GtkPreview"><span class="type">GtkPreview</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>data</code></em> :</span></td>
<td>the new data for the portion. It should contain
<em class="parameter"><code>w</code></em> bytes of data if the preview is of type
GTK_TYPE_GRAYSCALE, and 3*<em class="parameter"><code>w</code></em> bytes of data
if the preview is of type GTK_TYPE_COLOR.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>x</code></em> :</span></td>
<td>the starting value on the row to set.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>y</code></em> :</span></td>
<td>the row to change.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>w</code></em> :</span></td>
<td>the number of pixels in the row to change.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3920206"></a><h3>
<a name="gtk-preview-set-expand"></a>gtk_preview_set_expand ()</h3>
<a class="indexterm" name="id3920222"></a><pre class="programlisting">void gtk_preview_set_expand (<a href="GtkPreview.html" title="GtkPreview">GtkPreview</a> *preview,
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> expand);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_preview_set_expand</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Determines the way that the the preview widget behaves
when the size it is allocated is larger than the requested
size. If <em class="parameter"><code>expand</code></em> is <a
href="../glib/glib-Standard-Macros.html#FALSE:CAPS"
><code class="literal">FALSE</code></a>, then the preview's window
and buffer will be no larger than the size set with
<a href="GtkPreview.html#gtk-preview-size"><code class="function">gtk_preview_size()</code></a>, and the data set will be centered
in the allocation if it is larger. If <em class="parameter"><code>expand</code></em> is <a
href="../glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a>
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>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>preview</code></em> :</span></td>
<td>a <a href="GtkPreview.html" title="GtkPreview"><span class="type">GtkPreview</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>expand</code></em> :</span></td>
<td>whether the preview's window should expand or not.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3920361"></a><h3>
<a name="gtk-preview-set-gamma"></a>gtk_preview_set_gamma ()</h3>
<a class="indexterm" name="id3920377"></a><pre class="programlisting">void gtk_preview_set_gamma (double gamma_);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_preview_set_gamma</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Set the gamma-correction value for all preview widgets.
(This function will eventually be replaced with a
function that sets a per-preview-widget gamma value).
The resulting intensity is given by:
<code class="literal">destination_value * pow (source_value/255, 1/gamma)</code>.
The gamma value is applied when the data is
set with <a href="GtkPreview.html#gtk-preview-draw-row"><code class="function">gtk_preview_draw_row()</code></a> so changing this
value will not affect existing data in preview
widgets.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><em class="parameter"><code>gamma_</code></em> :</span></td>
<td>the new gamma value.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3920459"></a><h3>
<a name="gtk-preview-set-color-cube"></a>gtk_preview_set_color_cube ()</h3>
<a class="indexterm" name="id3920476"></a><pre class="programlisting">void gtk_preview_set_color_cube (<a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> nred_shades,
<a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> ngreen_shades,
<a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> nblue_shades,
<a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> ngray_shades);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_preview_set_color_cube</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
This function is deprecated and does nothing. GdkRGB
automatically picks an optimium color cube for the
display.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>nred_shades</code></em> :</span></td>
<td>ignored
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>ngreen_shades</code></em> :</span></td>
<td>ignored
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>nblue_shades</code></em> :</span></td>
<td>ignored
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>ngray_shades</code></em> :</span></td>
<td>ignored
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3920601"></a><h3>
<a name="gtk-preview-set-install-cmap"></a>gtk_preview_set_install_cmap ()</h3>
<a class="indexterm" name="id3920617"></a><pre class="programlisting">void gtk_preview_set_install_cmap (<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> install_cmap);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_preview_set_install_cmap</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
This function is deprecated
and does nothing. GdkRGB will automatically pick
a private colormap if it cannot allocate sufficient
colors.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><em class="parameter"><code>install_cmap</code></em> :</span></td>
<td>ignored.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3920679"></a><h3>
<a name="gtk-preview-set-reserved"></a>gtk_preview_set_reserved ()</h3>
<a class="indexterm" name="id3920695"></a><pre class="programlisting">void gtk_preview_set_reserved (<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> nreserved);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_preview_set_reserved</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
This function is deprecated and does nothing.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><em class="parameter"><code>nreserved</code></em> :</span></td>
<td>ignored.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3920755"></a><h3>
<a name="gtk-preview-set-dither"></a>gtk_preview_set_dither ()</h3>
<a class="indexterm" name="id3920770"></a><pre class="programlisting">void gtk_preview_set_dither (<a href="GtkPreview.html" title="GtkPreview">GtkPreview</a> *preview,
<a
href="../gdk/gdk-GdkRGB.html#GdkRgbDither"
>GdkRgbDither</a> dither);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_preview_set_dither</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Set the dithering mode for the display.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>preview</code></em> :</span></td>
<td>a <a href="GtkPreview.html" title="GtkPreview"><span class="type">GtkPreview</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>dither</code></em> :</span></td>
<td>the dithering mode.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3920860"></a><h3>
<a name="gtk-preview-get-visual"></a>gtk_preview_get_visual ()</h3>
<a class="indexterm" name="id3920875"></a><pre class="programlisting"><a
href="../gdk/gdk-Visuals.html#GdkVisual"
>GdkVisual</a>* gtk_preview_get_visual (void);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_preview_get_visual</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Returns the visual used by preview widgets. This
function is deprecated, and you should use
<a
href="../gdk/gdk-GdkRGB.html#gdk-rgb-get-visual"
><code class="function">gdk_rgb_get_visual()</code></a> instead.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>the visual for previews.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3920938"></a><h3>
<a name="gtk-preview-get-cmap"></a>gtk_preview_get_cmap ()</h3>
<a class="indexterm" name="id3920954"></a><pre class="programlisting"><a
href="../gdk/gdk-Colormaps-and-Colors.html#GdkColormap"
>GdkColormap</a>* gtk_preview_get_cmap (void);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_preview_get_cmap</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Returns the colormap used by preview widgets. This
function is deprecated, and you should use
<a
href="../gdk/gdk-GdkRGB.html#gdk-rgb-get-cmap"
><code class="function">gdk_rgb_get_cmap()</code></a> instead.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>the colormap for previews.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3921016"></a><h3>
<a name="gtk-preview-get-info"></a>gtk_preview_get_info ()</h3>
<a class="indexterm" name="id3921032"></a><pre class="programlisting"><a href="GtkPreview.html#GtkPreviewInfo">GtkPreviewInfo</a>* gtk_preview_get_info (void);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_preview_get_info</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Return a <a href="GtkPreview.html#GtkPreviewInfo"><span class="type">GtkPreviewInfo</span></a> structure containing
global information about preview widgets.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>a <a href="GtkPreview.html#GtkPreviewInfo"><span class="type">GtkPreviewInfo</span></a> structure. The return
value belongs to GTK+ and must not be modified
or freed.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3921100"></a><h3>
<a name="gtk-preview-reset"></a>gtk_preview_reset ()</h3>
<a class="indexterm" name="id3921116"></a><pre class="programlisting">void gtk_preview_reset (void);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_preview_reset</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
This function is deprecated and does nothing. It was
once used for changing the colormap and visual on the fly.
</p>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id3921152"></a><h2>Property Details</h2>
<div class="refsect2" lang="en">
<a name="id3921163"></a><h3>
<a name="GtkPreview--expand"></a>The "<code class="literal">expand</code>" property</h3>
<a class="indexterm" name="id3921178"></a><pre class="programlisting"> "expand" <a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> : Read / Write</pre>
<p>Whether the preview widget should take up the entire space it is allocated.</p>
<p>Default value: FALSE</p>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id3921206"></a><h2>See Also</h2>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><span class="type">GdkRGB</span></span></td>
<td><p>the backend used by <a href="GtkPreview.html" title="GtkPreview"><span class="type">GtkPreview</span></a>.</p></td>
</tr></tbody>
</table></div>
<p>
</p>
</div>
</div>
</body>
</html>