919 lines
35 KiB
HTML
919 lines
35 KiB
HTML
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<html>
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
|
|
<title>gimputils</title>
|
|
<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
|
|
<link rel="start" href="index.html" title="GIMP Base Library Reference Manual">
|
|
<link rel="up" href="libgimpbase.html" title="Part I. GIMP Base Library">
|
|
<link rel="prev" href="libgimpbase-gimpunit.html" title="gimpunit">
|
|
<link rel="next" href="libgimpbase-index.html" title="Index">
|
|
<meta name="generator" content="GTK-Doc V1.8 (XML mode)">
|
|
<link rel="stylesheet" href="style.css" type="text/css">
|
|
<link rel="part" href="libgimpbase.html" title="Part I. GIMP Base Library">
|
|
<link rel="index" href="libgimpbase-index.html" title="Index">
|
|
<link rel="index" href="libgimpbase-index-new-in-2-2.html" title="Index of new symbols in GIMP 2.2">
|
|
<link rel="index" href="libgimpbase-index-new-in-2-4.html" title="Index of new symbols in GIMP 2.4">
|
|
<link rel="index" href="libgimpbase-index-deprecated.html" title="Index of deprecated symbols">
|
|
</head>
|
|
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
|
|
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
|
|
<tr valign="middle">
|
|
<td><a accesskey="p" href="libgimpbase-gimpunit.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
|
|
<td><a accesskey="u" href="libgimpbase.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
|
|
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
|
|
<th width="100%" align="center">GIMP Base Library Reference Manual</th>
|
|
<td><a accesskey="n" href="libgimpbase-index.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="#id2604865" class="shortcut">Top</a>
|
|
 | 
|
|
<a href="#id2593227" class="shortcut">Description</a></nobr></td></tr>
|
|
</table>
|
|
<div class="refentry" lang="en">
|
|
<a name="libgimpbase-gimputils"></a><div class="titlepage"></div>
|
|
<div class="refnamediv"><table width="100%"><tr>
|
|
<td valign="top">
|
|
<h2>
|
|
<a name="id2604865"></a><span class="refentrytitle">gimputils</span>
|
|
</h2>
|
|
<p>gimputils — Utilities of general interest</p>
|
|
</td>
|
|
<td valign="top" align="right"></td>
|
|
</tr></table></div>
|
|
<div class="refsynopsisdiv">
|
|
<h2>Synopsis</h2>
|
|
<pre class="synopsis">
|
|
|
|
|
|
|
|
<a
|
|
href="../glib/glib-Basic-Types.html#gchar"
|
|
>gchar</a>* <a class="link" href="libgimpbase-gimputils.html#gimp-any-to-utf8">gimp_any_to_utf8</a> (const <a
|
|
href="../glib/glib-Basic-Types.html#gchar"
|
|
>gchar</a> *str,
|
|
<a
|
|
href="../glib/glib-Basic-Types.html#gssize"
|
|
>gssize</a> len,
|
|
const <a
|
|
href="../glib/glib-Basic-Types.html#gchar"
|
|
>gchar</a> *warning_format,
|
|
...);
|
|
const <a
|
|
href="../glib/glib-Basic-Types.html#gchar"
|
|
>gchar</a>* <a class="link" href="libgimpbase-gimputils.html#gimp-filename-to-utf8">gimp_filename_to_utf8</a> (const <a
|
|
href="../glib/glib-Basic-Types.html#gchar"
|
|
>gchar</a> *filename);
|
|
<a
|
|
href="../glib/glib-Basic-Types.html#gchar"
|
|
>gchar</a>* <a class="link" href="libgimpbase-gimputils.html#gimp-utf8-strtrim">gimp_utf8_strtrim</a> (const <a
|
|
href="../glib/glib-Basic-Types.html#gchar"
|
|
>gchar</a> *str,
|
|
<a
|
|
href="../glib/glib-Basic-Types.html#gint"
|
|
>gint</a> max_chars);
|
|
<a
|
|
href="../glib/glib-Basic-Types.html#gchar"
|
|
>gchar</a>* <a class="link" href="libgimpbase-gimputils.html#gimp-escape-uline">gimp_escape_uline</a> (const <a
|
|
href="../glib/glib-Basic-Types.html#gchar"
|
|
>gchar</a> *str);
|
|
<a
|
|
href="../glib/glib-Basic-Types.html#gchar"
|
|
>gchar</a>* <a class="link" href="libgimpbase-gimputils.html#gimp-strip-uline">gimp_strip_uline</a> (const <a
|
|
href="../glib/glib-Basic-Types.html#gchar"
|
|
>gchar</a> *str);
|
|
<a
|
|
href="../glib/glib-Basic-Types.html#gchar"
|
|
>gchar</a>* <a class="link" href="libgimpbase-gimputils.html#gimp-canonicalize-identifier">gimp_canonicalize_identifier</a> (const <a
|
|
href="../glib/glib-Basic-Types.html#gchar"
|
|
>gchar</a> *identifier);
|
|
<a class="link" href="libgimpbase-gimpbasetypes.html#GimpEnumDesc">GimpEnumDesc</a>* <a class="link" href="libgimpbase-gimputils.html#gimp-enum-get-desc">gimp_enum_get_desc</a> (<a
|
|
href="../gobject/gobject-Enumeration-and-Flag-Types.html#GEnumClass"
|
|
>GEnumClass</a> *enum_class,
|
|
<a
|
|
href="../glib/glib-Basic-Types.html#gint"
|
|
>gint</a> value);
|
|
<a
|
|
href="../glib/glib-Basic-Types.html#gboolean"
|
|
>gboolean</a> <a class="link" href="libgimpbase-gimputils.html#gimp-enum-get-value">gimp_enum_get_value</a> (<a
|
|
href="../gobject/gobject-Type-Information.html#GType"
|
|
>GType</a> enum_type,
|
|
<a
|
|
href="../glib/glib-Basic-Types.html#gint"
|
|
>gint</a> value,
|
|
const <a
|
|
href="../glib/glib-Basic-Types.html#gchar"
|
|
>gchar</a> **value_name,
|
|
const <a
|
|
href="../glib/glib-Basic-Types.html#gchar"
|
|
>gchar</a> **value_nick,
|
|
const <a
|
|
href="../glib/glib-Basic-Types.html#gchar"
|
|
>gchar</a> **value_desc,
|
|
const <a
|
|
href="../glib/glib-Basic-Types.html#gchar"
|
|
>gchar</a> **value_help);
|
|
const <a
|
|
href="../glib/glib-Basic-Types.html#gchar"
|
|
>gchar</a>* <a class="link" href="libgimpbase-gimputils.html#gimp-enum-value-get-desc">gimp_enum_value_get_desc</a> (<a
|
|
href="../gobject/gobject-Enumeration-and-Flag-Types.html#GEnumClass"
|
|
>GEnumClass</a> *enum_class,
|
|
<a
|
|
href="../gobject/gobject-Enumeration-and-Flag-Types.html#GEnumValue"
|
|
>GEnumValue</a> *enum_value);
|
|
const <a
|
|
href="../glib/glib-Basic-Types.html#gchar"
|
|
>gchar</a>* <a class="link" href="libgimpbase-gimputils.html#gimp-enum-value-get-help">gimp_enum_value_get_help</a> (<a
|
|
href="../gobject/gobject-Enumeration-and-Flag-Types.html#GEnumClass"
|
|
>GEnumClass</a> *enum_class,
|
|
<a
|
|
href="../gobject/gobject-Enumeration-and-Flag-Types.html#GEnumValue"
|
|
>GEnumValue</a> *enum_value);
|
|
<a class="link" href="libgimpbase-gimpbasetypes.html#GimpFlagsDesc">GimpFlagsDesc</a>* <a class="link" href="libgimpbase-gimputils.html#gimp-flags-get-first-desc">gimp_flags_get_first_desc</a> (<a
|
|
href="../gobject/gobject-Enumeration-and-Flag-Types.html#GFlagsClass"
|
|
>GFlagsClass</a> *flags_class,
|
|
<a
|
|
href="../glib/glib-Basic-Types.html#guint"
|
|
>guint</a> value);
|
|
<a
|
|
href="../glib/glib-Basic-Types.html#gboolean"
|
|
>gboolean</a> <a class="link" href="libgimpbase-gimputils.html#gimp-flags-get-first-value">gimp_flags_get_first_value</a> (<a
|
|
href="../gobject/gobject-Type-Information.html#GType"
|
|
>GType</a> flags_type,
|
|
<a
|
|
href="../glib/glib-Basic-Types.html#guint"
|
|
>guint</a> value,
|
|
const <a
|
|
href="../glib/glib-Basic-Types.html#gchar"
|
|
>gchar</a> **value_name,
|
|
const <a
|
|
href="../glib/glib-Basic-Types.html#gchar"
|
|
>gchar</a> **value_nick,
|
|
const <a
|
|
href="../glib/glib-Basic-Types.html#gchar"
|
|
>gchar</a> **value_desc,
|
|
const <a
|
|
href="../glib/glib-Basic-Types.html#gchar"
|
|
>gchar</a> **value_help);
|
|
const <a
|
|
href="../glib/glib-Basic-Types.html#gchar"
|
|
>gchar</a>* <a class="link" href="libgimpbase-gimputils.html#gimp-flags-value-get-desc">gimp_flags_value_get_desc</a> (<a
|
|
href="../gobject/gobject-Enumeration-and-Flag-Types.html#GFlagsClass"
|
|
>GFlagsClass</a> *flags_class,
|
|
<a
|
|
href="../gobject/gobject-Enumeration-and-Flag-Types.html#GFlagsValue"
|
|
>GFlagsValue</a> *flags_value);
|
|
const <a
|
|
href="../glib/glib-Basic-Types.html#gchar"
|
|
>gchar</a>* <a class="link" href="libgimpbase-gimputils.html#gimp-flags-value-get-help">gimp_flags_value_get_help</a> (<a
|
|
href="../gobject/gobject-Enumeration-and-Flag-Types.html#GFlagsClass"
|
|
>GFlagsClass</a> *flags_class,
|
|
<a
|
|
href="../gobject/gobject-Enumeration-and-Flag-Types.html#GFlagsValue"
|
|
>GFlagsValue</a> *flags_value);
|
|
</pre>
|
|
</div>
|
|
<div class="refsect1" lang="en">
|
|
<a name="id2593227"></a><h2>Description</h2>
|
|
<p>
|
|
|
|
</p>
|
|
</div>
|
|
<div class="refsect1" lang="en">
|
|
<a name="id2593242"></a><h2>Details</h2>
|
|
<div class="refsect2" lang="en">
|
|
<a name="id2593253"></a><h3>
|
|
<a name="gimp-any-to-utf8"></a>gimp_any_to_utf8 ()</h3>
|
|
<a class="indexterm" name="id2593266"></a><pre class="programlisting"><a
|
|
href="../glib/glib-Basic-Types.html#gchar"
|
|
>gchar</a>* gimp_any_to_utf8 (const <a
|
|
href="../glib/glib-Basic-Types.html#gchar"
|
|
>gchar</a> *str,
|
|
<a
|
|
href="../glib/glib-Basic-Types.html#gssize"
|
|
>gssize</a> len,
|
|
const <a
|
|
href="../glib/glib-Basic-Types.html#gchar"
|
|
>gchar</a> *warning_format,
|
|
...);</pre>
|
|
<p>
|
|
This function takes any string (UTF-8 or not) and always returns a valid
|
|
UTF-8 string.
|
|
</p>
|
|
<p>
|
|
If <em class="parameter"><code>str</code></em> is valid UTF-8, a copy of the string is returned.
|
|
</p>
|
|
<p>
|
|
If UTF-8 validation fails, <a
|
|
href="../glib/glib-Character-Set-Conversion.html#g-locale-to-utf8"
|
|
><code class="function">g_locale_to_utf8()</code></a> is tried and if it
|
|
succeeds the resulting string is returned.
|
|
</p>
|
|
<p>
|
|
Otherwise, the portion of <em class="parameter"><code>str</code></em> that is UTF-8, concatenated
|
|
with "(invalid UTF-8 string)" is returned. If not even the start
|
|
of <em class="parameter"><code>str</code></em> is valid UTF-8, only "(invalid UTF-8 string)" is returned.</p>
|
|
<p>
|
|
|
|
</p>
|
|
<div class="variablelist"><table border="0">
|
|
<col align="left" valign="top">
|
|
<tbody>
|
|
<tr>
|
|
<td><p><span class="term"><em class="parameter"><code>str</code></em> :</span></p></td>
|
|
<td> The string to be converted to UTF-8.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><em class="parameter"><code>len</code></em> :</span></p></td>
|
|
<td> The length of the string, or -1 if the string
|
|
is nul-terminated.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><em class="parameter"><code>warning_format</code></em> :</span></p></td>
|
|
<td> The message format for the warning message if conversion
|
|
to UTF-8 fails. See the <code class="function"><code class="function">printf()</code></code>
|
|
documentation.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
|
|
<td> The parameters to insert into the format string.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
<td> The UTF-8 string as described above.
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table></div>
|
|
</div>
|
|
<hr>
|
|
<div class="refsect2" lang="en">
|
|
<a name="id2621912"></a><h3>
|
|
<a name="gimp-filename-to-utf8"></a>gimp_filename_to_utf8 ()</h3>
|
|
<a class="indexterm" name="id2621923"></a><pre class="programlisting">const <a
|
|
href="../glib/glib-Basic-Types.html#gchar"
|
|
>gchar</a>* gimp_filename_to_utf8 (const <a
|
|
href="../glib/glib-Basic-Types.html#gchar"
|
|
>gchar</a> *filename);</pre>
|
|
<p>
|
|
Convert a filename in the filesystem's encoding to UTF-8
|
|
temporarily. The return value is a pointer to a string that is
|
|
guaranteed to be valid only during the current iteration of the
|
|
main loop or until the next call to <a class="link" href="libgimpbase-gimputils.html#gimp-filename-to-utf8"><code class="function">gimp_filename_to_utf8()</code></a>.
|
|
</p>
|
|
<p>
|
|
The only purpose of this function is to provide an easy way to pass
|
|
a filename in the filesystem encoding to a function that expects an
|
|
UTF-8 encoded filename.</p>
|
|
<p>
|
|
|
|
</p>
|
|
<div class="variablelist"><table border="0">
|
|
<col align="left" valign="top">
|
|
<tbody>
|
|
<tr>
|
|
<td><p><span class="term"><em class="parameter"><code>filename</code></em> :</span></p></td>
|
|
<td> The filename to be converted to UTF-8.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
<td> A temporarily valid UTF-8 representation of <em class="parameter"><code>filename</code></em>.
|
|
This string must not be changed or freed.
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table></div>
|
|
</div>
|
|
<hr>
|
|
<div class="refsect2" lang="en">
|
|
<a name="id2622010"></a><h3>
|
|
<a name="gimp-utf8-strtrim"></a>gimp_utf8_strtrim ()</h3>
|
|
<a class="indexterm" name="id2622023"></a><pre class="programlisting"><a
|
|
href="../glib/glib-Basic-Types.html#gchar"
|
|
>gchar</a>* gimp_utf8_strtrim (const <a
|
|
href="../glib/glib-Basic-Types.html#gchar"
|
|
>gchar</a> *str,
|
|
<a
|
|
href="../glib/glib-Basic-Types.html#gint"
|
|
>gint</a> max_chars);</pre>
|
|
<p>
|
|
Creates a (possibly trimmed) copy of <em class="parameter"><code>str</code></em>. The string is cut if it
|
|
exceeds <em class="parameter"><code>max_chars</code></em> characters or on the first newline. The fact
|
|
that the string was trimmed is indicated by appending an ellipsis.</p>
|
|
<p>
|
|
|
|
</p>
|
|
<div class="variablelist"><table border="0">
|
|
<col align="left" valign="top">
|
|
<tbody>
|
|
<tr>
|
|
<td><p><span class="term"><em class="parameter"><code>str</code></em> :</span></p></td>
|
|
<td> an UTF-8 encoded string (or <a
|
|
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
|
|
><code class="literal">NULL</code></a>)
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><em class="parameter"><code>max_chars</code></em> :</span></p></td>
|
|
<td> the maximum number of characters before the string get
|
|
trimmed
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
<td> A (possibly trimmed) copy of <em class="parameter"><code>str</code></em> which should be freed
|
|
using <a
|
|
href="../glib/glib-Memory-Allocation.html#g-free"
|
|
><code class="function">g_free()</code></a> when it is not needed any longer.
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table></div>
|
|
</div>
|
|
<hr>
|
|
<div class="refsect2" lang="en">
|
|
<a name="id2622142"></a><h3>
|
|
<a name="gimp-escape-uline"></a>gimp_escape_uline ()</h3>
|
|
<a class="indexterm" name="id2622156"></a><pre class="programlisting"><a
|
|
href="../glib/glib-Basic-Types.html#gchar"
|
|
>gchar</a>* gimp_escape_uline (const <a
|
|
href="../glib/glib-Basic-Types.html#gchar"
|
|
>gchar</a> *str);</pre>
|
|
<p>
|
|
This function returns a copy of <em class="parameter"><code>str</code></em> with all underline converted
|
|
to two adjacent underlines. This comes in handy when needing to display
|
|
strings with underlines (like filenames) in a place that would convert
|
|
them to mnemonics.</p>
|
|
<p>
|
|
|
|
</p>
|
|
<div class="variablelist"><table border="0">
|
|
<col align="left" valign="top">
|
|
<tbody>
|
|
<tr>
|
|
<td><p><span class="term"><em class="parameter"><code>str</code></em> :</span></p></td>
|
|
<td> Underline infested string (or <a
|
|
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
|
|
><code class="literal">NULL</code></a>)
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
<td> A (possibly escaped) copy of <em class="parameter"><code>str</code></em> which should be
|
|
freed using <a
|
|
href="../glib/glib-Memory-Allocation.html#g-free"
|
|
><code class="function">g_free()</code></a> when it is not needed any longer.
|
|
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table></div>
|
|
<p class="since">Since GIMP 2.2
|
|
</p>
|
|
</div>
|
|
<hr>
|
|
<div class="refsect2" lang="en">
|
|
<a name="id2629516"></a><h3>
|
|
<a name="gimp-strip-uline"></a>gimp_strip_uline ()</h3>
|
|
<a class="indexterm" name="id2629526"></a><pre class="programlisting"><a
|
|
href="../glib/glib-Basic-Types.html#gchar"
|
|
>gchar</a>* gimp_strip_uline (const <a
|
|
href="../glib/glib-Basic-Types.html#gchar"
|
|
>gchar</a> *str);</pre>
|
|
<p>
|
|
This function returns a copy of <em class="parameter"><code>str</code></em> stripped of underline
|
|
characters. This comes in handy when needing to strip mnemonics
|
|
from menu paths etc.
|
|
</p>
|
|
<p>
|
|
In some languages, mnemonics are handled by adding the mnemonic
|
|
character in brackets (like "File (_F)"). This function recognizes
|
|
this construct and removes the whole bracket construction to get
|
|
rid of the mnemonic (see bug <span class="type">157561</span>).</p>
|
|
<p>
|
|
|
|
</p>
|
|
<div class="variablelist"><table border="0">
|
|
<col align="left" valign="top">
|
|
<tbody>
|
|
<tr>
|
|
<td><p><span class="term"><em class="parameter"><code>str</code></em> :</span></p></td>
|
|
<td> underline infested string (or <a
|
|
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
|
|
><code class="literal">NULL</code></a>)
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
<td> A (possibly stripped) copy of <em class="parameter"><code>str</code></em> which should be
|
|
freed using <a
|
|
href="../glib/glib-Memory-Allocation.html#g-free"
|
|
><code class="function">g_free()</code></a> when it is not needed any longer.
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table></div>
|
|
</div>
|
|
<hr>
|
|
<div class="refsect2" lang="en">
|
|
<a name="id2629627"></a><h3>
|
|
<a name="gimp-canonicalize-identifier"></a>gimp_canonicalize_identifier ()</h3>
|
|
<a class="indexterm" name="id2629643"></a><pre class="programlisting"><a
|
|
href="../glib/glib-Basic-Types.html#gchar"
|
|
>gchar</a>* gimp_canonicalize_identifier (const <a
|
|
href="../glib/glib-Basic-Types.html#gchar"
|
|
>gchar</a> *identifier);</pre>
|
|
<p>
|
|
Turns any input string into a canonicalized string.
|
|
</p>
|
|
<p>
|
|
Canonical identifiers are e.g. expected by the PDB for procedure
|
|
and parameter names. Every character of the input string that is
|
|
not either '-', 'a-z', 'A-Z' or '0-9' will be replaced by a '-'.</p>
|
|
<p>
|
|
|
|
</p>
|
|
<div class="variablelist"><table border="0">
|
|
<col align="left" valign="top">
|
|
<tbody>
|
|
<tr>
|
|
<td><p><span class="term"><em class="parameter"><code>identifier</code></em> :</span></p></td>
|
|
<td> The identifier string to canonicalize.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
<td> The canonicalized identifier. This is a newly
|
|
allocated string that should be freed with <a
|
|
href="../glib/glib-Memory-Allocation.html#g-free"
|
|
><code class="function">g_free()</code></a>
|
|
when no longer needed.
|
|
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table></div>
|
|
<p class="since">Since GIMP 2.4
|
|
</p>
|
|
</div>
|
|
<hr>
|
|
<div class="refsect2" lang="en">
|
|
<a name="id2629731"></a><h3>
|
|
<a name="gimp-enum-get-desc"></a>gimp_enum_get_desc ()</h3>
|
|
<a class="indexterm" name="id2629745"></a><pre class="programlisting"><a class="link" href="libgimpbase-gimpbasetypes.html#GimpEnumDesc">GimpEnumDesc</a>* gimp_enum_get_desc (<a
|
|
href="../gobject/gobject-Enumeration-and-Flag-Types.html#GEnumClass"
|
|
>GEnumClass</a> *enum_class,
|
|
<a
|
|
href="../glib/glib-Basic-Types.html#gint"
|
|
>gint</a> value);</pre>
|
|
<p>
|
|
Retrieves <a class="link" href="libgimpbase-gimpbasetypes.html#GimpEnumDesc"><span class="type">GimpEnumDesc</span></a> associated with the given value, or <a
|
|
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
|
|
><code class="literal">NULL</code></a>.</p>
|
|
<p>
|
|
|
|
</p>
|
|
<div class="variablelist"><table border="0">
|
|
<col align="left" valign="top">
|
|
<tbody>
|
|
<tr>
|
|
<td><p><span class="term"><em class="parameter"><code>enum_class</code></em> :</span></p></td>
|
|
<td> a <a
|
|
href="../gobject/gobject-Enumeration-and-Flag-Types.html#GEnumClass"
|
|
><span class="type">GEnumClass</span></a>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
|
|
<td> a value from <em class="parameter"><code>enum_class</code></em>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
<td> the value's <a class="link" href="libgimpbase-gimpbasetypes.html#GimpEnumDesc"><span class="type">GimpEnumDesc</span></a>.
|
|
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table></div>
|
|
<p class="since">Since GIMP 2.2
|
|
</p>
|
|
</div>
|
|
<hr>
|
|
<div class="refsect2" lang="en">
|
|
<a name="id2629872"></a><h3>
|
|
<a name="gimp-enum-get-value"></a>gimp_enum_get_value ()</h3>
|
|
<a class="indexterm" name="id2629886"></a><pre class="programlisting"><a
|
|
href="../glib/glib-Basic-Types.html#gboolean"
|
|
>gboolean</a> gimp_enum_get_value (<a
|
|
href="../gobject/gobject-Type-Information.html#GType"
|
|
>GType</a> enum_type,
|
|
<a
|
|
href="../glib/glib-Basic-Types.html#gint"
|
|
>gint</a> value,
|
|
const <a
|
|
href="../glib/glib-Basic-Types.html#gchar"
|
|
>gchar</a> **value_name,
|
|
const <a
|
|
href="../glib/glib-Basic-Types.html#gchar"
|
|
>gchar</a> **value_nick,
|
|
const <a
|
|
href="../glib/glib-Basic-Types.html#gchar"
|
|
>gchar</a> **value_desc,
|
|
const <a
|
|
href="../glib/glib-Basic-Types.html#gchar"
|
|
>gchar</a> **value_help);</pre>
|
|
<p>
|
|
Checks if <em class="parameter"><code>value</code></em> is valid for the enum registered as <em class="parameter"><code>enum_type</code></em>.
|
|
If the value exists in that enum, its name, nick and its translated
|
|
desc and help are returned (if <em class="parameter"><code>value_name</code></em>, <em class="parameter"><code>value_nick</code></em>, <em class="parameter"><code>value_desc</code></em>
|
|
and <em class="parameter"><code>value_help</code></em> are not <a
|
|
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
|
|
><code class="literal">NULL</code></a>).</p>
|
|
<p>
|
|
|
|
</p>
|
|
<div class="variablelist"><table border="0">
|
|
<col align="left" valign="top">
|
|
<tbody>
|
|
<tr>
|
|
<td><p><span class="term"><em class="parameter"><code>enum_type</code></em> :</span></p></td>
|
|
<td> the <a
|
|
href="../gobject/gobject-Type-Information.html#GType"
|
|
><span class="type">GType</span></a> of a registered enum
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
|
|
<td> an integer value
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><em class="parameter"><code>value_name</code></em> :</span></p></td>
|
|
<td> return location for the value's name (or <a
|
|
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
|
|
><code class="literal">NULL</code></a>)
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><em class="parameter"><code>value_nick</code></em> :</span></p></td>
|
|
<td> return location for the value's nick (or <a
|
|
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
|
|
><code class="literal">NULL</code></a>)
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><em class="parameter"><code>value_desc</code></em> :</span></p></td>
|
|
<td> return location for the value's translated desc (or <a
|
|
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
|
|
><code class="literal">NULL</code></a>)
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><em class="parameter"><code>value_help</code></em> :</span></p></td>
|
|
<td> return location for the value's translated help (or <a
|
|
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
|
|
><code class="literal">NULL</code></a>)
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
<td> <a
|
|
href="../glib/glib-Standard-Macros.html#TRUE:CAPS"
|
|
><code class="literal">TRUE</code></a> if <em class="parameter"><code>value</code></em> is valid for the <em class="parameter"><code>enum_type</code></em>,
|
|
<a
|
|
href="../glib/glib-Standard-Macros.html#FALSE:CAPS"
|
|
><code class="literal">FALSE</code></a> otherwise
|
|
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table></div>
|
|
<p class="since">Since GIMP 2.2
|
|
</p>
|
|
</div>
|
|
<hr>
|
|
<div class="refsect2" lang="en">
|
|
<a name="id2630158"></a><h3>
|
|
<a name="gimp-enum-value-get-desc"></a>gimp_enum_value_get_desc ()</h3>
|
|
<a class="indexterm" name="id2630170"></a><pre class="programlisting">const <a
|
|
href="../glib/glib-Basic-Types.html#gchar"
|
|
>gchar</a>* gimp_enum_value_get_desc (<a
|
|
href="../gobject/gobject-Enumeration-and-Flag-Types.html#GEnumClass"
|
|
>GEnumClass</a> *enum_class,
|
|
<a
|
|
href="../gobject/gobject-Enumeration-and-Flag-Types.html#GEnumValue"
|
|
>GEnumValue</a> *enum_value);</pre>
|
|
<p>
|
|
Retrieves the translated desc for a given <em class="parameter"><code>enum_value</code></em>.</p>
|
|
<p>
|
|
|
|
</p>
|
|
<div class="variablelist"><table border="0">
|
|
<col align="left" valign="top">
|
|
<tbody>
|
|
<tr>
|
|
<td><p><span class="term"><em class="parameter"><code>enum_class</code></em> :</span></p></td>
|
|
<td> a <a
|
|
href="../gobject/gobject-Enumeration-and-Flag-Types.html#GEnumClass"
|
|
><span class="type">GEnumClass</span></a>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><em class="parameter"><code>enum_value</code></em> :</span></p></td>
|
|
<td> a <a
|
|
href="../gobject/gobject-Enumeration-and-Flag-Types.html#GEnumValue"
|
|
><span class="type">GEnumValue</span></a> from <em class="parameter"><code>enum_class</code></em>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
<td> the translated desc of the enum value
|
|
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table></div>
|
|
<p class="since">Since GIMP 2.2
|
|
</p>
|
|
</div>
|
|
<hr>
|
|
<div class="refsect2" lang="en">
|
|
<a name="id2630274"></a><h3>
|
|
<a name="gimp-enum-value-get-help"></a>gimp_enum_value_get_help ()</h3>
|
|
<a class="indexterm" name="id2630287"></a><pre class="programlisting">const <a
|
|
href="../glib/glib-Basic-Types.html#gchar"
|
|
>gchar</a>* gimp_enum_value_get_help (<a
|
|
href="../gobject/gobject-Enumeration-and-Flag-Types.html#GEnumClass"
|
|
>GEnumClass</a> *enum_class,
|
|
<a
|
|
href="../gobject/gobject-Enumeration-and-Flag-Types.html#GEnumValue"
|
|
>GEnumValue</a> *enum_value);</pre>
|
|
<p>
|
|
Retrieves the translated help for a given <em class="parameter"><code>enum_value</code></em>.</p>
|
|
<p>
|
|
|
|
</p>
|
|
<div class="variablelist"><table border="0">
|
|
<col align="left" valign="top">
|
|
<tbody>
|
|
<tr>
|
|
<td><p><span class="term"><em class="parameter"><code>enum_class</code></em> :</span></p></td>
|
|
<td> a <a
|
|
href="../gobject/gobject-Enumeration-and-Flag-Types.html#GEnumClass"
|
|
><span class="type">GEnumClass</span></a>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><em class="parameter"><code>enum_value</code></em> :</span></p></td>
|
|
<td> a <a
|
|
href="../gobject/gobject-Enumeration-and-Flag-Types.html#GEnumValue"
|
|
><span class="type">GEnumValue</span></a> from <em class="parameter"><code>enum_class</code></em>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
<td> the translated help of the enum value
|
|
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table></div>
|
|
<p class="since">Since GIMP 2.2
|
|
</p>
|
|
</div>
|
|
<hr>
|
|
<div class="refsect2" lang="en">
|
|
<a name="id2630391"></a><h3>
|
|
<a name="gimp-flags-get-first-desc"></a>gimp_flags_get_first_desc ()</h3>
|
|
<a class="indexterm" name="id2630404"></a><pre class="programlisting"><a class="link" href="libgimpbase-gimpbasetypes.html#GimpFlagsDesc">GimpFlagsDesc</a>* gimp_flags_get_first_desc (<a
|
|
href="../gobject/gobject-Enumeration-and-Flag-Types.html#GFlagsClass"
|
|
>GFlagsClass</a> *flags_class,
|
|
<a
|
|
href="../glib/glib-Basic-Types.html#guint"
|
|
>guint</a> value);</pre>
|
|
<p>
|
|
Retrieves the first <a class="link" href="libgimpbase-gimpbasetypes.html#GimpFlagsDesc"><span class="type">GimpFlagsDesc</span></a> that matches the given value, or <a
|
|
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
|
|
><code class="literal">NULL</code></a>.</p>
|
|
<p>
|
|
|
|
</p>
|
|
<div class="variablelist"><table border="0">
|
|
<col align="left" valign="top">
|
|
<tbody>
|
|
<tr>
|
|
<td><p><span class="term"><em class="parameter"><code>flags_class</code></em> :</span></p></td>
|
|
<td> a <a
|
|
href="../gobject/gobject-Enumeration-and-Flag-Types.html#GFlagsClass"
|
|
><span class="type">GFlagsClass</span></a>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
|
|
<td> a value from <em class="parameter"><code>flags_class</code></em>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
<td> the value's <a class="link" href="libgimpbase-gimpbasetypes.html#GimpFlagsDesc"><span class="type">GimpFlagsDesc</span></a>.
|
|
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table></div>
|
|
<p class="since">Since GIMP 2.2
|
|
</p>
|
|
</div>
|
|
<hr>
|
|
<div class="refsect2" lang="en">
|
|
<a name="id2630516"></a><h3>
|
|
<a name="gimp-flags-get-first-value"></a>gimp_flags_get_first_value ()</h3>
|
|
<a class="indexterm" name="id2630529"></a><pre class="programlisting"><a
|
|
href="../glib/glib-Basic-Types.html#gboolean"
|
|
>gboolean</a> gimp_flags_get_first_value (<a
|
|
href="../gobject/gobject-Type-Information.html#GType"
|
|
>GType</a> flags_type,
|
|
<a
|
|
href="../glib/glib-Basic-Types.html#guint"
|
|
>guint</a> value,
|
|
const <a
|
|
href="../glib/glib-Basic-Types.html#gchar"
|
|
>gchar</a> **value_name,
|
|
const <a
|
|
href="../glib/glib-Basic-Types.html#gchar"
|
|
>gchar</a> **value_nick,
|
|
const <a
|
|
href="../glib/glib-Basic-Types.html#gchar"
|
|
>gchar</a> **value_desc,
|
|
const <a
|
|
href="../glib/glib-Basic-Types.html#gchar"
|
|
>gchar</a> **value_help);</pre>
|
|
<p>
|
|
Checks if <em class="parameter"><code>value</code></em> is valid for the flags registered as <em class="parameter"><code>flags_type</code></em>.
|
|
If the value exists in that flags, its name, nick and its translated
|
|
desc and help are returned (if <em class="parameter"><code>value_name</code></em>, <em class="parameter"><code>value_nick</code></em>, <em class="parameter"><code>value_desc</code></em>
|
|
and <em class="parameter"><code>value_help</code></em> are not <a
|
|
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
|
|
><code class="literal">NULL</code></a>).</p>
|
|
<p>
|
|
|
|
</p>
|
|
<div class="variablelist"><table border="0">
|
|
<col align="left" valign="top">
|
|
<tbody>
|
|
<tr>
|
|
<td><p><span class="term"><em class="parameter"><code>flags_type</code></em> :</span></p></td>
|
|
<td> the <a
|
|
href="../gobject/gobject-Type-Information.html#GType"
|
|
><span class="type">GType</span></a> of registered flags
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
|
|
<td> an integer value
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><em class="parameter"><code>value_name</code></em> :</span></p></td>
|
|
<td> return location for the value's name (or <a
|
|
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
|
|
><code class="literal">NULL</code></a>)
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><em class="parameter"><code>value_nick</code></em> :</span></p></td>
|
|
<td> return location for the value's nick (or <a
|
|
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
|
|
><code class="literal">NULL</code></a>)
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><em class="parameter"><code>value_desc</code></em> :</span></p></td>
|
|
<td> return location for the value's translated desc (or <a
|
|
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
|
|
><code class="literal">NULL</code></a>)
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><em class="parameter"><code>value_help</code></em> :</span></p></td>
|
|
<td> return location for the value's translated help (or <a
|
|
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
|
|
><code class="literal">NULL</code></a>)
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
<td> <a
|
|
href="../glib/glib-Standard-Macros.html#TRUE:CAPS"
|
|
><code class="literal">TRUE</code></a> if <em class="parameter"><code>value</code></em> is valid for the <em class="parameter"><code>flags_type</code></em>,
|
|
<a
|
|
href="../glib/glib-Standard-Macros.html#FALSE:CAPS"
|
|
><code class="literal">FALSE</code></a> otherwise
|
|
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table></div>
|
|
<p class="since">Since GIMP 2.2
|
|
</p>
|
|
</div>
|
|
<hr>
|
|
<div class="refsect2" lang="en">
|
|
<a name="id2630797"></a><h3>
|
|
<a name="gimp-flags-value-get-desc"></a>gimp_flags_value_get_desc ()</h3>
|
|
<a class="indexterm" name="id2630810"></a><pre class="programlisting">const <a
|
|
href="../glib/glib-Basic-Types.html#gchar"
|
|
>gchar</a>* gimp_flags_value_get_desc (<a
|
|
href="../gobject/gobject-Enumeration-and-Flag-Types.html#GFlagsClass"
|
|
>GFlagsClass</a> *flags_class,
|
|
<a
|
|
href="../gobject/gobject-Enumeration-and-Flag-Types.html#GFlagsValue"
|
|
>GFlagsValue</a> *flags_value);</pre>
|
|
<p>
|
|
Retrieves the translated desc for a given <em class="parameter"><code>flags_value</code></em>.</p>
|
|
<p>
|
|
|
|
</p>
|
|
<div class="variablelist"><table border="0">
|
|
<col align="left" valign="top">
|
|
<tbody>
|
|
<tr>
|
|
<td><p><span class="term"><em class="parameter"><code>flags_class</code></em> :</span></p></td>
|
|
<td> a <a
|
|
href="../gobject/gobject-Enumeration-and-Flag-Types.html#GFlagsClass"
|
|
><span class="type">GFlagsClass</span></a>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><em class="parameter"><code>flags_value</code></em> :</span></p></td>
|
|
<td> a <a
|
|
href="../gobject/gobject-Enumeration-and-Flag-Types.html#GFlagsValue"
|
|
><span class="type">GFlagsValue</span></a> from <em class="parameter"><code>flags_class</code></em>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
<td> the translated desc of the flags value
|
|
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table></div>
|
|
<p class="since">Since GIMP 2.2
|
|
</p>
|
|
</div>
|
|
<hr>
|
|
<div class="refsect2" lang="en">
|
|
<a name="id2630915"></a><h3>
|
|
<a name="gimp-flags-value-get-help"></a>gimp_flags_value_get_help ()</h3>
|
|
<a class="indexterm" name="id2630928"></a><pre class="programlisting">const <a
|
|
href="../glib/glib-Basic-Types.html#gchar"
|
|
>gchar</a>* gimp_flags_value_get_help (<a
|
|
href="../gobject/gobject-Enumeration-and-Flag-Types.html#GFlagsClass"
|
|
>GFlagsClass</a> *flags_class,
|
|
<a
|
|
href="../gobject/gobject-Enumeration-and-Flag-Types.html#GFlagsValue"
|
|
>GFlagsValue</a> *flags_value);</pre>
|
|
<p>
|
|
Retrieves the translated help for a given <em class="parameter"><code>flags_value</code></em>.</p>
|
|
<p>
|
|
|
|
</p>
|
|
<div class="variablelist"><table border="0">
|
|
<col align="left" valign="top">
|
|
<tbody>
|
|
<tr>
|
|
<td><p><span class="term"><em class="parameter"><code>flags_class</code></em> :</span></p></td>
|
|
<td> a <a
|
|
href="../gobject/gobject-Enumeration-and-Flag-Types.html#GFlagsClass"
|
|
><span class="type">GFlagsClass</span></a>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><em class="parameter"><code>flags_value</code></em> :</span></p></td>
|
|
<td> a <a
|
|
href="../gobject/gobject-Enumeration-and-Flag-Types.html#GFlagsValue"
|
|
><span class="type">GFlagsValue</span></a> from <em class="parameter"><code>flags_class</code></em>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
|
<td> the translated help of the flags value
|
|
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table></div>
|
|
<p class="since">Since GIMP 2.2
|
|
</p>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html>
|