1
\alias{cairoShowTextGlyphs}
2
\name{cairoShowTextGlyphs}
3
\title{cairoShowTextGlyphs}
4
\description{This operation has rendering effects similar to \code{\link{cairoShowGlyphs}}
5
but, if the target surface supports it, uses the provided text and
6
cluster mapping to embed the text for the glyphs shown in the output.
7
If the target does not support the extended attributes, this function
8
acts like the basic \code{\link{cairoShowGlyphs}} as if it had been passed
9
\code{glyphs} and \code{num.glyphs}.}
10
\usage{cairoShowTextGlyphs(cr, utf8, glyphs, clusters, cluster.flags)}
12
\item{\verb{cr}}{[\code{\link{Cairo}}] a cairo context}
13
\item{\verb{utf8}}{[char] a string of text encoded in UTF-8}
14
\item{\verb{glyphs}}{[\code{\link{CairoGlyph}}] list of glyphs to show}
15
\item{\verb{clusters}}{[\code{\link{CairoTextCluster}}] list of cluster mapping information}
16
\item{\verb{cluster.flags}}{[\code{\link{CairoTextClusterFlags}}] cluster mapping flags}
18
\details{The mapping between \code{utf8} and \code{glyphs} is provided by a list of
19
\dfn{clusters}. Each cluster covers a number of
20
text bytes and glyphs, and neighboring clusters cover neighboring
21
areas of \code{utf8} and \code{glyphs}. The clusters should collectively cover \code{utf8}
22
and \code{glyphs} in entirety.
24
The first cluster always covers bytes from the beginning of \code{utf8}.
25
If \code{cluster.flags} do not have the \code{CAIRO_TEXT_CLUSTER_FLAG_BACKWARD}
26
set, the first cluster also covers the beginning
27
of \code{glyphs}, otherwise it covers the end of the \code{glyphs} list and
28
following clusters move backward.
30
See \code{\link{CairoTextCluster}} for constraints on valid clusters.
32
\author{Derived by RGtkGen from GTK+ documentation}