~ubuntu-branches/ubuntu/raring/gtk+2.0/raring-proposed

« back to all changes in this revision

Viewing changes to docs/reference/gdk/html/gdk-Visuals.html

  • Committer: Package Import Robot
  • Author(s): Ken VanDine
  • Date: 2011-12-01 11:40:06 UTC
  • mfrom: (1.14.11)
  • Revision ID: package-import@ubuntu.com-20111201114006-nrmf6qu3pg512veo
Tags: 2.24.8-0ubuntu1
* New upstream release 
  - gtkfilechooser should be more robust to malformed URIs
    in .gtk-bookmarks (LP: #189494)
* debian/patches/010_make_bg_changes_queue_repaint.patch
  - dropped it introduces performance regressions in some gtk2 
    apps (LP: #889019)
* 101_filechooser.patch, 000git_file_chooser.patch: dropped, upstream

Show diffs side-by-side

added added

removed removed

Lines of Context:
8
8
<link rel="up" href="reference.html" title="API Reference">
9
9
<link rel="prev" href="gdk-Colormaps-and-Colors.html" title="Colormaps and Colors">
10
10
<link rel="next" href="gdk-Fonts.html" title="Fonts">
11
 
<meta name="generator" content="GTK-Doc V1.17.1 (XML mode)">
 
11
<meta name="generator" content="GTK-Doc V1.17 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
13
</head>
14
14
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
43
43
                    <a class="link" href="gdk-Visuals.html#GdkVisual" title="GdkVisual">GdkVisual</a>;
44
44
enum                <a class="link" href="gdk-Visuals.html#GdkVisualType" title="enum GdkVisualType">GdkVisualType</a>;
45
45
enum                <a class="link" href="gdk-Visuals.html#GdkByteOrder" title="enum GdkByteOrder">GdkByteOrder</a>;
46
 
<span class="returnvalue">void</span>                <a class="link" href="gdk-Visuals.html#gdk-query-depths" title="gdk_query_depths ()">gdk_query_depths</a>                    (<em class="parameter"><code><span class="type">gint</span> **depths</code></em>,
47
 
                                                         <em class="parameter"><code><span class="type">gint</span> *count</code></em>);
 
46
<span class="returnvalue">void</span>                <a class="link" href="gdk-Visuals.html#gdk-query-depths" title="gdk_query_depths ()">gdk_query_depths</a>                    (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> **depths</code></em>,
 
47
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *count</code></em>);
48
48
<span class="returnvalue">void</span>                <a class="link" href="gdk-Visuals.html#gdk-query-visual-types" title="gdk_query_visual_types ()">gdk_query_visual_types</a>              (<em class="parameter"><code><a class="link" href="gdk-Visuals.html#GdkVisualType" title="enum GdkVisualType"><span class="type">GdkVisualType</span></a> **visual_types</code></em>,
49
 
                                                         <em class="parameter"><code><span class="type">gint</span> *count</code></em>);
50
 
<span class="returnvalue">GList</span> *             <a class="link" href="gdk-Visuals.html#gdk-list-visuals" title="gdk_list_visuals ()">gdk_list_visuals</a>                    (<em class="parameter"><code><span class="type">void</span></code></em>);
51
 
<span class="returnvalue">gint</span>                <a class="link" href="gdk-Visuals.html#gdk-visual-get-best-depth" title="gdk_visual_get_best_depth ()">gdk_visual_get_best_depth</a>           (<em class="parameter"><code><span class="type">void</span></code></em>);
 
49
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *count</code></em>);
 
50
<a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *             <a class="link" href="gdk-Visuals.html#gdk-list-visuals" title="gdk_list_visuals ()">gdk_list_visuals</a>                    (<em class="parameter"><code><span class="type">void</span></code></em>);
 
51
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                <a class="link" href="gdk-Visuals.html#gdk-visual-get-best-depth" title="gdk_visual_get_best_depth ()">gdk_visual_get_best_depth</a>           (<em class="parameter"><code><span class="type">void</span></code></em>);
52
52
<a class="link" href="gdk-Visuals.html#GdkVisualType" title="enum GdkVisualType"><span class="returnvalue">GdkVisualType</span></a>       <a class="link" href="gdk-Visuals.html#gdk-visual-get-best-type" title="gdk_visual_get_best_type ()">gdk_visual_get_best_type</a>            (<em class="parameter"><code><span class="type">void</span></code></em>);
53
53
<a class="link" href="gdk-Visuals.html#GdkVisual" title="GdkVisual"><span class="returnvalue">GdkVisual</span></a> *         <a class="link" href="gdk-Visuals.html#gdk-visual-get-system" title="gdk_visual_get_system ()">gdk_visual_get_system</a>               (<em class="parameter"><code><span class="type">void</span></code></em>);
54
54
<a class="link" href="gdk-Visuals.html#GdkVisual" title="GdkVisual"><span class="returnvalue">GdkVisual</span></a> *         <a class="link" href="gdk-Visuals.html#gdk-visual-get-best" title="gdk_visual_get_best ()">gdk_visual_get_best</a>                 (<em class="parameter"><code><span class="type">void</span></code></em>);
55
 
<a class="link" href="gdk-Visuals.html#GdkVisual" title="GdkVisual"><span class="returnvalue">GdkVisual</span></a> *         <a class="link" href="gdk-Visuals.html#gdk-visual-get-best-with-depth" title="gdk_visual_get_best_with_depth ()">gdk_visual_get_best_with_depth</a>      (<em class="parameter"><code><span class="type">gint</span> depth</code></em>);
 
55
<a class="link" href="gdk-Visuals.html#GdkVisual" title="GdkVisual"><span class="returnvalue">GdkVisual</span></a> *         <a class="link" href="gdk-Visuals.html#gdk-visual-get-best-with-depth" title="gdk_visual_get_best_with_depth ()">gdk_visual_get_best_with_depth</a>      (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> depth</code></em>);
56
56
<a class="link" href="gdk-Visuals.html#GdkVisual" title="GdkVisual"><span class="returnvalue">GdkVisual</span></a> *         <a class="link" href="gdk-Visuals.html#gdk-visual-get-best-with-type" title="gdk_visual_get_best_with_type ()">gdk_visual_get_best_with_type</a>       (<em class="parameter"><code><a class="link" href="gdk-Visuals.html#GdkVisualType" title="enum GdkVisualType"><span class="type">GdkVisualType</span></a> visual_type</code></em>);
57
 
<a class="link" href="gdk-Visuals.html#GdkVisual" title="GdkVisual"><span class="returnvalue">GdkVisual</span></a> *         <a class="link" href="gdk-Visuals.html#gdk-visual-get-best-with-both" title="gdk_visual_get_best_with_both ()">gdk_visual_get_best_with_both</a>       (<em class="parameter"><code><span class="type">gint</span> depth</code></em>,
 
57
<a class="link" href="gdk-Visuals.html#GdkVisual" title="GdkVisual"><span class="returnvalue">GdkVisual</span></a> *         <a class="link" href="gdk-Visuals.html#gdk-visual-get-best-with-both" title="gdk_visual_get_best_with_both ()">gdk_visual_get_best_with_both</a>       (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> depth</code></em>,
58
58
                                                         <em class="parameter"><code><a class="link" href="gdk-Visuals.html#GdkVisualType" title="enum GdkVisualType"><span class="type">GdkVisualType</span></a> visual_type</code></em>);
59
59
#define             <a class="link" href="gdk-Visuals.html#gdk-visual-ref" title="gdk_visual_ref()">gdk_visual_ref</a>                      (v)
60
60
#define             <a class="link" href="gdk-Visuals.html#gdk-visual-unref" title="gdk_visual_unref()">gdk_visual_unref</a>                    (v)
61
61
<a class="link" href="GdkScreen.html" title="GdkScreen"><span class="returnvalue">GdkScreen</span></a> *         <a class="link" href="gdk-Visuals.html#gdk-visual-get-screen" title="gdk_visual_get_screen ()">gdk_visual_get_screen</a>               (<em class="parameter"><code><a class="link" href="gdk-Visuals.html#GdkVisual" title="GdkVisual"><span class="type">GdkVisual</span></a> *visual</code></em>);
62
 
<span class="returnvalue">gint</span>                <a class="link" href="gdk-Visuals.html#gdk-visual-get-bits-per-rgb" title="gdk_visual_get_bits_per_rgb ()">gdk_visual_get_bits_per_rgb</a>         (<em class="parameter"><code><a class="link" href="gdk-Visuals.html#GdkVisual" title="GdkVisual"><span class="type">GdkVisual</span></a> *visual</code></em>);
 
62
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                <a class="link" href="gdk-Visuals.html#gdk-visual-get-bits-per-rgb" title="gdk_visual_get_bits_per_rgb ()">gdk_visual_get_bits_per_rgb</a>         (<em class="parameter"><code><a class="link" href="gdk-Visuals.html#GdkVisual" title="GdkVisual"><span class="type">GdkVisual</span></a> *visual</code></em>);
63
63
<span class="returnvalue">void</span>                <a class="link" href="gdk-Visuals.html#gdk-visual-get-blue-pixel-details" title="gdk_visual_get_blue_pixel_details ()">gdk_visual_get_blue_pixel_details</a>   (<em class="parameter"><code><a class="link" href="gdk-Visuals.html#GdkVisual" title="GdkVisual"><span class="type">GdkVisual</span></a> *visual</code></em>,
64
 
                                                         <em class="parameter"><code><span class="type">guint32</span> *mask</code></em>,
65
 
                                                         <em class="parameter"><code><span class="type">gint</span> *shift</code></em>,
66
 
                                                         <em class="parameter"><code><span class="type">gint</span> *precision</code></em>);
 
64
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> *mask</code></em>,
 
65
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *shift</code></em>,
 
66
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *precision</code></em>);
67
67
<a class="link" href="gdk-Visuals.html#GdkByteOrder" title="enum GdkByteOrder"><span class="returnvalue">GdkByteOrder</span></a>        <a class="link" href="gdk-Visuals.html#gdk-visual-get-byte-order" title="gdk_visual_get_byte_order ()">gdk_visual_get_byte_order</a>           (<em class="parameter"><code><a class="link" href="gdk-Visuals.html#GdkVisual" title="GdkVisual"><span class="type">GdkVisual</span></a> *visual</code></em>);
68
 
<span class="returnvalue">gint</span>                <a class="link" href="gdk-Visuals.html#gdk-visual-get-colormap-size" title="gdk_visual_get_colormap_size ()">gdk_visual_get_colormap_size</a>        (<em class="parameter"><code><a class="link" href="gdk-Visuals.html#GdkVisual" title="GdkVisual"><span class="type">GdkVisual</span></a> *visual</code></em>);
69
 
<span class="returnvalue">gint</span>                <a class="link" href="gdk-Visuals.html#gdk-visual-get-depth" title="gdk_visual_get_depth ()">gdk_visual_get_depth</a>                (<em class="parameter"><code><a class="link" href="gdk-Visuals.html#GdkVisual" title="GdkVisual"><span class="type">GdkVisual</span></a> *visual</code></em>);
 
68
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                <a class="link" href="gdk-Visuals.html#gdk-visual-get-colormap-size" title="gdk_visual_get_colormap_size ()">gdk_visual_get_colormap_size</a>        (<em class="parameter"><code><a class="link" href="gdk-Visuals.html#GdkVisual" title="GdkVisual"><span class="type">GdkVisual</span></a> *visual</code></em>);
 
69
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                <a class="link" href="gdk-Visuals.html#gdk-visual-get-depth" title="gdk_visual_get_depth ()">gdk_visual_get_depth</a>                (<em class="parameter"><code><a class="link" href="gdk-Visuals.html#GdkVisual" title="GdkVisual"><span class="type">GdkVisual</span></a> *visual</code></em>);
70
70
<span class="returnvalue">void</span>                <a class="link" href="gdk-Visuals.html#gdk-visual-get-green-pixel-details" title="gdk_visual_get_green_pixel_details ()">gdk_visual_get_green_pixel_details</a>  (<em class="parameter"><code><a class="link" href="gdk-Visuals.html#GdkVisual" title="GdkVisual"><span class="type">GdkVisual</span></a> *visual</code></em>,
71
 
                                                         <em class="parameter"><code><span class="type">guint32</span> *mask</code></em>,
72
 
                                                         <em class="parameter"><code><span class="type">gint</span> *shift</code></em>,
73
 
                                                         <em class="parameter"><code><span class="type">gint</span> *precision</code></em>);
 
71
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> *mask</code></em>,
 
72
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *shift</code></em>,
 
73
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *precision</code></em>);
74
74
<span class="returnvalue">void</span>                <a class="link" href="gdk-Visuals.html#gdk-visual-get-red-pixel-details" title="gdk_visual_get_red_pixel_details ()">gdk_visual_get_red_pixel_details</a>    (<em class="parameter"><code><a class="link" href="gdk-Visuals.html#GdkVisual" title="GdkVisual"><span class="type">GdkVisual</span></a> *visual</code></em>,
75
 
                                                         <em class="parameter"><code><span class="type">guint32</span> *mask</code></em>,
76
 
                                                         <em class="parameter"><code><span class="type">gint</span> *shift</code></em>,
77
 
                                                         <em class="parameter"><code><span class="type">gint</span> *precision</code></em>);
 
75
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> *mask</code></em>,
 
76
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *shift</code></em>,
 
77
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *precision</code></em>);
78
78
<a class="link" href="gdk-Visuals.html#GdkVisualType" title="enum GdkVisualType"><span class="returnvalue">GdkVisualType</span></a>       <a class="link" href="gdk-Visuals.html#gdk-visual-get-visual-type" title="gdk_visual_get_visual_type ()">gdk_visual_get_visual_type</a>          (<em class="parameter"><code><a class="link" href="gdk-Visuals.html#GdkVisual" title="GdkVisual"><span class="type">GdkVisual</span></a> *visual</code></em>);
79
79
</pre>
80
80
</div>
164
164
6
165
165
7
166
166
8</pre></td>
167
 
        <td class="listing_code"><pre class="programlisting"><span class="normal">guint</span>
 
167
        <td class="listing_code"><pre class="programlisting"><span class="normal"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a></span>
168
168
<span class="function">pixel_from_rgb</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GdkVisual</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">visual</span><span class="symbol">,</span>
169
169
<span class="normal">                </span><span class="usertype">guchar</span><span class="normal"> r</span><span class="symbol">,</span><span class="normal"> </span><span class="usertype">guchar</span><span class="normal"> b</span><span class="symbol">,</span><span class="normal"> </span><span class="usertype">guchar</span><span class="normal"> g</span><span class="symbol">)</span>
170
170
<span class="cbracket">{</span>
181
181
<br class="example-break"><div class="variablelist"><table border="0">
182
182
<col align="left" valign="top">
183
183
<tbody><tr>
184
 
<td><p><span class="term"><span class="type">GObject</span> <em class="structfield"><code><a name="GdkVisual.parent-instance"></a>parent_instance</code></em>;</span></p></td>
185
 
<td>inherited portion from <span class="type">GObject</span>
 
184
<td><p><span class="term"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> <em class="structfield"><code><a name="GdkVisual.parent-instance"></a>parent_instance</code></em>;</span></p></td>
 
185
<td>inherited portion from <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>
186
186
</td>
187
187
</tr></tbody>
188
188
</table></div>
286
286
<hr>
287
287
<div class="refsect2">
288
288
<a name="gdk-query-depths"></a><h3>gdk_query_depths ()</h3>
289
 
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_query_depths                    (<em class="parameter"><code><span class="type">gint</span> **depths</code></em>,
290
 
                                                         <em class="parameter"><code><span class="type">gint</span> *count</code></em>);</pre>
 
289
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_query_depths                    (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> **depths</code></em>,
 
290
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *count</code></em>);</pre>
291
291
<p>
292
292
This function returns the available bit depths for the default
293
293
screen. It's equivalent to listing the visuals
317
317
<div class="refsect2">
318
318
<a name="gdk-query-visual-types"></a><h3>gdk_query_visual_types ()</h3>
319
319
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_query_visual_types              (<em class="parameter"><code><a class="link" href="gdk-Visuals.html#GdkVisualType" title="enum GdkVisualType"><span class="type">GdkVisualType</span></a> **visual_types</code></em>,
320
 
                                                         <em class="parameter"><code><span class="type">gint</span> *count</code></em>);</pre>
 
320
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *count</code></em>);</pre>
321
321
<p>
322
322
This function returns the available visual types for the default
323
323
screen. It's equivalent to listing the visuals
344
344
<hr>
345
345
<div class="refsect2">
346
346
<a name="gdk-list-visuals"></a><h3>gdk_list_visuals ()</h3>
347
 
<pre class="programlisting"><span class="returnvalue">GList</span> *             gdk_list_visuals                    (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 
347
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *             gdk_list_visuals                    (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
348
348
<p>
349
349
Lists the available visuals for the default screen.
350
350
(See <a class="link" href="GdkScreen.html#gdk-screen-list-visuals" title="gdk_screen_list_visuals ()"><code class="function">gdk_screen_list_visuals()</code></a>)
353
353
and might expect pixels to be in a certain format.
354
354
</p>
355
355
<p>
356
 
Call <code class="function">g_list_free()</code> on the return value when you're finished with it.
 
356
Call <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#g-list-free"><code class="function">g_list_free()</code></a> on the return value when you're finished with it.
357
357
</p>
358
358
<div class="variablelist"><table border="0">
359
359
<col align="left" valign="top">
367
367
<hr>
368
368
<div class="refsect2">
369
369
<a name="gdk-visual-get-best-depth"></a><h3>gdk_visual_get_best_depth ()</h3>
370
 
<pre class="programlisting"><span class="returnvalue">gint</span>                gdk_visual_get_best_depth           (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 
370
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                gdk_visual_get_best_depth           (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
371
371
<p>
372
372
Get the best available depth for the default GDK screen.  "Best"
373
373
means "largest," i.e. 32 preferred over 24 preferred over 8 bits
434
434
<hr>
435
435
<div class="refsect2">
436
436
<a name="gdk-visual-get-best-with-depth"></a><h3>gdk_visual_get_best_with_depth ()</h3>
437
 
<pre class="programlisting"><a class="link" href="gdk-Visuals.html#GdkVisual" title="GdkVisual"><span class="returnvalue">GdkVisual</span></a> *         gdk_visual_get_best_with_depth      (<em class="parameter"><code><span class="type">gint</span> depth</code></em>);</pre>
 
437
<pre class="programlisting"><a class="link" href="gdk-Visuals.html#GdkVisual" title="GdkVisual"><span class="returnvalue">GdkVisual</span></a> *         gdk_visual_get_best_with_depth      (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> depth</code></em>);</pre>
438
438
<p>
439
439
Get the best visual with depth <em class="parameter"><code>depth</code></em> for the default GDK screen.
440
440
Color visuals and visuals with mutable colormaps are preferred
441
441
over grayscale or fixed-colormap visuals. The return value should not
442
 
be freed. <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> may be returned if no visual supports <em class="parameter"><code>depth</code></em>.
 
442
be freed. <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> may be returned if no visual supports <em class="parameter"><code>depth</code></em>.
443
443
</p>
444
444
<div class="variablelist"><table border="0">
445
445
<col align="left" valign="top">
463
463
<p>
464
464
Get the best visual of the given <em class="parameter"><code>visual_type</code></em> for the default GDK screen.
465
465
Visuals with higher color depths are considered better. The return value
466
 
should not be freed. <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> may be returned if no visual has type
 
466
should not be freed. <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> may be returned if no visual has type
467
467
<em class="parameter"><code>visual_type</code></em>.
468
468
</p>
469
469
<div class="variablelist"><table border="0">
484
484
<hr>
485
485
<div class="refsect2">
486
486
<a name="gdk-visual-get-best-with-both"></a><h3>gdk_visual_get_best_with_both ()</h3>
487
 
<pre class="programlisting"><a class="link" href="gdk-Visuals.html#GdkVisual" title="GdkVisual"><span class="returnvalue">GdkVisual</span></a> *         gdk_visual_get_best_with_both       (<em class="parameter"><code><span class="type">gint</span> depth</code></em>,
 
487
<pre class="programlisting"><a class="link" href="gdk-Visuals.html#GdkVisual" title="GdkVisual"><span class="returnvalue">GdkVisual</span></a> *         gdk_visual_get_best_with_both       (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> depth</code></em>,
488
488
                                                         <em class="parameter"><code><a class="link" href="gdk-Visuals.html#GdkVisualType" title="enum GdkVisualType"><span class="type">GdkVisualType</span></a> visual_type</code></em>);</pre>
489
489
<p>
490
490
Combines <a class="link" href="gdk-Visuals.html#gdk-visual-get-best-with-depth" title="gdk_visual_get_best_with_depth ()"><code class="function">gdk_visual_get_best_with_depth()</code></a> and <a class="link" href="gdk-Visuals.html#gdk-visual-get-best-with-type" title="gdk_visual_get_best_with_type ()"><code class="function">gdk_visual_get_best_with_type()</code></a>.
503
503
<tr>
504
504
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
505
505
<td>best visual with both <em class="parameter"><code>depth</code></em> and
506
 
<em class="parameter"><code>visual_type</code></em>, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> if none. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
 
506
<em class="parameter"><code>visual_type</code></em>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if none. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
507
507
</td>
508
508
</tr>
509
509
</tbody>
519
519
<p><code class="literal">gdk_visual_ref</code> is deprecated and should not be used in newly-written code.</p>
520
520
</div>
521
521
<p>
522
 
Deprecated equivalent of <code class="function">g_object_ref()</code>.
 
522
Deprecated equivalent of <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-ref"><code class="function">g_object_ref()</code></a>.
523
523
</p>
524
524
<div class="variablelist"><table border="0">
525
525
<col align="left" valign="top">
546
546
<p><code class="literal">gdk_visual_unref</code> is deprecated and should not be used in newly-written code.</p>
547
547
</div>
548
548
<p>
549
 
Deprecated equivalent of <code class="function">g_object_unref()</code>.
 
549
Deprecated equivalent of <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.
550
550
</p>
551
551
<div class="variablelist"><table border="0">
552
552
<col align="left" valign="top">
584
584
<hr>
585
585
<div class="refsect2">
586
586
<a name="gdk-visual-get-bits-per-rgb"></a><h3>gdk_visual_get_bits_per_rgb ()</h3>
587
 
<pre class="programlisting"><span class="returnvalue">gint</span>                gdk_visual_get_bits_per_rgb         (<em class="parameter"><code><a class="link" href="gdk-Visuals.html#GdkVisual" title="GdkVisual"><span class="type">GdkVisual</span></a> *visual</code></em>);</pre>
 
587
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                gdk_visual_get_bits_per_rgb         (<em class="parameter"><code><a class="link" href="gdk-Visuals.html#GdkVisual" title="GdkVisual"><span class="type">GdkVisual</span></a> *visual</code></em>);</pre>
588
588
<p>
589
589
Returns the number of significant bits per red, green and blue value.
590
590
</p>
608
608
<div class="refsect2">
609
609
<a name="gdk-visual-get-blue-pixel-details"></a><h3>gdk_visual_get_blue_pixel_details ()</h3>
610
610
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_visual_get_blue_pixel_details   (<em class="parameter"><code><a class="link" href="gdk-Visuals.html#GdkVisual" title="GdkVisual"><span class="type">GdkVisual</span></a> *visual</code></em>,
611
 
                                                         <em class="parameter"><code><span class="type">guint32</span> *mask</code></em>,
612
 
                                                         <em class="parameter"><code><span class="type">gint</span> *shift</code></em>,
613
 
                                                         <em class="parameter"><code><span class="type">gint</span> *precision</code></em>);</pre>
 
611
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> *mask</code></em>,
 
612
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *shift</code></em>,
 
613
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *precision</code></em>);</pre>
614
614
<p>
615
615
Obtains values that are needed to calculate blue pixel values in TrueColor
616
616
and DirectColor.  The "mask" is the significant bits within the pixel.
628
628
</tr>
629
629
<tr>
630
630
<td><p><span class="term"><em class="parameter"><code>mask</code></em> :</span></p></td>
631
 
<td>A pointer to a <span class="type">guint32</span> to be filled in, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 
631
<td>A pointer to a <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> to be filled in, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
632
632
</td>
633
633
</tr>
634
634
<tr>
635
635
<td><p><span class="term"><em class="parameter"><code>shift</code></em> :</span></p></td>
636
 
<td>A pointer to a <span class="type">gint</span> to be filled in, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 
636
<td>A pointer to a <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> to be filled in, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
637
637
</td>
638
638
</tr>
639
639
<tr>
640
640
<td><p><span class="term"><em class="parameter"><code>precision</code></em> :</span></p></td>
641
 
<td>A pointer to a <span class="type">gint</span> to be filled in, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 
641
<td>A pointer to a <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> to be filled in, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
642
642
</td>
643
643
</tr>
644
644
</tbody>
670
670
<hr>
671
671
<div class="refsect2">
672
672
<a name="gdk-visual-get-colormap-size"></a><h3>gdk_visual_get_colormap_size ()</h3>
673
 
<pre class="programlisting"><span class="returnvalue">gint</span>                gdk_visual_get_colormap_size        (<em class="parameter"><code><a class="link" href="gdk-Visuals.html#GdkVisual" title="GdkVisual"><span class="type">GdkVisual</span></a> *visual</code></em>);</pre>
 
673
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                gdk_visual_get_colormap_size        (<em class="parameter"><code><a class="link" href="gdk-Visuals.html#GdkVisual" title="GdkVisual"><span class="type">GdkVisual</span></a> *visual</code></em>);</pre>
674
674
<p>
675
675
Returns the size of a colormap for this visual.
676
676
</p>
692
692
<hr>
693
693
<div class="refsect2">
694
694
<a name="gdk-visual-get-depth"></a><h3>gdk_visual_get_depth ()</h3>
695
 
<pre class="programlisting"><span class="returnvalue">gint</span>                gdk_visual_get_depth                (<em class="parameter"><code><a class="link" href="gdk-Visuals.html#GdkVisual" title="GdkVisual"><span class="type">GdkVisual</span></a> *visual</code></em>);</pre>
 
695
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                gdk_visual_get_depth                (<em class="parameter"><code><a class="link" href="gdk-Visuals.html#GdkVisual" title="GdkVisual"><span class="type">GdkVisual</span></a> *visual</code></em>);</pre>
696
696
<p>
697
697
Returns the bit depth of this visual.
698
698
</p>
715
715
<div class="refsect2">
716
716
<a name="gdk-visual-get-green-pixel-details"></a><h3>gdk_visual_get_green_pixel_details ()</h3>
717
717
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_visual_get_green_pixel_details  (<em class="parameter"><code><a class="link" href="gdk-Visuals.html#GdkVisual" title="GdkVisual"><span class="type">GdkVisual</span></a> *visual</code></em>,
718
 
                                                         <em class="parameter"><code><span class="type">guint32</span> *mask</code></em>,
719
 
                                                         <em class="parameter"><code><span class="type">gint</span> *shift</code></em>,
720
 
                                                         <em class="parameter"><code><span class="type">gint</span> *precision</code></em>);</pre>
 
718
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> *mask</code></em>,
 
719
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *shift</code></em>,
 
720
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *precision</code></em>);</pre>
721
721
<p>
722
722
Obtains values that are needed to calculate green pixel values in TrueColor
723
723
and DirectColor.  The "mask" is the significant bits within the pixel.
735
735
</tr>
736
736
<tr>
737
737
<td><p><span class="term"><em class="parameter"><code>mask</code></em> :</span></p></td>
738
 
<td>A pointer to a <span class="type">guint32</span> to be filled in, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 
738
<td>A pointer to a <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> to be filled in, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
739
739
</td>
740
740
</tr>
741
741
<tr>
742
742
<td><p><span class="term"><em class="parameter"><code>shift</code></em> :</span></p></td>
743
 
<td>A pointer to a <span class="type">gint</span> to be filled in, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 
743
<td>A pointer to a <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> to be filled in, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
744
744
</td>
745
745
</tr>
746
746
<tr>
747
747
<td><p><span class="term"><em class="parameter"><code>precision</code></em> :</span></p></td>
748
 
<td>A pointer to a <span class="type">gint</span> to be filled in, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 
748
<td>A pointer to a <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> to be filled in, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
749
749
</td>
750
750
</tr>
751
751
</tbody>
756
756
<div class="refsect2">
757
757
<a name="gdk-visual-get-red-pixel-details"></a><h3>gdk_visual_get_red_pixel_details ()</h3>
758
758
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_visual_get_red_pixel_details    (<em class="parameter"><code><a class="link" href="gdk-Visuals.html#GdkVisual" title="GdkVisual"><span class="type">GdkVisual</span></a> *visual</code></em>,
759
 
                                                         <em class="parameter"><code><span class="type">guint32</span> *mask</code></em>,
760
 
                                                         <em class="parameter"><code><span class="type">gint</span> *shift</code></em>,
761
 
                                                         <em class="parameter"><code><span class="type">gint</span> *precision</code></em>);</pre>
 
759
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> *mask</code></em>,
 
760
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *shift</code></em>,
 
761
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *precision</code></em>);</pre>
762
762
<p>
763
763
Obtains values that are needed to calculate red pixel values in TrueColor
764
764
and DirectColor.  The "mask" is the significant bits within the pixel.
775
775
</tr>
776
776
<tr>
777
777
<td><p><span class="term"><em class="parameter"><code>mask</code></em> :</span></p></td>
778
 
<td>A pointer to a <span class="type">guint32</span> to be filled in, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 
778
<td>A pointer to a <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> to be filled in, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
779
779
</td>
780
780
</tr>
781
781
<tr>
782
782
<td><p><span class="term"><em class="parameter"><code>shift</code></em> :</span></p></td>
783
 
<td>A pointer to a <span class="type">gint</span> to be filled in, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 
783
<td>A pointer to a <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> to be filled in, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
784
784
</td>
785
785
</tr>
786
786
<tr>
787
787
<td><p><span class="term"><em class="parameter"><code>precision</code></em> :</span></p></td>
788
 
<td>A pointer to a <span class="type">gint</span> to be filled in, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 
788
<td>A pointer to a <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> to be filled in, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
789
789
</td>
790
790
</tr>
791
791
</tbody>
824
824
</div>
825
825
<div class="footer">
826
826
<hr>
827
 
          Generated by GTK-Doc V1.17.1</div>
 
827
          Generated by GTK-Doc V1.17</div>
828
828
</body>
829
829
</html>
 
 
b'\\ No newline at end of file'