Sophie

Sophie

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

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::PsSurface 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_1PsSurface.html">Cairo::PsSurface</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::PsSurface Class Reference</h1>  </div>
</div>
<div class="contents">
<!-- doxytag: class="Cairo::PsSurface" --><!-- doxytag: inherits="Cairo::Surface" -->
<p>A <a class="el" href="classCairo_1_1PsSurface.html" title="A PsSurface provides a way to render PostScript documents from cairo.">PsSurface</a> provides a way to render PostScript documents from cairo.  
<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_1PsSurface-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_1PsSurface.html#a0b84b39dd7188da7e785ee8af85374f1">PsSurface</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="#a0b84b39dd7188da7e785ee8af85374f1"></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_1PsSurface.html#a118c07206670cc3535c739599d4d10d3">~PsSurface</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_1PsSurface.html#a9de17b1a3db7227a4f16fbf08a4cef2a">set_size</a> (double width_in_points, double height_in_points)</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Changes the size of a PostScript surface for the current (and subsequent) pages.  <a href="#a9de17b1a3db7227a4f16fbf08a4cef2a"></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_1PsSurface.html#a9cd275173ea5dd88eeb485aab614cf92">dsc_comment</a> (<a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00237.html">std::string</a> comment)</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Emit a comment into the PostScript output for the given surface.  <a href="#a9cd275173ea5dd88eeb485aab614cf92"></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_1PsSurface.html#a2c72ddaa92aaf109511586e445309131">dsc_begin_setup</a> ()</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">This function indicates that subsequent calls to <a class="el" href="classCairo_1_1PsSurface.html#a9cd275173ea5dd88eeb485aab614cf92" title="Emit a comment into the PostScript output for the given surface.">dsc_comment()</a> should direct comments to the Setup section of the PostScript output.  <a href="#a2c72ddaa92aaf109511586e445309131"></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_1PsSurface.html#adcaaa1cf7f554e71f85039424726f6c9">dsc_begin_page_setup</a> ()</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">This function indicates that subsequent calls to <a class="el" href="classCairo_1_1PsSurface.html#a9cd275173ea5dd88eeb485aab614cf92" title="Emit a comment into the PostScript output for the given surface.">dsc_comment()</a> should direct comments to the PageSetup section of the PostScript output.  <a href="#adcaaa1cf7f554e71f85039424726f6c9"></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_1PsSurface.html#aa2424e42623eb0c410573b465f7b0f00">set_eps</a> (bool eps)</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">If eps is true, the PostScript surface will output Encapsulated PostScript.  <a href="#aa2424e42623eb0c410573b465f7b0f00"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classCairo_1_1PsSurface.html#af31ab624b15d1d8a36ee6e06e3980cc9">get_eps</a> () const </td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Check whether the PostScript surface will output Encapsulated PostScript.  <a href="#af31ab624b15d1d8a36ee6e06e3980cc9"></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_1PsSurface.html#a2db7043f9b80e2d2082a66ba419b5d46">restrict_to_level</a> (<a class="el" href="namespaceCairo.html#a452db49f19542c791e4a331f052a9a00">PsLevel</a> level)</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Restricts the generated PostSript file to .  <a href="#a2db7043f9b80e2d2082a66ba419b5d46"></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_1PsSurface.html">PsSurface</a> &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classCairo_1_1PsSurface.html#a0d7a34b58211563e2b1f2f4f85818e90">create</a> (<a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00237.html">std::string</a> filename, double width_in_points, double height_in_points)</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Creates a <a class="el" href="classCairo_1_1PsSurface.html" title="A PsSurface provides a way to render PostScript documents from cairo.">PsSurface</a> with a specified dimensions that will be saved as the given filename.  <a href="#a0d7a34b58211563e2b1f2f4f85818e90"></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_1PsSurface.html">PsSurface</a> &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classCairo_1_1PsSurface.html#aaa633e9ca0c424eae66d63826684f4d4">create_for_stream</a> (const <a class="el" href="classCairo_1_1Surface.html#a02fb9416d466b762bc5845b0ae204f49">SlotWriteFunc</a>&amp; write_func, double width_in_points, double height_in_points)</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Creates a <a class="el" href="classCairo_1_1PsSurface.html" title="A PsSurface provides a way to render PostScript documents from cairo.">PsSurface</a> with a specified dimensions that will be written to the given write function instead of saved directly to disk.  <a href="#aaa633e9ca0c424eae66d63826684f4d4"></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_1PsSurface.html">PsSurface</a> &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classCairo_1_1PsSurface.html#a108e885033a7a6c2697f7a94b40bb113">create</a> (cairo_write_func_t write_func, void* closure, double width_in_points, double height_in_points)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00640.html">std::vector</a>&lt; <a class="el" href="namespaceCairo.html#a452db49f19542c791e4a331f052a9a00">PsLevel</a> &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classCairo_1_1PsSurface.html#a63de398067f3af5e6179e057063cc76d">get_levels</a> ()</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Used to retrieve the list of supported levels.  <a href="#a63de398067f3af5e6179e057063cc76d"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00237.html">std::string</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classCairo_1_1PsSurface.html#a7afd98b03c189f1761cbe7e90db334dc">level_to_string</a> (<a class="el" href="namespaceCairo.html#a452db49f19542c791e4a331f052a9a00">PsLevel</a> level)</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Get the string representation of the given level id.  <a href="#a7afd98b03c189f1761cbe7e90db334dc"></a><br/></td></tr>
</table>
<hr/><a name="_details"></a><h2>Detailed Description</h2>
<p>A <a class="el" href="classCairo_1_1PsSurface.html" title="A PsSurface provides a way to render PostScript documents from cairo.">PsSurface</a> provides a way to render PostScript documents from cairo. </p>
<p>This surface is not rendered to the screen but instead renders the drawing to a PostScript file on disk.</p>
<dl class="note"><dt><b>Note:</b></dt><dd>For 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> to be available, cairo must have been compiled with PostScript support </dd></dl>
<hr/><h2>Constructor &amp; Destructor Documentation</h2>
<a class="anchor" id="a0b84b39dd7188da7e785ee8af85374f1"></a><!-- doxytag: member="Cairo::PsSurface::PsSurface" ref="a0b84b39dd7188da7e785ee8af85374f1" args="(cairo_surface_t *cobject, bool has_reference=false)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">Cairo::PsSurface::PsSurface </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="a118c07206670cc3535c739599d4d10d3"></a><!-- doxytag: member="Cairo::PsSurface::~PsSurface" ref="a118c07206670cc3535c739599d4d10d3" args="()" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">virtual Cairo::PsSurface::~PsSurface </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="a0d7a34b58211563e2b1f2f4f85818e90"></a><!-- doxytag: member="Cairo::PsSurface::create" ref="a0d7a34b58211563e2b1f2f4f85818e90" args="(std::string filename, double width_in_points, double height_in_points)" -->
<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_1PsSurface.html">PsSurface</a>&gt; Cairo::PsSurface::create </td>
          <td>(</td>
          <td class="paramtype"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00237.html">std::string</a>&#160;</td>
          <td class="paramname"> <em>filename</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">double&#160;</td>
          <td class="paramname"> <em>width_in_points</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">double&#160;</td>
          <td class="paramname"> <em>height_in_points</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 a <a class="el" href="classCairo_1_1PsSurface.html" title="A PsSurface provides a way to render PostScript documents from cairo.">PsSurface</a> with a specified dimensions that will be saved as the given filename. </p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>filename</em>&#160;</td><td>The name of the PostScript file to save the surface to </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>width_in_points</em>&#160;</td><td>The width of the PostScript document in points </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>height_in_points</em>&#160;</td><td>The height of the PostScript document in points </td></tr>
  </table>
  </dd>
</dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="ps-surface_8cc-example.html#a2">ps-surface.cc</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="a108e885033a7a6c2697f7a94b40bb113"></a><!-- doxytag: member="Cairo::PsSurface::create" ref="a108e885033a7a6c2697f7a94b40bb113" args="(cairo_write_func_t write_func, void *closure, double width_in_points, double height_in_points)" -->
<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_1PsSurface.html">PsSurface</a>&gt; Cairo::PsSurface::create </td>
          <td>(</td>
          <td class="paramtype">cairo_write_func_t&#160;</td>
          <td class="paramname"> <em>write_func</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">void *&#160;</td>
          <td class="paramname"> <em>closure</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">double&#160;</td>
          <td class="paramname"> <em>width_in_points</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">double&#160;</td>
          <td class="paramname"> <em>height_in_points</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">
<dl class="deprecated"><dt><b><a class="el" href="deprecated.html#_deprecated000014">Deprecated:</a></b></dt><dd>use <a class="el" href="classCairo_1_1PsSurface.html#aaa633e9ca0c424eae66d63826684f4d4" title="Creates a PsSurface with a specified dimensions that will be written to the given write function inst...">PsSurface::create_for_stream()</a> instead </dd></dl>

</div>
</div>
<a class="anchor" id="aaa633e9ca0c424eae66d63826684f4d4"></a><!-- doxytag: member="Cairo::PsSurface::create_for_stream" ref="aaa633e9ca0c424eae66d63826684f4d4" args="(const SlotWriteFunc &amp;write_func, double width_in_points, double height_in_points)" -->
<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_1PsSurface.html">PsSurface</a>&gt; Cairo::PsSurface::create_for_stream </td>
          <td>(</td>
          <td class="paramtype">const <a class="el" href="classCairo_1_1Surface.html#a02fb9416d466b762bc5845b0ae204f49">SlotWriteFunc</a>&amp;&#160;</td>
          <td class="paramname"> <em>write_func</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">double&#160;</td>
          <td class="paramname"> <em>width_in_points</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">double&#160;</td>
          <td class="paramname"> <em>height_in_points</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 a <a class="el" href="classCairo_1_1PsSurface.html" title="A PsSurface provides a way to render PostScript documents from cairo.">PsSurface</a> with a specified dimensions that will be written to the given write function instead of saved directly to disk. </p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>write_func</em>&#160;</td><td>The function to be called when the backend needs to write data to an output stream </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>width_in_points</em>&#160;</td><td>The width of the PostScript document in points </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>height_in_points</em>&#160;</td><td>The height of the PostScript document in points</td></tr>
  </table>
  </dd>
</dl>
<dl class="since"><dt><b>Since:</b></dt><dd>1.8 </dd></dl>

</div>
</div>
<a class="anchor" id="adcaaa1cf7f554e71f85039424726f6c9"></a><!-- doxytag: member="Cairo::PsSurface::dsc_begin_page_setup" ref="adcaaa1cf7f554e71f85039424726f6c9" args="()" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void Cairo::PsSurface::dsc_begin_page_setup </td>
          <td>(</td>
          <td class="paramname"></td>
          <td>&#160;)&#160;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>This function indicates that subsequent calls to <a class="el" href="classCairo_1_1PsSurface.html#a9cd275173ea5dd88eeb485aab614cf92" title="Emit a comment into the PostScript output for the given surface.">dsc_comment()</a> should direct comments to the PageSetup section of the PostScript output. </p>
<p>This function call is only needed for the first page of a surface. It should be called after any call to <a class="el" href="classCairo_1_1PsSurface.html#a2c72ddaa92aaf109511586e445309131" title="This function indicates that subsequent calls to dsc_comment() should direct comments to the Setup se...">dsc_begin_setup()</a> and before any drawing is performed to the surface. </p>

</div>
</div>
<a class="anchor" id="a2c72ddaa92aaf109511586e445309131"></a><!-- doxytag: member="Cairo::PsSurface::dsc_begin_setup" ref="a2c72ddaa92aaf109511586e445309131" args="()" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void Cairo::PsSurface::dsc_begin_setup </td>
          <td>(</td>
          <td class="paramname"></td>
          <td>&#160;)&#160;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>This function indicates that subsequent calls to <a class="el" href="classCairo_1_1PsSurface.html#a9cd275173ea5dd88eeb485aab614cf92" title="Emit a comment into the PostScript output for the given surface.">dsc_comment()</a> should direct comments to the Setup section of the PostScript output. </p>
<p>This function should be called at most once per surface, and must be called before any call to <a class="el" href="classCairo_1_1PsSurface.html#adcaaa1cf7f554e71f85039424726f6c9" title="This function indicates that subsequent calls to dsc_comment() should direct comments to the PageSetu...">dsc_begin_page_setup()</a> and before any drawing is performed to the surface. </p>

</div>
</div>
<a class="anchor" id="a9cd275173ea5dd88eeb485aab614cf92"></a><!-- doxytag: member="Cairo::PsSurface::dsc_comment" ref="a9cd275173ea5dd88eeb485aab614cf92" args="(std::string comment)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void Cairo::PsSurface::dsc_comment </td>
          <td>(</td>
          <td class="paramtype"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00237.html">std::string</a>&#160;</td>
          <td class="paramname"> <em>comment</em></td>
          <td>&#160;)&#160;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Emit a comment into the PostScript output for the given surface. </p>
<p>See the cairo reference documentation for more information.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>comment</em>&#160;</td><td>a comment string to be emitted into the PostScript output </td></tr>
  </table>
  </dd>
</dl>

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

<p>Check whether the PostScript surface will output Encapsulated PostScript. </p>
<dl class="since"><dt><b>Since:</b></dt><dd>1.8 </dd></dl>

</div>
</div>
<a class="anchor" id="a63de398067f3af5e6179e057063cc76d"></a><!-- doxytag: member="Cairo::PsSurface::get_levels" ref="a63de398067f3af5e6179e057063cc76d" args="()" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">static const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00640.html">std::vector</a>&lt;<a class="el" href="namespaceCairo.html#a452db49f19542c791e4a331f052a9a00">PsLevel</a>&gt; Cairo::PsSurface::get_levels </td>
          <td>(</td>
          <td class="paramname"></td>
          <td>&#160;)&#160;</td>
          <td><code> [static]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Used to retrieve the list of supported levels. </p>
<p>See <a class="el" href="classCairo_1_1PsSurface.html#a2db7043f9b80e2d2082a66ba419b5d46" title="Restricts the generated PostSript file to .">restrict_to_level()</a>.</p>
<dl class="since"><dt><b>Since:</b></dt><dd>1.6 </dd></dl>

</div>
</div>
<a class="anchor" id="a7afd98b03c189f1761cbe7e90db334dc"></a><!-- doxytag: member="Cairo::PsSurface::level_to_string" ref="a7afd98b03c189f1761cbe7e90db334dc" args="(PsLevel level)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">static <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00237.html">std::string</a> Cairo::PsSurface::level_to_string </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="namespaceCairo.html#a452db49f19542c791e4a331f052a9a00">PsLevel</a>&#160;</td>
          <td class="paramname"> <em>level</em></td>
          <td>&#160;)&#160;</td>
          <td><code> [static]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Get the string representation of the given level id. </p>
<p>This function will return an empty string if level id isn't valid. See <a class="el" href="classCairo_1_1PsSurface.html#a63de398067f3af5e6179e057063cc76d" title="Used to retrieve the list of supported levels.">get_levels()</a> for a way to get the list of valid level ids.</p>
<dl class="return"><dt><b>Returns:</b></dt><dd>the string associated to given level.</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>level</em>&#160;</td><td>a level id</td></tr>
  </table>
  </dd>
</dl>
<dl class="since"><dt><b>Since:</b></dt><dd>1.6 </dd></dl>

</div>
</div>
<a class="anchor" id="a2db7043f9b80e2d2082a66ba419b5d46"></a><!-- doxytag: member="Cairo::PsSurface::restrict_to_level" ref="a2db7043f9b80e2d2082a66ba419b5d46" args="(PsLevel level)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void Cairo::PsSurface::restrict_to_level </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="namespaceCairo.html#a452db49f19542c791e4a331f052a9a00">PsLevel</a>&#160;</td>
          <td class="paramname"> <em>level</em></td>
          <td>&#160;)&#160;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Restricts the generated PostSript file to . </p>
<p>See <a class="el" href="classCairo_1_1PsSurface.html#a63de398067f3af5e6179e057063cc76d" title="Used to retrieve the list of supported levels.">get_levels()</a> for a list of available level values that can be used here.</p>
<p>This function should only be called before any drawing operations have been performed on the given surface. The simplest way to do this is to call this function immediately after creating the surface.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>level</em>&#160;</td><td>PostScript level</td></tr>
  </table>
  </dd>
</dl>
<dl class="since"><dt><b>Since:</b></dt><dd>1.6 </dd></dl>

</div>
</div>
<a class="anchor" id="aa2424e42623eb0c410573b465f7b0f00"></a><!-- doxytag: member="Cairo::PsSurface::set_eps" ref="aa2424e42623eb0c410573b465f7b0f00" args="(bool eps)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void Cairo::PsSurface::set_eps </td>
          <td>(</td>
          <td class="paramtype">bool&#160;</td>
          <td class="paramname"> <em>eps</em></td>
          <td>&#160;)&#160;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>If eps is true, the PostScript surface will output Encapsulated PostScript. </p>
<p>This function should only be called before any drawing operations have been performed on the current page. The simplest way to do this is to call this function immediately after creating the surface. An Encapsulated Postscript file should never contain more than one page.</p>
<dl class="since"><dt><b>Since:</b></dt><dd>1.6 </dd></dl>

</div>
</div>
<a class="anchor" id="a9de17b1a3db7227a4f16fbf08a4cef2a"></a><!-- doxytag: member="Cairo::PsSurface::set_size" ref="a9de17b1a3db7227a4f16fbf08a4cef2a" args="(double width_in_points, double height_in_points)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void Cairo::PsSurface::set_size </td>
          <td>(</td>
          <td class="paramtype">double&#160;</td>
          <td class="paramname"> <em>width_in_points</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">double&#160;</td>
          <td class="paramname"> <em>height_in_points</em></td><td>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Changes the size of a PostScript surface for the current (and subsequent) pages. </p>
<p>This function should only be called before any drawing operations have been performed on the current page. The simplest way to do this is to call this function immediately after creating the surface or immediately after completing a page with either <a class="el" href="classCairo_1_1Context.html#a525cac95b4d4c2abea12b82c433adba9">Context::show_page()</a> or <a class="el" href="classCairo_1_1Context.html#a7ccbeacb2a7f2d787b3daf31a69383fd">Context::copy_page()</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>width_in_points</em>&#160;</td><td>new surface width, in points (1 point == 1/72.0 inch) </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>height_in_points</em>&#160;</td><td>new surface height, in points (1 point == 1/72.0 inch) </td></tr>
  </table>
  </dd>
</dl>

</div>
</div>
<hr/>The documentation for this class was generated from the following file:<ul>
<li>cairomm/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>