53 lines
7.4 KiB
HTML
53 lines
7.4 KiB
HTML
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>gimpmemsize</title><meta name="generator" content="DocBook XSL Stylesheets V1.66.1"><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-gimpenv.html" title="gimpenv"><link rel="next" href="libgimpbase-gimpparasite.html" title="gimpparasite"><meta name="generator" content="GTK-Doc V1.3 (XML mode)"><link rel="stylesheet" href="style.css" type="text/css"><link rel="part" href="libgimpbase.html" title="Part I. GIMP Base Library"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libgimpbase-gimpenv.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-gimpparasite.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry" lang="en"><a name="libgimpbase-gimpmemsize"></a><div class="titlepage"></div><div class="refnamediv"><table width="100%"><tr><td valign="top"><h2><span class="refentrytitle">gimpmemsize</span></h2><p>gimpmemsize — Functions to (de)serialize a given memory size.</p></td><td valign="top" align="right"></td></tr></table></div><div class="refsynopsisdiv"><h2>Synopsis</h2><pre class="synopsis">
|
||
|
||
|
||
|
||
gchar* <a href="libgimpbase-gimpmemsize.html#gimp-memsize-serialize">gimp_memsize_serialize</a> (guint64 memsize);
|
||
gboolean <a href="libgimpbase-gimpmemsize.html#gimp-memsize-deserialize">gimp_memsize_deserialize</a> (const gchar *string,
|
||
guint64 *memsize);
|
||
gchar* <a href="libgimpbase-gimpmemsize.html#gimp-memsize-to-string">gimp_memsize_to_string</a> (guint64 memsize);
|
||
#define <a href="libgimpbase-gimpmemsize.html#GIMP-TYPE-MEMSIZE:CAPS">GIMP_TYPE_MEMSIZE</a>
|
||
#define <a href="libgimpbase-gimpmemsize.html#GIMP-VALUE-HOLDS-MEMSIZE:CAPS">GIMP_VALUE_HOLDS_MEMSIZE</a> (value)
|
||
|
||
</pre></div><div class="refsect1" lang="en"><a name="id2531440"></a><h2>Description</h2><p>
|
||
Functions to (de)serialize a given memory size.
|
||
</p></div><div class="refsect1" lang="en"><a name="id2531450"></a><h2>Details</h2><div class="refsect2" lang="en"><a name="id2531456"></a><h3><a name="gimp-memsize-serialize"></a>gimp_memsize_serialize ()</h3><a class="indexterm" name="id2531464"></a><pre class="programlisting">gchar* gimp_memsize_serialize (guint64 memsize);</pre><p>
|
||
Creates a string representation of a given memory size. This string
|
||
can be parsed by <a href="libgimpbase-gimpmemsize.html#gimp-memsize-deserialize"><tt class="function">gimp_memsize_deserialize()</tt></a> and can thus be used in
|
||
config files. It should not be displayed to the user. If you need a
|
||
nice human-readable string please use <a href="libgimpbase-gimpmemsize.html#gimp-memsize-to-string"><tt class="function">gimp_memsize_to_string()</tt></a>.</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>memsize</tt></i> :</span></td><td> memory size in bytes
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> A newly allocated string representation of <i class="parameter"><tt>memsize</tt></i>.
|
||
|
||
</td></tr></tbody></table></div><p>Since GIMP 2.2
|
||
</p></div><hr><div class="refsect2" lang="en"><a name="id2545897"></a><h3><a name="gimp-memsize-deserialize"></a>gimp_memsize_deserialize ()</h3><a class="indexterm" name="id2545906"></a><pre class="programlisting">gboolean gimp_memsize_deserialize (const gchar *string,
|
||
guint64 *memsize);</pre><p>
|
||
Parses a string representation of a memory size as returned by
|
||
<a href="libgimpbase-gimpmemsize.html#gimp-memsize-serialize"><tt class="function">gimp_memsize_serialize()</tt></a>.</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>string</tt></i> :</span></td><td> a string as returned by <a href="libgimpbase-gimpmemsize.html#gimp-memsize-serialize"><tt class="function">gimp_memsize_serialize()</tt></a>
|
||
</td></tr><tr><td><span class="term"><i class="parameter"><tt>memsize</tt></i> :</span></td><td> return location for memory size in bytes
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> <tt class="literal">TRUE</tt> if the <i class="parameter"><tt>string</tt></i> was successfully parsed and
|
||
<i class="parameter"><tt>memsize</tt></i> has been set, <tt class="literal">FALSE</tt> otherwise.
|
||
|
||
</td></tr></tbody></table></div><p>Since GIMP 2.2
|
||
</p></div><hr><div class="refsect2" lang="en"><a name="id2564621"></a><h3><a name="gimp-memsize-to-string"></a>gimp_memsize_to_string ()</h3><a class="indexterm" name="id2564629"></a><pre class="programlisting">gchar* gimp_memsize_to_string (guint64 memsize);</pre><p>
|
||
This function returns a human readable, translated representation
|
||
of the passed <i class="parameter"><tt>memsize</tt></i>. Large values are displayed using a
|
||
reasonable memsize unit, e.g.: "345" becomes "345 Bytes", "4500"
|
||
becomes "4.4 KB" and so on.</p><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>memsize</tt></i> :</span></td><td> A memory size in bytes.
|
||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> A newly allocated human-readable, translated string.
|
||
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2564684"></a><h3><a name="GIMP-TYPE-MEMSIZE:CAPS"></a>GIMP_TYPE_MEMSIZE</h3><a class="indexterm" name="id2564692"></a><pre class="programlisting">#define GIMP_TYPE_MEMSIZE (gimp_memsize_get_type ())
|
||
</pre><p>
|
||
<a href="libgimpbase-gimpmemsize.html#GIMP-TYPE-MEMSIZE:CAPS"><span class="type">GIMP_TYPE_MEMSIZE</span></a> is a <span class="type">GType</span> derived from <span class="type">G_TYPE_UINT64</span>.
|
||
</p></div><hr><div class="refsect2" lang="en"><a name="id2583391"></a><h3><a name="GIMP-VALUE-HOLDS-MEMSIZE:CAPS"></a>GIMP_VALUE_HOLDS_MEMSIZE()</h3><a class="indexterm" name="id2583399"></a><pre class="programlisting">#define GIMP_VALUE_HOLDS_MEMSIZE(value) (G_TYPE_CHECK_VALUE_TYPE ((value), GIMP_TYPE_MEMSIZE))
|
||
</pre><p>
|
||
|
||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>value</tt></i> :</span></td><td>
|
||
|
||
|
||
</td></tr></tbody></table></div></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libgimpbase-gimpenv.html"><b><< gimpenv</b></a></td><td align="right"><a accesskey="n" href="libgimpbase-gimpparasite.html"><b>gimpparasite >></b></a></td></tr></table></body></html>
|