Imported Upstream version 2.4.0~rc3

This commit is contained in:
Ari Pollak
2010-08-11 01:23:08 -04:00
parent 4be5597e32
commit f35d8506c6
668 changed files with 59324 additions and 37769 deletions

View File

@ -31,16 +31,16 @@
<th width="100%" align="center">GIMP Library Reference Manual</th>
<td><a accesskey="n" href="libgimp-gimpfloatingsel.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2577331" class="shortcut">Top</a>
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2601572" class="shortcut">Top</a>
&#160;|&#160;
<a href="#id2642401" class="shortcut">Description</a></nobr></td></tr>
<a href="#id2642884" class="shortcut">Description</a></nobr></td></tr>
</table>
<div class="refentry" lang="en">
<a name="libgimp-gimpfileops"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2>
<a name="id2577331"></a><span class="refentrytitle">gimpfileops</span>
<a name="id2601572"></a><span class="refentrytitle">gimpfileops</span>
</h2>
<p>gimpfileops &#8212; File operations (load, save, etc.)</p>
</td>
@ -52,61 +52,143 @@
gchar* <a class="link" href="libgimp-gimpfileops.html#gimp-temp-name">gimp_temp_name</a> (const gchar *extension);
gint32 <a class="link" href="libgimp-gimpfileops.html#gimp-file-load">gimp_file_load</a> (<a
<a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a>* <a class="link" href="libgimp-gimpfileops.html#gimp-temp-name">gimp_temp_name</a> (const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *extension);
<a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> <a class="link" href="libgimp-gimpfileops.html#gimp-file-load">gimp_file_load</a> (<a
href="../libgimpbase/libgimpbase-gimpbaseenums.html#GimpRunMode"
>GimpRunMode</a> run_mode,
const gchar *filename,
const gchar *raw_filename);
gint32 <a class="link" href="libgimp-gimpfileops.html#gimp-file-load-layer">gimp_file_load_layer</a> (<a
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *filename,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *raw_filename);
<a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> <a class="link" href="libgimp-gimpfileops.html#gimp-file-load-layer">gimp_file_load_layer</a> (<a
href="../libgimpbase/libgimpbase-gimpbaseenums.html#GimpRunMode"
>GimpRunMode</a> run_mode,
gint32 image_ID,
const gchar *filename);
gint* <a class="link" href="libgimp-gimpfileops.html#gimp-file-load-layers">gimp_file_load_layers</a> (<a
<a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> image_ID,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *filename);
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a>* <a class="link" href="libgimp-gimpfileops.html#gimp-file-load-layers">gimp_file_load_layers</a> (<a
href="../libgimpbase/libgimpbase-gimpbaseenums.html#GimpRunMode"
>GimpRunMode</a> run_mode,
gint32 image_ID,
const gchar *filename,
gint *num_layers);
gboolean <a class="link" href="libgimp-gimpfileops.html#gimp-file-save">gimp_file_save</a> (<a
<a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> image_ID,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *filename,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> *num_layers);
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> <a class="link" href="libgimp-gimpfileops.html#gimp-file-save">gimp_file_save</a> (<a
href="../libgimpbase/libgimpbase-gimpbaseenums.html#GimpRunMode"
>GimpRunMode</a> run_mode,
gint32 image_ID,
gint32 drawable_ID,
const gchar *filename,
const gchar *raw_filename);
gboolean <a class="link" href="libgimp-gimpfileops.html#gimp-file-save-thumbnail">gimp_file_save_thumbnail</a> (gint32 image_ID,
const gchar *filename);
gboolean <a class="link" href="libgimp-gimpfileops.html#gimp-register-magic-load-handler">gimp_register_magic_load_handler</a> (const gchar *procedure_name,
const gchar *extensions,
const gchar *prefixes,
const gchar *magics);
gboolean <a class="link" href="libgimp-gimpfileops.html#gimp-register-load-handler">gimp_register_load_handler</a> (const gchar *procedure_name,
const gchar *extensions,
const gchar *prefixes);
gboolean <a class="link" href="libgimp-gimpfileops.html#gimp-register-save-handler">gimp_register_save_handler</a> (const gchar *procedure_name,
const gchar *extensions,
const gchar *prefixes);
gboolean <a class="link" href="libgimp-gimpfileops.html#gimp-register-file-handler-mime">gimp_register_file_handler_mime</a> (const gchar *procedure_name,
const gchar *mime_type);
gboolean <a class="link" href="libgimp-gimpfileops.html#gimp-register-thumbnail-loader">gimp_register_thumbnail_loader</a> (const gchar *load_proc,
const gchar *thumb_proc);
<a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> image_ID,
<a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> drawable_ID,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *filename,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *raw_filename);
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> <a class="link" href="libgimp-gimpfileops.html#gimp-file-save-thumbnail">gimp_file_save_thumbnail</a> (<a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> image_ID,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *filename);
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> <a class="link" href="libgimp-gimpfileops.html#gimp-register-magic-load-handler">gimp_register_magic_load_handler</a> (const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *procedure_name,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *extensions,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *prefixes,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *magics);
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> <a class="link" href="libgimp-gimpfileops.html#gimp-register-load-handler">gimp_register_load_handler</a> (const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *procedure_name,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *extensions,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *prefixes);
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> <a class="link" href="libgimp-gimpfileops.html#gimp-register-save-handler">gimp_register_save_handler</a> (const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *procedure_name,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *extensions,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *prefixes);
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> <a class="link" href="libgimp-gimpfileops.html#gimp-register-file-handler-mime">gimp_register_file_handler_mime</a> (const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *procedure_name,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *mime_type);
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> <a class="link" href="libgimp-gimpfileops.html#gimp-register-thumbnail-loader">gimp_register_thumbnail_loader</a> (const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *load_proc,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *thumb_proc);
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id2642401"></a><h2>Description</h2>
<a name="id2642884"></a><h2>Description</h2>
<p>
File operations (load, save, etc.)
</p>
</div>
<div class="refsect1" lang="en">
<a name="id2642416"></a><h2>Details</h2>
<a name="id2642899"></a><h2>Details</h2>
<div class="refsect2" lang="en">
<a name="id2642427"></a><h3>
<a name="id2642910"></a><h3>
<a name="gimp-temp-name"></a>gimp_temp_name ()</h3>
<a class="indexterm" name="id2642440"></a><pre class="programlisting">gchar* gimp_temp_name (const gchar *extension);</pre>
<a class="indexterm" name="id2642922"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a>* gimp_temp_name (const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *extension);</pre>
<p>
Generates a unique filename.
</p>
@ -134,13 +216,19 @@ user's gimprc.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2642504"></a><h3>
<a name="id2642987"></a><h3>
<a name="gimp-file-load"></a>gimp_file_load ()</h3>
<a class="indexterm" name="id2642517"></a><pre class="programlisting">gint32 gimp_file_load (<a
<a class="indexterm" name="id2643000"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> gimp_file_load (<a
href="../libgimpbase/libgimpbase-gimpbaseenums.html#GimpRunMode"
>GimpRunMode</a> run_mode,
const gchar *filename,
const gchar *raw_filename);</pre>
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *filename,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *raw_filename);</pre>
<p>
Loads an image file by invoking the right load handler.
</p>
@ -183,13 +271,19 @@ will not look like a URL.\"</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2642631"></a><h3>
<a name="id2648768"></a><h3>
<a name="gimp-file-load-layer"></a>gimp_file_load_layer ()</h3>
<a class="indexterm" name="id2642645"></a><pre class="programlisting">gint32 gimp_file_load_layer (<a
<a class="indexterm" name="id2648782"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> gimp_file_load_layer (<a
href="../libgimpbase/libgimpbase-gimpbaseenums.html#GimpRunMode"
>GimpRunMode</a> run_mode,
gint32 image_ID,
const gchar *filename);</pre>
<a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> image_ID,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *filename);</pre>
<p>
Loads an image file as a layer for an existing image.
</p>
@ -231,14 +325,22 @@ needs to be added to the existing image with <a class="link" href="libgimp-gimpi
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2642771"></a><h3>
<a name="id2648908"></a><h3>
<a name="gimp-file-load-layers"></a>gimp_file_load_layers ()</h3>
<a class="indexterm" name="id2642785"></a><pre class="programlisting">gint* gimp_file_load_layers (<a
<a class="indexterm" name="id2648922"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gint"
>gint</a>* gimp_file_load_layers (<a
href="../libgimpbase/libgimpbase-gimpbaseenums.html#GimpRunMode"
>GimpRunMode</a> run_mode,
gint32 image_ID,
const gchar *filename,
gint *num_layers);</pre>
<a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> image_ID,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *filename,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> *num_layers);</pre>
<p>
Loads an image file as layers for an existing image.
</p>
@ -285,15 +387,25 @@ needs to be added to the existing image with <a class="link" href="libgimp-gimpi
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2642932"></a><h3>
<a name="id2649069"></a><h3>
<a name="gimp-file-save"></a>gimp_file_save ()</h3>
<a class="indexterm" name="id2642944"></a><pre class="programlisting">gboolean gimp_file_save (<a
<a class="indexterm" name="id2649081"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> gimp_file_save (<a
href="../libgimpbase/libgimpbase-gimpbaseenums.html#GimpRunMode"
>GimpRunMode</a> run_mode,
gint32 image_ID,
gint32 drawable_ID,
const gchar *filename,
const gchar *raw_filename);</pre>
<a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> image_ID,
<a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> drawable_ID,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *filename,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *raw_filename);</pre>
<p>
Saves a file by extension.
</p>
@ -345,10 +457,16 @@ fetch a URL, and the full pathname will not look like a URL.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2636983"></a><h3>
<a name="id2641212"></a><h3>
<a name="gimp-file-save-thumbnail"></a>gimp_file_save_thumbnail ()</h3>
<a class="indexterm" name="id2636994"></a><pre class="programlisting">gboolean gimp_file_save_thumbnail (gint32 image_ID,
const gchar *filename);</pre>
<a class="indexterm" name="id2641223"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> gimp_file_save_thumbnail (<a
href="../glib/glib-Basic-Types.html#gint32"
>gint32</a> image_ID,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *filename);</pre>
<p>
Saves a thumbnail for the given image
</p>
@ -385,12 +503,22 @@ explicitely save a thumbnail with a file.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2637086"></a><h3>
<a name="id2641315"></a><h3>
<a name="gimp-register-magic-load-handler"></a>gimp_register_magic_load_handler ()</h3>
<a class="indexterm" name="id2637098"></a><pre class="programlisting">gboolean gimp_register_magic_load_handler (const gchar *procedure_name,
const gchar *extensions,
const gchar *prefixes,
const gchar *magics);</pre>
<a class="indexterm" name="id2641326"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> gimp_register_magic_load_handler (const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *procedure_name,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *extensions,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *prefixes,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *magics);</pre>
<p>
Registers a file load handler procedure.
</p>
@ -433,11 +561,19 @@ of a particular file format using magic file information.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2637232"></a><h3>
<a name="id2641461"></a><h3>
<a name="gimp-register-load-handler"></a>gimp_register_load_handler ()</h3>
<a class="indexterm" name="id2637243"></a><pre class="programlisting">gboolean gimp_register_load_handler (const gchar *procedure_name,
const gchar *extensions,
const gchar *prefixes);</pre>
<a class="indexterm" name="id2641472"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> gimp_register_load_handler (const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *procedure_name,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *extensions,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *prefixes);</pre>
<p>
Registers a file load handler procedure.
</p>
@ -475,11 +611,19 @@ of a particular file format.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2637355"></a><h3>
<a name="id2641584"></a><h3>
<a name="gimp-register-save-handler"></a>gimp_register_save_handler ()</h3>
<a class="indexterm" name="id2637367"></a><pre class="programlisting">gboolean gimp_register_save_handler (const gchar *procedure_name,
const gchar *extensions,
const gchar *prefixes);</pre>
<a class="indexterm" name="id2641595"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> gimp_register_save_handler (const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *procedure_name,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *extensions,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *prefixes);</pre>
<p>
Registers a file save handler procedure.
</p>
@ -517,10 +661,16 @@ in a particular file format.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2637478"></a><h3>
<a name="id2641706"></a><h3>
<a name="gimp-register-file-handler-mime"></a>gimp_register_file_handler_mime ()</h3>
<a class="indexterm" name="id2637494"></a><pre class="programlisting">gboolean gimp_register_file_handler_mime (const gchar *procedure_name,
const gchar *mime_type);</pre>
<a class="indexterm" name="id2641720"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> gimp_register_file_handler_mime (const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *procedure_name,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *mime_type);</pre>
<p>
Associates a MIME type with a file handler procedure.
</p>
@ -557,10 +707,16 @@ procedure.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2637592"></a><h3>
<a name="id2641818"></a><h3>
<a name="gimp-register-thumbnail-loader"></a>gimp_register_thumbnail_loader ()</h3>
<a class="indexterm" name="id2637608"></a><pre class="programlisting">gboolean gimp_register_thumbnail_loader (const gchar *load_proc,
const gchar *thumb_proc);</pre>
<a class="indexterm" name="id2641831"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> gimp_register_thumbnail_loader (const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *load_proc,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *thumb_proc);</pre>
<p>
Associates a thumbnail loader with a file load procedure.
</p>