RubyGems - cairo - Versions diffs - 1.12.4-x86-mingw32 → 1.12.5-x86-mingw32 - Mend

cairo 1.12.4-x86-mingw32 → 1.12.5-x86-mingw32

Potentially problematic release.

This version of cairo might be problematic. Click here for more details.

Files changed (931) hide show

data/vendor/local/share/gtk-doc/html/cairo/cairo-FreeType-Fonts.html CHANGED Viewed

@@ -3,12 +3,12 @@
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>FreeType Fonts</title>
-<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
+<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
 <link rel="home" href="index.html" title="Cairo: A Vector Graphics Library">
 <link rel="up" href="cairo-fonts.html" title="Fonts">
 <link rel="prev" href="cairo-cairo-font-options-t.html" title="cairo_font_options_t">
 <link rel="next" href="cairo-Win32-Fonts.html" title="Win32 Fonts">
-<meta name="generator" content="GTK-Doc V1.15 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.18 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -26,7 +26,7 @@
                   <a href="#cairo-FreeType-Fonts.description" class="shortcut">Description</a>
 </td></tr>
 </table>
-<div class="refentry" title="FreeType Fonts">
+<div class="refentry">
 <a name="cairo-FreeType-Fonts"></a><div class="titlepage"></div>
 <div class="refnamediv"><table width="100%"><tr>
 <td valign="top">
@@ -35,7 +35,7 @@
 </td>
 <td valign="top" align="right"></td>
 </tr></table></div>
-<div class="refsynopsisdiv" title="Synopsis">
+<div class="refsynopsisdiv">
 <a name="cairo-FreeType-Fonts.synopsis"></a><h2>Synopsis</h2>
 <pre class="synopsis">#define             <a class="link" href="cairo-FreeType-Fonts.html#CAIRO-HAS-FT-FONT:CAPS" title="CAIRO_HAS_FT_FONT">CAIRO_HAS_FT_FONT</a>
 #define             <a class="link" href="cairo-FreeType-Fonts.html#CAIRO-HAS-FC-FONT:CAPS" title="CAIRO_HAS_FC_FONT">CAIRO_HAS_FC_FONT</a>
@@ -48,18 +48,24 @@
                                                          <em class="parameter"><code><span class="type">FcPattern</span> *pattern</code></em>);
 <span class="returnvalue">FT_Face</span>             <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-scaled-font-lock-face" title="cairo_ft_scaled_font_lock_face ()">cairo_ft_scaled_font_lock_face</a>      (<em class="parameter"><code><a class="link" href="cairo-cairo-scaled-font-t.html#cairo-scaled-font-t" title="cairo_scaled_font_t"><span class="type">cairo_scaled_font_t</span></a> *scaled_font</code></em>);
 <span class="returnvalue">void</span>                <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-scaled-font-unlock-face" title="cairo_ft_scaled_font_unlock_face ()">cairo_ft_scaled_font_unlock_face</a>    (<em class="parameter"><code><a class="link" href="cairo-cairo-scaled-font-t.html#cairo-scaled-font-t" title="cairo_scaled_font_t"><span class="type">cairo_scaled_font_t</span></a> *scaled_font</code></em>);
+enum                <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-synthesize-t" title="enum cairo_ft_synthesize_t">cairo_ft_synthesize_t</a>;
+unsigned <span class="returnvalue">int</span>        <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-font-face-get-synthesize" title="cairo_ft_font_face_get_synthesize ()">cairo_ft_font_face_get_synthesize</a>   (<em class="parameter"><code><a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-t" title="cairo_font_face_t"><span class="type">cairo_font_face_t</span></a> *font_face</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-font-face-set-synthesize" title="cairo_ft_font_face_set_synthesize ()">cairo_ft_font_face_set_synthesize</a>   (<em class="parameter"><code><a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-t" title="cairo_font_face_t"><span class="type">cairo_font_face_t</span></a> *font_face</code></em>,
+                                                         <em class="parameter"><code>unsigned <span class="type">int</span> synth_flags</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-font-face-unset-synthesize" title="cairo_ft_font_face_unset_synthesize ()">cairo_ft_font_face_unset_synthesize</a> (<em class="parameter"><code><a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-t" title="cairo_font_face_t"><span class="type">cairo_font_face_t</span></a> *font_face</code></em>,
+                                                         <em class="parameter"><code>unsigned <span class="type">int</span> synth_flags</code></em>);
 </pre>
 </div>
-<div class="refsect1" title="Description">
+<div class="refsect1">
 <a name="cairo-FreeType-Fonts.description"></a><h2>Description</h2>
 <p>
 The FreeType font backend is primarily used to render text on GNU/Linux
 systems, but can be used on other platforms too.
 </p>
 </div>
-<div class="refsect1" title="Details">
+<div class="refsect1">
 <a name="cairo-FreeType-Fonts.details"></a><h2>Details</h2>
-<div class="refsect2" title="CAIRO_HAS_FT_FONT">
+<div class="refsect2">
 <a name="CAIRO-HAS-FT-FONT:CAPS"></a><h3>CAIRO_HAS_FT_FONT</h3>
 <pre class="programlisting">#define CAIRO_HAS_FT_FONT 1
 </pre>
@@ -67,9 +73,10 @@ systems, but can be used on other platforms too.
 Defined if the FreeType font backend is available.
 This macro can be used to conditionally compile backend-specific code.
 </p>
+<p class="since">Since 1.0</p>
 </div>
 <hr>
-<div class="refsect2" title="CAIRO_HAS_FC_FONT">
+<div class="refsect2">
 <a name="CAIRO-HAS-FC-FONT:CAPS"></a><h3>CAIRO_HAS_FC_FONT</h3>
 <pre class="programlisting">#define CAIRO_HAS_FC_FONT 1
 </pre>
@@ -78,9 +85,10 @@ Defined if the Fontconfig-specific functions of the FreeType font backend
 are available.
 This macro can be used to conditionally compile backend-specific code.
 </p>
+<p class="since">Since 1.10</p>
 </div>
 <hr>
-<div class="refsect2" title="cairo_ft_font_face_create_for_ft_face ()">
+<div class="refsect2">
 <a name="cairo-ft-font-face-create-for-ft-face"></a><h3>cairo_ft_font_face_create_for_ft_face ()</h3>
 <pre class="programlisting"><a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-t" title="cairo_font_face_t"><span class="returnvalue">cairo_font_face_t</span></a> * cairo_ft_font_face_create_for_ft_face
                                                         (<em class="parameter"><code><span class="type">FT_Face</span> face</code></em>,
@@ -103,18 +111,35 @@ the FreeType face object to the <a class="link" href="cairo-cairo-font-face-t.ht
 </p>
 <p>
 </p>
-<div class="informalexample"><pre class="programlisting">
-static const cairo_user_data_key_t key;
+<div class="informalexample">
+  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
+    <tbody>
+      <tr>
+        <td class="listing_lines" align="right"><pre>1
+2
+3
+4
+5
+6
+7
+8
+9
+10</pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="gtkdoc kwb">static const</span> cairo_user_data_key_t key<span class="gtkdoc opt">;</span>
+font_face <span class="gtkdoc opt">=</span> <span class="function"><a href="../cairo/cairo-FreeType-Fonts.html#cairo-ft-font-face-create-for-ft-face">cairo_ft_font_face_create_for_ft_face</a></span> <span class="gtkdoc opt">(</span>ft_face<span class="gtkdoc opt">,</span> <span class="number">0</span><span class="gtkdoc opt">);</span>
+status <span class="gtkdoc opt">=</span> <span class="function"><a href="../cairo/cairo-cairo-font-face-t.html#cairo-font-face-set-user-data">cairo_font_face_set_user_data</a></span> <span class="gtkdoc opt">(</span>font_face<span class="gtkdoc opt">, &amp;</span>key<span class="gtkdoc opt">,</span>
+                               ft_face<span class="gtkdoc opt">, (</span>cairo_destroy_func_t<span class="gtkdoc opt">)</span> FT_Done_Face<span class="gtkdoc opt">);</span>
+<span class="keyword">if</span> <span class="gtkdoc opt">(</span>status<span class="gtkdoc opt">) {</span>
+   <span class="function"><a href="../cairo/cairo-cairo-font-face-t.html#cairo-font-face-destroy">cairo_font_face_destroy</a></span> <span class="gtkdoc opt">(</span>font_face<span class="gtkdoc opt">);</span>
+   <span class="function">FT_Done_Face</span> <span class="gtkdoc opt">(</span>ft_face<span class="gtkdoc opt">);</span>
+   <span class="keyword">return</span> ERROR<span class="gtkdoc opt">;</span>
+<span class="gtkdoc opt">}</span></pre></td>
+      </tr>
+    </tbody>
+  </table>
+</div>
-font_face = cairo_ft_font_face_create_for_ft_face (ft_face, 0);
-status = cairo_font_face_set_user_data (font_face, &amp;key,
-                               ft_face, (cairo_destroy_func_t) FT_Done_Face);
-if (status) {
-   cairo_font_face_destroy (font_face);
-   FT_Done_Face (ft_face);
-   return ERROR;
-}
-</pre></div>
 <p>
 </p>
 <div class="variablelist"><table border="0">
@@ -123,35 +148,34 @@ if (status) {
 <tr>
 <td><p><span class="term"><em class="parameter"><code>face</code></em> :</span></p></td>
 <td>A FreeType face object, already opened. This must
-  be kept around until the face's ref_count drops to
-  zero and it is freed. Since the face may be referenced
-  internally to Cairo, the best way to determine when it
-  is safe to free the face is to pass a
-  <a class="link" href="cairo-Types.html#cairo-destroy-func-t" title="cairo_destroy_func_t ()"><span class="type">cairo_destroy_func_t</span></a> to <a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-set-user-data" title="cairo_font_face_set_user_data ()"><code class="function">cairo_font_face_set_user_data()</code></a>
+be kept around until the face's ref_count drops to
+zero and it is freed. Since the face may be referenced
+internally to Cairo, the best way to determine when it
+is safe to free the face is to pass a
+<a class="link" href="cairo-Types.html#cairo-destroy-func-t" title="cairo_destroy_func_t ()"><span class="type">cairo_destroy_func_t</span></a> to <a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-set-user-data" title="cairo_font_face_set_user_data ()"><code class="function">cairo_font_face_set_user_data()</code></a>
 </td>
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>load_flags</code></em> :</span></p></td>
 <td>flags to pass to FT_Load_Glyph when loading
-  glyphs from the font. These flags are OR'ed together with
-  the flags derived from the <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a> passed
-  to <a class="link" href="cairo-cairo-scaled-font-t.html#cairo-scaled-font-create" title="cairo_scaled_font_create ()"><code class="function">cairo_scaled_font_create()</code></a>, so only a few values such
-  as <code class="literal">FT_LOAD_VERTICAL_LAYOUT</code>, and <code class="literal">FT_LOAD_FORCE_AUTOHINT</code>
-  are useful. You should not pass any of the flags affecting
-  the load target, such as <code class="literal">FT_LOAD_TARGET_LIGHT</code>.
-</td>
+glyphs from the font. These flags are OR'ed together with
+the flags derived from the <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a> passed
+to <a class="link" href="cairo-cairo-scaled-font-t.html#cairo-scaled-font-create" title="cairo_scaled_font_create ()"><code class="function">cairo_scaled_font_create()</code></a>, so only a few values such
+as <code class="literal">FT_LOAD_VERTICAL_LAYOUT</code>, and <code class="literal">FT_LOAD_FORCE_AUTOHINT</code>
+are useful. You should not pass any of the flags affecting
+the load target, such as <code class="literal">FT_LOAD_TARGET_LIGHT</code>.</td>
 </tr>
 <tr>
 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
-<td> a newly created <a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-t" title="cairo_font_face_t"><span class="type">cairo_font_face_t</span></a>. Free with
- <a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-destroy" title="cairo_font_face_destroy ()"><code class="function">cairo_font_face_destroy()</code></a> when you are done using it.
-</td>
+<td>a newly created <a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-t" title="cairo_font_face_t"><span class="type">cairo_font_face_t</span></a>. Free with
+<a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-destroy" title="cairo_font_face_destroy ()"><code class="function">cairo_font_face_destroy()</code></a> when you are done using it.</td>
 </tr>
 </tbody>
 </table></div>
+<p class="since">Since 1.0</p>
 </div>
 <hr>
-<div class="refsect2" title="cairo_ft_font_face_create_for_pattern ()">
+<div class="refsect2">
 <a name="cairo-ft-font-face-create-for-pattern"></a><h3>cairo_ft_font_face_create_for_pattern ()</h3>
 <pre class="programlisting"><a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-t" title="cairo_font_face_t"><span class="returnvalue">cairo_font_face_t</span></a> * cairo_ft_font_face_create_for_pattern
                                                         (<em class="parameter"><code><span class="type">FcPattern</span> *pattern</code></em>);</pre>
@@ -186,7 +210,7 @@ and the resulting font pattern is used.
 If the FC_FT_FACE element of <em class="parameter"><code>pattern</code></em> is set, the user is responsible
 for making sure that the referenced FT_Face remains valid for the life
 time of the returned <a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-t" title="cairo_font_face_t"><span class="type">cairo_font_face_t</span></a>.  See
-<a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-font-face-create-for-ft-face" title="cairo_ft_font_face_create_for_ft_face ()"><code class="function">cairo_ft_font_face_create_for_ft_face()</code></a> for an exmaple of how to couple
+<a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-font-face-create-for-ft-face" title="cairo_ft_font_face_create_for_ft_face ()"><code class="function">cairo_ft_font_face_create_for_ft_face()</code></a> for an example of how to couple
 the life time of the FT_Face to that of the cairo font-face.
 </p>
 <div class="variablelist"><table border="0">
@@ -195,20 +219,19 @@ the life time of the FT_Face to that of the cairo font-face.
 <tr>
 <td><p><span class="term"><em class="parameter"><code>pattern</code></em> :</span></p></td>
 <td>A fontconfig pattern.  Cairo makes a copy of the pattern
-if it needs to.  You are free to modify or free <em class="parameter"><code>pattern</code></em> after this call.
-</td>
+if it needs to.  You are free to modify or free <em class="parameter"><code>pattern</code></em> after this call.</td>
 </tr>
 <tr>
 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
-<td> a newly created <a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-t" title="cairo_font_face_t"><span class="type">cairo_font_face_t</span></a>. Free with
- <a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-destroy" title="cairo_font_face_destroy ()"><code class="function">cairo_font_face_destroy()</code></a> when you are done using it.
-</td>
+<td>a newly created <a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-t" title="cairo_font_face_t"><span class="type">cairo_font_face_t</span></a>. Free with
+<a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-destroy" title="cairo_font_face_destroy ()"><code class="function">cairo_font_face_destroy()</code></a> when you are done using it.</td>
 </tr>
 </tbody>
 </table></div>
+<p class="since">Since 1.0</p>
 </div>
 <hr>
-<div class="refsect2" title="cairo_ft_font_options_substitute ()">
+<div class="refsect2">
 <a name="cairo-ft-font-options-substitute"></a><h3>cairo_ft_font_options_substitute ()</h3>
 <pre class="programlisting"><span class="returnvalue">void</span>                cairo_ft_font_options_substitute    (<em class="parameter"><code>const <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a> *options</code></em>,
                                                          <em class="parameter"><code><span class="type">FcPattern</span> *pattern</code></em>);</pre>
@@ -224,8 +247,7 @@ before calling <code class="function">FcDefaultSubstitute()</code>.
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>options</code></em> :</span></p></td>
-<td>a <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a> object
-</td>
+<td>a <a class="link" href="cairo-cairo-font-options-t.html#cairo-font-options-t" title="cairo_font_options_t"><span class="type">cairo_font_options_t</span></a> object</td>
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>pattern</code></em> :</span></p></td>
@@ -234,9 +256,10 @@ before calling <code class="function">FcDefaultSubstitute()</code>.
 </tr>
 </tbody>
 </table></div>
+<p class="since">Since 1.0</p>
 </div>
 <hr>
-<div class="refsect2" title="cairo_ft_scaled_font_lock_face ()">
+<div class="refsect2">
 <a name="cairo-ft-scaled-font-lock-face"></a><h3>cairo_ft_scaled_font_lock_face ()</h3>
 <pre class="programlisting"><span class="returnvalue">FT_Face</span>             cairo_ft_scaled_font_lock_face      (<em class="parameter"><code><a class="link" href="cairo-cairo-scaled-font-t.html#cairo-scaled-font-t" title="cairo_scaled_font_t"><span class="type">cairo_scaled_font_t</span></a> *scaled_font</code></em>);</pre>
 <p>
@@ -266,23 +289,22 @@ might result in a call into the freetype library).
 <tr>
 <td><p><span class="term"><em class="parameter"><code>scaled_font</code></em> :</span></p></td>
 <td>A <a class="link" href="cairo-cairo-scaled-font-t.html#cairo-scaled-font-t" title="cairo_scaled_font_t"><span class="type">cairo_scaled_font_t</span></a> from the FreeType font backend. Such an
-  object can be created by calling <a class="link" href="cairo-cairo-scaled-font-t.html#cairo-scaled-font-create" title="cairo_scaled_font_create ()"><code class="function">cairo_scaled_font_create()</code></a> on a
-  FreeType backend font face (see <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-font-face-create-for-pattern" title="cairo_ft_font_face_create_for_pattern ()"><code class="function">cairo_ft_font_face_create_for_pattern()</code></a>,
-  <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-font-face-create-for-ft-face" title="cairo_ft_font_face_create_for_ft_face ()"><code class="function">cairo_ft_font_face_create_for_ft_face()</code></a>).
-</td>
+object can be created by calling <a class="link" href="cairo-cairo-scaled-font-t.html#cairo-scaled-font-create" title="cairo_scaled_font_create ()"><code class="function">cairo_scaled_font_create()</code></a> on a
+FreeType backend font face (see <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-font-face-create-for-pattern" title="cairo_ft_font_face_create_for_pattern ()"><code class="function">cairo_ft_font_face_create_for_pattern()</code></a>,
+<a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-font-face-create-for-ft-face" title="cairo_ft_font_face_create_for_ft_face ()"><code class="function">cairo_ft_font_face_create_for_ft_face()</code></a>).</td>
 </tr>
 <tr>
 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
-<td> The <span class="type">FT_Face</span> object for <em class="parameter"><code>font</code></em>, scaled appropriately,
-or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>scaled_font</code></em> is in an error state (see
-<a class="link" href="cairo-cairo-scaled-font-t.html#cairo-scaled-font-status" title="cairo_scaled_font_status ()"><code class="function">cairo_scaled_font_status()</code></a>) or there is insufficient memory.
-</td>
+<td>The <span class="type">FT_Face</span> object for <em class="parameter"><code>font</code></em>, scaled appropriately,
+or <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>scaled_font</code></em> is in an error state (see
+<a class="link" href="cairo-cairo-scaled-font-t.html#cairo-scaled-font-status" title="cairo_scaled_font_status ()"><code class="function">cairo_scaled_font_status()</code></a>) or there is insufficient memory.</td>
 </tr>
 </tbody>
 </table></div>
+<p class="since">Since 1.0</p>
 </div>
 <hr>
-<div class="refsect2" title="cairo_ft_scaled_font_unlock_face ()">
+<div class="refsect2">
 <a name="cairo-ft-scaled-font-unlock-face"></a><h3>cairo_ft_scaled_font_unlock_face ()</h3>
 <pre class="programlisting"><span class="returnvalue">void</span>                cairo_ft_scaled_font_unlock_face    (<em class="parameter"><code><a class="link" href="cairo-cairo-scaled-font-t.html#cairo-scaled-font-t" title="cairo_scaled_font_t"><span class="type">cairo_scaled_font_t</span></a> *scaled_font</code></em>);</pre>
 <p>
@@ -293,21 +315,131 @@ Releases a face obtained with <a class="link" href="cairo-FreeType-Fonts.html#ca
 <tbody><tr>
 <td><p><span class="term"><em class="parameter"><code>scaled_font</code></em> :</span></p></td>
 <td>A <a class="link" href="cairo-cairo-scaled-font-t.html#cairo-scaled-font-t" title="cairo_scaled_font_t"><span class="type">cairo_scaled_font_t</span></a> from the FreeType font backend. Such an
-  object can be created by calling <a class="link" href="cairo-cairo-scaled-font-t.html#cairo-scaled-font-create" title="cairo_scaled_font_create ()"><code class="function">cairo_scaled_font_create()</code></a> on a
-  FreeType backend font face (see <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-font-face-create-for-pattern" title="cairo_ft_font_face_create_for_pattern ()"><code class="function">cairo_ft_font_face_create_for_pattern()</code></a>,
-  <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-font-face-create-for-ft-face" title="cairo_ft_font_face_create_for_ft_face ()"><code class="function">cairo_ft_font_face_create_for_ft_face()</code></a>).
-</td>
+object can be created by calling <a class="link" href="cairo-cairo-scaled-font-t.html#cairo-scaled-font-create" title="cairo_scaled_font_create ()"><code class="function">cairo_scaled_font_create()</code></a> on a
+FreeType backend font face (see <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-font-face-create-for-pattern" title="cairo_ft_font_face_create_for_pattern ()"><code class="function">cairo_ft_font_face_create_for_pattern()</code></a>,
+<a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-font-face-create-for-ft-face" title="cairo_ft_font_face_create_for_ft_face ()"><code class="function">cairo_ft_font_face_create_for_ft_face()</code></a>).</td>
 </tr></tbody>
 </table></div>
+<p class="since">Since 1.0</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="cairo-ft-synthesize-t"></a><h3>enum cairo_ft_synthesize_t</h3>
+<pre class="programlisting">typedef enum {
+    CAIRO_FT_SYNTHESIZE_BOLD = 1 &lt;&lt; 0,
+    CAIRO_FT_SYNTHESIZE_OBLIQUE = 1 &lt;&lt; 1
+} cairo_ft_synthesize_t;
+</pre>
+<p>
+A set of synthesis options to control how FreeType renders the glyphs
+for a particular font face.
+</p>
+<p>
+Individual synthesis features of a <span class="type">cairo_ft_font_face_t</span> can be set
+using <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-font-face-set-synthesize" title="cairo_ft_font_face_set_synthesize ()"><code class="function">cairo_ft_font_face_set_synthesize()</code></a>, or disabled using
+<a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-font-face-unset-synthesize" title="cairo_ft_font_face_unset_synthesize ()"><code class="function">cairo_ft_font_face_unset_synthesize()</code></a>. The currently enabled set of
+synthesis options can be queried with <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-font-face-get-synthesize" title="cairo_ft_font_face_get_synthesize ()"><code class="function">cairo_ft_font_face_get_synthesize()</code></a>.
+</p>
+<p>
+Note: that when synthesizing glyphs, the font metrics returned will only
+be estimates.
+</p>
+<div class="variablelist"><table border="0">
+<col align="left" valign="top">
+<tbody>
+<tr>
+<td><p><a name="CAIRO-FT-SYNTHESIZE-BOLD:CAPS"></a><span class="term"><code class="literal">CAIRO_FT_SYNTHESIZE_BOLD</code></span></p></td>
+<td>Embolden the glyphs (redraw with a pixel offset)
+</td>
+</tr>
+<tr>
+<td><p><a name="CAIRO-FT-SYNTHESIZE-OBLIQUE:CAPS"></a><span class="term"><code class="literal">CAIRO_FT_SYNTHESIZE_OBLIQUE</code></span></p></td>
+<td>Slant the glyph outline by 12 degrees to the
+right.
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 1.12</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="cairo-ft-font-face-get-synthesize"></a><h3>cairo_ft_font_face_get_synthesize ()</h3>
+<pre class="programlisting">unsigned <span class="returnvalue">int</span>        cairo_ft_font_face_get_synthesize   (<em class="parameter"><code><a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-t" title="cairo_font_face_t"><span class="type">cairo_font_face_t</span></a> *font_face</code></em>);</pre>
+<p>
+See <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-synthesize-t" title="enum cairo_ft_synthesize_t"><span class="type">cairo_ft_synthesize_t</span></a>.
+</p>
+<div class="variablelist"><table border="0">
+<col align="left" valign="top">
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>font_face</code></em> :</span></p></td>
+<td>The <span class="type">cairo_ft_font_face_t</span> object to query</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>the current set of synthesis options.</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 1.12</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="cairo-ft-font-face-set-synthesize"></a><h3>cairo_ft_font_face_set_synthesize ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                cairo_ft_font_face_set_synthesize   (<em class="parameter"><code><a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-t" title="cairo_font_face_t"><span class="type">cairo_font_face_t</span></a> *font_face</code></em>,
+                                                         <em class="parameter"><code>unsigned <span class="type">int</span> synth_flags</code></em>);</pre>
+<p>
+FreeType provides the ability to synthesize different glyphs from a base
+font, which is useful if you lack those glyphs from a true bold or oblique
+font. See also <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-synthesize-t" title="enum cairo_ft_synthesize_t"><span class="type">cairo_ft_synthesize_t</span></a>.
+</p>
+<div class="variablelist"><table border="0">
+<col align="left" valign="top">
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>font_face</code></em> :</span></p></td>
+<td>The <span class="type">cairo_ft_font_face_t</span> object to modify</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>synth_flags</code></em> :</span></p></td>
+<td>the set of synthesis options to enable</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 1.12</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="cairo-ft-font-face-unset-synthesize"></a><h3>cairo_ft_font_face_unset_synthesize ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                cairo_ft_font_face_unset_synthesize (<em class="parameter"><code><a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-t" title="cairo_font_face_t"><span class="type">cairo_font_face_t</span></a> *font_face</code></em>,
+                                                         <em class="parameter"><code>unsigned <span class="type">int</span> synth_flags</code></em>);</pre>
+<p>
+See <a class="link" href="cairo-FreeType-Fonts.html#cairo-ft-font-face-set-synthesize" title="cairo_ft_font_face_set_synthesize ()"><code class="function">cairo_ft_font_face_set_synthesize()</code></a>.
+</p>
+<div class="variablelist"><table border="0">
+<col align="left" valign="top">
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>font_face</code></em> :</span></p></td>
+<td>The <span class="type">cairo_ft_font_face_t</span> object to modify</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>synth_flags</code></em> :</span></p></td>
+<td>the set of synthesis options to disable</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 1.12</p>
 </div>
 </div>
-<div class="refsect1" title="See Also">
+<div class="refsect1">
 <a name="cairo-FreeType-Fonts.see-also"></a><h2>See Also</h2>
 <a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-t" title="cairo_font_face_t"><span class="type">cairo_font_face_t</span></a>
 </div>
 </div>
 <div class="footer">
 <hr>
-          Generated by GTK-Doc V1.15</div>
+          Generated by GTK-Doc V1.18</div>
 </body>
 </html>

data/vendor/local/share/gtk-doc/html/cairo/cairo-Image-Surfaces.html CHANGED Viewed

@@ -3,12 +3,12 @@
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>Image Surfaces</title>
-<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
+<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
 <link rel="home" href="index.html" title="Cairo: A Vector Graphics Library">
 <link rel="up" href="cairo-surfaces.html" title="Surfaces">
 <link rel="prev" href="cairo-cairo-surface-t.html" title="cairo_surface_t">
 <link rel="next" href="cairo-PDF-Surfaces.html" title="PDF Surfaces">
-<meta name="generator" content="GTK-Doc V1.15 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.18 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -26,7 +26,7 @@
                   <a href="#cairo-Image-Surfaces.description" class="shortcut">Description</a>
 </td></tr>
 </table>
-<div class="refentry" title="Image Surfaces">
+<div class="refentry">
 <a name="cairo-Image-Surfaces"></a><div class="titlepage"></div>
 <div class="refnamediv"><table width="100%"><tr>
 <td valign="top">
@@ -35,7 +35,7 @@
 </td>
 <td valign="top" align="right"></td>
 </tr></table></div>
-<div class="refsynopsisdiv" title="Synopsis">
+<div class="refsynopsisdiv">
 <a name="cairo-Image-Surfaces.synopsis"></a><h2>Synopsis</h2>
 <pre class="synopsis">#define             <a class="link" href="cairo-Image-Surfaces.html#CAIRO-HAS-IMAGE-SURFACE:CAPS" title="CAIRO_HAS_IMAGE_SURFACE">CAIRO_HAS_IMAGE_SURFACE</a>
 enum                <a class="link" href="cairo-Image-Surfaces.html#cairo-format-t" title="enum cairo_format_t">cairo_format_t</a>;
@@ -56,7 +56,7 @@ unsigned <span class="returnvalue">char</span> *     <a class="link" href="cairo
 <span class="returnvalue">int</span>                 <a class="link" href="cairo-Image-Surfaces.html#cairo-image-surface-get-stride" title="cairo_image_surface_get_stride ()">cairo_image_surface_get_stride</a>      (<em class="parameter"><code><a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a> *surface</code></em>);
 </pre>
 </div>
-<div class="refsect1" title="Description">
+<div class="refsect1">
 <a name="cairo-Image-Surfaces.description"></a><h2>Description</h2>
 <p>
 Image surfaces provide the ability to render to memory buffers
@@ -64,9 +64,9 @@ either allocated by cairo or by the calling code.  The supported
 image formats are those defined in <a class="link" href="cairo-Image-Surfaces.html#cairo-format-t" title="enum cairo_format_t"><span class="type">cairo_format_t</span></a>.
 </p>
 </div>
-<div class="refsect1" title="Details">
+<div class="refsect1">
 <a name="cairo-Image-Surfaces.details"></a><h2>Details</h2>
-<div class="refsect2" title="CAIRO_HAS_IMAGE_SURFACE">
+<div class="refsect2">
 <a name="CAIRO-HAS-IMAGE-SURFACE:CAPS"></a><h3>CAIRO_HAS_IMAGE_SURFACE</h3>
 <pre class="programlisting">#define CAIRO_HAS_IMAGE_SURFACE 1
 </pre>
@@ -75,20 +75,19 @@ Defined if the image surface backend is available.
 The image surface backend is always built in.
 This macro was added for completeness in cairo 1.8.
 </p>
-<p>
-<em class="parameter"><code>Since</code></em>: 1.8
-</p>
+<p class="since">Since 1.8</p>
 </div>
 <hr>
-<div class="refsect2" title="enum cairo_format_t">
+<div class="refsect2">
 <a name="cairo-format-t"></a><h3>enum cairo_format_t</h3>
-<pre class="programlisting">typedef enum _cairo_format {
+<pre class="programlisting">typedef enum {
     CAIRO_FORMAT_INVALID   = -1,
     CAIRO_FORMAT_ARGB32    = 0,
     CAIRO_FORMAT_RGB24     = 1,
     CAIRO_FORMAT_A8        = 2,
     CAIRO_FORMAT_A1        = 3,
-    CAIRO_FORMAT_RGB16_565 = 4
+    CAIRO_FORMAT_RGB16_565 = 4,
+    CAIRO_FORMAT_RGB30     = 5
 } cairo_format_t;
 </pre>
 <p>
@@ -112,20 +111,20 @@ New entries may be added in future versions.
   alpha in the upper 8 bits, then red, then green, then blue.
   The 32-bit quantities are stored native-endian. Pre-multiplied
   alpha is used. (That is, 50% transparent red is 0x80800000,
-  not 0x80ff0000.)
+  not 0x80ff0000.) (Since 1.0)
 </td>
 </tr>
 <tr>
 <td><p><a name="CAIRO-FORMAT-RGB24:CAPS"></a><span class="term"><code class="literal">CAIRO_FORMAT_RGB24</code></span></p></td>
 <td>each pixel is a 32-bit quantity, with
   the upper 8 bits unused. Red, Green, and Blue are stored
-  in the remaining 24 bits in that order.
+  in the remaining 24 bits in that order. (Since 1.0)
 </td>
 </tr>
 <tr>
 <td><p><a name="CAIRO-FORMAT-A8:CAPS"></a><span class="term"><code class="literal">CAIRO_FORMAT_A8</code></span></p></td>
 <td>each pixel is a 8-bit quantity holding
-  an alpha value.
+  an alpha value. (Since 1.0)
 </td>
 </tr>
 <tr>
@@ -135,21 +134,27 @@ New entries may be added in future versions.
   quantities. The ordering of the bits matches the
   endianess of the platform. On a big-endian machine, the
   first pixel is in the uppermost bit, on a little-endian
-  machine the first pixel is in the least-significant bit.
+  machine the first pixel is in the least-significant bit. (Since 1.0)
 </td>
 </tr>
 <tr>
 <td><p><a name="CAIRO-FORMAT-RGB16-565:CAPS"></a><span class="term"><code class="literal">CAIRO_FORMAT_RGB16_565</code></span></p></td>
 <td>each pixel is a 16-bit quantity
   with red in the upper 5 bits, then green in the middle
-  6 bits, and blue in the lower 5 bits.
+  6 bits, and blue in the lower 5 bits. (Since 1.2)
+</td>
+</tr>
+<tr>
+<td><p><a name="CAIRO-FORMAT-RGB30:CAPS"></a><span class="term"><code class="literal">CAIRO_FORMAT_RGB30</code></span></p></td>
+<td>like RGB24 but with 10bpc. (Since 1.12)
 </td>
 </tr>
 </tbody>
 </table></div>
+<p class="since">Since 1.0</p>
 </div>
 <hr>
-<div class="refsect2" title="cairo_format_stride_for_width ()">
+<div class="refsect2">
 <a name="cairo-format-stride-for-width"></a><h3>cairo_format_stride_for_width ()</h3>
 <pre class="programlisting"><span class="returnvalue">int</span>                 cairo_format_stride_for_width       (<em class="parameter"><code><a class="link" href="cairo-Image-Surfaces.html#cairo-format-t" title="enum cairo_format_t"><span class="type">cairo_format_t</span></a> format</code></em>,
                                                          <em class="parameter"><code><span class="type">int</span> width</code></em>);</pre>
@@ -160,17 +165,33 @@ within cairo. Typical usage will be of the form:
 </p>
 <p>
 </p>
-<div class="informalexample"><pre class="programlisting">
-int stride;
-unsigned char *data;
-<a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t">cairo_surface_t</a> *surface;
+<div class="informalexample">
+  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
+    <tbody>
+      <tr>
+        <td class="listing_lines" align="right"><pre>1
+2
+3
+4
+5
+6
+7
+8
+9</pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="gtkdoc kwb">int</span> stride<span class="gtkdoc opt">;</span>
+<span class="gtkdoc kwb">unsigned char</span> <span class="gtkdoc opt">*</span>data<span class="gtkdoc opt">;</span>
+<span class="gtkdoc opt">&lt;</span>a <span class="gtkdoc kwc">class</span><span class="gtkdoc opt">=</span><span class="string">&quot;link&quot;</span> href<span class="gtkdoc opt">=</span><span class="string">&quot;cairo-cairo-surface-t.html#cairo-surface-t&quot;</span> title<span class="gtkdoc opt">=</span><span class="string">&quot;cairo_surface_t&quot;</span><span class="gtkdoc opt">&gt;</span>cairo_surface_t<span class="gtkdoc opt">&lt;/</span>a<span class="gtkdoc opt">&gt; *</span>surface<span class="gtkdoc opt">;</span>
+stride <span class="gtkdoc opt">=</span> <span class="function"><a href="../cairo/cairo-Image-Surfaces.html#cairo-format-stride-for-width">cairo_format_stride_for_width</a></span> <span class="gtkdoc opt">(</span>format<span class="gtkdoc opt">,</span> width<span class="gtkdoc opt">);</span>
+data <span class="gtkdoc opt">=</span> <span class="function">malloc</span> <span class="gtkdoc opt">(</span>stride <span class="gtkdoc opt">*</span> height<span class="gtkdoc opt">);</span>
+surface <span class="gtkdoc opt">=</span> <span class="function"><a href="../cairo/cairo-Image-Surfaces.html#cairo-image-surface-create-for-data">cairo_image_surface_create_for_data</a></span> <span class="gtkdoc opt">(</span>data<span class="gtkdoc opt">,</span> format<span class="gtkdoc opt">,</span>
+					  width<span class="gtkdoc opt">,</span> height<span class="gtkdoc opt">,</span>
+					  stride<span class="gtkdoc opt">);</span></pre></td>
+      </tr>
+    </tbody>
+  </table>
+</div>
-stride = cairo_format_stride_for_width (format, width);
-data = malloc (stride * height);
-surface = cairo_image_surface_create_for_data (data, format,
-					  width, height,
-					  stride);
-</pre></div>
 <p>
 </p>
 <div class="variablelist"><table border="0">
@@ -178,28 +199,24 @@ surface = cairo_image_surface_create_for_data (data, format,
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td>
-<td>A <a class="link" href="cairo-Image-Surfaces.html#cairo-format-t" title="enum cairo_format_t"><span class="type">cairo_format_t</span></a> value
-</td>
+<td>A <a class="link" href="cairo-Image-Surfaces.html#cairo-format-t" title="enum cairo_format_t"><span class="type">cairo_format_t</span></a> value</td>
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td>
-<td>The desired width of an image surface to be created.
-</td>
+<td>The desired width of an image surface to be created.</td>
 </tr>
 <tr>
 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
-<td> the appropriate stride to use given the desired
+<td>the appropriate stride to use given the desired
 format and width, or -1 if either the format is invalid or the width
-too large.
-</td>
+too large.</td>
 </tr>
 </tbody>
 </table></div>
 <p class="since">Since 1.6</p>
 </div>
 <hr>
-<div class="refsect2" title="cairo_image_surface_create ()">
+<div class="refsect2">
 <a name="cairo-image-surface-create"></a><h3>cairo_image_surface_create ()</h3>
 <pre class="programlisting"><a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="returnvalue">cairo_surface_t</span></a> *   cairo_image_surface_create          (<em class="parameter"><code><a class="link" href="cairo-Image-Surfaces.html#cairo-format-t" title="enum cairo_format_t"><span class="type">cairo_format_t</span></a> format</code></em>,
                                                          <em class="parameter"><code><span class="type">int</span> width</code></em>,
@@ -216,35 +233,31 @@ but not belonging to the given format are undefined).
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td>
-<td>format of pixels in the surface to create
-</td>
+<td>format of pixels in the surface to create</td>
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td>
-<td>width of the surface, in pixels
-</td>
+<td>width of the surface, in pixels</td>
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td>
-<td>height of the surface, in pixels
-</td>
+<td>height of the surface, in pixels</td>
 </tr>
 <tr>
 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
-<td> a pointer to the newly created surface. The caller
+<td>a pointer to the newly created surface. The caller
 owns the surface and should call <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-destroy" title="cairo_surface_destroy ()"><code class="function">cairo_surface_destroy()</code></a> when done
 with it.
 This function always returns a valid pointer, but it will return a
 pointer to a "nil" surface if an error such as out of memory
-occurs. You can use <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-status" title="cairo_surface_status ()"><code class="function">cairo_surface_status()</code></a> to check for this.
-</td>
+occurs. You can use <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-status" title="cairo_surface_status ()"><code class="function">cairo_surface_status()</code></a> to check for this.</td>
 </tr>
 </tbody>
 </table></div>
+<p class="since">Since 1.0</p>
 </div>
 <hr>
-<div class="refsect2" title="cairo_image_surface_create_for_data ()">
+<div class="refsect2">
 <a name="cairo-image-surface-create-for-data"></a><h3>cairo_image_surface_create_for_data ()</h3>
 <pre class="programlisting"><a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="returnvalue">cairo_surface_t</span></a> *   cairo_image_surface_create_for_data (<em class="parameter"><code>unsigned <span class="type">char</span> *data</code></em>,
                                                          <em class="parameter"><code><a class="link" href="cairo-Image-Surfaces.html#cairo-format-t" title="enum cairo_format_t"><span class="type">cairo_format_t</span></a> format</code></em>,
@@ -275,61 +288,60 @@ to allocate the data and to create the image surface. See
 <tr>
 <td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
 <td>a pointer to a buffer supplied by the application in which
-    to write contents. This pointer must be suitably aligned for any
-    kind of variable, (for example, a pointer returned by malloc).
-</td>
+to write contents. This pointer must be suitably aligned for any
+kind of variable, (for example, a pointer returned by malloc).</td>
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td>
-<td>the format of pixels in the buffer
-</td>
+<td>the format of pixels in the buffer</td>
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td>
-<td>the width of the image to be stored in the buffer
-</td>
+<td>the width of the image to be stored in the buffer</td>
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td>
-<td>the height of the image to be stored in the buffer
-</td>
+<td>the height of the image to be stored in the buffer</td>
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>stride</code></em> :</span></p></td>
 <td>the number of bytes between the start of rows in the
-    buffer as allocated. This value should always be computed by
-    <a class="link" href="cairo-Image-Surfaces.html#cairo-format-stride-for-width" title="cairo_format_stride_for_width ()"><code class="function">cairo_format_stride_for_width()</code></a> before allocating the data
-    buffer.
-</td>
+buffer as allocated. This value should always be computed by
+<a class="link" href="cairo-Image-Surfaces.html#cairo-format-stride-for-width" title="cairo_format_stride_for_width ()"><code class="function">cairo_format_stride_for_width()</code></a> before allocating the data
+buffer.</td>
 </tr>
 <tr>
 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
-<td> a pointer to the newly created surface. The caller
+<td>a pointer to the newly created surface. The caller
 owns the surface and should call <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-destroy" title="cairo_surface_destroy ()"><code class="function">cairo_surface_destroy()</code></a> when done
 with it.
 This function always returns a valid pointer, but it will return a
 pointer to a "nil" surface in the case of an error such as out of
 memory or an invalid stride value. In case of invalid stride value
 the error status of the returned surface will be
 <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-INVALID-STRIDE:CAPS"><code class="literal">CAIRO_STATUS_INVALID_STRIDE</code></a>.  You can use
 <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-status" title="cairo_surface_status ()"><code class="function">cairo_surface_status()</code></a> to check for this.
 See <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-set-user-data" title="cairo_surface_set_user_data ()"><code class="function">cairo_surface_set_user_data()</code></a> for a means of attaching a
-destroy-notification fallback to the surface if necessary.
-</td>
+destroy-notification fallback to the surface if necessary.</td>
 </tr>
 </tbody>
 </table></div>
+<p class="since">Since 1.0</p>
 </div>
 <hr>
-<div class="refsect2" title="cairo_image_surface_get_data ()">
+<div class="refsect2">
 <a name="cairo-image-surface-get-data"></a><h3>cairo_image_surface_get_data ()</h3>
 <pre class="programlisting">unsigned <span class="returnvalue">char</span> *     cairo_image_surface_get_data        (<em class="parameter"><code><a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a> *surface</code></em>);</pre>
 <p>
 Get a pointer to the data of the image surface, for direct
 inspection or modification.
 </p>
+<p>
+A call to <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-flush" title="cairo_surface_flush ()"><code class="function">cairo_surface_flush()</code></a> is required before accessing the
+pixel data to ensure that all pending drawing operations are
+finished. A call to <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-mark-dirty" title="cairo_surface_mark_dirty ()"><code class="function">cairo_surface_mark_dirty()</code></a> is required after
+the data is modified.
+</p>
 <div class="variablelist"><table border="0">
 <col align="left" valign="top">
 <tbody>
@@ -340,18 +352,16 @@ inspection or modification.
 </tr>
 <tr>
 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
-<td> a pointer to the image data of this surface or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
+<td>a pointer to the image data of this surface or <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
 if <em class="parameter"><code>surface</code></em> is not an image surface, or if <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-finish" title="cairo_surface_finish ()"><code class="function">cairo_surface_finish()</code></a>
-has been called.
-</td>
+has been called.</td>
 </tr>
 </tbody>
 </table></div>
 <p class="since">Since 1.2</p>
 </div>
 <hr>
-<div class="refsect2" title="cairo_image_surface_get_format ()">
+<div class="refsect2">
 <a name="cairo-image-surface-get-format"></a><h3>cairo_image_surface_get_format ()</h3>
 <pre class="programlisting"><a class="link" href="cairo-Image-Surfaces.html#cairo-format-t" title="enum cairo_format_t"><span class="returnvalue">cairo_format_t</span></a>      cairo_image_surface_get_format      (<em class="parameter"><code><a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a> *surface</code></em>);</pre>
 <p>
@@ -367,16 +377,14 @@ Get the format of the surface.
 </tr>
 <tr>
 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
-<td> the format of the surface
-</td>
+<td>the format of the surface</td>
 </tr>
 </tbody>
 </table></div>
 <p class="since">Since 1.2</p>
 </div>
 <hr>
-<div class="refsect2" title="cairo_image_surface_get_width ()">
+<div class="refsect2">
 <a name="cairo-image-surface-get-width"></a><h3>cairo_image_surface_get_width ()</h3>
 <pre class="programlisting"><span class="returnvalue">int</span>                 cairo_image_surface_get_width       (<em class="parameter"><code><a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a> *surface</code></em>);</pre>
 <p>
@@ -392,14 +400,14 @@ Get the width of the image surface in pixels.
 </tr>
 <tr>
 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
-<td> the width of the surface in pixels.
-</td>
+<td>the width of the surface in pixels.</td>
 </tr>
 </tbody>
 </table></div>
+<p class="since">Since 1.0</p>
 </div>
 <hr>
-<div class="refsect2" title="cairo_image_surface_get_height ()">
+<div class="refsect2">
 <a name="cairo-image-surface-get-height"></a><h3>cairo_image_surface_get_height ()</h3>
 <pre class="programlisting"><span class="returnvalue">int</span>                 cairo_image_surface_get_height      (<em class="parameter"><code><a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a> *surface</code></em>);</pre>
 <p>
@@ -415,14 +423,14 @@ Get the height of the image surface in pixels.
 </tr>
 <tr>
 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
-<td> the height of the surface in pixels.
-</td>
+<td>the height of the surface in pixels.</td>
 </tr>
 </tbody>
 </table></div>
+<p class="since">Since 1.0</p>
 </div>
 <hr>
-<div class="refsect2" title="cairo_image_surface_get_stride ()">
+<div class="refsect2">
 <a name="cairo-image-surface-get-stride"></a><h3>cairo_image_surface_get_stride ()</h3>
 <pre class="programlisting"><span class="returnvalue">int</span>                 cairo_image_surface_get_stride      (<em class="parameter"><code><a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a> *surface</code></em>);</pre>
 <p>
@@ -438,25 +446,23 @@ Get the stride of the image surface in bytes
 </tr>
 <tr>
 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
-<td> the stride of the image surface in bytes (or 0 if
+<td>the stride of the image surface in bytes (or 0 if
 <em class="parameter"><code>surface</code></em> is not an image surface). The stride is the distance in
 bytes from the beginning of one row of the image data to the
-beginning of the next row.
-</td>
+beginning of the next row.</td>
 </tr>
 </tbody>
 </table></div>
 <p class="since">Since 1.2</p>
 </div>
 </div>
-<div class="refsect1" title="See Also">
+<div class="refsect1">
 <a name="cairo-Image-Surfaces.see-also"></a><h2>See Also</h2>
 <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a>
 </div>
 </div>
 <div class="footer">
 <hr>
-          Generated by GTK-Doc V1.15</div>
+          Generated by GTK-Doc V1.18</div>
 </body>
 </html>