cairoShowTextGlyphs: cairoShowTextGlyphs

Description Usage Arguments Details Author(s)

View source: R/cairoFuncs.R

Description

This operation has rendering effects similar to cairoShowGlyphs but, if the target surface supports it, uses the provided text and cluster mapping to embed the text for the glyphs shown in the output. If the target does not support the extended attributes, this function acts like the basic cairoShowGlyphs as if it had been passed glyphs and num.glyphs.

Usage

1
cairoShowTextGlyphs(cr, utf8, glyphs, clusters, cluster.flags)

Arguments

cr

[Cairo] a cairo context

utf8

[char] a string of text encoded in UTF-8

glyphs

[CairoGlyph] list of glyphs to show

clusters

[CairoTextCluster] list of cluster mapping information

cluster.flags

[CairoTextClusterFlags] cluster mapping flags

Details

The mapping between utf8 and glyphs is provided by a list of clusters. Each cluster covers a number of text bytes and glyphs, and neighboring clusters cover neighboring areas of utf8 and glyphs. The clusters should collectively cover utf8 and glyphs in entirety.

The first cluster always covers bytes from the beginning of utf8. If cluster.flags do not have the CAIRO_TEXT_CLUSTER_FLAG_BACKWARD set, the first cluster also covers the beginning of glyphs, otherwise it covers the end of the glyphs list and following clusters move backward.

See CairoTextCluster for constraints on valid clusters. Since 1.8

Author(s)

Derived by RGtkGen from GTK+ documentation


RGtk2 documentation built on Oct. 14, 2021, 5:08 p.m.