← Back to branch summary

~ubuntu-branches/ubuntu/jaunty/gimp/jaunty-security

« back to all changes in this revision

Viewing changes to devel-docs/libgimp/html/libgimp-gimpfileops.html

  • Committer: Bazaar Package Importer
  • Author(s): Daniel Holbach
  • Date: 2007-05-02 16:33:03 UTC
  • mfrom: (1.1.4 upstream)
  • Revision ID: james.westby@ubuntu.com-20070502163303-bvzhjzbpw8qglc4y
Tags: 2.3.16-1ubuntu1
* Resynchronized with Debian, remaining Ubuntu changes:
  - debian/rules: i18n magic.
* debian/control.in:
  - Maintainer: Ubuntu Core Developers <ubuntu-devel@lists.ubuntu.com>
* debian/patches/02_help-message.patch,
  debian/patches/03_gimp.desktop.in.in.patch,
  debian/patches/10_dont_show_wizard.patch: updated.
* debian/patches/04_composite-signedness.patch,
  debian/patches/05_add-letter-spacing.patch: dropped, used upstream.

Show diffs side-by-side

added added

removed removed

Lines of Context:
devel-docs/libgimp/html/libgimp-gimpfileops.html
3
3
<head>
4
4
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
5
5
<title>gimpfileops</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 Library Reference Manual">
8
 
<link rel="up" href="libgimp-image.html" title="Manupulating Images and all their Properties">
 
8
<link rel="up" href="libgimp-image.html" title="Manupulating Images and their Properties">
9
9
<link rel="prev" href="libgimp-gimpedit.html" title="gimpedit">
10
10
<link rel="next" href="libgimp-gimpfloatingsel.html" title="gimpfloatingsel">
11
 
<meta name="generator" content="GTK-Doc V1.7 (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
 
<link rel="part" href="gimpdefinitions.html" title="Part&#160;I.&#160;GIMP Constants">
14
 
<link rel="part" href="libgimp.html" title="Part&#160;II.&#160;GIMP Library">
 
13
<link rel="part" href="libgimp.html" title="Part&#160;I.&#160;GIMP Library">
15
14
<link rel="chapter" href="libgimp-general.html" title="Functions not Related to Specific Images">
16
 
<link rel="chapter" href="libgimp-image.html" title="Manupulating Images and all their Properties">
 
15
<link rel="chapter" href="libgimp-image.html" title="Manupulating Images and their Properties">
17
16
<link rel="chapter" href="libgimp-data.html" title="Data Objects">
18
17
<link rel="chapter" href="libgimp-selectors.html" title="Controlling the Core's Selection Dialogs">
19
 
<link rel="part" href="libgimpui.html" title="Part&#160;III.&#160;GIMP User Interface Library">
 
18
<link rel="part" href="libgimpui.html" title="Part&#160;II.&#160;GIMP User Interface Library">
20
19
<link rel="chapter" href="libgimpui-hierarchy.html" title="Object Hierarchy">
 
20
<link rel="index" href="libgimp-index.html" title="Index">
 
21
<link rel="index" href="libgimp-index-new-in-2-2.html" title="Index of new symbols in GIMP 2.2">
 
22
<link rel="index" href="libgimp-index-new-in-2-4.html" title="Index of new symbols in GIMP 2.4">
 
23
<link rel="index" href="libgimp-index-deprecated.html" title="Index of deprecated symbols">
21
24
</head>
22
25
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
23
26
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
28
31
<th width="100%" align="center">GIMP Library Reference Manual</th>
29
32
<td><a accesskey="n" href="libgimp-gimpfloatingsel.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
30
33
</tr>
31
 
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2525262" class="shortcut">Top</a>
 
34
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2572254" class="shortcut">Top</a>
32
35
                  &#160;|&#160;
33
 
                  <a href="#id2586555" class="shortcut">Description</a></nobr></td></tr>
 
36
                  <a href="#id2624966" class="shortcut">Description</a></nobr></td></tr>
34
37
</table>
35
38
<div class="refentry" lang="en">
36
39
<a name="libgimp-gimpfileops"></a><div class="titlepage"></div>
37
40
<div class="refnamediv"><table width="100%"><tr>
38
41
<td valign="top">
39
42
<h2>
40
 
<a name="id2525262"></a><span class="refentrytitle">gimpfileops</span>
 
43
<a name="id2572254"></a><span class="refentrytitle">gimpfileops</span>
41
44
</h2>
42
45
<p>gimpfileops &#8212; File operations (load, save, etc.)</p>
43
46
</td>
49
52
 
50
53
 
51
54
 
52
 
gchar*      <a href="libgimp-gimpfileops.html#gimp-temp-name">gimp_temp_name</a>                  (const gchar *extension);
53
 
gint32      <a href="libgimp-gimpfileops.html#gimp-file-load">gimp_file_load</a>                  (<a href="libgimp-gimpenums.html#GimpRunMode">GimpRunMode</a> run_mode,
54
 
                                             const gchar *filename,
55
 
                                             const gchar *raw_filename);
56
 
gboolean    <a href="libgimp-gimpfileops.html#gimp-file-save">gimp_file_save</a>                  (<a href="libgimp-gimpenums.html#GimpRunMode">GimpRunMode</a> run_mode,
57
 
                                             gint32 image_ID,
58
 
                                             gint32 drawable_ID,
59
 
                                             const gchar *filename,
60
 
                                             const gchar *raw_filename);
61
 
gboolean    <a href="libgimp-gimpfileops.html#gimp-register-magic-load-handler">gimp_register_magic_load_handler</a>
62
 
                                            (const gchar *procedure_name,
63
 
                                             const gchar *extensions,
64
 
                                             const gchar *prefixes,
65
 
                                             const gchar *magics);
66
 
gboolean    <a href="libgimp-gimpfileops.html#gimp-register-load-handler">gimp_register_load_handler</a>      (const gchar *procedure_name,
67
 
                                             const gchar *extensions,
68
 
                                             const gchar *prefixes);
69
 
gboolean    <a href="libgimp-gimpfileops.html#gimp-register-save-handler">gimp_register_save_handler</a>      (const gchar *procedure_name,
70
 
                                             const gchar *extensions,
71
 
                                             const gchar *prefixes);
72
 
gboolean    <a href="libgimp-gimpfileops.html#gimp-register-file-handler-mime">gimp_register_file_handler_mime</a> (const gchar *procedure_name,
73
 
                                             const gchar *mime_type);
74
 
gboolean    <a href="libgimp-gimpfileops.html#gimp-register-thumbnail-loader">gimp_register_thumbnail_loader</a>  (const gchar *load_proc,
75
 
                                             const gchar *thumb_proc);
 
55
gchar*              <a href="libgimp-gimpfileops.html#gimp-temp-name">gimp_temp_name</a>                      (const gchar *extension);
 
56
gint32              <a href="libgimp-gimpfileops.html#gimp-file-load">gimp_file_load</a>                      (<a
 
57
href="../libgimpbase/libgimpbase-gimpbaseenums.html#GimpRunMode"
 
58
>GimpRunMode</a> run_mode,
 
59
                                                         const gchar *filename,
 
60
                                                         const gchar *raw_filename);
 
61
gint32              <a href="libgimp-gimpfileops.html#gimp-file-load-layer">gimp_file_load_layer</a>                (<a
 
62
href="../libgimpbase/libgimpbase-gimpbaseenums.html#GimpRunMode"
 
63
>GimpRunMode</a> run_mode,
 
64
                                                         gint32 image_ID,
 
65
                                                         const gchar *filename);
 
66
gint*               <a href="libgimp-gimpfileops.html#gimp-file-load-layers">gimp_file_load_layers</a>               (<a
 
67
href="../libgimpbase/libgimpbase-gimpbaseenums.html#GimpRunMode"
 
68
>GimpRunMode</a> run_mode,
 
69
                                                         gint32 image_ID,
 
70
                                                         const gchar *filename,
 
71
                                                         gint *num_layers);
 
72
gboolean            <a href="libgimp-gimpfileops.html#gimp-file-save">gimp_file_save</a>                      (<a
 
73
href="../libgimpbase/libgimpbase-gimpbaseenums.html#GimpRunMode"
 
74
>GimpRunMode</a> run_mode,
 
75
                                                         gint32 image_ID,
 
76
                                                         gint32 drawable_ID,
 
77
                                                         const gchar *filename,
 
78
                                                         const gchar *raw_filename);
 
79
gboolean            <a href="libgimp-gimpfileops.html#gimp-file-save-thumbnail">gimp_file_save_thumbnail</a>            (gint32 image_ID,
 
80
                                                         const gchar *filename);
 
81
gboolean            <a href="libgimp-gimpfileops.html#gimp-register-magic-load-handler">gimp_register_magic_load_handler</a>    (const gchar *procedure_name,
 
82
                                                         const gchar *extensions,
 
83
                                                         const gchar *prefixes,
 
84
                                                         const gchar *magics);
 
85
gboolean            <a href="libgimp-gimpfileops.html#gimp-register-load-handler">gimp_register_load_handler</a>          (const gchar *procedure_name,
 
86
                                                         const gchar *extensions,
 
87
                                                         const gchar *prefixes);
 
88
gboolean            <a href="libgimp-gimpfileops.html#gimp-register-save-handler">gimp_register_save_handler</a>          (const gchar *procedure_name,
 
89
                                                         const gchar *extensions,
 
90
                                                         const gchar *prefixes);
 
91
gboolean            <a href="libgimp-gimpfileops.html#gimp-register-file-handler-mime">gimp_register_file_handler_mime</a>     (const gchar *procedure_name,
 
92
                                                         const gchar *mime_type);
 
93
gboolean            <a href="libgimp-gimpfileops.html#gimp-register-thumbnail-loader">gimp_register_thumbnail_loader</a>      (const gchar *load_proc,
 
94
                                                         const gchar *thumb_proc);
76
95
</pre>
77
96
</div>
78
97
<div class="refsect1" lang="en">
79
 
<a name="id2586555"></a><h2>Description</h2>
 
98
<a name="id2624966"></a><h2>Description</h2>
80
99
<p>
81
100
File operations (load, save, etc.)
82
101
 
83
102
</p>
84
103
</div>
85
104
<div class="refsect1" lang="en">
86
 
<a name="id2586571"></a><h2>Details</h2>
 
105
<a name="id2624982"></a><h2>Details</h2>
87
106
<div class="refsect2" lang="en">
88
 
<a name="id2586581"></a><h3>
 
107
<a name="id2624993"></a><h3>
89
108
<a name="gimp-temp-name"></a>gimp_temp_name ()</h3>
90
 
<a class="indexterm" name="id2586594"></a><pre class="programlisting">gchar*      gimp_temp_name                  (const gchar *extension);</pre>
 
109
<a class="indexterm" name="id2625005"></a><pre class="programlisting">gchar*              gimp_temp_name                      (const gchar *extension);</pre>
91
110
<p>
92
111
Generates a unique filename.
93
112
</p>
101
120
<col align="left" valign="top">
102
121
<tbody>
103
122
<tr>
104
 
<td>
105
 
<span class="term"><em class="parameter"><code>extension</code></em>&#160;:</span></td>
 
123
<td><span class="term"><em class="parameter"><code>extension</code></em>&#160;:</span></td>
106
124
<td> The extension the file will have.
107
125
</td>
108
126
</tr>
109
127
<tr>
110
 
<td>
111
 
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
128
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
112
129
<td> The new temp filename.
113
130
</td>
114
131
</tr>
117
134
</div>
118
135
<hr>
119
136
<div class="refsect2" lang="en">
120
 
<a name="id2589001"></a><h3>
 
137
<a name="id2625070"></a><h3>
121
138
<a name="gimp-file-load"></a>gimp_file_load ()</h3>
122
 
<a class="indexterm" name="id2589013"></a><pre class="programlisting">gint32      gimp_file_load                  (<a href="libgimp-gimpenums.html#GimpRunMode">GimpRunMode</a> run_mode,
123
 
                                             const gchar *filename,
124
 
                                             const gchar *raw_filename);</pre>
 
139
<a class="indexterm" name="id2625082"></a><pre class="programlisting">gint32              gimp_file_load                      (<a
 
140
href="../libgimpbase/libgimpbase-gimpbaseenums.html#GimpRunMode"
 
141
>GimpRunMode</a> run_mode,
 
142
                                                         const gchar *filename,
 
143
                                                         const gchar *raw_filename);</pre>
125
144
<p>
126
 
Loads a file by invoking the right load handler.
 
145
Loads an image file by invoking the right load handler.
127
146
</p>
128
147
<p>
129
148
This procedure invokes the correct file load handler using magic if
140
159
<col align="left" valign="top">
141
160
<tbody>
142
161
<tr>
143
 
<td>
144
 
<span class="term"><em class="parameter"><code>run_mode</code></em>&#160;:</span></td>
 
162
<td><span class="term"><em class="parameter"><code>run_mode</code></em>&#160;:</span></td>
145
163
<td> The run mode.
146
164
</td>
147
165
</tr>
148
166
<tr>
149
 
<td>
150
 
<span class="term"><em class="parameter"><code>filename</code></em>&#160;:</span></td>
 
167
<td><span class="term"><em class="parameter"><code>filename</code></em>&#160;:</span></td>
151
168
<td> The name of the file to load.
152
169
</td>
153
170
</tr>
154
171
<tr>
155
 
<td>
156
 
<span class="term"><em class="parameter"><code>raw_filename</code></em>&#160;:</span></td>
 
172
<td><span class="term"><em class="parameter"><code>raw_filename</code></em>&#160;:</span></td>
157
173
<td> The name as entered by the user.
158
174
</td>
159
175
</tr>
160
176
<tr>
161
 
<td>
162
 
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
177
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
163
178
<td> The output image.
164
179
</td>
165
180
</tr>
168
183
</div>
169
184
<hr>
170
185
<div class="refsect2" lang="en">
171
 
<a name="id2589127"></a><h3>
 
186
<a name="id2625197"></a><h3>
 
187
<a name="gimp-file-load-layer"></a>gimp_file_load_layer ()</h3>
 
188
<a class="indexterm" name="id2625211"></a><pre class="programlisting">gint32              gimp_file_load_layer                (<a
 
189
href="../libgimpbase/libgimpbase-gimpbaseenums.html#GimpRunMode"
 
190
>GimpRunMode</a> run_mode,
 
191
                                                         gint32 image_ID,
 
192
                                                         const gchar *filename);</pre>
 
193
<p>
 
194
Loads an image file as a layer for an existing image.
 
195
</p>
 
196
<p>
 
197
This procedure behaves like the file-load procedure but opens the
 
198
specified image as a layer for an existing image. The returned layer
 
199
needs to be added to the existing image with <a href="libgimp-gimpimage.html#gimp-image-add-layer"><code class="function">gimp_image_add_layer()</code></a>.</p>
 
200
<p>
 
201
 
 
202
</p>
 
203
<div class="variablelist"><table border="0">
 
204
<col align="left" valign="top">
 
205
<tbody>
 
206
<tr>
 
207
<td><span class="term"><em class="parameter"><code>run_mode</code></em>&#160;:</span></td>
 
208
<td> The run mode.
 
209
</td>
 
210
</tr>
 
211
<tr>
 
212
<td><span class="term"><em class="parameter"><code>image_ID</code></em>&#160;:</span></td>
 
213
<td> Destination image.
 
214
</td>
 
215
</tr>
 
216
<tr>
 
217
<td><span class="term"><em class="parameter"><code>filename</code></em>&#160;:</span></td>
 
218
<td> The name of the file to load.
 
219
</td>
 
220
</tr>
 
221
<tr>
 
222
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
223
<td> The layer created when loading the image file.
 
224
 
 
225
</td>
 
226
</tr>
 
227
</tbody>
 
228
</table></div>
 
229
<p class="since">Since  GIMP 2.4
 
230
</p>
 
231
</div>
 
232
<hr>
 
233
<div class="refsect2" lang="en">
 
234
<a name="id2625337"></a><h3>
 
235
<a name="gimp-file-load-layers"></a>gimp_file_load_layers ()</h3>
 
236
<a class="indexterm" name="id2625351"></a><pre class="programlisting">gint*               gimp_file_load_layers               (<a
 
237
href="../libgimpbase/libgimpbase-gimpbaseenums.html#GimpRunMode"
 
238
>GimpRunMode</a> run_mode,
 
239
                                                         gint32 image_ID,
 
240
                                                         const gchar *filename,
 
241
                                                         gint *num_layers);</pre>
 
242
<p>
 
243
Loads an image file as layers for an existing image.
 
244
</p>
 
245
<p>
 
246
This procedure behaves like the file-load procedure but opens the
 
247
specified image as layers for an existing image. The returned layers
 
248
needs to be added to the existing image with <a href="libgimp-gimpimage.html#gimp-image-add-layer"><code class="function">gimp_image_add_layer()</code></a>.</p>
 
249
<p>
 
250
 
 
251
</p>
 
252
<div class="variablelist"><table border="0">
 
253
<col align="left" valign="top">
 
254
<tbody>
 
255
<tr>
 
256
<td><span class="term"><em class="parameter"><code>run_mode</code></em>&#160;:</span></td>
 
257
<td> The run mode.
 
258
</td>
 
259
</tr>
 
260
<tr>
 
261
<td><span class="term"><em class="parameter"><code>image_ID</code></em>&#160;:</span></td>
 
262
<td> Destination image.
 
263
</td>
 
264
</tr>
 
265
<tr>
 
266
<td><span class="term"><em class="parameter"><code>filename</code></em>&#160;:</span></td>
 
267
<td> The name of the file to load.
 
268
</td>
 
269
</tr>
 
270
<tr>
 
271
<td><span class="term"><em class="parameter"><code>num_layers</code></em>&#160;:</span></td>
 
272
<td> The number of loaded layers.
 
273
</td>
 
274
</tr>
 
275
<tr>
 
276
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
277
<td> The list of loaded layers.
 
278
 
 
279
</td>
 
280
</tr>
 
281
</tbody>
 
282
</table></div>
 
283
<p class="since">Since  GIMP 2.4
 
284
</p>
 
285
</div>
 
286
<hr>
 
287
<div class="refsect2" lang="en">
 
288
<a name="id2625497"></a><h3>
172
289
<a name="gimp-file-save"></a>gimp_file_save ()</h3>
173
 
<a class="indexterm" name="id2589139"></a><pre class="programlisting">gboolean    gimp_file_save                  (<a href="libgimp-gimpenums.html#GimpRunMode">GimpRunMode</a> run_mode,
174
 
                                             gint32 image_ID,
175
 
                                             gint32 drawable_ID,
176
 
                                             const gchar *filename,
177
 
                                             const gchar *raw_filename);</pre>
 
290
<a class="indexterm" name="id2619393"></a><pre class="programlisting">gboolean            gimp_file_save                      (<a
 
291
href="../libgimpbase/libgimpbase-gimpbaseenums.html#GimpRunMode"
 
292
>GimpRunMode</a> run_mode,
 
293
                                                         gint32 image_ID,
 
294
                                                         gint32 drawable_ID,
 
295
                                                         const gchar *filename,
 
296
                                                         const gchar *raw_filename);</pre>
178
297
<p>
179
298
Saves a file by extension.
180
299
</p>
192
311
<col align="left" valign="top">
193
312
<tbody>
194
313
<tr>
195
 
<td>
196
 
<span class="term"><em class="parameter"><code>run_mode</code></em>&#160;:</span></td>
 
314
<td><span class="term"><em class="parameter"><code>run_mode</code></em>&#160;:</span></td>
197
315
<td> The run mode.
198
316
</td>
199
317
</tr>
200
318
<tr>
201
 
<td>
202
 
<span class="term"><em class="parameter"><code>image_ID</code></em>&#160;:</span></td>
 
319
<td><span class="term"><em class="parameter"><code>image_ID</code></em>&#160;:</span></td>
203
320
<td> Input image.
204
321
</td>
205
322
</tr>
206
323
<tr>
207
 
<td>
208
 
<span class="term"><em class="parameter"><code>drawable_ID</code></em>&#160;:</span></td>
 
324
<td><span class="term"><em class="parameter"><code>drawable_ID</code></em>&#160;:</span></td>
209
325
<td> Drawable to save.
210
326
</td>
211
327
</tr>
212
328
<tr>
213
 
<td>
214
 
<span class="term"><em class="parameter"><code>filename</code></em>&#160;:</span></td>
 
329
<td><span class="term"><em class="parameter"><code>filename</code></em>&#160;:</span></td>
215
330
<td> The name of the file to save the image in.
216
331
</td>
217
332
</tr>
218
333
<tr>
219
 
<td>
220
 
<span class="term"><em class="parameter"><code>raw_filename</code></em>&#160;:</span></td>
 
334
<td><span class="term"><em class="parameter"><code>raw_filename</code></em>&#160;:</span></td>
221
335
<td> The name as entered by the user.
222
336
</td>
223
337
</tr>
224
338
<tr>
225
 
<td>
226
 
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
227
 
<td> TRUE on success.
228
 
</td>
229
 
</tr>
230
 
</tbody>
231
 
</table></div>
232
 
</div>
233
 
<hr>
234
 
<div class="refsect2" lang="en">
235
 
<a name="id2587344"></a><h3>
 
339
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
340
<td> TRUE on success.
 
341
</td>
 
342
</tr>
 
343
</tbody>
 
344
</table></div>
 
345
</div>
 
346
<hr>
 
347
<div class="refsect2" lang="en">
 
348
<a name="id2619550"></a><h3>
 
349
<a name="gimp-file-save-thumbnail"></a>gimp_file_save_thumbnail ()</h3>
 
350
<a class="indexterm" name="id2619562"></a><pre class="programlisting">gboolean            gimp_file_save_thumbnail            (gint32 image_ID,
 
351
                                                         const gchar *filename);</pre>
 
352
<p>
 
353
Saves a thumbnail for the given image
 
354
</p>
 
355
<p>
 
356
This procedure saves a thumbnail for the given image according to
 
357
the Free Desktop Thumbnail Managing Standard. The thumbnail is saved
 
358
so that it belongs to the file with the given filename. This means
 
359
you have to save the image under this name first, otherwise this
 
360
procedure will fail. This procedure may become useful if you want to
 
361
explicitely save a thumbnail with a file.</p>
 
362
<p>
 
363
 
 
364
</p>
 
365
<div class="variablelist"><table border="0">
 
366
<col align="left" valign="top">
 
367
<tbody>
 
368
<tr>
 
369
<td><span class="term"><em class="parameter"><code>image_ID</code></em>&#160;:</span></td>
 
370
<td> The image.
 
371
</td>
 
372
</tr>
 
373
<tr>
 
374
<td><span class="term"><em class="parameter"><code>filename</code></em>&#160;:</span></td>
 
375
<td> The name of the file the thumbnail belongs to.
 
376
</td>
 
377
</tr>
 
378
<tr>
 
379
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
380
<td> TRUE on success.
 
381
</td>
 
382
</tr>
 
383
</tbody>
 
384
</table></div>
 
385
</div>
 
386
<hr>
 
387
<div class="refsect2" lang="en">
 
388
<a name="id2619654"></a><h3>
236
389
<a name="gimp-register-magic-load-handler"></a>gimp_register_magic_load_handler ()</h3>
237
 
<a class="indexterm" name="id2587355"></a><pre class="programlisting">gboolean    gimp_register_magic_load_handler
238
 
                                            (const gchar *procedure_name,
239
 
                                             const gchar *extensions,
240
 
                                             const gchar *prefixes,
241
 
                                             const gchar *magics);</pre>
 
390
<a class="indexterm" name="id2619665"></a><pre class="programlisting">gboolean            gimp_register_magic_load_handler    (const gchar *procedure_name,
 
391
                                                         const gchar *extensions,
 
392
                                                         const gchar *prefixes,
 
393
                                                         const gchar *magics);</pre>
242
394
<p>
243
395
Registers a file load handler procedure.
244
396
</p>
252
404
<col align="left" valign="top">
253
405
<tbody>
254
406
<tr>
255
 
<td>
256
 
<span class="term"><em class="parameter"><code>procedure_name</code></em>&#160;:</span></td>
 
407
<td><span class="term"><em class="parameter"><code>procedure_name</code></em>&#160;:</span></td>
257
408
<td> The name of the procedure to be used for loading.
258
409
</td>
259
410
</tr>
260
411
<tr>
261
 
<td>
262
 
<span class="term"><em class="parameter"><code>extensions</code></em>&#160;:</span></td>
 
412
<td><span class="term"><em class="parameter"><code>extensions</code></em>&#160;:</span></td>
263
413
<td> comma separated list of extensions this handler can load (i.e. \"jpg,jpeg\").
264
414
</td>
265
415
</tr>
266
416
<tr>
267
 
<td>
268
 
<span class="term"><em class="parameter"><code>prefixes</code></em>&#160;:</span></td>
 
417
<td><span class="term"><em class="parameter"><code>prefixes</code></em>&#160;:</span></td>
269
418
<td> comma separated list of prefixes this handler can load (i.e. \"http:,ftp:\").
270
419
</td>
271
420
</tr>
272
421
<tr>
273
 
<td>
274
 
<span class="term"><em class="parameter"><code>magics</code></em>&#160;:</span></td>
 
422
<td><span class="term"><em class="parameter"><code>magics</code></em>&#160;:</span></td>
275
423
<td> comma separated list of magic file information this handler can load (i.e. \"0,string,GIF\").
276
424
</td>
277
425
</tr>
278
426
<tr>
279
 
<td>
280
 
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
427
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
281
428
<td> TRUE on success.
282
429
</td>
283
430
</tr>
286
433
</div>
287
434
<hr>
288
435
<div class="refsect2" lang="en">
289
 
<a name="id2587489"></a><h3>
 
436
<a name="id2619799"></a><h3>
290
437
<a name="gimp-register-load-handler"></a>gimp_register_load_handler ()</h3>
291
 
<a class="indexterm" name="id2587501"></a><pre class="programlisting">gboolean    gimp_register_load_handler      (const gchar *procedure_name,
292
 
                                             const gchar *extensions,
293
 
                                             const gchar *prefixes);</pre>
 
438
<a class="indexterm" name="id2619811"></a><pre class="programlisting">gboolean            gimp_register_load_handler          (const gchar *procedure_name,
 
439
                                                         const gchar *extensions,
 
440
                                                         const gchar *prefixes);</pre>
294
441
<p>
295
442
Registers a file load handler procedure.
296
443
</p>
304
451
<col align="left" valign="top">
305
452
<tbody>
306
453
<tr>
307
 
<td>
308
 
<span class="term"><em class="parameter"><code>procedure_name</code></em>&#160;:</span></td>
 
454
<td><span class="term"><em class="parameter"><code>procedure_name</code></em>&#160;:</span></td>
309
455
<td> The name of the procedure to be used for loading.
310
456
</td>
311
457
</tr>
312
458
<tr>
313
 
<td>
314
 
<span class="term"><em class="parameter"><code>extensions</code></em>&#160;:</span></td>
 
459
<td><span class="term"><em class="parameter"><code>extensions</code></em>&#160;:</span></td>
315
460
<td> comma separated list of extensions this handler can load (i.e. \"jpg,jpeg\").
316
461
</td>
317
462
</tr>
318
463
<tr>
319
 
<td>
320
 
<span class="term"><em class="parameter"><code>prefixes</code></em>&#160;:</span></td>
 
464
<td><span class="term"><em class="parameter"><code>prefixes</code></em>&#160;:</span></td>
321
465
<td> comma separated list of prefixes this handler can load (i.e. \"http:,ftp:\").
322
466
</td>
323
467
</tr>
324
468
<tr>
325
 
<td>
326
 
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
469
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
327
470
<td> TRUE on success.
328
471
</td>
329
472
</tr>
332
475
</div>
333
476
<hr>
334
477
<div class="refsect2" lang="en">
335
 
<a name="id2587612"></a><h3>
 
478
<a name="id2619922"></a><h3>
336
479
<a name="gimp-register-save-handler"></a>gimp_register_save_handler ()</h3>
337
 
<a class="indexterm" name="id2587624"></a><pre class="programlisting">gboolean    gimp_register_save_handler      (const gchar *procedure_name,
338
 
                                             const gchar *extensions,
339
 
                                             const gchar *prefixes);</pre>
 
480
<a class="indexterm" name="id2619933"></a><pre class="programlisting">gboolean            gimp_register_save_handler          (const gchar *procedure_name,
 
481
                                                         const gchar *extensions,
 
482
                                                         const gchar *prefixes);</pre>
340
483
<p>
341
484
Registers a file save handler procedure.
342
485
</p>
350
493
<col align="left" valign="top">
351
494
<tbody>
352
495
<tr>
353
 
<td>
354
 
<span class="term"><em class="parameter"><code>procedure_name</code></em>&#160;:</span></td>
 
496
<td><span class="term"><em class="parameter"><code>procedure_name</code></em>&#160;:</span></td>
355
497
<td> The name of the procedure to be used for saving.
356
498
</td>
357
499
</tr>
358
500
<tr>
359
 
<td>
360
 
<span class="term"><em class="parameter"><code>extensions</code></em>&#160;:</span></td>
 
501
<td><span class="term"><em class="parameter"><code>extensions</code></em>&#160;:</span></td>
361
502
<td> comma separated list of extensions this handler can save (i.e. \"jpg,jpeg\").
362
503
</td>
363
504
</tr>
364
505
<tr>
365
 
<td>
366
 
<span class="term"><em class="parameter"><code>prefixes</code></em>&#160;:</span></td>
 
506
<td><span class="term"><em class="parameter"><code>prefixes</code></em>&#160;:</span></td>
367
507
<td> comma separated list of prefixes this handler can save (i.e. \"http:,ftp:\").
368
508
</td>
369
509
</tr>
370
510
<tr>
371
 
<td>
372
 
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
511
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
373
512
<td> TRUE on success.
374
513
</td>
375
514
</tr>
378
517
</div>
379
518
<hr>
380
519
<div class="refsect2" lang="en">
381
 
<a name="id2587736"></a><h3>
 
520
<a name="id2620045"></a><h3>
382
521
<a name="gimp-register-file-handler-mime"></a>gimp_register_file_handler_mime ()</h3>
383
 
<a class="indexterm" name="id2587751"></a><pre class="programlisting">gboolean    gimp_register_file_handler_mime (const gchar *procedure_name,
384
 
                                             const gchar *mime_type);</pre>
 
522
<a class="indexterm" name="id2620058"></a><pre class="programlisting">gboolean            gimp_register_file_handler_mime     (const gchar *procedure_name,
 
523
                                                         const gchar *mime_type);</pre>
385
524
<p>
386
525
Associates a MIME type with a file handler procedure.
387
526
</p>
396
535
<col align="left" valign="top">
397
536
<tbody>
398
537
<tr>
399
 
<td>
400
 
<span class="term"><em class="parameter"><code>procedure_name</code></em>&#160;:</span></td>
 
538
<td><span class="term"><em class="parameter"><code>procedure_name</code></em>&#160;:</span></td>
401
539
<td> The name of the procedure to associate a MIME type with.
402
540
</td>
403
541
</tr>
404
542
<tr>
405
 
<td>
406
 
<span class="term"><em class="parameter"><code>mime_type</code></em>&#160;:</span></td>
 
543
<td><span class="term"><em class="parameter"><code>mime_type</code></em>&#160;:</span></td>
407
544
<td> A single MIME type, like for example \"image/jpeg\".
408
545
</td>
409
546
</tr>
410
547
<tr>
411
 
<td>
412
 
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
548
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
413
549
<td> TRUE on success.
414
550
 
415
551
</td>
416
552
</tr>
417
553
</tbody>
418
554
</table></div>
419
 
<p>Since  GIMP 2.2
 
555
<p class="since">Since  GIMP 2.2
420
556
</p>
421
557
</div>
422
558
<hr>
423
559
<div class="refsect2" lang="en">
424
 
<a name="id2588386"></a><h3>
 
560
<a name="id2620156"></a><h3>
425
561
<a name="gimp-register-thumbnail-loader"></a>gimp_register_thumbnail_loader ()</h3>
426
 
<a class="indexterm" name="id2588401"></a><pre class="programlisting">gboolean    gimp_register_thumbnail_loader  (const gchar *load_proc,
427
 
                                             const gchar *thumb_proc);</pre>
 
562
<a class="indexterm" name="id2620172"></a><pre class="programlisting">gboolean            gimp_register_thumbnail_loader      (const gchar *load_proc,
 
563
                                                         const gchar *thumb_proc);</pre>
428
564
<p>
429
565
Associates a thumbnail loader with a file load procedure.
430
566
</p>
442
578
<col align="left" valign="top">
443
579
<tbody>
444
580
<tr>
445
 
<td>
446
 
<span class="term"><em class="parameter"><code>load_proc</code></em>&#160;:</span></td>
 
581
<td><span class="term"><em class="parameter"><code>load_proc</code></em>&#160;:</span></td>
447
582
<td> The name of the procedure the thumbnail loader with.
448
583
</td>
449
584
</tr>
450
585
<tr>
451
 
<td>
452
 
<span class="term"><em class="parameter"><code>thumb_proc</code></em>&#160;:</span></td>
 
586
<td><span class="term"><em class="parameter"><code>thumb_proc</code></em>&#160;:</span></td>
453
587
<td> The name of the thumbnail load procedure.
454
588
</td>
455
589
</tr>
456
590
<tr>
457
 
<td>
458
 
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
591
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
459
592
<td> TRUE on success.
460
593
 
461
594
</td>
462
595
</tr>
463
596
</tbody>
464
597
</table></div>
465
 
<p>Since  GIMP 2.2
 
598
<p class="since">Since  GIMP 2.2
466
599
</p>
467
600
</div>
468
601
</div>