4
4
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
5
5
<title>gimpexport</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="libgimpui.html" title="Part III. GIMP User Interface Library">
8
<link rel="up" href="libgimpui.html" title="Part II. GIMP User Interface Library">
9
9
<link rel="prev" href="libgimp-gimpui.html" title="gimpui">
10
<link rel="next" href="GimpAspectPreview.html" title="GimpAspectPreview">
11
<meta name="generator" content="GTK-Doc V1.7 (XML mode)">
10
<link rel="next" href="GimpDrawablePreview.html" title="GimpDrawablePreview">
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 I. GIMP Constants">
14
<link rel="part" href="libgimp.html" title="Part II. GIMP Library">
13
<link rel="part" href="libgimp.html" title="Part I. 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 III. GIMP User Interface Library">
18
<link rel="part" href="libgimpui.html" title="Part II. 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">
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">
26
29
<td><a accesskey="u" href="libgimpui.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
27
30
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
28
31
<th width="100%" align="center">GIMP Library Reference Manual</th>
29
<td><a accesskey="n" href="GimpAspectPreview.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
32
<td><a accesskey="n" href="GimpDrawablePreview.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="#id2557466" class="shortcut">Top</a>
34
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2665056" class="shortcut">Top</a>
33
<a href="#id2652159" class="shortcut">Description</a></nobr></td></tr>
36
<a href="#id2601188" class="shortcut">Description</a></nobr></td></tr>
35
38
<div class="refentry" lang="en">
36
39
<a name="libgimp-gimpexport"></a><div class="titlepage"></div>
37
40
<div class="refnamediv"><table width="100%"><tr>
40
<a name="id2557466"></a><span class="refentrytitle">gimpexport</span>
43
<a name="id2665056"></a><span class="refentrytitle">gimpexport</span>
42
45
<p>gimpexport — Export an image before it is saved.</p>
52
enum <a href="libgimp-gimpexport.html#GimpExportCapabilities">GimpExportCapabilities</a>;
53
enum <a href="libgimp-gimpexport.html#GimpExportReturn">GimpExportReturn</a>;
54
<a href="libgimp-gimpexport.html#GimpExportReturn">GimpExportReturn</a> <a href="libgimp-gimpexport.html#gimp-export-image">gimp_export_image</a> (gint32 *image_ID,
56
const gchar *format_name,
57
<a href="libgimp-gimpexport.html#GimpExportCapabilities">GimpExportCapabilities</a> capabilities);
55
enum <a href="libgimp-gimpexport.html#GimpExportCapabilities">GimpExportCapabilities</a>;
56
enum <a href="libgimp-gimpexport.html#GimpExportReturn">GimpExportReturn</a>;
57
<a href="libgimp-gimpexport.html#GimpExportReturn">GimpExportReturn</a> <a href="libgimp-gimpexport.html#gimp-export-image">gimp_export_image</a> (gint32 *image_ID,
59
const gchar *format_name,
60
<a href="libgimp-gimpexport.html#GimpExportCapabilities">GimpExportCapabilities</a> capabilities);
60
63
<div class="refsect1" lang="en">
61
<a name="id2652159"></a><h2>Description</h2>
64
<a name="id2601188"></a><h2>Description</h2>
63
66
This function should be called by all save_plugins unless they are
64
67
able to save all image formats the GIMP knows about. It takes care
77
80
<div class="refsect1" lang="en">
78
<a name="id2652190"></a><h2>Details</h2>
81
<a name="id2609371"></a><h2>Details</h2>
79
82
<div class="refsect2" lang="en">
80
<a name="id2652201"></a><h3>
83
<a name="id2711622"></a><h3>
81
84
<a name="GimpExportCapabilities"></a>enum GimpExportCapabilities</h3>
82
<a class="indexterm" name="id2586296"></a><pre class="programlisting">typedef enum
85
<a class="indexterm" name="id2711634"></a><pre class="programlisting">typedef enum
84
87
GIMP_EXPORT_CAN_HANDLE_RGB = 1 << 0,
85
88
GIMP_EXPORT_CAN_HANDLE_GRAY = 1 << 1,
100
103
<div class="refsect2" lang="en">
101
<a name="id2559973"></a><h3>
104
<a name="id2711657"></a><h3>
102
105
<a name="GimpExportReturn"></a>enum GimpExportReturn</h3>
103
<a class="indexterm" name="id2580512"></a><pre class="programlisting">typedef enum
106
<a class="indexterm" name="id2711669"></a><pre class="programlisting">typedef enum
105
108
GIMP_EXPORT_CANCEL,
106
109
GIMP_EXPORT_IGNORE,
115
118
<div class="refsect2" lang="en">
116
<a name="id2652223"></a><h3>
119
<a name="id2711685"></a><h3>
117
120
<a name="gimp-export-image"></a>gimp_export_image ()</h3>
118
<a class="indexterm" name="id2652233"></a><pre class="programlisting"><a href="libgimp-gimpexport.html#GimpExportReturn">GimpExportReturn</a> gimp_export_image (gint32 *image_ID,
120
const gchar *format_name,
121
<a href="libgimp-gimpexport.html#GimpExportCapabilities">GimpExportCapabilities</a> capabilities);</pre>
121
<a class="indexterm" name="id2711696"></a><pre class="programlisting"><a href="libgimp-gimpexport.html#GimpExportReturn">GimpExportReturn</a> gimp_export_image (gint32 *image_ID,
123
const gchar *format_name,
124
<a href="libgimp-gimpexport.html#GimpExportCapabilities">GimpExportCapabilities</a> capabilities);</pre>
123
126
Takes an image and a drawable to be saved together with a
124
127
description of the capabilities of the image_format. If the
146
149
<col align="left" valign="top">
150
<span class="term"><em class="parameter"><code>image_ID</code></em> :</span></td>
152
<td><span class="term"><em class="parameter"><code>image_ID</code></em> :</span></td>
151
153
<td> Pointer to the image_ID.
156
<span class="term"><em class="parameter"><code>drawable_ID</code></em> :</span></td>
157
<td><span class="term"><em class="parameter"><code>drawable_ID</code></em> :</span></td>
157
158
<td> Pointer to the drawable_ID.
162
<span class="term"><em class="parameter"><code>format_name</code></em> :</span></td>
162
<td><span class="term"><em class="parameter"><code>format_name</code></em> :</span></td>
163
163
<td> The (short) name of the image_format (e.g. JPEG or GIF).
168
<span class="term"><em class="parameter"><code>capabilities</code></em> :</span></td>
167
<td><span class="term"><em class="parameter"><code>capabilities</code></em> :</span></td>
169
168
<td> What can the image_format do?
174
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
172
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
175
173
<td> An enum of <a href="libgimp-gimpexport.html#GimpExportReturn"><span class="type">GimpExportReturn</span></a> describing the user_action.