Text Cluster¶
class TextCluster(tuple)¶
-
class
cairo.
TextCluster
(num_bytes, num_glyphs)¶ Parameters: - num_bytes (int) – the number of bytes of UTF-8 text covered by cluster
- num_glyphs (int) – the number of glyphs covered by cluster
New in version 1.15.
The
TextCluster
structure holds information about a single text cluster. A text cluster is a minimal mapping of some glyphs corresponding to some UTF-8 text.For a cluster to be valid, both
num_bytes
andnum_glyphs
should be non-negative, and at least one should be non-zero. Note that clusters with zero glyphs are not as well supported as normal clusters. For example, PDF rendering applications typically ignore those clusters when PDF text is being selected.See
Context.show_text_glyphs()
for how clusters are used in advanced text operations.-
num_bytes
¶ int
-
num_glyphs
¶ int