![]() |
![]() |
![]() |
![]() |
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
);
pango_coverage_max
has been deprecated since version 1.44 and should not be used in newly-written code.
This function does nothing
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
);
pango_coverage_to_bytes
has been deprecated since version 1.44 and should not be used in newly-written code.
This returns NULL
Convert a PangoCoverage structure into a flat binary format
coverage |
||
bytes |
location to store result (must be freed with |
[out][array length=n_bytes][element-type guint8] |
n_bytes |
location to store size of result. |
[out] |
PangoCoverage * pango_coverage_from_bytes (guchar *bytes
,int n_bytes
);
pango_coverage_from_bytes
has been deprecated since version 1.44 and should not be used in newly-written code.
This returns NULL
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.
Since 1.44, only PANGO_COVERAGE_NONE
and PANGO_COVERAGE_EXACT
will be returned.
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.