← Back to branch summary

~ubuntu-branches/ubuntu/natty/cairo/natty

« back to all changes in this revision

Viewing changes to doc/public/html/cairo-cairo-scaled-font-t.html

  • Committer: Bazaar Package Importer
  • Author(s): Sebastien Bacher
  • Date: 2010-09-09 18:27:34 UTC
  • mfrom: (1.3.6 upstream)
  • Revision ID: james.westby@ubuntu.com-20100909182734-nzi571ez2opssx6t
Tags: 1.10.0-1ubuntu1
* Resync on Debian
* debian/patches/server_side_gradients.patch:
  - don't use server side gradients, most drivers don't handle those and are
    really slow, should workaround performances issues for ati and nouveau

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/public/html/cairo-cairo-scaled-font-t.html
183
183
<tbody>
184
184
<tr>
185
185
<td><p><span class="term"><em class="parameter"><code>scaled_font</code></em> :</span></p></td>
186
 
<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>, (may be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> in which case
 
186
<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>, (may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> in which case
187
187
this function does nothing)
188
188
</td>
189
189
</tr>
515
515
mapping, that can be used to render later using <em class="parameter"><code>scaled_font</code></em>.
516
516
</p>
517
517
<p>
518
 
If <em class="parameter"><code>glyphs</code></em> initially points to a non-<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> value, that array is used
 
518
If <em class="parameter"><code>glyphs</code></em> initially points to a non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> value, that array is used
519
519
as a glyph buffer, and <em class="parameter"><code>num_glyphs</code></em> should point to the number of glyph
520
520
entries available there.  If the provided glyph array is too short for
521
521
the conversion, a new glyph array is allocated using <a class="link" href="cairo-text.html#cairo-glyph-allocate" title="cairo_glyph_allocate ()"><code class="function">cairo_glyph_allocate()</code></a>
526
526
array was large enough.
527
527
</p>
528
528
<p>
529
 
If <em class="parameter"><code>clusters</code></em> is not <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, <em class="parameter"><code>num_clusters</code></em> and <em class="parameter"><code>cluster_flags</code></em> should not be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>,
 
529
If <em class="parameter"><code>clusters</code></em> is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, <em class="parameter"><code>num_clusters</code></em> and <em class="parameter"><code>cluster_flags</code></em> should not be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>,
530
530
and cluster mapping will be computed.
531
531
The semantics of how cluster array allocation works is similar to the glyph
532
532
array.  That is,
533
 
if <em class="parameter"><code>clusters</code></em> initially points to a non-<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> value, that array is used
 
533
if <em class="parameter"><code>clusters</code></em> initially points to a non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> value, that array is used
534
534
as a cluster buffer, and <em class="parameter"><code>num_clusters</code></em> should point to the number of cluster
535
535
entries available there.  If the provided cluster array is too short for
536
536
the conversion, a new cluster array is allocated using <a class="link" href="cairo-text.html#cairo-text-cluster-allocate" title="cairo_text_cluster_allocate ()"><code class="function">cairo_text_cluster_allocate()</code></a>
541
541
array was large enough.
542
542
</p>
543
543
<p>
544
 
In the simplest case, <em class="parameter"><code>glyphs</code></em> and <em class="parameter"><code>clusters</code></em> can point to <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> initially
 
544
In the simplest case, <em class="parameter"><code>glyphs</code></em> and <em class="parameter"><code>clusters</code></em> can point to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> initially
545
545
and a suitable array will be allocated.  In code:
546
546
</p>
547
 
<div class="informalexample"><pre class="programlisting">
548
 
cairo_status_t status;
549
 
 
550
 
cairo_glyph_t *glyphs = NULL;
551
 
int num_glyphs;
552
 
cairo_text_cluster_t *clusters = NULL;
553
 
int num_clusters;
554
 
cairo_text_cluster_flags_t cluster_flags;
555
 
 
556
 
status = cairo_scaled_font_text_to_glyphs (scaled_font,
557
 
                                           x, y,
558
 
                                           utf8, utf8_len,
559
 
                                           &amp;glyphs, &amp;num_glyphs,
560
 
                                           &amp;clusters, &amp;num_clusters, &amp;cluster_flags);
561
 
 
562
 
if (status == CAIRO_STATUS_SUCCESS) {
563
 
    cairo_show_text_glyphs (cr,
564
 
                            utf8, utf8_len,
565
 
                            glyphs, num_glyphs,
566
 
                            clusters, num_clusters, cluster_flags);
567
 
 
568
 
    cairo_glyph_free (glyphs);
569
 
    cairo_text_cluster_free (clusters);
570
 
}
571
 
</pre></div>
 
547
<div class="informalexample">
 
548
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
 
549
    <tbody>
 
550
      <tr>
 
551
        <td class="listing_lines" align="right"><pre>1
 
552
2
 
553
3
 
554
4
 
555
5
 
556
6
 
557
7
 
558
8
 
559
9
 
560
10
 
561
11
 
562
12
 
563
13
 
564
14
 
565
15
 
566
16
 
567
17
 
568
18
 
569
19
 
570
20
 
571
21
 
572
22
 
573
23</pre></td>
 
574
        <td class="listing_code"><pre class="programlisting"><span class="usertype">cairo_status_t</span><span class="normal"> status</span><span class="symbol">;</span>
 
575
 
 
576
<span class="usertype">cairo_glyph_t</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">glyphs </span><span class="symbol">=</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">;</span>
 
577
<span class="type">int</span><span class="normal"> num_glyphs</span><span class="symbol">;</span>
 
578
<span class="usertype">cairo_text_cluster_t</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">clusters </span><span class="symbol">=</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">;</span>
 
579
<span class="type">int</span><span class="normal"> num_clusters</span><span class="symbol">;</span>
 
580
<span class="usertype">cairo_text_cluster_flags_t</span><span class="normal"> cluster_flags</span><span class="symbol">;</span>
 
581
 
 
582
<span class="normal">status </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="/usr/share/gtk-doc/html/cairo/cairo-cairo-scaled-font-t.html#cairo-scaled-font-text-to-glyphs">cairo_scaled_font_text_to_glyphs</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">scaled_font</span><span class="symbol">,</span>
 
583
<span class="normal">                                           x</span><span class="symbol">,</span><span class="normal"> y</span><span class="symbol">,</span>
 
584
<span class="normal">                                           utf8</span><span class="symbol">,</span><span class="normal"> utf8_len</span><span class="symbol">,</span>
 
585
<span class="normal">                                           </span><span class="symbol">&amp;</span><span class="normal">glyphs</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">num_glyphs</span><span class="symbol">,</span>
 
586
<span class="normal">                                           </span><span class="symbol">&amp;</span><span class="normal">clusters</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">num_clusters</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">cluster_flags</span><span class="symbol">);</span>
 
587
 
 
588
<span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">status </span><span class="symbol">==</span><span class="normal"> <a href="/usr/share/gtk-doc/html/cairo/cairo-Error-handling.html#CAIRO-STATUS-SUCCESS:CAPS">CAIRO_STATUS_SUCCESS</a></span><span class="symbol">)</span><span class="normal"> </span><span class="cbracket">{</span>
 
589
<span class="normal">    </span><span class="function"><a href="/usr/share/gtk-doc/html/cairo/cairo-text.html#cairo-show-text-glyphs">cairo_show_text_glyphs</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">cr</span><span class="symbol">,</span>
 
590
<span class="normal">                            utf8</span><span class="symbol">,</span><span class="normal"> utf8_len</span><span class="symbol">,</span>
 
591
<span class="normal">                            glyphs</span><span class="symbol">,</span><span class="normal"> num_glyphs</span><span class="symbol">,</span>
 
592
<span class="normal">                            clusters</span><span class="symbol">,</span><span class="normal"> num_clusters</span><span class="symbol">,</span><span class="normal"> cluster_flags</span><span class="symbol">);</span>
 
593
 
 
594
<span class="normal">    </span><span class="function"><a href="/usr/share/gtk-doc/html/cairo/cairo-text.html#cairo-glyph-free">cairo_glyph_free</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">glyphs</span><span class="symbol">);</span>
 
595
<span class="normal">    </span><span class="function"><a href="/usr/share/gtk-doc/html/cairo/cairo-text.html#cairo-text-cluster-free">cairo_text_cluster_free</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">clusters</span><span class="symbol">);</span>
 
596
<span class="cbracket">}</span></pre></td>
 
597
      </tr>
 
598
    </tbody>
 
599
  </table>
 
600
</div>
 
601
 
572
602
<p>
573
603
</p>
574
604
<p>
575
605
If no cluster mapping is needed:
576
606
</p>
577
 
<div class="informalexample"><pre class="programlisting">
578
 
cairo_status_t status;
579
 
 
580
 
cairo_glyph_t *glyphs = NULL;
581
 
int num_glyphs;
582
 
 
583
 
status = cairo_scaled_font_text_to_glyphs (scaled_font,
584
 
                                           x, y,
585
 
                                           utf8, utf8_len,
586
 
                                           &amp;glyphs, &amp;num_glyphs,
587
 
                                           NULL, NULL,
588
 
                                           NULL);
589
 
 
590
 
if (status == CAIRO_STATUS_SUCCESS) {
591
 
    cairo_show_glyphs (cr, glyphs, num_glyphs);
592
 
    cairo_glyph_free (glyphs);
593
 
}
594
 
</pre></div>
 
607
<div class="informalexample">
 
608
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
 
609
    <tbody>
 
610
      <tr>
 
611
        <td class="listing_lines" align="right"><pre>1
 
612
2
 
613
3
 
614
4
 
615
5
 
616
6
 
617
7
 
618
8
 
619
9
 
620
10
 
621
11
 
622
12
 
623
13
 
624
14
 
625
15
 
626
16</pre></td>
 
627
        <td class="listing_code"><pre class="programlisting"><span class="usertype">cairo_status_t</span><span class="normal"> status</span><span class="symbol">;</span>
 
628
 
 
629
<span class="usertype">cairo_glyph_t</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">glyphs </span><span class="symbol">=</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">;</span>
 
630
<span class="type">int</span><span class="normal"> num_glyphs</span><span class="symbol">;</span>
 
631
 
 
632
<span class="normal">status </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="/usr/share/gtk-doc/html/cairo/cairo-cairo-scaled-font-t.html#cairo-scaled-font-text-to-glyphs">cairo_scaled_font_text_to_glyphs</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">scaled_font</span><span class="symbol">,</span>
 
633
<span class="normal">                                           x</span><span class="symbol">,</span><span class="normal"> y</span><span class="symbol">,</span>
 
634
<span class="normal">                                           utf8</span><span class="symbol">,</span><span class="normal"> utf8_len</span><span class="symbol">,</span>
 
635
<span class="normal">                                           </span><span class="symbol">&amp;</span><span class="normal">glyphs</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">num_glyphs</span><span class="symbol">,</span>
 
636
<span class="normal">                                           <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span>
 
637
<span class="normal">                                           <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
 
638
 
 
639
<span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">status </span><span class="symbol">==</span><span class="normal"> <a href="/usr/share/gtk-doc/html/cairo/cairo-Error-handling.html#CAIRO-STATUS-SUCCESS:CAPS">CAIRO_STATUS_SUCCESS</a></span><span class="symbol">)</span><span class="normal"> </span><span class="cbracket">{</span>
 
640
<span class="normal">    </span><span class="function"><a href="/usr/share/gtk-doc/html/cairo/cairo-text.html#cairo-show-glyphs">cairo_show_glyphs</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">cr</span><span class="symbol">,</span><span class="normal"> glyphs</span><span class="symbol">,</span><span class="normal"> num_glyphs</span><span class="symbol">);</span>
 
641
<span class="normal">    </span><span class="function"><a href="/usr/share/gtk-doc/html/cairo/cairo-text.html#cairo-glyph-free">cairo_glyph_free</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">glyphs</span><span class="symbol">);</span>
 
642
<span class="cbracket">}</span></pre></td>
 
643
      </tr>
 
644
    </tbody>
 
645
  </table>
 
646
</div>
 
647
 
595
648
<p>
596
649
</p>
597
650
<p>
598
651
If stack-based glyph and cluster arrays are to be used for small
599
652
arrays:
600
653
</p>
601
 
<div class="informalexample"><pre class="programlisting">
602
 
cairo_status_t status;
603
 
 
604
 
cairo_glyph_t stack_glyphs[40];
605
 
cairo_glyph_t *glyphs = stack_glyphs;
606
 
int num_glyphs = sizeof (stack_glyphs) / sizeof (stack_glyphs[0]);
607
 
cairo_text_cluster_t stack_clusters[40];
608
 
cairo_text_cluster_t *clusters = stack_clusters;
609
 
int num_clusters = sizeof (stack_clusters) / sizeof (stack_clusters[0]);
610
 
cairo_text_cluster_flags_t cluster_flags;
611
 
 
612
 
status = cairo_scaled_font_text_to_glyphs (scaled_font,
613
 
                                           x, y,
614
 
                                           utf8, utf8_len,
615
 
                                           &amp;glyphs, &amp;num_glyphs,
616
 
                                           &amp;clusters, &amp;num_clusters, &amp;cluster_flags);
617
 
 
618
 
if (status == CAIRO_STATUS_SUCCESS) {
619
 
    cairo_show_text_glyphs (cr,
620
 
                            utf8, utf8_len,
621
 
                            glyphs, num_glyphs,
622
 
                            clusters, num_clusters, cluster_flags);
623
 
 
624
 
    if (glyphs != stack_glyphs)
625
 
        cairo_glyph_free (glyphs);
626
 
    if (clusters != stack_clusters)
627
 
        cairo_text_cluster_free (clusters);
628
 
}
629
 
</pre></div>
 
654
<div class="informalexample">
 
655
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
 
656
    <tbody>
 
657
      <tr>
 
658
        <td class="listing_lines" align="right"><pre>1
 
659
2
 
660
3
 
661
4
 
662
5
 
663
6
 
664
7
 
665
8
 
666
9
 
667
10
 
668
11
 
669
12
 
670
13
 
671
14
 
672
15
 
673
16
 
674
17
 
675
18
 
676
19
 
677
20
 
678
21
 
679
22
 
680
23
 
681
24
 
682
25
 
683
26
 
684
27</pre></td>
 
685
        <td class="listing_code"><pre class="programlisting"><span class="usertype">cairo_status_t</span><span class="normal"> status</span><span class="symbol">;</span>
 
686
 
 
687
<span class="usertype">cairo_glyph_t</span><span class="normal"> stack_glyphs</span><span class="symbol">[</span><span class="number">40</span><span class="symbol">];</span>
 
688
<span class="usertype">cairo_glyph_t</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">glyphs </span><span class="symbol">=</span><span class="normal"> stack_glyphs</span><span class="symbol">;</span>
 
689
<span class="type">int</span><span class="normal"> num_glyphs </span><span class="symbol">=</span><span class="normal"> </span><span class="keyword">sizeof</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">stack_glyphs</span><span class="symbol">)</span><span class="normal"> </span><span class="symbol">/</span><span class="normal"> </span><span class="keyword">sizeof</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">stack_glyphs</span><span class="symbol">[</span><span class="number">0</span><span class="symbol">]);</span>
 
690
<span class="usertype">cairo_text_cluster_t</span><span class="normal"> stack_clusters</span><span class="symbol">[</span><span class="number">40</span><span class="symbol">];</span>
 
691
<span class="usertype">cairo_text_cluster_t</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">clusters </span><span class="symbol">=</span><span class="normal"> stack_clusters</span><span class="symbol">;</span>
 
692
<span class="type">int</span><span class="normal"> num_clusters </span><span class="symbol">=</span><span class="normal"> </span><span class="keyword">sizeof</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">stack_clusters</span><span class="symbol">)</span><span class="normal"> </span><span class="symbol">/</span><span class="normal"> </span><span class="keyword">sizeof</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">stack_clusters</span><span class="symbol">[</span><span class="number">0</span><span class="symbol">]);</span>
 
693
<span class="usertype">cairo_text_cluster_flags_t</span><span class="normal"> cluster_flags</span><span class="symbol">;</span>
 
694
 
 
695
<span class="normal">status </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="/usr/share/gtk-doc/html/cairo/cairo-cairo-scaled-font-t.html#cairo-scaled-font-text-to-glyphs">cairo_scaled_font_text_to_glyphs</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">scaled_font</span><span class="symbol">,</span>
 
696
<span class="normal">                                           x</span><span class="symbol">,</span><span class="normal"> y</span><span class="symbol">,</span>
 
697
<span class="normal">                                           utf8</span><span class="symbol">,</span><span class="normal"> utf8_len</span><span class="symbol">,</span>
 
698
<span class="normal">                                           </span><span class="symbol">&amp;</span><span class="normal">glyphs</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">num_glyphs</span><span class="symbol">,</span>
 
699
<span class="normal">                                           </span><span class="symbol">&amp;</span><span class="normal">clusters</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">num_clusters</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">cluster_flags</span><span class="symbol">);</span>
 
700
 
 
701
<span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">status </span><span class="symbol">==</span><span class="normal"> <a href="/usr/share/gtk-doc/html/cairo/cairo-Error-handling.html#CAIRO-STATUS-SUCCESS:CAPS">CAIRO_STATUS_SUCCESS</a></span><span class="symbol">)</span><span class="normal"> </span><span class="cbracket">{</span>
 
702
<span class="normal">    </span><span class="function"><a href="/usr/share/gtk-doc/html/cairo/cairo-text.html#cairo-show-text-glyphs">cairo_show_text_glyphs</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">cr</span><span class="symbol">,</span>
 
703
<span class="normal">                            utf8</span><span class="symbol">,</span><span class="normal"> utf8_len</span><span class="symbol">,</span>
 
704
<span class="normal">                            glyphs</span><span class="symbol">,</span><span class="normal"> num_glyphs</span><span class="symbol">,</span>
 
705
<span class="normal">                            clusters</span><span class="symbol">,</span><span class="normal"> num_clusters</span><span class="symbol">,</span><span class="normal"> cluster_flags</span><span class="symbol">);</span>
 
706
 
 
707
<span class="normal">    </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">glyphs </span><span class="symbol">!=</span><span class="normal"> stack_glyphs</span><span class="symbol">)</span>
 
708
<span class="normal">        </span><span class="function"><a href="/usr/share/gtk-doc/html/cairo/cairo-text.html#cairo-glyph-free">cairo_glyph_free</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">glyphs</span><span class="symbol">);</span>
 
709
<span class="normal">    </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">clusters </span><span class="symbol">!=</span><span class="normal"> stack_clusters</span><span class="symbol">)</span>
 
710
<span class="normal">        </span><span class="function"><a href="/usr/share/gtk-doc/html/cairo/cairo-text.html#cairo-text-cluster-free">cairo_text_cluster_free</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">clusters</span><span class="symbol">);</span>
 
711
<span class="cbracket">}</span></pre></td>
 
712
      </tr>
 
713
    </tbody>
 
714
  </table>
 
715
</div>
 
716
 
630
717
<p>
631
718
</p>
632
719
<p>
678
765
</tr>
679
766
<tr>
680
767
<td><p><span class="term"><em class="parameter"><code>clusters</code></em> :</span></p></td>
681
 
<td>pointer to array of cluster mapping information to fill, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
 
768
<td>pointer to array of cluster mapping information to fill, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
682
769
</td>
683
770
</tr>
684
771
<tr>
685
772
<td><p><span class="term"><em class="parameter"><code>num_clusters</code></em> :</span></p></td>
686
 
<td>pointer to number of clusters, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
 
773
<td>pointer to number of clusters, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
687
774
</td>
688
775
</tr>
689
776
<tr>
690
777
<td><p><span class="term"><em class="parameter"><code>cluster_flags</code></em> :</span></p></td>
691
778
<td>pointer to location to store cluster flags corresponding to the
692
 
                output <em class="parameter"><code>clusters</code></em>, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
 
779
                output <em class="parameter"><code>clusters</code></em>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
693
780
</td>
694
781
</tr>
695
782
<tr>
903
990
                                                         <em class="parameter"><code><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> destroy</code></em>);</pre>
904
991
<p>
905
992
Attach user data to <em class="parameter"><code>scaled_font</code></em>.  To remove user data from a surface,
906
 
call this function with the key that was used to set it and <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
 
993
call this function with the key that was used to set it and <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
907
994
for <em class="parameter"><code>data</code></em>.
908
995
</p>
909
996
<div class="variablelist"><table border="0">
950
1037
<p>
951
1038
Return user data previously attached to <em class="parameter"><code>scaled_font</code></em> using the
952
1039
specified key.  If no user data has been attached with the given
953
 
key this function returns <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
 
1040
key this function returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
954
1041
</p>
955
1042
<div class="variablelist"><table border="0">
956
1043
<col align="left" valign="top">
968
1055
</tr>
969
1056
<tr>
970
1057
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
971
 
<td> the user data previously attached or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
 
1058
<td> the user data previously attached or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
972
1059
 
973
1060
</td>
974
1061
</tr>