| Top |
| #define | PANGO_TYPE_COVERAGE_LEVEL |
| PangoCoverage * | pango_coverage_new () |
| PangoCoverage * | pango_coverage_ref () |
| void | pango_coverage_unref () |
| PangoCoverage * | pango_coverage_copy () |
| PangoCoverageLevel | pango_coverage_get () |
| void | pango_coverage_max () |
| void | pango_coverage_set () |
| void | pango_coverage_to_bytes () |
| PangoCoverage * | pango_coverage_from_bytes () |
It is often necessary in Pango to determine if a particular font can represent a particular character, and also how well it can represent that character. The PangoCoverage is a data structure that is used to represent that information.
PangoCoverage *
pango_coverage_new (void);
Create a new PangoCoverage
the newly allocated PangoCoverage,
initialized to PANGO_COVERAGE_NONE
with a reference count of one, which
should be freed with pango_coverage_unref().
PangoCoverage *
pango_coverage_ref (PangoCoverage *coverage);
Increase the reference count on the PangoCoverage by one
void
pango_coverage_unref (PangoCoverage *coverage);
Decrease the reference count on the PangoCoverage by one. If the result is zero, free the coverage and all associated memory.
PangoCoverage *
pango_coverage_copy (PangoCoverage *coverage);
Copy an existing PangoCoverage. (This function may now be unnecessary since we refcount the structure. File a bug if you use it.)
the newly allocated PangoCoverage,
with a reference count of one, which should be freed
with pango_coverage_unref().
[transfer full]
PangoCoverageLevel pango_coverage_get (PangoCoverage *coverage,int index_);
Determine whether a particular index is covered by coverage
void pango_coverage_max (PangoCoverage *coverage,PangoCoverage *other);
Set the coverage for each index in coverage
to be the max (better)
value of the current coverage for the index and the coverage for
the corresponding index in other
.
void pango_coverage_set (PangoCoverage *coverage,int index_,PangoCoverageLevel level);
Modify a particular index within coverage
void pango_coverage_to_bytes (PangoCoverage *coverage,guchar **bytes,int *n_bytes);
Convert a PangoCoverage structure into a flat binary format
PangoCoverage * pango_coverage_from_bytes (guchar *bytes,int n_bytes);
Convert data generated from pango_coverage_to_bytes() back
to a PangoCoverage
bytes |
binary data representing a PangoCoverage. |
[array length=n_bytes][element-type guint8] |
n_bytes |
the size of |
Used to indicate how well a font can represent a particular Unicode character point for a particular script.
|
The character is not representable with the font. |
||
|
The character is represented in a way that may be comprehensible but is not the correct graphical form. For instance, a Hangul character represented as a a sequence of Jamos, or a Latin transliteration of a Cyrillic word. |
||
|
The character is represented as basically the correct graphical form, but with a stylistic variant inappropriate for the current script. |
||
|
The character is represented as the correct graphical form. |
typedef struct _PangoCoverage PangoCoverage;
The PangoCoverage structure represents a map from Unicode characters to PangoCoverageLevel. It is an opaque structure with no public fields.