~ubuntu-branches/ubuntu/lucid/cairo/lucid

« back to all changes in this revision

Viewing changes to doc/public/html/cairo-context.html

  • Committer: Bazaar Package Importer
  • Author(s): Sebastien Bacher
  • Date: 2010-02-25 23:23:11 UTC
  • mfrom: (1.3.2 upstream) (1.2.5 sid)
  • Revision ID: james.westby@ubuntu.com-20100225232311-7xifnse6v4tl6u6h
Tags: 1.8.10-2ubuntu1
* Resync on Debian
* debian/control:
  - don't use the new debian breaks so users don't remove xulrunner
* debian/patches/04_lcd_filter.patch: 
  - adds a Cairo LCD filter to use FreeType LCD colour filtering features;
    initial implementation from FreeDesktop #10301; build-deps and dep on
    libfontconfig1-dev >= 2.5.92 and libfreetype6-dev >= 2.3.5-1ubuntu4.
* debian/patches/06_Xlib-Xcb-Hand-off-EXTEND_PAD-to-XRender: 
  - hand off EXTEND_PAD to XRender; LP #217908.

Show diffs side-by-side

added added

removed removed

Lines of Context:
3
3
<head>
4
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
<title>cairo_t</title>
6
 
<meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
 
6
<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
7
7
<link rel="home" href="index.html" title="Cairo: A Vector Graphics Library">
8
8
<link rel="up" href="cairo-drawing.html" title="Drawing">
9
9
<link rel="prev" href="cairo-drawing.html" title="Drawing">
233
233
<td> a newly allocated <a class="link" href="cairo-context.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> with a reference
234
234
 count of 1. The initial reference count should be released
235
235
 with <a class="link" href="cairo-context.html#cairo-destroy" title="cairo_destroy ()"><code class="function">cairo_destroy()</code></a> when you are done using the <a class="link" href="cairo-context.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a>.
236
 
 This function never returns <a
237
 
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
238
 
><code class="literal">NULL</code></a>. If memory cannot be
 
236
 This function never returns <code class="literal">NULL</code>. If memory cannot be
239
237
 allocated, a special <a class="link" href="cairo-context.html#cairo-t" title="cairo_t"><span class="type">cairo_t</span></a> object will be returned on
240
238
 which <a class="link" href="cairo-context.html#cairo-status" title="cairo_status ()"><code class="function">cairo_status()</code></a> returns <a class="link" href="cairo-error-status.html#CAIRO-STATUS-NO-MEMORY--CAPS"><code class="literal">CAIRO_STATUS_NO_MEMORY</code></a>.
241
239
 You can use this object normally, but no drawing will
1036
1034
                                                         double *dashes,
1037
1035
                                                         double *offset);</pre>
1038
1036
<p>
1039
 
Gets the current dash array.  If not <a
1040
 
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1041
 
><code class="literal">NULL</code></a>, <em class="parameter"><code>dashes</code></em> should be big
 
1037
Gets the current dash array.  If not <code class="literal">NULL</code>, <em class="parameter"><code>dashes</code></em> should be big
1042
1038
enough to hold at least the number of values returned by
1043
1039
<a class="link" href="cairo-context.html#cairo-get-dash-count" title="cairo_get_dash_count ()"><code class="function">cairo_get_dash_count()</code></a>.</p>
1044
1040
<p>
1053
1049
</tr>
1054
1050
<tr>
1055
1051
<td><p><span class="term"><em class="parameter"><code>dashes</code></em> :</span></p></td>
1056
 
<td> return value for the dash array, or <a
1057
 
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1058
 
><code class="literal">NULL</code></a>
 
1052
<td> return value for the dash array, or <code class="literal">NULL</code>
1059
1053
</td>
1060
1054
</tr>
1061
1055
<tr>
1062
1056
<td><p><span class="term"><em class="parameter"><code>offset</code></em> :</span></p></td>
1063
 
<td> return value for the current dash offset, or <a
1064
 
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1065
 
><code class="literal">NULL</code></a>
 
1057
<td> return value for the current dash offset, or <code class="literal">NULL</code>
1066
1058
</td>
1067
1059
</tr>
1068
1060
</tbody>
2006
1998
<pre class="programlisting"><a class="link" href="cairo-context.html#cairo-rectangle-list-t" title="cairo_rectangle_list_t">cairo_rectangle_list_t</a> * cairo_copy_clip_rectangle_list (<a class="link" href="cairo-context.html#cairo-t" title="cairo_t">cairo_t</a> *cr);</pre>
2007
1999
<p>
2008
2000
Gets the current clip region as a list of rectangles in user coordinates.
2009
 
Never returns <a
2010
 
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2011
 
><code class="literal">NULL</code></a>.
 
2001
Never returns <code class="literal">NULL</code>.
2012
2002
</p>
2013
2003
<p>
2014
2004
The status in the list may be <a class="link" href="cairo-error-status.html#CAIRO-STATUS-CLIP-NOT-REPRESENTABLE--CAPS"><code class="literal">CAIRO_STATUS_CLIP_NOT_REPRESENTABLE</code></a> to
2561
2551
                                                         <a class="link" href="cairo-types.html#cairo-destroy-func-t" title="cairo_destroy_func_t ()">cairo_destroy_func_t</a> destroy);</pre>
2562
2552
<p>
2563
2553
Attach user data to <em class="parameter"><code>cr</code></em>.  To remove user data from a surface,
2564
 
call this function with the key that was used to set it and <a
2565
 
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2566
 
><code class="literal">NULL</code></a>
 
2554
call this function with the key that was used to set it and <code class="literal">NULL</code>
2567
2555
for <em class="parameter"><code>data</code></em>.</p>
2568
2556
<p>
2569
2557
</p>
2611
2599
<p>
2612
2600
Return user data previously attached to <em class="parameter"><code>cr</code></em> using the specified
2613
2601
key.  If no user data has been attached with the given key this
2614
 
function returns <a
2615
 
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2616
 
><code class="literal">NULL</code></a>.</p>
 
2602
function returns <code class="literal">NULL</code>.</p>
2617
2603
<p>
2618
2604
</p>
2619
2605
<div class="variablelist"><table border="0">
2632
2618
</tr>
2633
2619
<tr>
2634
2620
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2635
 
<td> the user data previously attached or <a
2636
 
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
2637
 
><code class="literal">NULL</code></a>.
 
2621
<td> the user data previously attached or <code class="literal">NULL</code>.
2638
2622
 
2639
2623
</td>
2640
2624
</tr>