<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>gtkmm: Gdk::Visual Class Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.3 -->
<div id="top">
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td style="padding-left: 0.5em;">
<div id="projectname">gtkmm <span id="projectnumber">2.24.4</span></div>
</td>
</tr>
</tbody>
</table>
</div>
<div id="navrow1" class="tabs">
<ul class="tablist">
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="pages.html"><span>Related Pages</span></a></li>
<li><a href="modules.html"><span>Modules</span></a></li>
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
<li class="current"><a href="annotated.html"><span>Classes</span></a></li>
</ul>
</div>
<div id="navrow2" class="tabs2">
<ul class="tablist">
<li><a href="annotated.html"><span>Class List</span></a></li>
<li><a href="classes.html"><span>Class Index</span></a></li>
<li><a href="inherits.html"><span>Class Hierarchy</span></a></li>
<li><a href="functions.html"><span>Class Members</span></a></li>
</ul>
</div>
<div id="nav-path" class="navpath">
<ul>
<li class="navelem"><a class="el" href="namespaceGdk.html">Gdk</a> </li>
<li class="navelem"><a class="el" href="classGdk_1_1Visual.html">Visual</a> </li>
</ul>
</div>
</div>
<div class="header">
<div class="summary">
<a href="#pub-methods">Public Member Functions</a> |
<a href="#pub-static-methods">Static Public Member Functions</a> |
<a href="#pro-methods">Protected Member Functions</a> |
<a href="#related">Related Functions</a> </div>
<div class="headertitle">
<h1>Gdk::Visual Class Reference</h1> </div>
</div>
<div class="contents">
<!-- doxytag: class="Gdk::Visual" --><!-- doxytag: inherits="Glib::Object" -->
<p>A <a class="el" href="classGdk_1_1Visual.html" title="A Gdk::Visual describes a particular video hardware display format.">Gdk::Visual</a> describes a particular video hardware display format. <a href="#_details">More...</a></p>
<div class="dynheader">
Inheritance diagram for Gdk::Visual:</div>
<div class="dyncontent">
<div class="center"><img src="classGdk_1_1Visual__inherit__graph.png" border="0" usemap="#Gdk_1_1Visual_inherit__map" alt="Inheritance graph"/></div>
<map name="Gdk_1_1Visual_inherit__map" id="Gdk_1_1Visual_inherit__map">
<area shape="rect" id="node2" href="../../../glibmm-2.4/reference/html/classGlib_1_1Object.html" title="Glib::Object" alt="" coords="21,160,115,189"/><area shape="rect" id="node4" href="../../../glibmm-2.4/reference/html/classGlib_1_1ObjectBase.html" title="Glib::ObjectBase" alt="" coords="5,83,131,112"/><area shape="rect" id="node6" href="../../../libsigc++-2.0/reference/html/structsigc_1_1trackable.html" title="sigc::trackable" alt="" coords="11,5,125,35"/></map>
<center><span class="legend">[<a href="graph_legend.html">legend</a>]</span></center></div>
<div class="dynheader">
Collaboration diagram for Gdk::Visual:</div>
<div class="dyncontent">
<div class="center"><img src="classGdk_1_1Visual__coll__graph.png" border="0" usemap="#Gdk_1_1Visual_coll__map" alt="Collaboration graph"/></div>
<map name="Gdk_1_1Visual_coll__map" id="Gdk_1_1Visual_coll__map">
<area shape="rect" id="node2" href="../../../glibmm-2.4/reference/html/classGlib_1_1Object.html" title="Glib::Object" alt="" coords="21,160,115,189"/><area shape="rect" id="node4" href="../../../glibmm-2.4/reference/html/classGlib_1_1ObjectBase.html" title="Glib::ObjectBase" alt="" coords="5,83,131,112"/><area shape="rect" id="node6" href="../../../libsigc++-2.0/reference/html/structsigc_1_1trackable.html" title="sigc::trackable" alt="" coords="11,5,125,35"/></map>
<center><span class="legend">[<a href="graph_legend.html">legend</a>]</span></center></div>
<p><a href="classGdk_1_1Visual-members.html">List of all members.</a></p>
<table class="memberdecls">
<tr><td colspan="2"><h2><a name="pub-methods"></a>
Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual </td><td class="memItemRight" valign="bottom"><a class="el" href="classGdk_1_1Visual.html#a3e1b56ed29c8c6b4a9b54a4bc14a64a8">~Visual</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">GdkVisual* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGdk_1_1Visual.html#a23e5a76ba206f65d763186a9161b1f00">gobj</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C GObject. <a href="#a23e5a76ba206f65d763186a9161b1f00"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const GdkVisual* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGdk_1_1Visual.html#a3452bcc88c3ef7b9d9d1489ac84e3629">gobj</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C GObject. <a href="#a3452bcc88c3ef7b9d9d1489ac84e3629"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">GdkVisual* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGdk_1_1Visual.html#aac860c63e6f3740145653aef122bdf11">gobj_copy</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. <a href="#aac860c63e6f3740145653aef122bdf11"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGdk_1_1Screen.html">Screen</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGdk_1_1Visual.html#a7e10f47bbec94749bf683969e52927a5">get_screen</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the screen to which this visual belongs. <a href="#a7e10f47bbec94749bf683969e52927a5"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< const <a class="el" href="classGdk_1_1Screen.html">Screen</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGdk_1_1Visual.html#a194d4df865f1a72171bae1de27571ca4">get_screen</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the screen to which this visual belongs. <a href="#a194d4df865f1a72171bae1de27571ca4"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__gdkmmEnums.html#gaf51d8a92358be17e8bdcbe2a229d1620">VisualType</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGdk_1_1Visual.html#af615a02cb1a5bf13d748250d3202e552">get_visual_type</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the type of visual this is (PseudoColor, TrueColor, etc). <a href="#af615a02cb1a5bf13d748250d3202e552"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="classGdk_1_1Visual.html#a0093c5b3fbc21bed2ca0b7383eb5ef2c">get_depth</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the bit depth of this visual. <a href="#a0093c5b3fbc21bed2ca0b7383eb5ef2c"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__gdkmmEnums.html#ga23c7243f15304c7a86cf6a20118a7c85">ByteOrder</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGdk_1_1Visual.html#a3df15d1041143c6f20075e1469034d3a">get_byte_order</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the byte order of this visual. <a href="#a3df15d1041143c6f20075e1469034d3a"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="classGdk_1_1Visual.html#a1b3bc9654ddb15048c89e08e8dbc2b2e">get_colormap_size</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the size of a colormap for this visual. <a href="#a1b3bc9654ddb15048c89e08e8dbc2b2e"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="classGdk_1_1Visual.html#a000f87fd3dc00651046fa2c9dbaae05d">get_bits_per_rgb</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the number of significant bits per red, green and blue value. <a href="#a000f87fd3dc00651046fa2c9dbaae05d"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGdk_1_1Visual.html#ac9713165720bebfa769b274dfc1ae272">get_red_pixel_details</a> (guint32& mask, int&<a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01176.html#ga9a8c05a074abad2cd4c15634dabc250f">shift</a>, int& precision) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Obtains values that are needed to calculate red pixel values in TrueColor and DirectColor. <a href="#ac9713165720bebfa769b274dfc1ae272"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGdk_1_1Visual.html#a00950ae087e9e5cb3f720f9ab033b830">get_green_pixel_details</a> (guint32& mask, int&<a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01176.html#ga9a8c05a074abad2cd4c15634dabc250f">shift</a>, int& precision) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Obtains values that are needed to calculate green pixel values in TrueColor and DirectColor. <a href="#a00950ae087e9e5cb3f720f9ab033b830"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGdk_1_1Visual.html#ad322b8a271797fd244b43bd25d981f1f">get_blue_pixel_details</a> (guint32& mask, int&<a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01176.html#ga9a8c05a074abad2cd4c15634dabc250f">shift</a>, int& precision) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Obtains values that are needed to calculate blue pixel values in TrueColor and DirectColor. <a href="#ad322b8a271797fd244b43bd25d981f1f"></a><br/></td></tr>
<tr><td colspan="2"><h2><a name="pub-static-methods"></a>
Static Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGdk_1_1Visual.html">Visual</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGdk_1_1Visual.html#a4724a117dabcb795c406fea0172e3d08">get_system</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the system's default visual for the default GDK screen. <a href="#a4724a117dabcb795c406fea0172e3d08"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGdk_1_1Visual.html">Visual</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGdk_1_1Visual.html#a8d67541c7ac1cca24b20f1e04a654c9e">get_best</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the visual with the most available colors for the default GDK screen. <a href="#a8d67541c7ac1cca24b20f1e04a654c9e"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGdk_1_1Visual.html">Visual</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGdk_1_1Visual.html#a2f44b4029c4b3091f567903f6991e88a">get_best</a> (int depth)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the best visual with depth <em>depth</em> for the default GDK screen. <a href="#a2f44b4029c4b3091f567903f6991e88a"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGdk_1_1Visual.html">Visual</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGdk_1_1Visual.html#a23a87ca05f0ff38962c341fad1698239">get_best</a> (<a class="el" href="group__gdkmmEnums.html#gaf51d8a92358be17e8bdcbe2a229d1620">VisualType</a> visual_type)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the best visual of the given <em>visual_type</em> for the default GDK screen. <a href="#a23a87ca05f0ff38962c341fad1698239"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGdk_1_1Visual.html">Visual</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGdk_1_1Visual.html#aa58e64d37a98afc31f4a09412b558863">get_best</a> (int depth, <a class="el" href="group__gdkmmEnums.html#gaf51d8a92358be17e8bdcbe2a229d1620">VisualType</a> visual_type)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Combines get_best_with_depth() and get_best_with_type(). <a href="#aa58e64d37a98afc31f4a09412b558863"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static int </td><td class="memItemRight" valign="bottom"><a class="el" href="classGdk_1_1Visual.html#a4033654c987ba7208b7f1ab8e53c04a2">get_best_depth</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the best available depth for the default GDK screen. <a href="#a4033654c987ba7208b7f1ab8e53c04a2"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="el" href="group__gdkmmEnums.html#gaf51d8a92358be17e8bdcbe2a229d1620">VisualType</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGdk_1_1Visual.html#a9653abce581c94fca4dca322ffb4e16d">get_best_type</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Return the best available visual type for the default GDK screen. <a href="#a9653abce581c94fca4dca322ffb4e16d"></a><br/></td></tr>
<tr><td colspan="2"><h2><a name="pro-methods"></a>
Protected Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGdk_1_1Visual.html#a04412275c902225a6bd103d0a5f3ad2e">Visual</a> ()</td></tr>
<tr><td colspan="2"><h2><a name="related"></a>
Related Functions</h2></td></tr>
<tr><td colspan="2">(Note that these are not member functions.) <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGdk_1_1Visual.html">Gdk::Visual</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGdk_1_1Visual.html#a151170bd9f613ba53f811871166a6f55">wrap</a> (GdkVisual* object, bool take_copy=false)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">A <a class="elRef" href="../../../glibmm-2.4/reference/html/namespaceGlib.html#a671306f4a3a0cae5ab4d7a9d54886592">Glib::wrap()</a> method for this object. <a href="#a151170bd9f613ba53f811871166a6f55"></a><br/></td></tr>
</table>
<hr/><a name="_details"></a><h2>Detailed Description</h2>
<div class="textblock"><p>A <a class="el" href="classGdk_1_1Visual.html" title="A Gdk::Visual describes a particular video hardware display format.">Gdk::Visual</a> describes a particular video hardware display format. </p>
<p>It includes information about the number of bits used for each color, the way the bits are translated into an RGB value for display, and the way the bits are stored in memory. For example, a piece of display hardware might support 24-bit color, 16-bit color, or 8-bit color; meaning 24/16/8-bit pixel sizes. For a given pixel size, pixels can be in different formats; for example the "red" element of an RGB pixel may be in the top 8 bits of the pixel, or may be in the lower 4 bits.</p>
<p>Usually you can avoid thinking about visuals in GTK+. Visuals are useful to interpret the contents of a GdkImage, but you should avoid <a class="el" href="classGdk_1_1Image.html" title="This represents an area for drawing graphics.">Gdk::Image</a> precisely because its contents depend on the display hardware; use <a class="el" href="classGdk_1_1Pixbuf.html">Gdk::Pixbuf</a> instead, for all but the most low-level purposes. Also, anytime you provide a <a class="el" href="classGdk_1_1Colormap.html" title="A Colormap is an object that contains the mapping between the color values stored in memory and the R...">Gdk::Colormap</a>, the visual is implied as part of the colormap (<a class="el" href="classGdk_1_1Colormap.html#a90d5e438d78992e2030832a196ac222b" title="Returns the visual for which a given colormap was created.">Gdk::Colormap::get_visual()</a>), so you won't have to provide a visual in addition.</p>
<p>There are several standard visuals. The visual returned by <a class="el" href="classGdk_1_1Visual.html#a4724a117dabcb795c406fea0172e3d08" title="Get the system's default visual for the default GDK screen.">get_system()</a> is the system's default visual. get_visual() returns the visual most suited to displaying full-color image data. If you use the calls in Gdk::RGB, you should create your windows using this visual (and the colormap returned by Gdk::Rgb::get_colormap()).</p>
<p>A number of methods are provided for determining the "best" available visual. For the purposes of making this determination, higher bit depths are considered better, and for visuals of the same bit depth, GDK_VISUAL_PSEUDO_COLOR is preferred at 8bpp, otherwise, the visual types are ranked in the order of (highest to lowest) GDK_VISUAL_DIRECT_COLOR, GDK_VISUAL_TRUE_COLOR, GDK_VISUAL_PSEUDO_COLOR, GDK_VISUAL_STATIC_COLOR, GDK_VISUAL_GRAYSCALE, then GDK_VISUAL_STATIC_GRAY. </p>
</div><hr/><h2>Constructor & Destructor Documentation</h2>
<a class="anchor" id="a3e1b56ed29c8c6b4a9b54a4bc14a64a8"></a><!-- doxytag: member="Gdk::Visual::~Visual" ref="a3e1b56ed29c8c6b4a9b54a4bc14a64a8" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual Gdk::Visual::~Visual </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
</div>
</div>
<a class="anchor" id="a04412275c902225a6bd103d0a5f3ad2e"></a><!-- doxytag: member="Gdk::Visual::Visual" ref="a04412275c902225a6bd103d0a5f3ad2e" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">Gdk::Visual::Visual </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td><code> [protected]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
</div>
</div>
<hr/><h2>Member Function Documentation</h2>
<a class="anchor" id="a8d67541c7ac1cca24b20f1e04a654c9e"></a><!-- doxytag: member="Gdk::Visual::get_best" ref="a8d67541c7ac1cca24b20f1e04a654c9e" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classGdk_1_1Visual.html">Visual</a>> Gdk::Visual::get_best </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Get the visual with the most available colors for the default GDK screen. </p>
<p>The return value should not be freed. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>Best visual. </dd></dl>
</div>
</div>
<a class="anchor" id="aa58e64d37a98afc31f4a09412b558863"></a><!-- doxytag: member="Gdk::Visual::get_best" ref="aa58e64d37a98afc31f4a09412b558863" args="(int depth, VisualType visual_type)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classGdk_1_1Visual.html">Visual</a>> Gdk::Visual::get_best </td>
<td>(</td>
<td class="paramtype">int </td>
<td class="paramname"><em>depth</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__gdkmmEnums.html#gaf51d8a92358be17e8bdcbe2a229d1620">VisualType</a> </td>
<td class="paramname"><em>visual_type</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Combines get_best_with_depth() and get_best_with_type(). </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">depth</td><td>A bit depth. </td></tr>
<tr><td class="paramname">visual_type</td><td>A visual type. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Best visual with both <em>depth</em> and <em>visual_type</em>, or <code>0</code> if none. </dd></dl>
</div>
</div>
<a class="anchor" id="a2f44b4029c4b3091f567903f6991e88a"></a><!-- doxytag: member="Gdk::Visual::get_best" ref="a2f44b4029c4b3091f567903f6991e88a" args="(int depth)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classGdk_1_1Visual.html">Visual</a>> Gdk::Visual::get_best </td>
<td>(</td>
<td class="paramtype">int </td>
<td class="paramname"><em>depth</em></td><td>)</td>
<td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Get the best visual with depth <em>depth</em> for the default GDK screen. </p>
<p><a class="el" href="classGdk_1_1Color.html" title="Gdk::Color is used to describe an allocated or unallocated color.">Color</a> visuals and visuals with mutable colormaps are preferred over grayscale or fixed-colormap visuals. The return value should not be freed. <code>0</code> may be returned if no visual supports <em>depth</em>. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">depth</td><td>A bit depth. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Best visual for the given depth. </dd></dl>
</div>
</div>
<a class="anchor" id="a23a87ca05f0ff38962c341fad1698239"></a><!-- doxytag: member="Gdk::Visual::get_best" ref="a23a87ca05f0ff38962c341fad1698239" args="(VisualType visual_type)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classGdk_1_1Visual.html">Visual</a>> Gdk::Visual::get_best </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__gdkmmEnums.html#gaf51d8a92358be17e8bdcbe2a229d1620">VisualType</a> </td>
<td class="paramname"><em>visual_type</em></td><td>)</td>
<td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Get the best visual of the given <em>visual_type</em> for the default GDK screen. </p>
<p>Visuals with higher color depths are considered better. The return value should not be freed. <code>0</code> may be returned if no visual has type <em>visual_type</em>. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">visual_type</td><td>A visual type. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Best visual of the given type. </dd></dl>
</div>
</div>
<a class="anchor" id="a4033654c987ba7208b7f1ab8e53c04a2"></a><!-- doxytag: member="Gdk::Visual::get_best_depth" ref="a4033654c987ba7208b7f1ab8e53c04a2" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static int Gdk::Visual::get_best_depth </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Get the best available depth for the default GDK screen. </p>
<p>"Best" means "largest," i.e. 32 preferred over 24 preferred over 8 bits per pixel. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>Best available depth. </dd></dl>
</div>
</div>
<a class="anchor" id="a9653abce581c94fca4dca322ffb4e16d"></a><!-- doxytag: member="Gdk::Visual::get_best_type" ref="a9653abce581c94fca4dca322ffb4e16d" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static <a class="el" href="group__gdkmmEnums.html#gaf51d8a92358be17e8bdcbe2a229d1620">VisualType</a> Gdk::Visual::get_best_type </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Return the best available visual type for the default GDK screen. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>Best visual type. </dd></dl>
</div>
</div>
<a class="anchor" id="a000f87fd3dc00651046fa2c9dbaae05d"></a><!-- doxytag: member="Gdk::Visual::get_bits_per_rgb" ref="a000f87fd3dc00651046fa2c9dbaae05d" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int Gdk::Visual::get_bits_per_rgb </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns the number of significant bits per red, green and blue value. </p>
<dl class="since_2_22"><dt><b><a class="el" href="since_2_22.html#_since_2_22000033">Since gtkmm 2.22:</a></b></dt><dd></dd></dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The number of significant bits per color value for <em>visual</em>. </dd></dl>
</div>
</div>
<a class="anchor" id="ad322b8a271797fd244b43bd25d981f1f"></a><!-- doxytag: member="Gdk::Visual::get_blue_pixel_details" ref="ad322b8a271797fd244b43bd25d981f1f" args="(guint32 &mask, int &shift, int &precision) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gdk::Visual::get_blue_pixel_details </td>
<td>(</td>
<td class="paramtype">guint32 & </td>
<td class="paramname"><em>mask</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int & </td>
<td class="paramname"><em>shift</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int & </td>
<td class="paramname"><em>precision</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Obtains values that are needed to calculate blue pixel values in TrueColor and DirectColor. </p>
<p>The "mask" is the significant bits within the pixel. The "shift" is the number of bits left we must shift a primary for it to be in position (according to the "mask"). Finally, "precision" refers to how much precision the pixel value contains for a particular primary.</p>
<dl class="since_2_22"><dt><b><a class="el" href="since_2_22.html#_since_2_22000036">Since gtkmm 2.22:</a></b></dt><dd></dd></dl>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">mask</td><td>A pointer to a #guint32 to be filled in, or <code>0</code>. </td></tr>
<tr><td class="paramname">shift</td><td>A pointer to a <code>int</code> to be filled in, or <code>0</code>. </td></tr>
<tr><td class="paramname">precision</td><td>A pointer to a <code>int</code> to be filled in, or <code>0</code>. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="a3df15d1041143c6f20075e1469034d3a"></a><!-- doxytag: member="Gdk::Visual::get_byte_order" ref="a3df15d1041143c6f20075e1469034d3a" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="group__gdkmmEnums.html#ga23c7243f15304c7a86cf6a20118a7c85">ByteOrder</a> Gdk::Visual::get_byte_order </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns the byte order of this visual. </p>
<dl class="since_2_22"><dt><b><a class="el" href="since_2_22.html#_since_2_22000031">Since gtkmm 2.22:</a></b></dt><dd></dd></dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A Gdk::ByteOrder stating the byte order of <em>visual</em>. </dd></dl>
</div>
</div>
<a class="anchor" id="a1b3bc9654ddb15048c89e08e8dbc2b2e"></a><!-- doxytag: member="Gdk::Visual::get_colormap_size" ref="a1b3bc9654ddb15048c89e08e8dbc2b2e" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int Gdk::Visual::get_colormap_size </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns the size of a colormap for this visual. </p>
<dl class="since_2_22"><dt><b><a class="el" href="since_2_22.html#_since_2_22000032">Since gtkmm 2.22:</a></b></dt><dd></dd></dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The size of a colormap that is suitable for <em>visual</em>. </dd></dl>
</div>
</div>
<a class="anchor" id="a0093c5b3fbc21bed2ca0b7383eb5ef2c"></a><!-- doxytag: member="Gdk::Visual::get_depth" ref="a0093c5b3fbc21bed2ca0b7383eb5ef2c" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int Gdk::Visual::get_depth </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns the bit depth of this visual. </p>
<dl class="since_2_22"><dt><b><a class="el" href="since_2_22.html#_since_2_22000030">Since gtkmm 2.22:</a></b></dt><dd></dd></dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The bit depth of this visual. </dd></dl>
</div>
</div>
<a class="anchor" id="a00950ae087e9e5cb3f720f9ab033b830"></a><!-- doxytag: member="Gdk::Visual::get_green_pixel_details" ref="a00950ae087e9e5cb3f720f9ab033b830" args="(guint32 &mask, int &shift, int &precision) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gdk::Visual::get_green_pixel_details </td>
<td>(</td>
<td class="paramtype">guint32 & </td>
<td class="paramname"><em>mask</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int & </td>
<td class="paramname"><em>shift</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int & </td>
<td class="paramname"><em>precision</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Obtains values that are needed to calculate green pixel values in TrueColor and DirectColor. </p>
<p>The "mask" is the significant bits within the pixel. The "shift" is the number of bits left we must shift a primary for it to be in position (according to the "mask"). Finally, "precision" refers to how much precision the pixel value contains for a particular primary.</p>
<dl class="since_2_22"><dt><b><a class="el" href="since_2_22.html#_since_2_22000035">Since gtkmm 2.22:</a></b></dt><dd></dd></dl>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">mask</td><td>A pointer to a #guint32 to be filled in, or <code>0</code>. </td></tr>
<tr><td class="paramname">shift</td><td>A pointer to a <code>int</code> to be filled in, or <code>0</code>. </td></tr>
<tr><td class="paramname">precision</td><td>A pointer to a <code>int</code> to be filled in, or <code>0</code>. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="ac9713165720bebfa769b274dfc1ae272"></a><!-- doxytag: member="Gdk::Visual::get_red_pixel_details" ref="ac9713165720bebfa769b274dfc1ae272" args="(guint32 &mask, int &shift, int &precision) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gdk::Visual::get_red_pixel_details </td>
<td>(</td>
<td class="paramtype">guint32 & </td>
<td class="paramname"><em>mask</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int & </td>
<td class="paramname"><em>shift</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int & </td>
<td class="paramname"><em>precision</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Obtains values that are needed to calculate red pixel values in TrueColor and DirectColor. </p>
<p>The "mask" is the significant bits within the pixel. The "shift" is the number of bits left we must shift a primary for it to be in position (according to the "mask"). Finally, "precision" refers to how much precision the pixel value contains for a particular primary.</p>
<dl class="since_2_22"><dt><b><a class="el" href="since_2_22.html#_since_2_22000034">Since gtkmm 2.22:</a></b></dt><dd></dd></dl>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">mask</td><td>A pointer to a #guint32 to be filled in, or <code>0</code>. </td></tr>
<tr><td class="paramname">shift</td><td>A pointer to a <code>int</code> to be filled in, or <code>0</code>. </td></tr>
<tr><td class="paramname">precision</td><td>A pointer to a <code>int</code> to be filled in, or <code>0</code>. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="a7e10f47bbec94749bf683969e52927a5"></a><!-- doxytag: member="Gdk::Visual::get_screen" ref="a7e10f47bbec94749bf683969e52927a5" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classGdk_1_1Screen.html">Screen</a>> Gdk::Visual::get_screen </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Gets the screen to which this visual belongs. </p>
<dl class="since_2_2"><dt><b><a class="el" href="since_2_2.html#_since_2_2000085">Since gtkmm 2.2:</a></b></dt><dd></dd></dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The screen to which this visual belongs. </dd></dl>
</div>
</div>
<a class="anchor" id="a194d4df865f1a72171bae1de27571ca4"></a><!-- doxytag: member="Gdk::Visual::get_screen" ref="a194d4df865f1a72171bae1de27571ca4" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><const <a class="el" href="classGdk_1_1Screen.html">Screen</a>> Gdk::Visual::get_screen </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Gets the screen to which this visual belongs. </p>
<dl class="since_2_2"><dt><b><a class="el" href="since_2_2.html#_since_2_2000086">Since gtkmm 2.2:</a></b></dt><dd></dd></dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The screen to which this visual belongs. </dd></dl>
</div>
</div>
<a class="anchor" id="a4724a117dabcb795c406fea0172e3d08"></a><!-- doxytag: member="Gdk::Visual::get_system" ref="a4724a117dabcb795c406fea0172e3d08" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classGdk_1_1Visual.html">Visual</a>> Gdk::Visual::get_system </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Get the system's default visual for the default GDK screen. </p>
<p>This is the visual for the root window of the display. The return value should not be freed. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>System visual. </dd></dl>
</div>
</div>
<a class="anchor" id="af615a02cb1a5bf13d748250d3202e552"></a><!-- doxytag: member="Gdk::Visual::get_visual_type" ref="af615a02cb1a5bf13d748250d3202e552" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="group__gdkmmEnums.html#gaf51d8a92358be17e8bdcbe2a229d1620">VisualType</a> Gdk::Visual::get_visual_type </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns the type of visual this is (PseudoColor, TrueColor, etc). </p>
<dl class="since_2_22"><dt><b><a class="el" href="since_2_22.html#_since_2_22000029">Since gtkmm 2.22:</a></b></dt><dd></dd></dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A Gdk::VisualType stating the type of <em>visual</em>. </dd></dl>
</div>
</div>
<a class="anchor" id="a3452bcc88c3ef7b9d9d1489ac84e3629"></a><!-- doxytag: member="Gdk::Visual::gobj" ref="a3452bcc88c3ef7b9d9d1489ac84e3629" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const GdkVisual* Gdk::Visual::gobj </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const<code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Provides access to the underlying C GObject. </p>
<p>Reimplemented from <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ObjectBase.html#a778a94181132976bbfb0519793f3b32e">Glib::ObjectBase</a>.</p>
</div>
</div>
<a class="anchor" id="a23e5a76ba206f65d763186a9161b1f00"></a><!-- doxytag: member="Gdk::Visual::gobj" ref="a23e5a76ba206f65d763186a9161b1f00" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">GdkVisual* Gdk::Visual::gobj </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td><code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Provides access to the underlying C GObject. </p>
<p>Reimplemented from <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ObjectBase.html#a4c6efc18be8cb9c56e58fc0bd20fafbe">Glib::ObjectBase</a>.</p>
</div>
</div>
<a class="anchor" id="aac860c63e6f3740145653aef122bdf11"></a><!-- doxytag: member="Gdk::Visual::gobj_copy" ref="aac860c63e6f3740145653aef122bdf11" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">GdkVisual* Gdk::Visual::gobj_copy </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. </p>
</div>
</div>
<hr/><h2>Friends And Related Function Documentation</h2>
<a class="anchor" id="a151170bd9f613ba53f811871166a6f55"></a><!-- doxytag: member="Gdk::Visual::wrap" ref="a151170bd9f613ba53f811871166a6f55" args="(GdkVisual *object, bool take_copy=false)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGdk_1_1Visual.html">Gdk::Visual</a> > wrap </td>
<td>(</td>
<td class="paramtype">GdkVisual * </td>
<td class="paramname"><em>object</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"><em>take_copy</em> = <code>false</code> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [related]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>A <a class="elRef" href="../../../glibmm-2.4/reference/html/namespaceGlib.html#a671306f4a3a0cae5ab4d7a9d54886592">Glib::wrap()</a> method for this object. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">object</td><td>The C instance. </td></tr>
<tr><td class="paramname">take_copy</td><td>False if the result should take ownership of the C instance. True if it should take a new copy or ref. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A C++ instance that wraps this C instance. </dd></dl>
</div>
</div>
<hr/>The documentation for this class was generated from the following file:<ul>
<li>gdkmm/visual.h</li>
</ul>
</div>
<hr class="footer"/><address class="footer"><small>Generated on Tue Jun 25 2013 for gtkmm by 
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.7.3 </small></address>
</body>
</html>
