Sophie

Sophie

distrib > Fedora > 15 > i386 > by-pkgid > bf5ad49bf8714f68fa4d0bb1597cb497 > files > 75

cairomm-doc-1.9.8-2.fc15.2.noarch.rpm

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
    <head>
        <meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1">
        <title>cairomm: Cairo::XlibSurface Class Reference</title>
        <link href="cairomm.css" rel="stylesheet" type="text/css">
    </head>
<body>
<!-- Generated by Doxygen 1.7.1 -->
<div class="navigation" id="top">
  <div class="tabs">
    <ul class="tablist">
      <li><a href="index.html"><span>Main&#160;Page</span></a></li>
      <li><a href="pages.html"><span>Related&#160;Pages</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>
      <li><a href="examples.html"><span>Examples</span></a></li>
    </ul>
  </div>
  <div class="tabs2">
    <ul class="tablist">
      <li><a href="annotated.html"><span>Class&#160;List</span></a></li>
      <li><a href="hierarchy.html"><span>Class&#160;Hierarchy</span></a></li>
      <li><a href="functions.html"><span>Class&#160;Members</span></a></li>
    </ul>
  </div>
  <div class="navpath">
    <ul>
      <li><a class="el" href="namespaceCairo.html">Cairo</a>      </li>
      <li><a class="el" href="classCairo_1_1XlibSurface.html">Cairo::XlibSurface</a>      </li>
    </ul>
  </div>
</div>
<div class="header">
  <div class="summary">
<a href="#pub-methods">Public Member Functions</a> &#124;
<a href="#pub-static-methods">Static Public Member Functions</a>  </div>
  <div class="headertitle">
<h1>Cairo::XlibSurface Class Reference</h1>  </div>
</div>
<div class="contents">
<!-- doxytag: class="Cairo::XlibSurface" --><!-- doxytag: inherits="Cairo::Surface" -->
<p>An <a class="el" href="classCairo_1_1XlibSurface.html" title="An XlibSurface provides a way to render to the X Window System using XLib.">XlibSurface</a> provides a way to render to the X Window System using XLib.  
<a href="#_details">More...</a></p>

<p>Inherits <a class="el" href="classCairo_1_1Surface.html">Cairo::Surface</a>.</p>

<p><a href="classCairo_1_1XlibSurface-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">&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classCairo_1_1XlibSurface.html#afe45b69c03a79879b0e1b1cabb13a6da">XlibSurface</a> (cairo_surface_t*<a class="el" href="classCairo_1_1Surface.html#ad176eb7343b5902df3c19f9f56e59fb4">cobject</a>, bool has_reference=false)</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Create a C++ wrapper for the C instance.  <a href="#afe45b69c03a79879b0e1b1cabb13a6da"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classCairo_1_1XlibSurface.html#a362141c504db6742c4e09af52945709f">~XlibSurface</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classCairo_1_1XlibSurface.html#a69b6337fa91dd53a054427e9a8235f16">set_size</a> (int width, int height)</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Informs cairo of the new size of the X Drawable underlying the surface.  <a href="#a69b6337fa91dd53a054427e9a8235f16"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classCairo_1_1XlibSurface.html#a92f59aab3ce0a113df0f6de18f306816">set_drawable</a> (Drawable drawable, int width, int height)</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Informs cairo of a new X Drawable underlying the surface.  <a href="#a92f59aab3ce0a113df0f6de18f306816"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">Drawable&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classCairo_1_1XlibSurface.html#ae72506a16c6865a5709d38e2e33b1771">get_drawable</a> () const </td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">gets the Drawable object associated with this surface  <a href="#ae72506a16c6865a5709d38e2e33b1771"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const Display*&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classCairo_1_1XlibSurface.html#ad073af9affb7338e9b78589e7565a320">get_display</a> () const </td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Get the X Display for the underlying X Drawable.  <a href="#ad073af9affb7338e9b78589e7565a320"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">Display*&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classCairo_1_1XlibSurface.html#afe98ccb169fe84f05ff7f2c1fb413a5a">get_display</a> ()</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Get the X Display for the underlying X Drawable.  <a href="#afe98ccb169fe84f05ff7f2c1fb413a5a"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">Screen*&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classCairo_1_1XlibSurface.html#a95da96899c1098dae4dc34d0b489d4b5">get_screen</a> ()</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Get the X Screen for the underlying X Drawable.  <a href="#a95da96899c1098dae4dc34d0b489d4b5"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const Screen*&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classCairo_1_1XlibSurface.html#ae0a1ccd477c2e5691b5a748c71191338">get_screen</a> () const </td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Get the X Screen for the underlying X Drawable.  <a href="#ae0a1ccd477c2e5691b5a748c71191338"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">Visual*&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classCairo_1_1XlibSurface.html#ada56c72e6f48420340a0bc4ae0ae22b0">get_visual</a> ()</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Get the X Visual for the underlying X Drawable.  <a href="#ada56c72e6f48420340a0bc4ae0ae22b0"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const Visual*&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classCairo_1_1XlibSurface.html#a2e1b0cc64bd149a141a08112236726a1">get_visual</a> () const </td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Get the X Visual for the underlying X Drawable.  <a href="#a2e1b0cc64bd149a141a08112236726a1"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classCairo_1_1XlibSurface.html#a476e5ddd3deee79c8f47be01e1e0f7e7">get_depth</a> () const </td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Get the number of bits used to represent each pixel value.  <a href="#a476e5ddd3deee79c8f47be01e1e0f7e7"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classCairo_1_1XlibSurface.html#a5ebd424f0c526c82141051a9824f3c69">get_height</a> () const </td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Get the height in pixels of the X Drawable underlying the surface.  <a href="#a5ebd424f0c526c82141051a9824f3c69"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classCairo_1_1XlibSurface.html#a8cce1064a3f867657eb31e83d1dd464d">get_width</a> () const </td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Get the width in pixels of the X Drawable underlying the surface.  <a href="#a8cce1064a3f867657eb31e83d1dd464d"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">XRenderPictFormat*&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classCairo_1_1XlibSurface.html#a285b8e6394c22f395cca79c92dc17429">get_xrender_format</a> () const </td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Gets the X Render picture format that  uses for rendering with the X Render extension.  <a href="#a285b8e6394c22f395cca79c92dc17429"></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="el" href="classCairo_1_1RefPtr.html">RefPtr</a>&lt; <a class="el" href="classCairo_1_1XlibSurface.html">XlibSurface</a> &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classCairo_1_1XlibSurface.html#ae4c1ee03939f091bc5f1bc75e8b35dcb">create</a> (Display* dpy, Drawable drawable, Visual* visual, int width, int height)</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Creates an Xlib surface that draws to the given drawable.  <a href="#ae4c1ee03939f091bc5f1bc75e8b35dcb"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="el" href="classCairo_1_1RefPtr.html">RefPtr</a>&lt; <a class="el" href="classCairo_1_1XlibSurface.html">XlibSurface</a> &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classCairo_1_1XlibSurface.html#a8ece252d2269f2f73c9f436dbc6c8a30">create</a> (Display* dpy, Pixmap bitmap, Screen* screen, int width, int height)</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Creates an Xlib surface that draws to the given bitmap.  <a href="#a8ece252d2269f2f73c9f436dbc6c8a30"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="el" href="classCairo_1_1RefPtr.html">Cairo::RefPtr</a><br class="typebreak"/>
&lt; <a class="el" href="classCairo_1_1XlibSurface.html">Cairo::XlibSurface</a> &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classCairo_1_1XlibSurface.html#a88149191bb6cef8fbe5dded45be35355">create_with_xrender_format</a> (Display* dpy, Drawable drawable, Screen* screen, XRenderPictFormat* format, int width, int height)</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Creates an Xlib surface that draws to the given drawable.  <a href="#a88149191bb6cef8fbe5dded45be35355"></a><br/></td></tr>
</table>
<hr/><a name="_details"></a><h2>Detailed Description</h2>
<p>An <a class="el" href="classCairo_1_1XlibSurface.html" title="An XlibSurface provides a way to render to the X Window System using XLib.">XlibSurface</a> provides a way to render to the X Window System using XLib. </p>
<p>If you want to draw to the screen within an application that uses the X Window system, you should use this <a class="el" href="classCairo_1_1Surface.html" title="A cairo surface represents an image, either as the destination of a drawing operation or as source wh...">Surface</a> type.</p>
<dl class="note"><dt><b>Note:</b></dt><dd>For this surface to be availabe, cairo must have been compiled with support for XLib Surfaces </dd></dl>
<hr/><h2>Constructor &amp; Destructor Documentation</h2>
<a class="anchor" id="afe45b69c03a79879b0e1b1cabb13a6da"></a><!-- doxytag: member="Cairo::XlibSurface::XlibSurface" ref="afe45b69c03a79879b0e1b1cabb13a6da" args="(cairo_surface_t *cobject, bool has_reference=false)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">Cairo::XlibSurface::XlibSurface </td>
          <td>(</td>
          <td class="paramtype">cairo_surface_t *&#160;</td>
          <td class="paramname"> <em>cobject</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">bool&#160;</td>
          <td class="paramname"> <em>has_reference</em> = <code>false</code></td><td>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td><code> [explicit]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Create a C++ wrapper for the C instance. </p>
<p>This C++ instance should then be given to a <a class="el" href="classCairo_1_1RefPtr.html" title="RefPtr&lt;&gt; is a reference-counting shared smartpointer.">RefPtr</a>.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>cobject</em>&#160;</td><td>The C instance. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>has_reference</em>&#160;</td><td>whether we already have a reference. Otherwise, the constructor will take an extra reference. </td></tr>
  </table>
  </dd>
</dl>

</div>
</div>
<a class="anchor" id="a362141c504db6742c4e09af52945709f"></a><!-- doxytag: member="Cairo::XlibSurface::~XlibSurface" ref="a362141c504db6742c4e09af52945709f" args="()" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">virtual Cairo::XlibSurface::~XlibSurface </td>
          <td>(</td>
          <td class="paramname"></td>
          <td>&#160;)&#160;</td>
          <td><code> [virtual]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

</div>
</div>
<hr/><h2>Member Function Documentation</h2>
<a class="anchor" id="ae4c1ee03939f091bc5f1bc75e8b35dcb"></a><!-- doxytag: member="Cairo::XlibSurface::create" ref="ae4c1ee03939f091bc5f1bc75e8b35dcb" args="(Display *dpy, Drawable drawable, Visual *visual, int width, int height)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">static <a class="el" href="classCairo_1_1RefPtr.html">RefPtr</a>&lt;<a class="el" href="classCairo_1_1XlibSurface.html">XlibSurface</a>&gt; Cairo::XlibSurface::create </td>
          <td>(</td>
          <td class="paramtype">Display *&#160;</td>
          <td class="paramname"> <em>dpy</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">Drawable&#160;</td>
          <td class="paramname"> <em>drawable</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">Visual *&#160;</td>
          <td class="paramname"> <em>visual</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&#160;</td>
          <td class="paramname"> <em>width</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&#160;</td>
          <td class="paramname"> <em>height</em></td><td>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td><code> [static]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Creates an Xlib surface that draws to the given drawable. </p>
<p>The way that colors are represented in the drawable is specified by the provided visual.</p>
<dl class="note"><dt><b>Note:</b></dt><dd>If drawable is a Window, then the function cairo_xlib_surface_set_size must be called whenever the size of the window changes.</dd></dl>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>dpy</em>&#160;</td><td>an X Display </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>drawable</em>&#160;</td><td>an X Drawable, (a Pixmap or a Window) </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>visual</em>&#160;</td><td>the visual to use for drawing to drawable. The depth of the visual must match the depth of the drawable. Currently, only TrueColor visuals are fully supported. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>width</em>&#160;</td><td>the current width of drawable. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>height</em>&#160;</td><td>the current height of drawable. </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A <a class="el" href="classCairo_1_1RefPtr.html" title="RefPtr&lt;&gt; is a reference-counting shared smartpointer.">RefPtr</a> to the newly created surface </dd></dl>

</div>
</div>
<a class="anchor" id="a8ece252d2269f2f73c9f436dbc6c8a30"></a><!-- doxytag: member="Cairo::XlibSurface::create" ref="a8ece252d2269f2f73c9f436dbc6c8a30" args="(Display *dpy, Pixmap bitmap, Screen *screen, int width, int height)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">static <a class="el" href="classCairo_1_1RefPtr.html">RefPtr</a>&lt;<a class="el" href="classCairo_1_1XlibSurface.html">XlibSurface</a>&gt; Cairo::XlibSurface::create </td>
          <td>(</td>
          <td class="paramtype">Display *&#160;</td>
          <td class="paramname"> <em>dpy</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">Pixmap&#160;</td>
          <td class="paramname"> <em>bitmap</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">Screen *&#160;</td>
          <td class="paramname"> <em>screen</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&#160;</td>
          <td class="paramname"> <em>width</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&#160;</td>
          <td class="paramname"> <em>height</em></td><td>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td><code> [static]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Creates an Xlib surface that draws to the given bitmap. </p>
<p>This will be drawn to as a CAIRO_FORMAT_A1 object.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>dpy</em>&#160;</td><td>an X Display </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>bitmap</em>&#160;</td><td>an X Drawable, (a depth-1 Pixmap) </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>screen</em>&#160;</td><td>the X Screen associated with bitmap </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>width</em>&#160;</td><td>the current width of bitmap. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>height</em>&#160;</td><td>the current height of bitmap. </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A <a class="el" href="classCairo_1_1RefPtr.html" title="RefPtr&lt;&gt; is a reference-counting shared smartpointer.">RefPtr</a> to the newly created surface </dd></dl>

</div>
</div>
<a class="anchor" id="a88149191bb6cef8fbe5dded45be35355"></a><!-- doxytag: member="Cairo::XlibSurface::create_with_xrender_format" ref="a88149191bb6cef8fbe5dded45be35355" args="(Display *dpy, Drawable drawable, Screen *screen, XRenderPictFormat *format, int width, int height)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">static <a class="el" href="classCairo_1_1RefPtr.html">Cairo::RefPtr</a>&lt;<a class="el" href="classCairo_1_1XlibSurface.html">Cairo::XlibSurface</a>&gt; Cairo::XlibSurface::create_with_xrender_format </td>
          <td>(</td>
          <td class="paramtype">Display *&#160;</td>
          <td class="paramname"> <em>dpy</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">Drawable&#160;</td>
          <td class="paramname"> <em>drawable</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">Screen *&#160;</td>
          <td class="paramname"> <em>screen</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">XRenderPictFormat *&#160;</td>
          <td class="paramname"> <em>format</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&#160;</td>
          <td class="paramname"> <em>width</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&#160;</td>
          <td class="paramname"> <em>height</em></td><td>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td><code> [static]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Creates an Xlib surface that draws to the given drawable. </p>
<p>The way that colors are represented in the drawable is specified by the provided picture format.</p>
<p>Note: If  is a Window, then the function <a class="el" href="classCairo_1_1XlibSurface.html#a69b6337fa91dd53a054427e9a8235f16" title="Informs cairo of the new size of the X Drawable underlying the surface.">set_size()</a> must be called whenever the size of the window changes.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>dpy</em>&#160;</td><td>an X Display </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>drawable</em>&#160;</td><td>an X Drawable, (a Pixmap or a Window) </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>screen</em>&#160;</td><td>the X Screen associated with  </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>format</em>&#160;</td><td>the picture format to use for drawing to . The depth of  must match the depth of the drawable. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>width</em>&#160;</td><td>the current width of . </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>height</em>&#160;</td><td>the current height of .</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>the newly created surface </dd></dl>

</div>
</div>
<a class="anchor" id="a476e5ddd3deee79c8f47be01e1e0f7e7"></a><!-- doxytag: member="Cairo::XlibSurface::get_depth" ref="a476e5ddd3deee79c8f47be01e1e0f7e7" args="() const " -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int Cairo::XlibSurface::get_depth </td>
          <td>(</td>
          <td class="paramname"></td>
          <td>&#160;)&#160;</td>
          <td> const</td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Get the number of bits used to represent each pixel value. </p>

</div>
</div>
<a class="anchor" id="ad073af9affb7338e9b78589e7565a320"></a><!-- doxytag: member="Cairo::XlibSurface::get_display" ref="ad073af9affb7338e9b78589e7565a320" args="() const " -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">const Display* Cairo::XlibSurface::get_display </td>
          <td>(</td>
          <td class="paramname"></td>
          <td>&#160;)&#160;</td>
          <td> const</td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Get the X Display for the underlying X Drawable. </p>

</div>
</div>
<a class="anchor" id="afe98ccb169fe84f05ff7f2c1fb413a5a"></a><!-- doxytag: member="Cairo::XlibSurface::get_display" ref="afe98ccb169fe84f05ff7f2c1fb413a5a" args="()" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">Display* Cairo::XlibSurface::get_display </td>
          <td>(</td>
          <td class="paramname"></td>
          <td>&#160;)&#160;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Get the X Display for the underlying X Drawable. </p>

</div>
</div>
<a class="anchor" id="ae72506a16c6865a5709d38e2e33b1771"></a><!-- doxytag: member="Cairo::XlibSurface::get_drawable" ref="ae72506a16c6865a5709d38e2e33b1771" args="() const " -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">Drawable Cairo::XlibSurface::get_drawable </td>
          <td>(</td>
          <td class="paramname"></td>
          <td>&#160;)&#160;</td>
          <td> const</td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>gets the Drawable object associated with this surface </p>

</div>
</div>
<a class="anchor" id="a5ebd424f0c526c82141051a9824f3c69"></a><!-- doxytag: member="Cairo::XlibSurface::get_height" ref="a5ebd424f0c526c82141051a9824f3c69" args="() const " -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int Cairo::XlibSurface::get_height </td>
          <td>(</td>
          <td class="paramname"></td>
          <td>&#160;)&#160;</td>
          <td> const</td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Get the height in pixels of the X Drawable underlying the surface. </p>

</div>
</div>
<a class="anchor" id="a95da96899c1098dae4dc34d0b489d4b5"></a><!-- doxytag: member="Cairo::XlibSurface::get_screen" ref="a95da96899c1098dae4dc34d0b489d4b5" args="()" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">Screen* Cairo::XlibSurface::get_screen </td>
          <td>(</td>
          <td class="paramname"></td>
          <td>&#160;)&#160;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Get the X Screen for the underlying X Drawable. </p>

</div>
</div>
<a class="anchor" id="ae0a1ccd477c2e5691b5a748c71191338"></a><!-- doxytag: member="Cairo::XlibSurface::get_screen" ref="ae0a1ccd477c2e5691b5a748c71191338" args="() const " -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">const Screen* Cairo::XlibSurface::get_screen </td>
          <td>(</td>
          <td class="paramname"></td>
          <td>&#160;)&#160;</td>
          <td> const</td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Get the X Screen for the underlying X Drawable. </p>

</div>
</div>
<a class="anchor" id="a2e1b0cc64bd149a141a08112236726a1"></a><!-- doxytag: member="Cairo::XlibSurface::get_visual" ref="a2e1b0cc64bd149a141a08112236726a1" args="() const " -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">const Visual* Cairo::XlibSurface::get_visual </td>
          <td>(</td>
          <td class="paramname"></td>
          <td>&#160;)&#160;</td>
          <td> const</td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Get the X Visual for the underlying X Drawable. </p>

</div>
</div>
<a class="anchor" id="ada56c72e6f48420340a0bc4ae0ae22b0"></a><!-- doxytag: member="Cairo::XlibSurface::get_visual" ref="ada56c72e6f48420340a0bc4ae0ae22b0" args="()" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">Visual* Cairo::XlibSurface::get_visual </td>
          <td>(</td>
          <td class="paramname"></td>
          <td>&#160;)&#160;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Get the X Visual for the underlying X Drawable. </p>

</div>
</div>
<a class="anchor" id="a8cce1064a3f867657eb31e83d1dd464d"></a><!-- doxytag: member="Cairo::XlibSurface::get_width" ref="a8cce1064a3f867657eb31e83d1dd464d" args="() const " -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int Cairo::XlibSurface::get_width </td>
          <td>(</td>
          <td class="paramname"></td>
          <td>&#160;)&#160;</td>
          <td> const</td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Get the width in pixels of the X Drawable underlying the surface. </p>

</div>
</div>
<a class="anchor" id="a285b8e6394c22f395cca79c92dc17429"></a><!-- doxytag: member="Cairo::XlibSurface::get_xrender_format" ref="a285b8e6394c22f395cca79c92dc17429" args="() const " -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">XRenderPictFormat* Cairo::XlibSurface::get_xrender_format </td>
          <td>(</td>
          <td class="paramname"></td>
          <td>&#160;)&#160;</td>
          <td> const</td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Gets the X Render picture format that  uses for rendering with the X Render extension. </p>
<p>If the surface was created by cairo_xlib_surface_create_with_xrender_format() originally, the return value is the format passed to that constructor.</p>
<p>Return value: the XRenderPictFormat* associated with , or NULL if the surface is not an xlib surface or if the X Render extension is not available.</p>
<p>Since: 1.6 </p>

</div>
</div>
<a class="anchor" id="a92f59aab3ce0a113df0f6de18f306816"></a><!-- doxytag: member="Cairo::XlibSurface::set_drawable" ref="a92f59aab3ce0a113df0f6de18f306816" args="(Drawable drawable, int width, int height)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void Cairo::XlibSurface::set_drawable </td>
          <td>(</td>
          <td class="paramtype">Drawable&#160;</td>
          <td class="paramname"> <em>drawable</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&#160;</td>
          <td class="paramname"> <em>width</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&#160;</td>
          <td class="paramname"> <em>height</em></td><td>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Informs cairo of a new X Drawable underlying the surface. </p>
<p>The drawable must match the display, screen and format of the existing drawable or the application will get X protocol errors and will probably terminate. No checks are done by this function to ensure this compatibility.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>drawable</em>&#160;</td><td>the new drawable for the surface </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>width</em>&#160;</td><td>the width of the new drawable </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>height</em>&#160;</td><td>the height of the new drawable </td></tr>
  </table>
  </dd>
</dl>

</div>
</div>
<a class="anchor" id="a69b6337fa91dd53a054427e9a8235f16"></a><!-- doxytag: member="Cairo::XlibSurface::set_size" ref="a69b6337fa91dd53a054427e9a8235f16" args="(int width, int height)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void Cairo::XlibSurface::set_size </td>
          <td>(</td>
          <td class="paramtype">int&#160;</td>
          <td class="paramname"> <em>width</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&#160;</td>
          <td class="paramname"> <em>height</em></td><td>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Informs cairo of the new size of the X Drawable underlying the surface. </p>
<p>For a surface created for a Window (rather than a Pixmap), this function must be called each time the size of the window changes. (For a subwindow, you are normally resizing the window yourself, but for a toplevel window, it is necessary to listen for ConfigureNotify events.)</p>
<p>A Pixmap can never change size, so it is never necessary to call this function on a surface created for a Pixmap.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>width</em>&#160;</td><td>the new width of the surface </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>height</em>&#160;</td><td>the new height of the surface </td></tr>
  </table>
  </dd>
</dl>

</div>
</div>
<hr/>The documentation for this class was generated from the following file:<ul>
<li>cairomm/xlib_surface.h</li>
</ul>
</div>
<hr class="footer"/><address class="footer"><small>Generated on Thu Dec 30 2010 22:31:50 for cairomm by&#160;
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.7.1 </small></address>
</body>
</html>