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

« back to all changes in this revision

Viewing changes to devel-docs/libgimpbase/html/libgimpbase-gimpunit.html

  • Committer: Bazaar Package Importer
  • Author(s): Pedro Fragoso
  • Date: 2008-08-22 11:50:05 UTC
  • mfrom: (0.1.1 upstream)
  • mto: This revision was merged to the branch mainline in revision 34.
  • Revision ID: james.westby@ubuntu.com-20080822115005-yxj5svf3v9x1mkr7
Tags: upstream-2.4.7
Import upstream version 2.4.7

Show diffs side-by-side

added added

removed removed

Lines of Context:
43
43
<a name="libgimpbase-gimpunit.synopsis"></a><h2>Synopsis</h2>
44
44
<pre class="synopsis">
45
45
enum                <a class="link" href="libgimpbase-gimpunit.html#GimpUnit" title="enum GimpUnit">GimpUnit</a>;
46
 
<a
47
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
48
 
>gint</a>                <a class="link" href="libgimpbase-gimpunit.html#gimp-unit-get-number-of-units" title="gimp_unit_get_number_of_units ()">gimp_unit_get_number_of_units</a>       (void);
49
 
<a
50
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
51
 
>gint</a>                <a class="link" href="libgimpbase-gimpunit.html#gimp-unit-get-number-of-built-in-units" title="gimp_unit_get_number_of_built_in_units ()">gimp_unit_get_number_of_built_in_units</a>
 
46
gint                <a class="link" href="libgimpbase-gimpunit.html#gimp-unit-get-number-of-units" title="gimp_unit_get_number_of_units ()">gimp_unit_get_number_of_units</a>       (void);
 
47
gint                <a class="link" href="libgimpbase-gimpunit.html#gimp-unit-get-number-of-built-in-units" title="gimp_unit_get_number_of_built_in_units ()">gimp_unit_get_number_of_built_in_units</a>
52
48
                                                        (void);
53
 
<a class="link" href="libgimpbase-gimpunit.html#GimpUnit" title="enum GimpUnit">GimpUnit</a>            <a class="link" href="libgimpbase-gimpunit.html#gimp-unit-new" title="gimp_unit_new ()">gimp_unit_new</a>                       (<a
54
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
55
 
>gchar</a> *identifier,
56
 
                                                         <a
57
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"
58
 
>gdouble</a> factor,
59
 
                                                         <a
60
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
61
 
>gint</a> digits,
62
 
                                                         <a
63
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
64
 
>gchar</a> *symbol,
65
 
                                                         <a
66
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
67
 
>gchar</a> *abbreviation,
68
 
                                                         <a
69
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
70
 
>gchar</a> *singular,
71
 
                                                         <a
72
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
73
 
>gchar</a> *plural);
74
 
<a
75
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
76
 
>gboolean</a>            <a class="link" href="libgimpbase-gimpunit.html#gimp-unit-get-deletion-flag" title="gimp_unit_get_deletion_flag ()">gimp_unit_get_deletion_flag</a>         (<a class="link" href="libgimpbase-gimpunit.html#GimpUnit" title="enum GimpUnit">GimpUnit</a> unit);
 
49
<a class="link" href="libgimpbase-gimpunit.html#GimpUnit" title="enum GimpUnit">GimpUnit</a>            <a class="link" href="libgimpbase-gimpunit.html#gimp-unit-new" title="gimp_unit_new ()">gimp_unit_new</a>                       (gchar *identifier,
 
50
                                                         gdouble factor,
 
51
                                                         gint digits,
 
52
                                                         gchar *symbol,
 
53
                                                         gchar *abbreviation,
 
54
                                                         gchar *singular,
 
55
                                                         gchar *plural);
 
56
gboolean            <a class="link" href="libgimpbase-gimpunit.html#gimp-unit-get-deletion-flag" title="gimp_unit_get_deletion_flag ()">gimp_unit_get_deletion_flag</a>         (<a class="link" href="libgimpbase-gimpunit.html#GimpUnit" title="enum GimpUnit">GimpUnit</a> unit);
77
57
void                <a class="link" href="libgimpbase-gimpunit.html#gimp-unit-set-deletion-flag" title="gimp_unit_set_deletion_flag ()">gimp_unit_set_deletion_flag</a>         (<a class="link" href="libgimpbase-gimpunit.html#GimpUnit" title="enum GimpUnit">GimpUnit</a> unit,
78
 
                                                         <a
79
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
80
 
>gboolean</a> deletion_flag);
81
 
<a
82
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"
83
 
>gdouble</a>             <a class="link" href="libgimpbase-gimpunit.html#gimp-unit-get-factor" title="gimp_unit_get_factor ()">gimp_unit_get_factor</a>                (<a class="link" href="libgimpbase-gimpunit.html#GimpUnit" title="enum GimpUnit">GimpUnit</a> unit);
84
 
<a
85
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
86
 
>gint</a>                <a class="link" href="libgimpbase-gimpunit.html#gimp-unit-get-digits" title="gimp_unit_get_digits ()">gimp_unit_get_digits</a>                (<a class="link" href="libgimpbase-gimpunit.html#GimpUnit" title="enum GimpUnit">GimpUnit</a> unit);
87
 
const <a
88
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
89
 
>gchar</a>*        <a class="link" href="libgimpbase-gimpunit.html#gimp-unit-get-identifier" title="gimp_unit_get_identifier ()">gimp_unit_get_identifier</a>            (<a class="link" href="libgimpbase-gimpunit.html#GimpUnit" title="enum GimpUnit">GimpUnit</a> unit);
90
 
const <a
91
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
92
 
>gchar</a>*        <a class="link" href="libgimpbase-gimpunit.html#gimp-unit-get-symbol" title="gimp_unit_get_symbol ()">gimp_unit_get_symbol</a>                (<a class="link" href="libgimpbase-gimpunit.html#GimpUnit" title="enum GimpUnit">GimpUnit</a> unit);
93
 
const <a
94
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
95
 
>gchar</a>*        <a class="link" href="libgimpbase-gimpunit.html#gimp-unit-get-abbreviation" title="gimp_unit_get_abbreviation ()">gimp_unit_get_abbreviation</a>          (<a class="link" href="libgimpbase-gimpunit.html#GimpUnit" title="enum GimpUnit">GimpUnit</a> unit);
96
 
const <a
97
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
98
 
>gchar</a>*        <a class="link" href="libgimpbase-gimpunit.html#gimp-unit-get-singular" title="gimp_unit_get_singular ()">gimp_unit_get_singular</a>              (<a class="link" href="libgimpbase-gimpunit.html#GimpUnit" title="enum GimpUnit">GimpUnit</a> unit);
99
 
const <a
100
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
101
 
>gchar</a>*        <a class="link" href="libgimpbase-gimpunit.html#gimp-unit-get-plural" title="gimp_unit_get_plural ()">gimp_unit_get_plural</a>                (<a class="link" href="libgimpbase-gimpunit.html#GimpUnit" title="enum GimpUnit">GimpUnit</a> unit);
 
58
                                                         gboolean deletion_flag);
 
59
gdouble             <a class="link" href="libgimpbase-gimpunit.html#gimp-unit-get-factor" title="gimp_unit_get_factor ()">gimp_unit_get_factor</a>                (<a class="link" href="libgimpbase-gimpunit.html#GimpUnit" title="enum GimpUnit">GimpUnit</a> unit);
 
60
gint                <a class="link" href="libgimpbase-gimpunit.html#gimp-unit-get-digits" title="gimp_unit_get_digits ()">gimp_unit_get_digits</a>                (<a class="link" href="libgimpbase-gimpunit.html#GimpUnit" title="enum GimpUnit">GimpUnit</a> unit);
 
61
const gchar*        <a class="link" href="libgimpbase-gimpunit.html#gimp-unit-get-identifier" title="gimp_unit_get_identifier ()">gimp_unit_get_identifier</a>            (<a class="link" href="libgimpbase-gimpunit.html#GimpUnit" title="enum GimpUnit">GimpUnit</a> unit);
 
62
const gchar*        <a class="link" href="libgimpbase-gimpunit.html#gimp-unit-get-symbol" title="gimp_unit_get_symbol ()">gimp_unit_get_symbol</a>                (<a class="link" href="libgimpbase-gimpunit.html#GimpUnit" title="enum GimpUnit">GimpUnit</a> unit);
 
63
const gchar*        <a class="link" href="libgimpbase-gimpunit.html#gimp-unit-get-abbreviation" title="gimp_unit_get_abbreviation ()">gimp_unit_get_abbreviation</a>          (<a class="link" href="libgimpbase-gimpunit.html#GimpUnit" title="enum GimpUnit">GimpUnit</a> unit);
 
64
const gchar*        <a class="link" href="libgimpbase-gimpunit.html#gimp-unit-get-singular" title="gimp_unit_get_singular ()">gimp_unit_get_singular</a>              (<a class="link" href="libgimpbase-gimpunit.html#GimpUnit" title="enum GimpUnit">GimpUnit</a> unit);
 
65
const gchar*        <a class="link" href="libgimpbase-gimpunit.html#gimp-unit-get-plural" title="gimp_unit_get_plural ()">gimp_unit_get_plural</a>                (<a class="link" href="libgimpbase-gimpunit.html#GimpUnit" title="enum GimpUnit">GimpUnit</a> unit);
102
66
#define             <a class="link" href="libgimpbase-gimpunit.html#GIMP-TYPE-UNIT:CAPS" title="GIMP_TYPE_UNIT">GIMP_TYPE_UNIT</a>
103
67
#define             <a class="link" href="libgimpbase-gimpunit.html#GIMP-TYPE-PARAM-UNIT:CAPS" title="GIMP_TYPE_PARAM_UNIT">GIMP_TYPE_PARAM_UNIT</a>
104
68
#define             <a class="link" href="libgimpbase-gimpunit.html#GIMP-IS-PARAM-SPEC-UNIT:CAPS" title="GIMP_IS_PARAM_SPEC_UNIT()">GIMP_IS_PARAM_SPEC_UNIT</a>             (pspec)
105
 
<a
106
 
href="/usr/share/gtk-doc/html/gobject/gobject-GParamSpec.html#GParamSpec"
107
 
>GParamSpec</a>*         <a class="link" href="libgimpbase-gimpunit.html#gimp-param-spec-unit" title="gimp_param_spec_unit ()">gimp_param_spec_unit</a>                (const <a
108
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
109
 
>gchar</a> *name,
110
 
                                                         const <a
111
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
112
 
>gchar</a> *nick,
113
 
                                                         const <a
114
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
115
 
>gchar</a> *blurb,
116
 
                                                         <a
117
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
118
 
>gboolean</a> allow_pixels,
119
 
                                                         <a
120
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
121
 
>gboolean</a> allow_percent,
 
69
GParamSpec*         <a class="link" href="libgimpbase-gimpunit.html#gimp-param-spec-unit" title="gimp_param_spec_unit ()">gimp_param_spec_unit</a>                (const gchar *name,
 
70
                                                         const gchar *nick,
 
71
                                                         const gchar *blurb,
 
72
                                                         gboolean allow_pixels,
 
73
                                                         gboolean allow_percent,
122
74
                                                         <a class="link" href="libgimpbase-gimpunit.html#GimpUnit" title="enum GimpUnit">GimpUnit</a> default_value,
123
 
                                                         <a
124
 
href="/usr/share/gtk-doc/html/gobject/gobject-GParamSpec.html#GParamFlags"
125
 
>GParamFlags</a> flags);
 
75
                                                         GParamFlags flags);
126
76
#define             <a class="link" href="libgimpbase-gimpunit.html#GIMP-VALUE-HOLDS-UNIT:CAPS" title="GIMP_VALUE_HOLDS_UNIT()">GIMP_VALUE_HOLDS_UNIT</a>               (value)
127
77
</pre>
128
78
</div>
159
109
<hr>
160
110
<div class="refsect2" lang="en">
161
111
<a name="gimp-unit-get-number-of-units"></a><h3>gimp_unit_get_number_of_units ()</h3>
162
 
<pre class="programlisting"><a
163
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
164
 
>gint</a>                gimp_unit_get_number_of_units       (void);</pre>
 
112
<pre class="programlisting">gint                gimp_unit_get_number_of_units       (void);</pre>
165
113
<p>
166
114
Returns the number of units which are known to the <a class="link" href="libgimpbase-gimpunit.html#GimpUnit" title="enum GimpUnit"><span class="type">GimpUnit</span></a> system.</p>
167
115
<p>
179
127
<hr>
180
128
<div class="refsect2" lang="en">
181
129
<a name="gimp-unit-get-number-of-built-in-units"></a><h3>gimp_unit_get_number_of_built_in_units ()</h3>
182
 
<pre class="programlisting"><a
183
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
184
 
>gint</a>                gimp_unit_get_number_of_built_in_units
 
130
<pre class="programlisting">gint                gimp_unit_get_number_of_built_in_units
185
131
                                                        (void);</pre>
186
132
<p>
187
133
Returns the number of <a class="link" href="libgimpbase-gimpunit.html#GimpUnit" title="enum GimpUnit"><span class="type">GimpUnit</span></a>'s which are hardcoded in the unit system
202
148
<hr>
203
149
<div class="refsect2" lang="en">
204
150
<a name="gimp-unit-new"></a><h3>gimp_unit_new ()</h3>
205
 
<pre class="programlisting"><a class="link" href="libgimpbase-gimpunit.html#GimpUnit" title="enum GimpUnit">GimpUnit</a>            gimp_unit_new                       (<a
206
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
207
 
>gchar</a> *identifier,
208
 
                                                         <a
209
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"
210
 
>gdouble</a> factor,
211
 
                                                         <a
212
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
213
 
>gint</a> digits,
214
 
                                                         <a
215
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
216
 
>gchar</a> *symbol,
217
 
                                                         <a
218
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
219
 
>gchar</a> *abbreviation,
220
 
                                                         <a
221
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
222
 
>gchar</a> *singular,
223
 
                                                         <a
224
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
225
 
>gchar</a> *plural);</pre>
 
151
<pre class="programlisting"><a class="link" href="libgimpbase-gimpunit.html#GimpUnit" title="enum GimpUnit">GimpUnit</a>            gimp_unit_new                       (gchar *identifier,
 
152
                                                         gdouble factor,
 
153
                                                         gint digits,
 
154
                                                         gchar *symbol,
 
155
                                                         gchar *abbreviation,
 
156
                                                         gchar *singular,
 
157
                                                         gchar *plural);</pre>
226
158
<p>
227
159
Returns the integer ID of the new <a class="link" href="libgimpbase-gimpunit.html#GimpUnit" title="enum GimpUnit"><span class="type">GimpUnit</span></a>.
228
160
</p>
229
161
<p>
230
162
Note that a new unit is always created with it's deletion flag
231
 
set to <a
232
 
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
233
 
><code class="literal">TRUE</code></a>. You will have to set it to <a
234
 
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
235
 
><code class="literal">FALSE</code></a> with
 
163
set to <code class="literal">TRUE</code>. You will have to set it to <code class="literal">FALSE</code> with
236
164
<a class="link" href="libgimpbase-gimpunit.html#gimp-unit-set-deletion-flag" title="gimp_unit_set_deletion_flag ()"><code class="function">gimp_unit_set_deletion_flag()</code></a> to make the unit definition persistent.</p>
237
165
<p>
238
166
 
286
214
<hr>
287
215
<div class="refsect2" lang="en">
288
216
<a name="gimp-unit-get-deletion-flag"></a><h3>gimp_unit_get_deletion_flag ()</h3>
289
 
<pre class="programlisting"><a
290
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
291
 
>gboolean</a>            gimp_unit_get_deletion_flag         (<a class="link" href="libgimpbase-gimpunit.html#GimpUnit" title="enum GimpUnit">GimpUnit</a> unit);</pre>
 
217
<pre class="programlisting">gboolean            gimp_unit_get_deletion_flag         (<a class="link" href="libgimpbase-gimpunit.html#GimpUnit" title="enum GimpUnit">GimpUnit</a> unit);</pre>
292
218
<p>
293
219
</p>
294
220
<p>
314
240
<div class="refsect2" lang="en">
315
241
<a name="gimp-unit-set-deletion-flag"></a><h3>gimp_unit_set_deletion_flag ()</h3>
316
242
<pre class="programlisting">void                gimp_unit_set_deletion_flag         (<a class="link" href="libgimpbase-gimpunit.html#GimpUnit" title="enum GimpUnit">GimpUnit</a> unit,
317
 
                                                         <a
318
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
319
 
>gboolean</a> deletion_flag);</pre>
 
243
                                                         gboolean deletion_flag);</pre>
320
244
<p>
321
245
Sets a <a class="link" href="libgimpbase-gimpunit.html#GimpUnit" title="enum GimpUnit"><span class="type">GimpUnit</span></a>'s <em class="parameter"><code>deletion_flag</code></em>. If the <em class="parameter"><code>deletion_flag</code></em> of a unit is
322
 
<a
323
 
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
324
 
><code class="literal">TRUE</code></a> when GIMP exits, this unit will not be saved in the users's
 
246
<code class="literal">TRUE</code> when GIMP exits, this unit will not be saved in the users's
325
247
"unitrc" file.
326
248
</p>
327
249
<p>
349
271
<hr>
350
272
<div class="refsect2" lang="en">
351
273
<a name="gimp-unit-get-factor"></a><h3>gimp_unit_get_factor ()</h3>
352
 
<pre class="programlisting"><a
353
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"
354
 
>gdouble</a>             gimp_unit_get_factor                (<a class="link" href="libgimpbase-gimpunit.html#GimpUnit" title="enum GimpUnit">GimpUnit</a> unit);</pre>
 
274
<pre class="programlisting">gdouble             gimp_unit_get_factor                (<a class="link" href="libgimpbase-gimpunit.html#GimpUnit" title="enum GimpUnit">GimpUnit</a> unit);</pre>
355
275
<p>
356
276
A <a class="link" href="libgimpbase-gimpunit.html#GimpUnit" title="enum GimpUnit"><span class="type">GimpUnit</span></a>'s <em class="parameter"><code>factor</code></em> is defined to be:
357
277
</p>
382
302
<hr>
383
303
<div class="refsect2" lang="en">
384
304
<a name="gimp-unit-get-digits"></a><h3>gimp_unit_get_digits ()</h3>
385
 
<pre class="programlisting"><a
386
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
387
 
>gint</a>                gimp_unit_get_digits                (<a class="link" href="libgimpbase-gimpunit.html#GimpUnit" title="enum GimpUnit">GimpUnit</a> unit);</pre>
 
305
<pre class="programlisting">gint                gimp_unit_get_digits                (<a class="link" href="libgimpbase-gimpunit.html#GimpUnit" title="enum GimpUnit">GimpUnit</a> unit);</pre>
388
306
<p>
389
307
Returns the number of digits an entry field should provide to get
390
308
approximately the same accuracy as an inch input field with two digits.
413
331
<hr>
414
332
<div class="refsect2" lang="en">
415
333
<a name="gimp-unit-get-identifier"></a><h3>gimp_unit_get_identifier ()</h3>
416
 
<pre class="programlisting">const <a
417
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
418
 
>gchar</a>*        gimp_unit_get_identifier            (<a class="link" href="libgimpbase-gimpunit.html#GimpUnit" title="enum GimpUnit">GimpUnit</a> unit);</pre>
 
334
<pre class="programlisting">const gchar*        gimp_unit_get_identifier            (<a class="link" href="libgimpbase-gimpunit.html#GimpUnit" title="enum GimpUnit">GimpUnit</a> unit);</pre>
419
335
<p>
420
336
This is an unstranslated string and must not be changed or freed.</p>
421
337
<p>
440
356
<hr>
441
357
<div class="refsect2" lang="en">
442
358
<a name="gimp-unit-get-symbol"></a><h3>gimp_unit_get_symbol ()</h3>
443
 
<pre class="programlisting">const <a
444
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
445
 
>gchar</a>*        gimp_unit_get_symbol                (<a class="link" href="libgimpbase-gimpunit.html#GimpUnit" title="enum GimpUnit">GimpUnit</a> unit);</pre>
 
359
<pre class="programlisting">const gchar*        gimp_unit_get_symbol                (<a class="link" href="libgimpbase-gimpunit.html#GimpUnit" title="enum GimpUnit">GimpUnit</a> unit);</pre>
446
360
<p>
447
361
This is e.g. "''" for UNIT_INCH.
448
362
</p>
470
384
<hr>
471
385
<div class="refsect2" lang="en">
472
386
<a name="gimp-unit-get-abbreviation"></a><h3>gimp_unit_get_abbreviation ()</h3>
473
 
<pre class="programlisting">const <a
474
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
475
 
>gchar</a>*        gimp_unit_get_abbreviation          (<a class="link" href="libgimpbase-gimpunit.html#GimpUnit" title="enum GimpUnit">GimpUnit</a> unit);</pre>
 
387
<pre class="programlisting">const gchar*        gimp_unit_get_abbreviation          (<a class="link" href="libgimpbase-gimpunit.html#GimpUnit" title="enum GimpUnit">GimpUnit</a> unit);</pre>
476
388
<p>
477
389
For built-in units, this function returns the translated abbreviation
478
390
of the unit.
501
413
<hr>
502
414
<div class="refsect2" lang="en">
503
415
<a name="gimp-unit-get-singular"></a><h3>gimp_unit_get_singular ()</h3>
504
 
<pre class="programlisting">const <a
505
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
506
 
>gchar</a>*        gimp_unit_get_singular              (<a class="link" href="libgimpbase-gimpunit.html#GimpUnit" title="enum GimpUnit">GimpUnit</a> unit);</pre>
 
416
<pre class="programlisting">const gchar*        gimp_unit_get_singular              (<a class="link" href="libgimpbase-gimpunit.html#GimpUnit" title="enum GimpUnit">GimpUnit</a> unit);</pre>
507
417
<p>
508
418
For built-in units, this function returns the translated singular form
509
419
of the unit's name.
532
442
<hr>
533
443
<div class="refsect2" lang="en">
534
444
<a name="gimp-unit-get-plural"></a><h3>gimp_unit_get_plural ()</h3>
535
 
<pre class="programlisting">const <a
536
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
537
 
>gchar</a>*        gimp_unit_get_plural                (<a class="link" href="libgimpbase-gimpunit.html#GimpUnit" title="enum GimpUnit">GimpUnit</a> unit);</pre>
 
445
<pre class="programlisting">const gchar*        gimp_unit_get_plural                (<a class="link" href="libgimpbase-gimpunit.html#GimpUnit" title="enum GimpUnit">GimpUnit</a> unit);</pre>
538
446
<p>
539
447
For built-in units, this function returns the translated plural form
540
448
of the unit's name.
566
474
<pre class="programlisting">#define GIMP_TYPE_UNIT               (gimp_unit_get_type ())
567
475
</pre>
568
476
<p>
569
 
<a class="link" href="libgimpbase-gimpunit.html#GIMP-TYPE-UNIT:CAPS" title="GIMP_TYPE_UNIT"><span class="type">GIMP_TYPE_UNIT</span></a> is a <a
570
 
href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"
571
 
><span class="type">GType</span></a> derived from <a
572
 
href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#G-TYPE-INT:CAPS"
573
 
><span class="type">G_TYPE_INT</span></a>.
 
477
<a class="link" href="libgimpbase-gimpunit.html#GIMP-TYPE-UNIT:CAPS" title="GIMP_TYPE_UNIT"><span class="type">GIMP_TYPE_UNIT</span></a> is a <span class="type">GType</span> derived from <span class="type">G_TYPE_INT</span>.
574
478
</p>
575
479
</div>
576
480
<hr>
604
508
<hr>
605
509
<div class="refsect2" lang="en">
606
510
<a name="gimp-param-spec-unit"></a><h3>gimp_param_spec_unit ()</h3>
607
 
<pre class="programlisting"><a
608
 
href="/usr/share/gtk-doc/html/gobject/gobject-GParamSpec.html#GParamSpec"
609
 
>GParamSpec</a>*         gimp_param_spec_unit                (const <a
610
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
611
 
>gchar</a> *name,
612
 
                                                         const <a
613
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
614
 
>gchar</a> *nick,
615
 
                                                         const <a
616
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
617
 
>gchar</a> *blurb,
618
 
                                                         <a
619
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
620
 
>gboolean</a> allow_pixels,
621
 
                                                         <a
622
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
623
 
>gboolean</a> allow_percent,
 
511
<pre class="programlisting">GParamSpec*         gimp_param_spec_unit                (const gchar *name,
 
512
                                                         const gchar *nick,
 
513
                                                         const gchar *blurb,
 
514
                                                         gboolean allow_pixels,
 
515
                                                         gboolean allow_percent,
624
516
                                                         <a class="link" href="libgimpbase-gimpunit.html#GimpUnit" title="enum GimpUnit">GimpUnit</a> default_value,
625
 
                                                         <a
626
 
href="/usr/share/gtk-doc/html/gobject/gobject-GParamSpec.html#GParamFlags"
627
 
>GParamFlags</a> flags);</pre>
 
517
                                                         GParamFlags flags);</pre>
628
518
<p>
629
519
Creates a param spec to hold a units param.
630
 
See <a
631
 
href="/usr/share/gtk-doc/html/gobject/gobject-GParamSpec.html#g-param-spec-internal"
632
 
><code class="function">g_param_spec_internal()</code></a> for more information.</p>
 
520
See <code class="function">g_param_spec_internal()</code> for more information.</p>
633
521
<p>
634
522
 
635
523
</p>
668
556
</tr>
669
557
<tr>
670
558
<td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
671
 
<td>         a combination of <a
672
 
href="/usr/share/gtk-doc/html/gobject/gobject-GParamSpec.html#GParamFlags"
673
 
><span class="type">GParamFlags</span></a>
 
559
<td>         a combination of <span class="type">GParamFlags</span>
674
560
</td>
675
561
</tr>
676
562
<tr>
677
563
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
678
 
<td> a newly allocated <a
679
 
href="/usr/share/gtk-doc/html/gobject/gobject-GParamSpec.html#GParamSpec"
680
 
><span class="type">GParamSpec</span></a> instance
 
564
<td> a newly allocated <span class="type">GParamSpec</span> instance
681
565
 
682
566
</td>
683
567
</tr>
709
593
<div class="refsect1" lang="en">
710
594
<a name="libgimpbase-gimpunit.see-also"></a><h2>See Also</h2>
711
595
<p>
712
 
<a
713
 
href="/usr/share/gtk-doc/html/libgimpwidgets/GimpUnitMenu.html"
714
 
><span class="type">GimpUnitMenu</span></a>
 
596
<span class="type">GimpUnitMenu</span>
715
597
</p>
716
598
<p>
717
 
<a
718
 
href="/usr/share/gtk-doc/html/libgimpwidgets/GimpSizeEntry.html"
719
 
><span class="type">GimpSizeEntry</span></a>
 
599
<span class="type">GimpSizeEntry</span>
720
600
</p>
721
601
</div>
722
602
</div>