gdk-colormaps-and-colors.html

最新gtk中文资料集

<td><p><span class="term"><em class="parameter"><code>allocate</code></em>&#160;:</span></p></td>
<td> if <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a>, the newly created colormap will be
a private colormap, and all colors in it will be
allocated for the applications use.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> the new <a class="link" href="gdk-Colormaps-and-Colors.html#GdkColormap"><span class="type">GdkColormap</span></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3146585"></a><h3>
<a name="gdk-colormap-ref"></a>gdk_colormap_ref ()</h3>
<a class="indexterm" name="id3146600"></a><pre class="programlisting"><a class="link" href="gdk-Colormaps-and-Colors.html#GdkColormap">GdkColormap</a>*        gdk_colormap_ref                    (<a class="link" href="gdk-Colormaps-and-Colors.html#GdkColormap">GdkColormap</a> *cmap);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gdk_colormap_ref</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Deprecated function; use <a
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-ref"
><code class="function">g_object_ref()</code></a> instead.</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>cmap</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="gdk-Colormaps-and-Colors.html#GdkColormap"><span class="type">GdkColormap</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> the colormap
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3146691"></a><h3>
<a name="gdk-colormap-unref"></a>gdk_colormap_unref ()</h3>
<a class="indexterm" name="id3146707"></a><pre class="programlisting">void                gdk_colormap_unref                  (<a class="link" href="gdk-Colormaps-and-Colors.html#GdkColormap">GdkColormap</a> *cmap);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gdk_colormap_unref</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Deprecated function; use <a
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-ref"
><code class="function">g_object_ref()</code></a> instead.</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>cmap</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="gdk-Colormaps-and-Colors.html#GdkColormap"><span class="type">GdkColormap</span></a>
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3146787"></a><h3>
<a name="gdk-colormap-get-system"></a>gdk_colormap_get_system ()</h3>
<a class="indexterm" name="id3146801"></a><pre class="programlisting"><a class="link" href="gdk-Colormaps-and-Colors.html#GdkColormap">GdkColormap</a>*        gdk_colormap_get_system             (void);</pre>
<p>
Gets the system's default colormap for the default screen. (See
<code class="function">gdk_colormap_get_system_for_screen()</code>)</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> the default colormap.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3146855"></a><h3>
<a name="gdk-colormap-get-system-size"></a>gdk_colormap_get_system_size ()</h3>
<a class="indexterm" name="id3146870"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a>                gdk_colormap_get_system_size        (void);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gdk_colormap_get_system_size</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Returns the size of the system's default colormap.
(See the description of struct <a class="link" href="gdk-Colormaps-and-Colors.html#GdkColormap"><span class="type">GdkColormap</span></a> for an
explanation of the size of a colormap.)</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> the size of the system's default colormap.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3146933"></a><h3>
<a name="gdk-colormap-change"></a>gdk_colormap_change ()</h3>
<a class="indexterm" name="id3146948"></a><pre class="programlisting">void                gdk_colormap_change                 (<a class="link" href="gdk-Colormaps-and-Colors.html#GdkColormap">GdkColormap</a> *colormap,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> ncolors);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gdk_colormap_change</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Changes the value of the first <em class="parameter"><code>ncolors</code></em> in a private colormap
to match the values in the <em class="structfield"><code>colors</code></em>
array in the colormap. This function is obsolete and
should not be used. See <a class="link" href="gdk-Colormaps-and-Colors.html#gdk-color-change"><code class="function">gdk_color_change()</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>colormap</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="gdk-Colormaps-and-Colors.html#GdkColormap"><span class="type">GdkColormap</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>ncolors</code></em>&#160;:</span></p></td>
<td> the number of colors to change.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3147062"></a><h3>
<a name="gdk-colormap-alloc-colors"></a>gdk_colormap_alloc_colors ()</h3>
<a class="indexterm" name="id3147076"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a>                gdk_colormap_alloc_colors           (<a class="link" href="gdk-Colormaps-and-Colors.html#GdkColormap">GdkColormap</a> *colormap,
                                                         <a class="link" href="gdk-Colormaps-and-Colors.html#GdkColor">GdkColor</a> *colors,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> ncolors,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> writeable,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> best_match,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> *success);</pre>
<p>
Allocates colors from a colormap.</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>colormap</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="gdk-Colormaps-and-Colors.html#GdkColormap"><span class="type">GdkColormap</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>colors</code></em>&#160;:</span></p></td>
<td> The color values to allocate. On return, the pixel
   values for allocated colors will be filled in.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>ncolors</code></em>&#160;:</span></p></td>
<td> The number of colors in <em class="parameter"><code>colors</code></em>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>writeable</code></em>&#160;:</span></p></td>
<td> If <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a>, the colors are allocated writeable
   (their values can later be changed using <a class="link" href="gdk-Colormaps-and-Colors.html#gdk-color-change"><code class="function">gdk_color_change()</code></a>).
   Writeable colors cannot be shared between applications.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>best_match</code></em>&#160;:</span></p></td>
<td> If <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a>, GDK will attempt to do matching against
   existing colors if the colors cannot be allocated as requested.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>success</code></em>&#160;:</span></p></td>
<td> An array of length <em class="parameter"><code>ncolors</code></em>. On return, this
  indicates whether the corresponding color in <em class="parameter"><code>colors</code></em> was
  successfully allocated or not.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> The number of colors that were not successfully 
allocated.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3147310"></a><h3>
<a name="gdk-colormap-alloc-color"></a>gdk_colormap_alloc_color ()</h3>
<a class="indexterm" name="id3147323"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            gdk_colormap_alloc_color            (<a class="link" href="gdk-Colormaps-and-Colors.html#GdkColormap">GdkColormap</a> *colormap,
                                                         <a class="link" href="gdk-Colormaps-and-Colors.html#GdkColor">GdkColor</a> *color,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> writeable,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> best_match);</pre>
<p>
Allocates a single color from a colormap.</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>colormap</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="gdk-Colormaps-and-Colors.html#GdkColormap"><span class="type">GdkColormap</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>color</code></em>&#160;:</span></p></td>
<td> the color to allocate. On return the
   <em class="structfield"><code>pixel</code></em> field will be
   filled in if allocation succeeds.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>writeable</code></em>&#160;:</span></p></td>
<td> If <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a>, the color is allocated writeable
   (their values can later be changed using <a class="link" href="gdk-Colormaps-and-Colors.html#gdk-color-change"><code class="function">gdk_color_change()</code></a>).
   Writeable colors cannot be shared between applications.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>best_match</code></em>&#160;:</span></p></td>
<td> If <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a>, GDK will attempt to do matching against
   existing colors if the color cannot be allocated as requested.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> if the allocation succeeded.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3147507"></a><h3>
<a name="gdk-colormap-free-colors"></a>gdk_colormap_free_colors ()</h3>
<a class="indexterm" name="id3147520"></a><pre class="programlisting">void                gdk_colormap_free_colors            (<a class="link" href="gdk-Colormaps-and-Colors.html#GdkColormap">GdkColormap</a> *colormap,
                                                         <a class="link" href="gdk-Colormaps-and-Colors.html#GdkColor">GdkColor</a> *colors,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> ncolors);</pre>
<p>
Frees previously allocated colors.</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>colormap</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="gdk-Colormaps-and-Colors.html#GdkColormap"><span class="type">GdkColormap</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>colors</code></em>&#160;:</span></p></td>
<td> the colors to free.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>ncolors</code></em>&#160;:</span></p></td>
<td> the number of colors in <em class="parameter"><code>colors</code></em>.
</td>
</tr>
</tbody>