← Back to branch summary

~canonical-dx-team/ubuntu/maverick/gtk+2.0/menuproxy

« back to all changes in this revision

Viewing changes to docs/reference/gtk/html/GtkPreview.html

  • Committer: Bazaar Package Importer
  • Author(s): Sebastien Bacher
  • Date: 2007-05-04 12:24:25 UTC
  • mfrom: (1.1.21 upstream)
  • Revision ID: james.westby@ubuntu.com-20070504122425-0m8midgzrp40y8w2
Tags: 2.10.12-1ubuntu1
* Sync with Debian
* New upstream version:
  Fixed bugs:
  - 379414 file chooser warnings when changing path in the entry
  - 418585 GtkFileChooserDefault sizing code is not DPI independent
  - 419568 Crash in search if start with special letter
  - 435062 build dies with icon cache validation
  - 379399 Segfault to call gtk_print_operation_run twice.
  - 387889 cups backend has problems when there are too many printers
  - 418531 invalid read to gtkicontheme.c gtk_icon_theme_lookup_icon...
  - 423916 crash in color scheme code
  - 424042 Segmentation fault while quickly pressing Alt+arrows
  - 415260 Protect against negative indices when setting values in G...
  - 419171 XGetVisualInfo() may not set nxvisuals
  - 128852 Gdk cursors don't look good on win32
  - 344657 Ctrl-H doesn't toggle "Show Hidden Files" setting
  - 345345 PrintOperation::paginate is not emitted for class handler
  - 347567 GtkPrintOperation::end-print is not emitted if it's cance...
  - 369112 gtk_ui_manager_add_ui should accept unnamed separator
  - 392015 Selected menu item invisible on Windows Vista
  - 399253 MS-Windows Theme Bottom Tab placement rendering glitches
  - 399425 gtk_input_dialog_fill_axes() adds child to gtkscrolledwin...
  - 403251 [patch] little memory leak in GtkPrintJob
  - 403267 [patch] memory leak in GtkPageSetupUnixDialog
  - 403470 MS-Windows Theme tab placement other than on top leaks a ...
  - 404506 Windows system fonts that have multi-byte font names cann...
  - 405089 Incorrect window placement for GtkEventBox private window
  - 405515 Minor leak in gtkfilesystemmodel.c
  - 405539 gdk_pixbuf_save() for PNG saver can return FALSE without ...
  - 415681 gdk_window_clear_area includes an extra line and column o...
  - 418219 GtkRecentChooser should apply filter before sorting and c...
  - 418403 Scroll to printer after selecting it from settings
  - 421985 _gtk_print_operation_platform_backend_launch_preview
  - 421990 gtk_print_job_get_surface
  - 421993 gtk_print_operation_init
  - 423064 Conditional jump or move depends on uninitialised value(s...
  - 423722 Fix printing header in gtk-demo
  - 424168 gtk_print_operation_run on async preview
  - 425655 Don't install gtk+-unix-print-2.0.pc on non-UNIX platforms
  - 425786 GDK segfaults if XineramaQueryScreens fails
  - 428665 Lpr Backend gets stuck in infinite loop during gtk_enumer...
  - 429902 GtkPrintOperation leaks cairo contextes
  - 431997 First delay of GdkPixbufAnimationIter is wrong
  - 433242 Inconsistent scroll arrow position calculations
  - 433972 Placing gtk.Expander inside a gtk.TextView() changes gtk....
  - 434261 _gtk_toolbar_elide_underscores incorrectly handles some s...
  - 383354 ctrl-L should make 'Location' entry disappear
  - 418673 gtk_recent_manager_add_item
  - 429732 gtk_accel_group_finalize accesses invalid memory
  - 435028 WM_CLIENT_LEADER is wrong on the leader_window
  - 431067 Background of the header window is not updated
  - 338843 add recent files support inside the ui manager
  - 148535 add drop shadow to menus, tooltips, etc. under Windows XP
* debian/control.in:
  - Conflicts on ubuntulooks (<= 0.9.11-1)
* debian/patches/15_default-fallback-icon-theme.patch:
  - patch from Debian, fallback on gnome icon theme

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/gtk/html/GtkPreview.html
 
1
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
 
2
<html>
 
3
<head>
 
4
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
 
5
<title>GtkPreview</title>
 
6
<meta name="generator" content="DocBook XSL Stylesheets V1.72.0">
 
7
<link rel="start" href="index.html" title="GTK+ Reference Manual">
 
8
<link rel="up" href="DeprecatedObjects.html" title="Deprecated">
 
9
<link rel="prev" href="GtkPixmap.html" title="GtkPixmap">
 
10
<link rel="next" href="GtkProgress.html" title="GtkProgress">
 
11
<meta name="generator" content="GTK-Doc V1.7 (XML mode)">
 
12
<link rel="stylesheet" href="style.css" type="text/css">
 
13
<link rel="part" href="gtk.html" title="Part&#160;I.&#160;GTK+ Overview">
 
14
<link rel="part" href="gtkbase.html" title="Part&#160;II.&#160;GTK+ Core Reference">
 
15
<link rel="part" href="gtkobjects.html" title="Part&#160;III.&#160;GTK+ Widgets and Objects">
 
16
<link rel="chapter" href="ch01.html" title="Object Hierarchy">
 
17
<link rel="chapter" href="ch02.html" title="Widget Gallery">
 
18
<link rel="chapter" href="WindowWidgets.html" title="Windows">
 
19
<link rel="chapter" href="DisplayWidgets.html" title="Display Widgets">
 
20
<link rel="chapter" href="ButtonWidgets.html" title="Buttons and Toggles">
 
21
<link rel="chapter" href="NumericEntry.html" title="Numeric/Text Data Entry">
 
22
<link rel="chapter" href="TextWidgetObjects.html" title="Multiline Text Editor">
 
23
<link rel="chapter" href="TreeWidgetObjects.html" title="Tree, List and Icon Grid Widgets">
 
24
<link rel="chapter" href="MenusAndCombos.html" title="Menus, Combo Box, Toolbar">
 
25
<link rel="chapter" href="Actions.html" title="Action-based menus and toolbars">
 
26
<link rel="chapter" href="SelectorWidgets.html" title="Selectors (File/Font/Color/Input Devices)">
 
27
<link rel="chapter" href="LayoutContainers.html" title="Layout Containers">
 
28
<link rel="chapter" href="Ornaments.html" title="Ornaments">
 
29
<link rel="chapter" href="ScrollingWidgets.html" title="Scrolling">
 
30
<link rel="chapter" href="Printing.html" title="Printing">
 
31
<link rel="chapter" href="MiscObjects.html" title="Miscellaneous">
 
32
<link rel="chapter" href="AbstractObjects.html" title="Abstract Base Classes">
 
33
<link rel="chapter" href="PlugSocket.html" title="Cross-process Embedding">
 
34
<link rel="chapter" href="SpecialObjects.html" title="Special-purpose features">
 
35
<link rel="chapter" href="RecentDocuments.html" title="Recently Used Documents">
 
36
<link rel="chapter" href="DeprecatedObjects.html" title="Deprecated">
 
37
<link rel="part" href="migrating.html" title="Part&#160;IV.&#160;Migrating from Previous Versions of GTK+">
 
38
<link rel="chapter" href="gtk-migrating-checklist.html" title="Migration Checklist">
 
39
<link rel="chapter" href="gtk-migrating-GtkFileChooser.html" title="Migrating from GtkFileSelection to GtkFileChooser">
 
40
<link rel="chapter" href="gtk-migrating-GtkAction.html" title="Migrating from old menu and toolbar systems to GtkAction">
 
41
<link rel="chapter" href="gtk-migrating-GtkComboBox.html" title="Migrating from GtkOptionMenu and GtkCombo to GtkComboBox and GtkComboBoxEntry">
 
42
<link rel="chapter" href="gtk-migrating-GtkIconView.html" title="Migrating from GnomeIconList to GtkIconView">
 
43
<link rel="chapter" href="gtk-migrating-GtkAboutDialog.html" title="Migrating from GnomeAbout to GtkAboutDialog">
 
44
<link rel="chapter" href="gtk-migrating-GtkColorButton.html" title="Migrating from GnomeColorPicker to GtkColorButton">
 
45
<link rel="chapter" href="gtk-migrating-GtkAssistant.html" title="Migrating from GnomeDruid to GtkAssistant">
 
46
<link rel="chapter" href="gtk-migrating-GtkRecentChooser.html" title="Migrating from EggRecent to GtkRecentChooser">
 
47
<link rel="chapter" href="gtk-migrating-GtkLinkButton.html" title="Migrating from GnomeHRef to GtkLinkButton">
 
48
<link rel="part" href="pt05.html" title="Part&#160;V.&#160;GTK+ Tools">
 
49
<link rel="glossary" href="glossary.html" title="Glossary">
 
50
<link rel="index" href="ix01.html" title="Index">
 
51
<link rel="index" href="ix02.html" title="Index of deprecated symbols">
 
52
<link rel="index" href="ix03.html" title="Index of new symbols in 2.2">
 
53
<link rel="index" href="ix04.html" title="Index of new symbols in 2.4">
 
54
<link rel="index" href="ix05.html" title="Index of new symbols in 2.6">
 
55
<link rel="index" href="ix06.html" title="Index of new symbols in 2.8">
 
56
<link rel="index" href="ix07.html" title="Index of new symbols in 2.10">
 
57
</head>
 
58
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
 
59
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
 
60
<tr valign="middle">
 
61
<td><a accesskey="p" href="GtkPixmap.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
 
62
<td><a accesskey="u" href="DeprecatedObjects.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
 
63
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
 
64
<th width="100%" align="center">GTK+ Reference Manual</th>
 
65
<td><a accesskey="n" href="GtkProgress.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
 
66
</tr>
 
67
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id3974764" class="shortcut">Top</a>
 
68
                  &#160;|&#160;
 
69
                  <a href="#id3975369" class="shortcut">Description</a>
 
70
                  &#160;|&#160;
 
71
                  <a href="#id3975266" class="shortcut">Object Hierarchy</a>
 
72
                  &#160;|&#160;
 
73
                  <a href="#id3975313" class="shortcut">Implemented Interfaces</a>
 
74
                  &#160;|&#160;
 
75
                  <a href="#id3975336" class="shortcut">Properties</a></nobr></td></tr>
 
76
</table>
 
77
<div class="refentry" lang="en">
 
78
<a name="GtkPreview"></a><div class="titlepage"></div>
 
79
<div class="refnamediv"><table width="100%"><tr>
 
80
<td valign="top">
 
81
<h2>
 
82
<a name="id3974764"></a><span class="refentrytitle">GtkPreview</span>
 
83
</h2>
 
84
<p>GtkPreview &#8212; A widget to display RGB or grayscale data</p>
 
85
</td>
 
86
<td valign="top" align="right"></td>
 
87
</tr></table></div>
 
88
<div class="refsynopsisdiv">
 
89
<h2>Synopsis</h2>
 
90
<pre class="synopsis">
 
91
 
 
92
#include &lt;gtk/gtk.h&gt;
 
93
 
 
94
 
 
95
                    <a href="GtkPreview.html#GtkPreview-struct">GtkPreview</a>;
 
96
                    <a href="GtkPreview.html#GtkPreviewInfo">GtkPreviewInfo</a>;
 
97
union               <a href="GtkPreview.html#GtkDitherInfo">GtkDitherInfo</a>;
 
98
void                <a href="GtkPreview.html#gtk-preview-uninit">gtk_preview_uninit</a>                  (void);
 
99
<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);
 
100
void                <a href="GtkPreview.html#gtk-preview-size">gtk_preview_size</a>                    (<a href="GtkPreview.html" title="GtkPreview">GtkPreview</a> *preview,
 
101
                                                         gint width,
 
102
                                                         gint height);
 
103
void                <a href="GtkPreview.html#gtk-preview-put">gtk_preview_put</a>                     (<a href="GtkPreview.html" title="GtkPreview">GtkPreview</a> *preview,
 
104
                                                         <a
 
105
href="../gdk/gdk-Windows.html#GdkWindow"
 
106
>GdkWindow</a> *window,
 
107
                                                         <a
 
108
href="../gdk/gdk-Graphics-Contexts.html#GdkGC"
 
109
>GdkGC</a> *gc,
 
110
                                                         gint srcx,
 
111
                                                         gint srcy,
 
112
                                                         gint destx,
 
113
                                                         gint desty,
 
114
                                                         gint width,
 
115
                                                         gint height);
 
116
void                <a href="GtkPreview.html#gtk-preview-draw-row">gtk_preview_draw_row</a>                (<a href="GtkPreview.html" title="GtkPreview">GtkPreview</a> *preview,
 
117
                                                         guchar *data,
 
118
                                                         gint x,
 
119
                                                         gint y,
 
120
                                                         gint w);
 
121
void                <a href="GtkPreview.html#gtk-preview-set-expand">gtk_preview_set_expand</a>              (<a href="GtkPreview.html" title="GtkPreview">GtkPreview</a> *preview,
 
122
                                                         gboolean expand);
 
123
void                <a href="GtkPreview.html#gtk-preview-set-gamma">gtk_preview_set_gamma</a>               (double gamma_);
 
124
void                <a href="GtkPreview.html#gtk-preview-set-color-cube">gtk_preview_set_color_cube</a>          (guint nred_shades,
 
125
                                                         guint ngreen_shades,
 
126
                                                         guint nblue_shades,
 
127
                                                         guint ngray_shades);
 
128
void                <a href="GtkPreview.html#gtk-preview-set-install-cmap">gtk_preview_set_install_cmap</a>        (gint install_cmap);
 
129
void                <a href="GtkPreview.html#gtk-preview-set-reserved">gtk_preview_set_reserved</a>            (gint nreserved);
 
130
void                <a href="GtkPreview.html#gtk-preview-set-dither">gtk_preview_set_dither</a>              (<a href="GtkPreview.html" title="GtkPreview">GtkPreview</a> *preview,
 
131
                                                         <a
 
132
href="../gdk/gdk-GdkRGB.html#GdkRgbDither"
 
133
>GdkRgbDither</a> dither);
 
134
<a
 
135
href="../gdk/gdk-Visuals.html#GdkVisual"
 
136
>GdkVisual</a>*          <a href="GtkPreview.html#gtk-preview-get-visual">gtk_preview_get_visual</a>              (void);
 
137
<a
 
138
href="../gdk/gdk-Colormaps-and-Colors.html#GdkColormap"
 
139
>GdkColormap</a>*        <a href="GtkPreview.html#gtk-preview-get-cmap">gtk_preview_get_cmap</a>                (void);
 
140
<a href="GtkPreview.html#GtkPreviewInfo">GtkPreviewInfo</a>*     <a href="GtkPreview.html#gtk-preview-get-info">gtk_preview_get_info</a>                (void);
 
141
void                <a href="GtkPreview.html#gtk-preview-reset">gtk_preview_reset</a>                   (void);
 
142
 
 
143
 
 
144
</pre>
 
145
</div>
 
146
<div class="refsect1" lang="en">
 
147
<a name="id3975266"></a><h2>Object Hierarchy</h2>
 
148
<pre class="synopsis">
 
149
 
 
150
  GObject
 
151
   +----GInitiallyUnowned
 
152
         +----<a href="GtkObject.html" title="GtkObject">GtkObject</a>
 
153
               +----<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
 
154
                     +----GtkPreview
 
155
</pre>
 
156
</div>
 
157
<div class="refsect1" lang="en">
 
158
<a name="id3975313"></a><h2>Implemented Interfaces</h2>
 
159
<p>
 
160
GtkPreview implements
 
161
 AtkImplementorIface.</p>
 
162
</div>
 
163
<div class="refsect1" lang="en">
 
164
<a name="id3975336"></a><h2>Properties</h2>
 
165
<pre class="synopsis">
 
166
 
 
167
  "<a href="GtkPreview.html#GtkPreview--expand">expand</a>"                   gboolean              : Read / Write
 
168
</pre>
 
169
</div>
 
170
<div class="refsect1" lang="en">
 
171
<a name="id3975369"></a><h2>Description</h2>
 
172
<p>
 
173
The <a href="GtkPreview.html" title="GtkPreview"><span class="type">GtkPreview</span></a> widget provides a simple interface 
 
174
used to display images as RGB or grayscale data.
 
175
It's deprecated; just use a <a
 
176
href="../gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"
 
177
><span class="type">GdkPixbuf</span></a> displayed by a <a href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a>, or
 
178
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 
 
179
approaches.
 
180
</p>
 
181
</div>
 
182
<div class="refsect1" lang="en">
 
183
<a name="id3975427"></a><h2>Details</h2>
 
184
<div class="refsect2" lang="en">
 
185
<a name="id3975437"></a><h3>
 
186
<a name="GtkPreview-struct"></a>GtkPreview</h3>
 
187
<a class="indexterm" name="id3975450"></a><pre class="programlisting">typedef struct _GtkPreview GtkPreview;</pre>
 
188
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
189
<h3 class="title">Warning</h3>
 
190
<p><code class="literal">GtkPreview</code> is deprecated and should not be used in newly-written code.</p>
 
191
</div>
 
192
<p>
 
193
The <a href="GtkPreview.html#GtkPreview-struct"><span class="type">GtkPreview</span></a> struct contains private data only, and
 
194
should be accessed using the functions below.
 
195
</p>
 
196
</div>
 
197
<hr>
 
198
<div class="refsect2" lang="en">
 
199
<a name="id3975488"></a><h3>
 
200
<a name="GtkPreviewInfo"></a>GtkPreviewInfo</h3>
 
201
<a class="indexterm" name="id3975502"></a><pre class="programlisting">typedef struct {
 
202
  guchar *lookup;
 
203
 
 
204
  gdouble gamma;
 
205
} GtkPreviewInfo;
 
206
</pre>
 
207
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
208
<h3 class="title">Warning</h3>
 
209
<p><code class="literal">GtkPreviewInfo</code> is deprecated and should not be used in newly-written code.</p>
 
210
</div>
 
211
<p>
 
212
Contains information about global properties
 
213
of preview widgets.
 
214
 
 
215
The <a href="GtkPreview.html#GtkPreviewInfo"><span class="type">GtkPreviewInfo</span></a> struct contains the following fields.
 
216
(These fields should be considered read-only. They should never be set by
 
217
an application.)
 
218
 
 
219
</p>
 
220
<div class="informaltable"><table width="100%" border="0">
 
221
<colgroup>
 
222
<col>
 
223
<col>
 
224
</colgroup>
 
225
<tbody>
 
226
<tr>
 
227
<td>
 
228
<a
 
229
href="../gdk/gdk-Visuals.html#GdkVisual"
 
230
><span class="type">GdkVisual</span></a> *visual;</td>
 
231
<td>the visual used by all previews.</td>
 
232
</tr>
 
233
<tr>
 
234
<td>
 
235
<a
 
236
href="../gdk/gdk-Colormaps-and-Colors.html#GdkColormap"
 
237
><span class="type">GdkColormap</span></a> *cmap;</td>
 
238
<td>the colormap used by all previews.</td>
 
239
</tr>
 
240
<tr>
 
241
<td>gdouble gamma;</td>
 
242
<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>
 
243
</tr>
 
244
</tbody>
 
245
</table></div>
 
246
<p>
 
247
 
 
248
</p>
 
249
</div>
 
250
<hr>
 
251
<div class="refsect2" lang="en">
 
252
<a name="id3975628"></a><h3>
 
253
<a name="GtkDitherInfo"></a>union GtkDitherInfo</h3>
 
254
<a class="indexterm" name="id3975643"></a><pre class="programlisting">union GtkDitherInfo
 
255
{
 
256
  gushort s[2];
 
257
  guchar c[4];
 
258
};
 
259
</pre>
 
260
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
261
<h3 class="title">Warning</h3>
 
262
<p><code class="literal">GtkDitherInfo</code> is deprecated and should not be used in newly-written code.</p>
 
263
</div>
 
264
<p>
 
265
This union not used in GTK+.
 
266
</p>
 
267
</div>
 
268
<hr>
 
269
<div class="refsect2" lang="en">
 
270
<a name="id3975672"></a><h3>
 
271
<a name="gtk-preview-uninit"></a>gtk_preview_uninit ()</h3>
 
272
<a class="indexterm" name="id3975688"></a><pre class="programlisting">void                gtk_preview_uninit                  (void);</pre>
 
273
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
274
<h3 class="title">Warning</h3>
 
275
<p><code class="literal">gtk_preview_uninit</code> is deprecated and should not be used in newly-written code.</p>
 
276
</div>
 
277
<p>
 
278
This function is deprecated and does nothing.
 
279
</p>
 
280
</div>
 
281
<hr>
 
282
<div class="refsect2" lang="en">
 
283
<a name="id3975722"></a><h3>
 
284
<a name="gtk-preview-new"></a>gtk_preview_new ()</h3>
 
285
<a class="indexterm" name="id3975737"></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>
 
286
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
287
<h3 class="title">Warning</h3>
 
288
<p><code class="literal">gtk_preview_new</code> is deprecated and should not be used in newly-written code.</p>
 
289
</div>
 
290
<p>
 
291
Create a new preview widget.
 
292
</p>
 
293
<div class="variablelist"><table border="0">
 
294
<col align="left" valign="top">
 
295
<tbody>
 
296
<tr>
 
297
<td><span class="term"><em class="parameter"><code>type</code></em>&#160;:</span></td>
 
298
<td>the type data contained by the widget. 
 
299
(Grayscale or RGB)
 
300
</td>
 
301
</tr>
 
302
<tr>
 
303
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
304
<td>a new <a href="GtkPreview.html" title="GtkPreview"><span class="type">GtkPreview</span></a>
 
305
 
 
306
 
 
307
</td>
 
308
</tr>
 
309
</tbody>
 
310
</table></div>
 
311
</div>
 
312
<hr>
 
313
<div class="refsect2" lang="en">
 
314
<a name="id3975816"></a><h3>
 
315
<a name="gtk-preview-size"></a>gtk_preview_size ()</h3>
 
316
<a class="indexterm" name="id3975831"></a><pre class="programlisting">void                gtk_preview_size                    (<a href="GtkPreview.html" title="GtkPreview">GtkPreview</a> *preview,
 
317
                                                         gint width,
 
318
                                                         gint height);</pre>
 
319
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
320
<h3 class="title">Warning</h3>
 
321
<p><code class="literal">gtk_preview_size</code> is deprecated and should not be used in newly-written code.</p>
 
322
</div>
 
323
<p>
 
324
Set the size that the preview widget will request
 
325
in response to a "size_request" signal. The 
 
326
drawing area may actually be allocated a size
 
327
larger than this depending on how it is packed
 
328
within the enclosing containers. The effect
 
329
of this is determined by whether the preview
 
330
is set to expand or not (see <code class="function">gtk_preview_expand()</code>)
 
331
</p>
 
332
<div class="variablelist"><table border="0">
 
333
<col align="left" valign="top">
 
334
<tbody>
 
335
<tr>
 
336
<td><span class="term"><em class="parameter"><code>preview</code></em>&#160;:</span></td>
 
337
<td>a <a href="GtkPreview.html" title="GtkPreview"><span class="type">GtkPreview</span></a>.
 
338
</td>
 
339
</tr>
 
340
<tr>
 
341
<td><span class="term"><em class="parameter"><code>width</code></em>&#160;:</span></td>
 
342
<td>the new width.
 
343
</td>
 
344
</tr>
 
345
<tr>
 
346
<td><span class="term"><em class="parameter"><code>height</code></em>&#160;:</span></td>
 
347
<td>the new height.
 
348
 
 
349
 
 
350
</td>
 
351
</tr>
 
352
</tbody>
 
353
</table></div>
 
354
</div>
 
355
<hr>
 
356
<div class="refsect2" lang="en">
 
357
<a name="id3975958"></a><h3>
 
358
<a name="gtk-preview-put"></a>gtk_preview_put ()</h3>
 
359
<a class="indexterm" name="id3975974"></a><pre class="programlisting">void                gtk_preview_put                     (<a href="GtkPreview.html" title="GtkPreview">GtkPreview</a> *preview,
 
360
                                                         <a
 
361
href="../gdk/gdk-Windows.html#GdkWindow"
 
362
>GdkWindow</a> *window,
 
363
                                                         <a
 
364
href="../gdk/gdk-Graphics-Contexts.html#GdkGC"
 
365
>GdkGC</a> *gc,
 
366
                                                         gint srcx,
 
367
                                                         gint srcy,
 
368
                                                         gint destx,
 
369
                                                         gint desty,
 
370
                                                         gint width,
 
371
                                                         gint height);</pre>
 
372
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
373
<h3 class="title">Warning</h3>
 
374
<p><code class="literal">gtk_preview_put</code> is deprecated and should not be used in newly-written code.</p>
 
375
</div>
 
376
<p>
 
377
Takes a portion of the contents of a preview widget
 
378
and draws it onto the given drawable, <em class="parameter"><code>window</code></em>.
 
379
</p>
 
380
<div class="variablelist"><table border="0">
 
381
<col align="left" valign="top">
 
382
<tbody>
 
383
<tr>
 
384
<td><span class="term"><em class="parameter"><code>preview</code></em>&#160;:</span></td>
 
385
<td>a <a href="GtkPreview.html" title="GtkPreview"><span class="type">GtkPreview</span></a>.
 
386
</td>
 
387
</tr>
 
388
<tr>
 
389
<td><span class="term"><em class="parameter"><code>window</code></em>&#160;:</span></td>
 
390
<td>a window or pixmap.
 
391
</td>
 
392
</tr>
 
393
<tr>
 
394
<td><span class="term"><em class="parameter"><code>gc</code></em>&#160;:</span></td>
 
395
<td>The graphics context for the operation. Only the
 
396
     clip mask for this GC matters.
 
397
</td>
 
398
</tr>
 
399
<tr>
 
400
<td><span class="term"><em class="parameter"><code>srcx</code></em>&#160;:</span></td>
 
401
<td>the x coordinate of the upper left corner in the source image.
 
402
</td>
 
403
</tr>
 
404
<tr>
 
405
<td><span class="term"><em class="parameter"><code>srcy</code></em>&#160;:</span></td>
 
406
<td>the y coordinate of the upper left corner in the source image.
 
407
</td>
 
408
</tr>
 
409
<tr>
 
410
<td><span class="term"><em class="parameter"><code>destx</code></em>&#160;:</span></td>
 
411
<td>the x coordinate of the upper left corner in the destination image.
 
412
</td>
 
413
</tr>
 
414
<tr>
 
415
<td><span class="term"><em class="parameter"><code>desty</code></em>&#160;:</span></td>
 
416
<td>the y coordinate of the upper left corner in the destination image.
 
417
</td>
 
418
</tr>
 
419
<tr>
 
420
<td><span class="term"><em class="parameter"><code>width</code></em>&#160;:</span></td>
 
421
<td>the width of the rectangular portion to draw.
 
422
</td>
 
423
</tr>
 
424
<tr>
 
425
<td><span class="term"><em class="parameter"><code>height</code></em>&#160;:</span></td>
 
426
<td>the height of the rectangular portion to draw.
 
427
 
 
428
 
 
429
</td>
 
430
</tr>
 
431
</tbody>
 
432
</table></div>
 
433
</div>
 
434
<hr>
 
435
<div class="refsect2" lang="en">
 
436
<a name="id3976227"></a><h3>
 
437
<a name="gtk-preview-draw-row"></a>gtk_preview_draw_row ()</h3>
 
438
<a class="indexterm" name="id3976242"></a><pre class="programlisting">void                gtk_preview_draw_row                (<a href="GtkPreview.html" title="GtkPreview">GtkPreview</a> *preview,
 
439
                                                         guchar *data,
 
440
                                                         gint x,
 
441
                                                         gint y,
 
442
                                                         gint w);</pre>
 
443
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
444
<h3 class="title">Warning</h3>
 
445
<p><code class="literal">gtk_preview_draw_row</code> is deprecated and should not be used in newly-written code.</p>
 
446
</div>
 
447
<p>
 
448
Sets the data for a portion of a row.
 
449
</p>
 
450
<div class="variablelist"><table border="0">
 
451
<col align="left" valign="top">
 
452
<tbody>
 
453
<tr>
 
454
<td><span class="term"><em class="parameter"><code>preview</code></em>&#160;:</span></td>
 
455
<td>a <a href="GtkPreview.html" title="GtkPreview"><span class="type">GtkPreview</span></a>.
 
456
</td>
 
457
</tr>
 
458
<tr>
 
459
<td><span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></td>
 
460
<td>the new data for the portion. It should contain
 
461
       <em class="parameter"><code>w</code></em> bytes of data if the preview is of type
 
462
       GTK_TYPE_GRAYSCALE, and 3*<em class="parameter"><code>w</code></em> bytes of data
 
463
       if the preview is of type GTK_TYPE_COLOR.
 
464
</td>
 
465
</tr>
 
466
<tr>
 
467
<td><span class="term"><em class="parameter"><code>x</code></em>&#160;:</span></td>
 
468
<td>the starting value on the row to set.
 
469
</td>
 
470
</tr>
 
471
<tr>
 
472
<td><span class="term"><em class="parameter"><code>y</code></em>&#160;:</span></td>
 
473
<td>the row to change.
 
474
</td>
 
475
</tr>
 
476
<tr>
 
477
<td><span class="term"><em class="parameter"><code>w</code></em>&#160;:</span></td>
 
478
<td>the number of pixels in the row to change.
 
479
 
 
480
 
 
481
</td>
 
482
</tr>
 
483
</tbody>
 
484
</table></div>
 
485
</div>
 
486
<hr>
 
487
<div class="refsect2" lang="en">
 
488
<a name="id3976410"></a><h3>
 
489
<a name="gtk-preview-set-expand"></a>gtk_preview_set_expand ()</h3>
 
490
<a class="indexterm" name="id3976425"></a><pre class="programlisting">void                gtk_preview_set_expand              (<a href="GtkPreview.html" title="GtkPreview">GtkPreview</a> *preview,
 
491
                                                         gboolean expand);</pre>
 
492
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
493
<h3 class="title">Warning</h3>
 
494
<p><code class="literal">gtk_preview_set_expand</code> is deprecated and should not be used in newly-written code.</p>
 
495
</div>
 
496
<p>
 
497
Determines the way that the the preview widget behaves
 
498
when the size it is allocated is larger than the requested
 
499
size. If <em class="parameter"><code>expand</code></em> is <code class="literal">FALSE</code>, then the preview's window
 
500
and buffer will be no larger than the size set with 
 
501
<a href="GtkPreview.html#gtk-preview-size"><code class="function">gtk_preview_size()</code></a>, and the data set will be centered
 
502
in the allocation if it is larger. If <em class="parameter"><code>expand</code></em> is <code class="literal">TRUE</code>
 
503
then the window and buffer will expand with the allocation;
 
504
the application is responsible for catching
 
505
the "size_allocate" signal and providing the data 
 
506
appropriate for this size.
 
507
</p>
 
508
<div class="variablelist"><table border="0">
 
509
<col align="left" valign="top">
 
510
<tbody>
 
511
<tr>
 
512
<td><span class="term"><em class="parameter"><code>preview</code></em>&#160;:</span></td>
 
513
<td>a <a href="GtkPreview.html" title="GtkPreview"><span class="type">GtkPreview</span></a>.
 
514
</td>
 
515
</tr>
 
516
<tr>
 
517
<td><span class="term"><em class="parameter"><code>expand</code></em>&#160;:</span></td>
 
518
<td>whether the preview's window should expand or not.
 
519
 
 
520
 
 
521
</td>
 
522
</tr>
 
523
</tbody>
 
524
</table></div>
 
525
</div>
 
526
<hr>
 
527
<div class="refsect2" lang="en">
 
528
<a name="id3976565"></a><h3>
 
529
<a name="gtk-preview-set-gamma"></a>gtk_preview_set_gamma ()</h3>
 
530
<a class="indexterm" name="id3976581"></a><pre class="programlisting">void                gtk_preview_set_gamma               (double gamma_);</pre>
 
531
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
532
<h3 class="title">Warning</h3>
 
533
<p><code class="literal">gtk_preview_set_gamma</code> is deprecated and should not be used in newly-written code.</p>
 
534
</div>
 
535
<p>
 
536
Set the gamma-correction value for all preview widgets.
 
537
(This function will eventually be replaced with a
 
538
function that sets a per-preview-widget gamma value).
 
539
The resulting intensity is given by:
 
540
<code class="literal">destination_value * pow (source_value/255, 1/gamma)</code>.
 
541
The gamma value is applied when the data is
 
542
set with <a href="GtkPreview.html#gtk-preview-draw-row"><code class="function">gtk_preview_draw_row()</code></a> so changing this
 
543
value will not affect existing data in preview
 
544
widgets.
 
545
</p>
 
546
<div class="variablelist"><table border="0">
 
547
<col align="left" valign="top">
 
548
<tbody><tr>
 
549
<td><span class="term"><em class="parameter"><code>gamma_</code></em>&#160;:</span></td>
 
550
<td>the new gamma value.
 
551
 
 
552
 
 
553
</td>
 
554
</tr></tbody>
 
555
</table></div>
 
556
</div>
 
557
<hr>
 
558
<div class="refsect2" lang="en">
 
559
<a name="id3976663"></a><h3>
 
560
<a name="gtk-preview-set-color-cube"></a>gtk_preview_set_color_cube ()</h3>
 
561
<a class="indexterm" name="id3976680"></a><pre class="programlisting">void                gtk_preview_set_color_cube          (guint nred_shades,
 
562
                                                         guint ngreen_shades,
 
563
                                                         guint nblue_shades,
 
564
                                                         guint ngray_shades);</pre>
 
565
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
566
<h3 class="title">Warning</h3>
 
567
<p><code class="literal">gtk_preview_set_color_cube</code> is deprecated and should not be used in newly-written code.</p>
 
568
</div>
 
569
<p>
 
570
This function is deprecated and does nothing. GdkRGB
 
571
automatically picks an optimium color cube for the
 
572
display.
 
573
</p>
 
574
<div class="variablelist"><table border="0">
 
575
<col align="left" valign="top">
 
576
<tbody>
 
577
<tr>
 
578
<td><span class="term"><em class="parameter"><code>nred_shades</code></em>&#160;:</span></td>
 
579
<td>ignored
 
580
</td>
 
581
</tr>
 
582
<tr>
 
583
<td><span class="term"><em class="parameter"><code>ngreen_shades</code></em>&#160;:</span></td>
 
584
<td>ignored
 
585
</td>
 
586
</tr>
 
587
<tr>
 
588
<td><span class="term"><em class="parameter"><code>nblue_shades</code></em>&#160;:</span></td>
 
589
<td>ignored
 
590
</td>
 
591
</tr>
 
592
<tr>
 
593
<td><span class="term"><em class="parameter"><code>ngray_shades</code></em>&#160;:</span></td>
 
594
<td>ignored
 
595
 
 
596
 
 
597
</td>
 
598
</tr>
 
599
</tbody>
 
600
</table></div>
 
601
</div>
 
602
<hr>
 
603
<div class="refsect2" lang="en">
 
604
<a name="id3976806"></a><h3>
 
605
<a name="gtk-preview-set-install-cmap"></a>gtk_preview_set_install_cmap ()</h3>
 
606
<a class="indexterm" name="id3976822"></a><pre class="programlisting">void                gtk_preview_set_install_cmap        (gint install_cmap);</pre>
 
607
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
608
<h3 class="title">Warning</h3>
 
609
<p><code class="literal">gtk_preview_set_install_cmap</code> is deprecated and should not be used in newly-written code.</p>
 
610
</div>
 
611
<p>
 
612
This function is deprecated
 
613
and does nothing. GdkRGB will automatically pick
 
614
a private colormap if it cannot allocate sufficient
 
615
colors.
 
616
</p>
 
617
<div class="variablelist"><table border="0">
 
618
<col align="left" valign="top">
 
619
<tbody><tr>
 
620
<td><span class="term"><em class="parameter"><code>install_cmap</code></em>&#160;:</span></td>
 
621
<td>ignored.
 
622
 
 
623
 
 
624
</td>
 
625
</tr></tbody>
 
626
</table></div>
 
627
</div>
 
628
<hr>
 
629
<div class="refsect2" lang="en">
 
630
<a name="id3976884"></a><h3>
 
631
<a name="gtk-preview-set-reserved"></a>gtk_preview_set_reserved ()</h3>
 
632
<a class="indexterm" name="id3976900"></a><pre class="programlisting">void                gtk_preview_set_reserved            (gint nreserved);</pre>
 
633
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
634
<h3 class="title">Warning</h3>
 
635
<p><code class="literal">gtk_preview_set_reserved</code> is deprecated and should not be used in newly-written code.</p>
 
636
</div>
 
637
<p>
 
638
This function is deprecated and does nothing.
 
639
</p>
 
640
<div class="variablelist"><table border="0">
 
641
<col align="left" valign="top">
 
642
<tbody><tr>
 
643
<td><span class="term"><em class="parameter"><code>nreserved</code></em>&#160;:</span></td>
 
644
<td>ignored.
 
645
 
 
646
 
 
647
</td>
 
648
</tr></tbody>
 
649
</table></div>
 
650
</div>
 
651
<hr>
 
652
<div class="refsect2" lang="en">
 
653
<a name="id3976960"></a><h3>
 
654
<a name="gtk-preview-set-dither"></a>gtk_preview_set_dither ()</h3>
 
655
<a class="indexterm" name="id3976976"></a><pre class="programlisting">void                gtk_preview_set_dither              (<a href="GtkPreview.html" title="GtkPreview">GtkPreview</a> *preview,
 
656
                                                         <a
 
657
href="../gdk/gdk-GdkRGB.html#GdkRgbDither"
 
658
>GdkRgbDither</a> dither);</pre>
 
659
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
660
<h3 class="title">Warning</h3>
 
661
<p><code class="literal">gtk_preview_set_dither</code> is deprecated and should not be used in newly-written code.</p>
 
662
</div>
 
663
<p>
 
664
Set the dithering mode for the display. 
 
665
</p>
 
666
<div class="variablelist"><table border="0">
 
667
<col align="left" valign="top">
 
668
<tbody>
 
669
<tr>
 
670
<td><span class="term"><em class="parameter"><code>preview</code></em>&#160;:</span></td>
 
671
<td>a <a href="GtkPreview.html" title="GtkPreview"><span class="type">GtkPreview</span></a>.
 
672
</td>
 
673
</tr>
 
674
<tr>
 
675
<td><span class="term"><em class="parameter"><code>dither</code></em>&#160;:</span></td>
 
676
<td>the dithering mode.
 
677
 
 
678
 
 
679
</td>
 
680
</tr>
 
681
</tbody>
 
682
</table></div>
 
683
</div>
 
684
<hr>
 
685
<div class="refsect2" lang="en">
 
686
<a name="id3977065"></a><h3>
 
687
<a name="gtk-preview-get-visual"></a>gtk_preview_get_visual ()</h3>
 
688
<a class="indexterm" name="id3977080"></a><pre class="programlisting"><a
 
689
href="../gdk/gdk-Visuals.html#GdkVisual"
 
690
>GdkVisual</a>*          gtk_preview_get_visual              (void);</pre>
 
691
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
692
<h3 class="title">Warning</h3>
 
693
<p><code class="literal">gtk_preview_get_visual</code> is deprecated and should not be used in newly-written code.</p>
 
694
</div>
 
695
<p>
 
696
Returns the visual used by preview widgets. This
 
697
function is deprecated, and you should use
 
698
<a
 
699
href="../gdk/gdk-GdkRGB.html#gdk-rgb-get-visual"
 
700
><code class="function">gdk_rgb_get_visual()</code></a> instead.
 
701
</p>
 
702
<div class="variablelist"><table border="0">
 
703
<col align="left" valign="top">
 
704
<tbody><tr>
 
705
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
706
<td>the visual for previews.
 
707
 
 
708
 
 
709
</td>
 
710
</tr></tbody>
 
711
</table></div>
 
712
</div>
 
713
<hr>
 
714
<div class="refsect2" lang="en">
 
715
<a name="id3977144"></a><h3>
 
716
<a name="gtk-preview-get-cmap"></a>gtk_preview_get_cmap ()</h3>
 
717
<a class="indexterm" name="id3977159"></a><pre class="programlisting"><a
 
718
href="../gdk/gdk-Colormaps-and-Colors.html#GdkColormap"
 
719
>GdkColormap</a>*        gtk_preview_get_cmap                (void);</pre>
 
720
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
721
<h3 class="title">Warning</h3>
 
722
<p><code class="literal">gtk_preview_get_cmap</code> is deprecated and should not be used in newly-written code.</p>
 
723
</div>
 
724
<p>
 
725
Returns the colormap used by preview widgets. This
 
726
function is deprecated, and you should use
 
727
<a
 
728
href="../gdk/gdk-GdkRGB.html#gdk-rgb-get-cmap"
 
729
><code class="function">gdk_rgb_get_cmap()</code></a> instead.
 
730
</p>
 
731
<div class="variablelist"><table border="0">
 
732
<col align="left" valign="top">
 
733
<tbody><tr>
 
734
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
735
<td>the colormap for previews.
 
736
 
 
737
 
 
738
</td>
 
739
</tr></tbody>
 
740
</table></div>
 
741
</div>
 
742
<hr>
 
743
<div class="refsect2" lang="en">
 
744
<a name="id3977222"></a><h3>
 
745
<a name="gtk-preview-get-info"></a>gtk_preview_get_info ()</h3>
 
746
<a class="indexterm" name="id3977238"></a><pre class="programlisting"><a href="GtkPreview.html#GtkPreviewInfo">GtkPreviewInfo</a>*     gtk_preview_get_info                (void);</pre>
 
747
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
748
<h3 class="title">Warning</h3>
 
749
<p><code class="literal">gtk_preview_get_info</code> is deprecated and should not be used in newly-written code.</p>
 
750
</div>
 
751
<p>
 
752
Return a <a href="GtkPreview.html#GtkPreviewInfo"><span class="type">GtkPreviewInfo</span></a> structure containing 
 
753
global information about preview widgets.
 
754
</p>
 
755
<div class="variablelist"><table border="0">
 
756
<col align="left" valign="top">
 
757
<tbody><tr>
 
758
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
759
<td>a <a href="GtkPreview.html#GtkPreviewInfo"><span class="type">GtkPreviewInfo</span></a> structure. The return
 
760
 value belongs to GTK+ and must not be modified
 
761
 or freed.
 
762
 
 
763
 
 
764
</td>
 
765
</tr></tbody>
 
766
</table></div>
 
767
</div>
 
768
<hr>
 
769
<div class="refsect2" lang="en">
 
770
<a name="id3977306"></a><h3>
 
771
<a name="gtk-preview-reset"></a>gtk_preview_reset ()</h3>
 
772
<a class="indexterm" name="id3977322"></a><pre class="programlisting">void                gtk_preview_reset                   (void);</pre>
 
773
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
774
<h3 class="title">Warning</h3>
 
775
<p><code class="literal">gtk_preview_reset</code> is deprecated and should not be used in newly-written code.</p>
 
776
</div>
 
777
<p>
 
778
This function is deprecated and does nothing. It was
 
779
once used for changing the colormap and visual on the fly.
 
780
</p>
 
781
</div>
 
782
</div>
 
783
<div class="refsect1" lang="en">
 
784
<a name="id3977358"></a><h2>Property Details</h2>
 
785
<div class="refsect2" lang="en">
 
786
<a name="id3977369"></a><h3>
 
787
<a name="GtkPreview--expand"></a>The "<code class="literal">expand</code>" property</h3>
 
788
<a class="indexterm" name="id3977385"></a><pre class="programlisting">  "expand"                   gboolean              : Read / Write</pre>
 
789
<p>Whether the preview widget should take up the entire space it is allocated.</p>
 
790
<p>Default value: FALSE</p>
 
791
</div>
 
792
</div>
 
793
<div class="refsect1" lang="en">
 
794
<a name="id3977414"></a><h2>See Also</h2>
 
795
<p>
 
796
</p>
 
797
<div class="variablelist"><table border="0">
 
798
<col align="left" valign="top">
 
799
<tbody><tr>
 
800
<td><span class="term"><span class="type">GdkRGB</span></span></td>
 
801
<td><p>the backend used by <a href="GtkPreview.html" title="GtkPreview"><span class="type">GtkPreview</span></a>.</p></td>
 
802
</tr></tbody>
 
803
</table></div>
 
804
<p>
 
805
</p>
 
806
</div>
 
807
</div>
 
808
</body>
 
809
</html>