4
4
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
5
5
<title>GimpPreviewArea</title>
6
<meta name="generator" content="DocBook XSL Stylesheets V1.68.1">
6
<meta name="generator" content="DocBook XSL Stylesheets V1.72.0">
7
7
<link rel="start" href="index.html" title="GIMP Widgets Library Reference Manual">
8
8
<link rel="up" href="libgimpwidgets-widgets.html" title="Part I. GIMP Widgets">
9
9
<link rel="prev" href="GimpPixmap.html" title="GimpPixmap">
10
10
<link rel="next" href="GimpPreview.html" title="GimpPreview">
11
<meta name="generator" content="GTK-Doc V1.6 (XML mode)">
11
<meta name="generator" content="GTK-Doc V1.8 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
13
<link rel="part" href="libgimpwidgets-widgets.html" title="Part I. GIMP Widgets">
14
14
<link rel="chapter" href="libgimpwidgets-hierarchy.html" title="Object Hierarchy">
15
<link rel="chapter" href="libgimpwidgets-gallery.html" title="Widget Gallery">
15
16
<link rel="chapter" href="libgimpwidgets-cell-renderers.html" title="Cell Renderers for GtkTreeView">
16
17
<link rel="part" href="libgimpwidgets-colordisplay.html" title="Part II. GIMP Display Filters">
17
18
<link rel="part" href="libgimpwidgets-colorselector.html" title="Part III. GIMP Color Selectors">
18
19
<link rel="part" href="libgimpwidgets-controller.html" title="Part IV. GIMP Controllers">
19
20
<link rel="part" href="libgimpwidgets-utils.html" title="Part V. GIMP Widgets Utilities">
20
21
<link rel="part" href="libgimpwidgets-deprecated.html" title="Part VI. Deprecated API">
22
<link rel="index" href="libgimpwidgets-index.html" title="Index">
23
<link rel="index" href="libgimpwidgets-index-new-in-2-2.html" title="Index of new symbols in GIMP 2.2">
24
<link rel="index" href="libgimpwidgets-index-new-in-2-4.html" title="Index of new symbols in GIMP 2.4">
25
<link rel="index" href="libgimpwidgets-index-deprecated.html" title="Index of deprecated symbols">
22
27
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
23
28
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
28
33
<th width="100%" align="center">GIMP Widgets Library Reference Manual</th>
29
34
<td><a accesskey="n" href="GimpPreview.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
31
<tr><td colspan="5" class="shortcuts"><nobr><a href="#top_of_page" class="shortcut">Top</a>
33
<a href="#desc" class="shortcut">Description</a>
35
<a href="#object_hierarchy" class="shortcut">Object Hierarchy</a>
37
<a href="#properties" class="shortcut">Properties</a></nobr></td></tr>
36
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2588480" class="shortcut">Top</a>
38
<a href="#id2617418" class="shortcut">Description</a>
40
<a href="#id2617306" class="shortcut">Object Hierarchy</a>
42
<a href="#id2617355" class="shortcut">Implemented Interfaces</a>
44
<a href="#id2617376" class="shortcut">Properties</a></nobr></td></tr>
39
46
<div class="refentry" lang="en">
40
47
<a name="GimpPreviewArea"></a><div class="titlepage"></div>
41
48
<div class="refnamediv"><table width="100%"><tr>
43
<h2><span class="refentrytitle"><a name="top_of_page"></a>GimpPreviewArea</span></h2>
51
<a name="id2588480"></a><span class="refentrytitle">GimpPreviewArea</span>
44
53
<p>GimpPreviewArea — A general purpose preview widget which caches its pixel data.</p>
46
<td valign="top" align="right"></td>
55
<td valign="top" align="right"><img src="gimp-preview-area.png"></td>
47
56
</tr></table></div>
48
57
<div class="refsynopsisdiv">
49
<a name="synopsis"></a><h2>Synopsis</h2>
50
59
<pre class="synopsis">
54
<a href="GimpPreviewArea.html#GimpPreviewArea-struct">GimpPreviewArea</a>;
55
GtkWidget* <a href="GimpPreviewArea.html#gimp-preview-area-new">gimp_preview_area_new</a> (void);
56
void <a href="GimpPreviewArea.html#gimp-preview-area-draw">gimp_preview_area_draw</a> (<a href="GimpPreviewArea.html" title="GimpPreviewArea">GimpPreviewArea</a> *area,
62
href="../libgimpbase/libgimpbase-gimpbaseenums.html#GimpImageType"
63
>GimpImageType</a> type,
66
void <a href="GimpPreviewArea.html#gimp-preview-area-fill">gimp_preview_area_fill</a> (<a href="GimpPreviewArea.html" title="GimpPreviewArea">GimpPreviewArea</a> *area,
74
void <a href="GimpPreviewArea.html#gimp-preview-area-blend">gimp_preview_area_blend</a> (<a href="GimpPreviewArea.html" title="GimpPreviewArea">GimpPreviewArea</a> *area,
80
href="../libgimpbase/libgimpbase-gimpbaseenums.html#GimpImageType"
81
>GimpImageType</a> type,
87
void <a href="GimpPreviewArea.html#gimp-preview-area-mask">gimp_preview_area_mask</a> (<a href="GimpPreviewArea.html" title="GimpPreviewArea">GimpPreviewArea</a> *area,
93
href="../libgimpbase/libgimpbase-gimpbaseenums.html#GimpImageType"
94
>GimpImageType</a> type,
100
gint rowstride_mask);
101
void <a href="GimpPreviewArea.html#gimp-preview-area-set-offsets">gimp_preview_area_set_offsets</a> (<a href="GimpPreviewArea.html" title="GimpPreviewArea">GimpPreviewArea</a> *area,
104
void <a href="GimpPreviewArea.html#gimp-preview-area-set-colormap">gimp_preview_area_set_colormap</a> (<a href="GimpPreviewArea.html" title="GimpPreviewArea">GimpPreviewArea</a> *area,
105
const guchar *colormap,
107
void <a href="GimpPreviewArea.html#gimp-preview-area-set-max-size">gimp_preview_area_set_max_size</a> (<a href="GimpPreviewArea.html" title="GimpPreviewArea">GimpPreviewArea</a> *area,
110
void <a href="GimpPreviewArea.html#gimp-preview-area-menu-popup">gimp_preview_area_menu_popup</a> (<a href="GimpPreviewArea.html" title="GimpPreviewArea">GimpPreviewArea</a> *area,
111
GdkEventButton *event);
63
<a href="GimpPreviewArea.html#GimpPreviewArea-struct">GimpPreviewArea</a>;
64
GtkWidget* <a href="GimpPreviewArea.html#gimp-preview-area-new">gimp_preview_area_new</a> (void);
65
void <a href="GimpPreviewArea.html#gimp-preview-area-draw">gimp_preview_area_draw</a> (<a href="GimpPreviewArea.html" title="GimpPreviewArea">GimpPreviewArea</a> *area,
71
href="../libgimpbase/libgimpbase-gimpbaseenums.html#GimpImageType"
72
>GimpImageType</a> type,
75
void <a href="GimpPreviewArea.html#gimp-preview-area-fill">gimp_preview_area_fill</a> (<a href="GimpPreviewArea.html" title="GimpPreviewArea">GimpPreviewArea</a> *area,
83
void <a href="GimpPreviewArea.html#gimp-preview-area-blend">gimp_preview_area_blend</a> (<a href="GimpPreviewArea.html" title="GimpPreviewArea">GimpPreviewArea</a> *area,
89
href="../libgimpbase/libgimpbase-gimpbaseenums.html#GimpImageType"
90
>GimpImageType</a> type,
96
void <a href="GimpPreviewArea.html#gimp-preview-area-mask">gimp_preview_area_mask</a> (<a href="GimpPreviewArea.html" title="GimpPreviewArea">GimpPreviewArea</a> *area,
102
href="../libgimpbase/libgimpbase-gimpbaseenums.html#GimpImageType"
103
>GimpImageType</a> type,
109
gint rowstride_mask);
110
void <a href="GimpPreviewArea.html#gimp-preview-area-set-offsets">gimp_preview_area_set_offsets</a> (<a href="GimpPreviewArea.html" title="GimpPreviewArea">GimpPreviewArea</a> *area,
113
void <a href="GimpPreviewArea.html#gimp-preview-area-set-colormap">gimp_preview_area_set_colormap</a> (<a href="GimpPreviewArea.html" title="GimpPreviewArea">GimpPreviewArea</a> *area,
114
const guchar *colormap,
116
void <a href="GimpPreviewArea.html#gimp-preview-area-set-max-size">gimp_preview_area_set_max_size</a> (<a href="GimpPreviewArea.html" title="GimpPreviewArea">GimpPreviewArea</a> *area,
119
void <a href="GimpPreviewArea.html#gimp-preview-area-menu-popup">gimp_preview_area_menu_popup</a> (<a href="GimpPreviewArea.html" title="GimpPreviewArea">GimpPreviewArea</a> *area,
120
GdkEventButton *event);
115
124
<div class="refsect1" lang="en">
116
<a name="object_hierarchy"></a><h2>Object Hierarchy</h2>
125
<a name="id2617306"></a><h2>Object Hierarchy</h2>
117
126
<pre class="synopsis">
127
136
<div class="refsect1" lang="en">
128
<a name="impl_interfaces"></a><h2>Implemented Interfaces</h2>
137
<a name="id2617355"></a><h2>Implemented Interfaces</h2>
130
139
GimpPreviewArea implements
131
140
AtkImplementorIface.</p>
133
142
<div class="refsect1" lang="en">
134
<a name="properties"></a><h2>Properties</h2>
143
<a name="id2617376"></a><h2>Properties</h2>
135
144
<pre class="synopsis">
137
"<a href="GimpPreviewArea.html#GimpPreviewArea--check-size">check-size</a>" <a
146
"<a href="GimpPreviewArea.html#GimpPreviewArea--check-size">check-size</a>" <a
138
147
href="../libgimpbase/libgimpbase-gimpbaseenums.html#GimpCheckSize"
139
148
>GimpCheckSize</a> : Read / Write
140
"<a href="GimpPreviewArea.html#GimpPreviewArea--check-type">check-type</a>" <a
149
"<a href="GimpPreviewArea.html#GimpPreviewArea--check-type">check-type</a>" <a
141
150
href="../libgimpbase/libgimpbase-gimpbaseenums.html#GimpCheckType"
142
151
>GimpCheckType</a> : Read / Write
145
154
<div class="refsect1" lang="en">
146
<a name="desc"></a><h2>Description</h2>
155
<a name="id2617418"></a><h2>Description</h2>
148
157
A general purpose preview widget which caches its pixel data.
151
160
<div class="refsect1" lang="en">
152
<a name="details"></a><h2>Details</h2>
161
<a name="id2617435"></a><h2>Details</h2>
153
162
<div class="refsect2" lang="en">
154
<a name="id2531698"></a><h3>
163
<a name="id2617446"></a><h3>
155
164
<a name="GimpPreviewArea-struct"></a>GimpPreviewArea</h3>
156
<a class="indexterm" name="id2531710"></a><pre class="programlisting">typedef struct _GimpPreviewArea GimpPreviewArea;</pre>
165
<a class="indexterm" name="id2617457"></a><pre class="programlisting">typedef struct _GimpPreviewArea GimpPreviewArea;</pre>
162
171
<div class="refsect2" lang="en">
163
<a name="id2531726"></a><h3>
172
<a name="id2617474"></a><h3>
164
173
<a name="gimp-preview-area-new"></a>gimp_preview_area_new ()</h3>
165
<a class="indexterm" name="id2531737"></a><pre class="programlisting">GtkWidget* gimp_preview_area_new (void);</pre>
174
<a class="indexterm" name="id2617485"></a><pre class="programlisting">GtkWidget* gimp_preview_area_new (void);</pre>
176
Creates a new <a href="GimpPreviewArea.html" title="GimpPreviewArea"><span class="type">GimpPreviewArea</span></a> widget.</p>
171
180
<div class="variablelist"><table border="0">
172
181
<col align="left" valign="top">
175
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
183
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
176
184
<td> a new <a href="GimpPreviewArea.html" title="GimpPreviewArea"><span class="type">GimpPreviewArea</span></a> widget.
206
214
<col align="left" valign="top">
210
<span class="term"><em class="parameter"><code>area</code></em> :</span></td>
217
<td><span class="term"><em class="parameter"><code>area</code></em> :</span></td>
211
218
<td> a <a href="GimpPreviewArea.html" title="GimpPreviewArea"><span class="type">GimpPreviewArea</span></a> widget.
216
<span class="term"><em class="parameter"><code>x</code></em> :</span></td>
222
<td><span class="term"><em class="parameter"><code>x</code></em> :</span></td>
217
223
<td> x offset in preview
222
<span class="term"><em class="parameter"><code>y</code></em> :</span></td>
227
<td><span class="term"><em class="parameter"><code>y</code></em> :</span></td>
223
228
<td> y offset in preview
228
<span class="term"><em class="parameter"><code>width</code></em> :</span></td>
232
<td><span class="term"><em class="parameter"><code>width</code></em> :</span></td>
229
233
<td> buffer width
234
<span class="term"><em class="parameter"><code>height</code></em> :</span></td>
237
<td><span class="term"><em class="parameter"><code>height</code></em> :</span></td>
235
238
<td> buffer height
240
<span class="term"><em class="parameter"><code>type</code></em> :</span></td>
242
<td><span class="term"><em class="parameter"><code>type</code></em> :</span></td>
242
244
href="../libgimpbase/libgimpbase-gimpbaseenums.html#GimpImageType"
243
245
><span class="type">GimpImageType</span></a> of <em class="parameter"><code>buf</code></em>
248
<span class="term"><em class="parameter"><code>buf</code></em> :</span></td>
249
<td><span class="term"><em class="parameter"><code>buf</code></em> :</span></td>
249
250
<td> a <span class="type">guchar</span> buffer that contains the preview pixel data.
254
<span class="term"><em class="parameter"><code>rowstride</code></em> :</span></td>
254
<td><span class="term"><em class="parameter"><code>rowstride</code></em> :</span></td>
255
255
<td> rowstride of <em class="parameter"><code>buf</code></em>
283
283
<col align="left" valign="top">
287
<span class="term"><em class="parameter"><code>area</code></em> :</span></td>
286
<td><span class="term"><em class="parameter"><code>area</code></em> :</span></td>
288
287
<td> a <a href="GimpPreviewArea.html" title="GimpPreviewArea"><span class="type">GimpPreviewArea</span></a> widget.
293
<span class="term"><em class="parameter"><code>x</code></em> :</span></td>
291
<td><span class="term"><em class="parameter"><code>x</code></em> :</span></td>
294
292
<td> x offset in preview
299
<span class="term"><em class="parameter"><code>y</code></em> :</span></td>
296
<td><span class="term"><em class="parameter"><code>y</code></em> :</span></td>
300
297
<td> y offset in preview
305
<span class="term"><em class="parameter"><code>width</code></em> :</span></td>
311
<span class="term"><em class="parameter"><code>height</code></em> :</span></td>
317
<span class="term"><em class="parameter"><code>red</code></em> :</span></td>
301
<td><span class="term"><em class="parameter"><code>width</code></em> :</span></td>
302
<td> width of the rectangle to fill
306
<td><span class="term"><em class="parameter"><code>height</code></em> :</span></td>
307
<td> height of the rectangle to fill
311
<td><span class="term"><em class="parameter"><code>red</code></em> :</span></td>
318
312
<td> red component of the fill color (0-255)
323
<span class="term"><em class="parameter"><code>green</code></em> :</span></td>
316
<td><span class="term"><em class="parameter"><code>green</code></em> :</span></td>
324
317
<td> green component of the fill color (0-255)
329
<span class="term"><em class="parameter"><code>blue</code></em> :</span></td>
321
<td><span class="term"><em class="parameter"><code>blue</code></em> :</span></td>
330
322
<td> red component of the fill color (0-255)
337
329
<div class="refsect2" lang="en">
338
<a name="id2583006"></a><h3>
330
<a name="id2624927"></a><h3>
339
331
<a name="gimp-preview-area-blend"></a>gimp_preview_area_blend ()</h3>
340
<a class="indexterm" name="id2583017"></a><pre class="programlisting">void gimp_preview_area_blend (<a href="GimpPreviewArea.html" title="GimpPreviewArea">GimpPreviewArea</a> *area,
332
<a class="indexterm" name="id2624938"></a><pre class="programlisting">void gimp_preview_area_blend (<a href="GimpPreviewArea.html" title="GimpPreviewArea">GimpPreviewArea</a> *area,
346
338
href="../libgimpbase/libgimpbase-gimpbaseenums.html#GimpImageType"
347
339
>GimpImageType</a> type,
352
guchar opacity);</pre>
344
guchar opacity);</pre>
354
346
Composites <em class="parameter"><code>buf1</code></em> on <em class="parameter"><code>buf2</code></em> with the given <em class="parameter"><code>opacity</code></em>, draws the result
355
347
to <em class="parameter"><code>area</code></em> and queues a redraw on the given rectangle.
363
355
<col align="left" valign="top">
367
<span class="term"><em class="parameter"><code>area</code></em> :</span></td>
358
<td><span class="term"><em class="parameter"><code>area</code></em> :</span></td>
368
359
<td> a <a href="GimpPreviewArea.html" title="GimpPreviewArea"><span class="type">GimpPreviewArea</span></a> widget.
373
<span class="term"><em class="parameter"><code>x</code></em> :</span></td>
363
<td><span class="term"><em class="parameter"><code>x</code></em> :</span></td>
374
364
<td> x offset in preview
379
<span class="term"><em class="parameter"><code>y</code></em> :</span></td>
368
<td><span class="term"><em class="parameter"><code>y</code></em> :</span></td>
380
369
<td> y offset in preview
385
<span class="term"><em class="parameter"><code>width</code></em> :</span></td>
373
<td><span class="term"><em class="parameter"><code>width</code></em> :</span></td>
386
374
<td> buffer width
391
<span class="term"><em class="parameter"><code>height</code></em> :</span></td>
378
<td><span class="term"><em class="parameter"><code>height</code></em> :</span></td>
392
379
<td> buffer height
397
<span class="term"><em class="parameter"><code>type</code></em> :</span></td>
383
<td><span class="term"><em class="parameter"><code>type</code></em> :</span></td>
399
385
href="../libgimpbase/libgimpbase-gimpbaseenums.html#GimpImageType"
400
386
><span class="type">GimpImageType</span></a> of <em class="parameter"><code>buf1</code></em> and <em class="parameter"><code>buf2</code></em>
405
<span class="term"><em class="parameter"><code>buf1</code></em> :</span></td>
390
<td><span class="term"><em class="parameter"><code>buf1</code></em> :</span></td>
406
391
<td> a <span class="type">guchar</span> buffer that contains the pixel data for
412
<span class="term"><em class="parameter"><code>rowstride1</code></em> :</span></td>
396
<td><span class="term"><em class="parameter"><code>rowstride1</code></em> :</span></td>
413
397
<td> rowstride of <em class="parameter"><code>buf1</code></em>
418
<span class="term"><em class="parameter"><code>buf2</code></em> :</span></td>
401
<td><span class="term"><em class="parameter"><code>buf2</code></em> :</span></td>
419
402
<td> a <span class="type">guchar</span> buffer that contains the pixel data for
425
<span class="term"><em class="parameter"><code>rowstride2</code></em> :</span></td>
407
<td><span class="term"><em class="parameter"><code>rowstride2</code></em> :</span></td>
426
408
<td> rowstride of <em class="parameter"><code>buf2</code></em>
431
<span class="term"><em class="parameter"><code>opacity</code></em> :</span></td>
412
<td><span class="term"><em class="parameter"><code>opacity</code></em> :</span></td>
432
413
<td> The opacity of the first layer.
439
420
<div class="refsect2" lang="en">
440
<a name="id2583363"></a><h3>
421
<a name="id2625284"></a><h3>
441
422
<a name="gimp-preview-area-mask"></a>gimp_preview_area_mask ()</h3>
442
<a class="indexterm" name="id2583374"></a><pre class="programlisting">void gimp_preview_area_mask (<a href="GimpPreviewArea.html" title="GimpPreviewArea">GimpPreviewArea</a> *area,
423
<a class="indexterm" name="id2625295"></a><pre class="programlisting">void gimp_preview_area_mask (<a href="GimpPreviewArea.html" title="GimpPreviewArea">GimpPreviewArea</a> *area,
448
429
href="../libgimpbase/libgimpbase-gimpbaseenums.html#GimpImageType"
449
430
>GimpImageType</a> type,
455
gint rowstride_mask);</pre>
436
gint rowstride_mask);</pre>
457
438
Composites <em class="parameter"><code>buf1</code></em> on <em class="parameter"><code>buf2</code></em> with the given <em class="parameter"><code>mask</code></em>, draws the result on
458
439
<em class="parameter"><code>area</code></em> and queues a redraw on the given rectangle.
466
447
<col align="left" valign="top">
470
<span class="term"><em class="parameter"><code>area</code></em> :</span></td>
450
<td><span class="term"><em class="parameter"><code>area</code></em> :</span></td>
471
451
<td> a <a href="GimpPreviewArea.html" title="GimpPreviewArea"><span class="type">GimpPreviewArea</span></a> widget.
476
<span class="term"><em class="parameter"><code>x</code></em> :</span></td>
455
<td><span class="term"><em class="parameter"><code>x</code></em> :</span></td>
477
456
<td> x offset in preview
482
<span class="term"><em class="parameter"><code>y</code></em> :</span></td>
460
<td><span class="term"><em class="parameter"><code>y</code></em> :</span></td>
483
461
<td> y offset in preview
488
<span class="term"><em class="parameter"><code>width</code></em> :</span></td>
465
<td><span class="term"><em class="parameter"><code>width</code></em> :</span></td>
489
466
<td> buffer width
494
<span class="term"><em class="parameter"><code>height</code></em> :</span></td>
470
<td><span class="term"><em class="parameter"><code>height</code></em> :</span></td>
495
471
<td> buffer height
500
<span class="term"><em class="parameter"><code>type</code></em> :</span></td>
475
<td><span class="term"><em class="parameter"><code>type</code></em> :</span></td>
502
477
href="../libgimpbase/libgimpbase-gimpbaseenums.html#GimpImageType"
503
478
><span class="type">GimpImageType</span></a> of <em class="parameter"><code>buf1</code></em> and <em class="parameter"><code>buf2</code></em>
508
<span class="term"><em class="parameter"><code>buf1</code></em> :</span></td>
482
<td><span class="term"><em class="parameter"><code>buf1</code></em> :</span></td>
509
483
<td> a <span class="type">guchar</span> buffer that contains the pixel data for
515
<span class="term"><em class="parameter"><code>rowstride1</code></em> :</span></td>
488
<td><span class="term"><em class="parameter"><code>rowstride1</code></em> :</span></td>
516
489
<td> rowstride of <em class="parameter"><code>buf1</code></em>
521
<span class="term"><em class="parameter"><code>buf2</code></em> :</span></td>
493
<td><span class="term"><em class="parameter"><code>buf2</code></em> :</span></td>
522
494
<td> a <span class="type">guchar</span> buffer that contains the pixel data for
528
<span class="term"><em class="parameter"><code>rowstride2</code></em> :</span></td>
499
<td><span class="term"><em class="parameter"><code>rowstride2</code></em> :</span></td>
529
500
<td> rowstride of <em class="parameter"><code>buf2</code></em>
534
<span class="term"><em class="parameter"><code>mask</code></em> :</span></td>
504
<td><span class="term"><em class="parameter"><code>mask</code></em> :</span></td>
535
505
<td> a <span class="type">guchar</span> buffer representing the mask of the second
541
<span class="term"><em class="parameter"><code>rowstride_mask</code></em> :</span></td>
510
<td><span class="term"><em class="parameter"><code>rowstride_mask</code></em> :</span></td>
542
511
<td> rowstride for the mask.
562
531
<col align="left" valign="top">
566
<span class="term"><em class="parameter"><code>area</code></em> :</span></td>
534
<td><span class="term"><em class="parameter"><code>area</code></em> :</span></td>
567
535
<td> a <a href="GimpPreviewArea.html" title="GimpPreviewArea"><span class="type">GimpPreviewArea</span></a>
572
<span class="term"><em class="parameter"><code>x</code></em> :</span></td>
539
<td><span class="term"><em class="parameter"><code>x</code></em> :</span></td>
573
540
<td> horizontal offset
578
<span class="term"><em class="parameter"><code>y</code></em> :</span></td>
544
<td><span class="term"><em class="parameter"><code>y</code></em> :</span></td>
579
545
<td> vertical offset
550
<p class="since">Since GIMP 2.2
588
554
<div class="refsect2" lang="en">
589
<a name="id2583870"></a><h3>
555
<a name="id2625796"></a><h3>
590
556
<a name="gimp-preview-area-set-colormap"></a>gimp_preview_area_set_colormap ()</h3>
591
<a class="indexterm" name="id2583883"></a><pre class="programlisting">void gimp_preview_area_set_colormap (<a href="GimpPreviewArea.html" title="GimpPreviewArea">GimpPreviewArea</a> *area,
592
const guchar *colormap,
593
gint num_colors);</pre>
557
<a class="indexterm" name="id2573809"></a><pre class="programlisting">void gimp_preview_area_set_colormap (<a href="GimpPreviewArea.html" title="GimpPreviewArea">GimpPreviewArea</a> *area,
558
const guchar *colormap,
559
gint num_colors);</pre>
595
561
Sets the colormap for the <a href="GimpPreviewArea.html" title="GimpPreviewArea"><span class="type">GimpPreviewArea</span></a> widget. You need to
596
562
call this function before you use <a href="GimpPreviewArea.html#gimp-preview-area-draw"><code class="function">gimp_preview_area_draw()</code></a> with
605
571
<col align="left" valign="top">
609
<span class="term"><em class="parameter"><code>area</code></em> :</span></td>
574
<td><span class="term"><em class="parameter"><code>area</code></em> :</span></td>
610
575
<td> a <a href="GimpPreviewArea.html" title="GimpPreviewArea"><span class="type">GimpPreviewArea</span></a>
615
<span class="term"><em class="parameter"><code>colormap</code></em> :</span></td>
579
<td><span class="term"><em class="parameter"><code>colormap</code></em> :</span></td>
616
580
<td> a <span class="type">guchar</span> buffer that contains the colormap
621
<span class="term"><em class="parameter"><code>num_colors</code></em> :</span></td>
584
<td><span class="term"><em class="parameter"><code>num_colors</code></em> :</span></td>
622
585
<td> the number of colors in the colormap
629
592
<div class="refsect2" lang="en">
630
<a name="id2584030"></a><h3>
593
<a name="id2625926"></a><h3>
631
594
<a name="gimp-preview-area-set-max-size"></a>gimp_preview_area_set_max_size ()</h3>
632
<a class="indexterm" name="id2584045"></a><pre class="programlisting">void gimp_preview_area_set_max_size (<a href="GimpPreviewArea.html" title="GimpPreviewArea">GimpPreviewArea</a> *area,
595
<a class="indexterm" name="id2625940"></a><pre class="programlisting">void gimp_preview_area_set_max_size (<a href="GimpPreviewArea.html" title="GimpPreviewArea">GimpPreviewArea</a> *area,
636
599
Usually a <a href="GimpPreviewArea.html" title="GimpPreviewArea"><span class="type">GimpPreviewArea</span></a> fills the size that it is
637
600
allocated. This funtion allows you to limit the preview area to a
644
607
<col align="left" valign="top">
648
<span class="term"><em class="parameter"><code>area</code></em> :</span></td>
610
<td><span class="term"><em class="parameter"><code>area</code></em> :</span></td>
649
611
<td> a <a href="GimpPreviewArea.html" title="GimpPreviewArea"><span class="type">GimpPreviewArea</span></a> widget
654
<span class="term"><em class="parameter"><code>width</code></em> :</span></td>
615
<td><span class="term"><em class="parameter"><code>width</code></em> :</span></td>
655
616
<td> the maximum width in pixels or -1 to unset the limit
660
<span class="term"><em class="parameter"><code>height</code></em> :</span></td>
620
<td><span class="term"><em class="parameter"><code>height</code></em> :</span></td>
661
621
<td> the maximum height in pixels or -1 to unset the limit
626
<p class="since">Since GIMP 2.2
670
630
<div class="refsect2" lang="en">
671
<a name="id2584162"></a><h3>
631
<a name="id2626047"></a><h3>
672
632
<a name="gimp-preview-area-menu-popup"></a>gimp_preview_area_menu_popup ()</h3>
673
<a class="indexterm" name="id2584178"></a><pre class="programlisting">void gimp_preview_area_menu_popup (<a href="GimpPreviewArea.html" title="GimpPreviewArea">GimpPreviewArea</a> *area,
674
GdkEventButton *event);</pre>
633
<a class="indexterm" name="id2626062"></a><pre class="programlisting">void gimp_preview_area_menu_popup (<a href="GimpPreviewArea.html" title="GimpPreviewArea">GimpPreviewArea</a> *area,
634
GdkEventButton *event);</pre>
676
636
Creates a popup menu that allows to configure the size and type of
677
637
the checkerboard pattern that the <em class="parameter"><code>area</code></em> uses to visualize transparency.</p>
682
642
<col align="left" valign="top">
686
<span class="term"><em class="parameter"><code>area</code></em> :</span></td>
645
<td><span class="term"><em class="parameter"><code>area</code></em> :</span></td>
687
646
<td> a <a href="GimpPreviewArea.html" title="GimpPreviewArea"><span class="type">GimpPreviewArea</span></a>
692
<span class="term"><em class="parameter"><code>event</code></em> :</span></td>
650
<td><span class="term"><em class="parameter"><code>event</code></em> :</span></td>
693
651
<td> the button event that causes the menu to popup or <code class="literal">NULL</code>
656
<p class="since">Since GIMP 2.2
702
660
<div class="refsect1" lang="en">
703
<a name="property_details"></a><h2>Property Details</h2>
661
<a name="id2626156"></a><h2>Property Details</h2>
704
662
<div class="refsect2" lang="en">
705
<a name="id2584292"></a><h3>
663
<a name="id2626165"></a><h3>
706
664
<a name="GimpPreviewArea--check-size"></a>The "<code class="literal">check-size</code>" property</h3>
707
<a class="indexterm" name="id2584305"></a><pre class="programlisting"> "check-size" <a
665
<a class="indexterm" name="id2626178"></a><pre class="programlisting"> "check-size" <a
708
666
href="../libgimpbase/libgimpbase-gimpbaseenums.html#GimpCheckSize"
709
667
>GimpCheckSize</a> : Read / Write</pre>