Next: , Previous: Overview, Up: Top


2 Coverage Maps

Unicode character range coverage storage

2.1 Overview

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 <pango-coverage> is a data structure that is used to represent that information.

2.2 Usage

— Class: <pango-coverage>

Opaque pointer.

This class defines no direct slots.

— Function: pango-coverage-new ⇒  (ret <pango-coverage>)

Create a new <pango-coverage>

ret
the newly allocated <pango-coverage>, initialized to ‘PANGO_COVERAGE_NONE’ with a reference count of one, which should be freed with pango-coverage-unref.
— Function: pango-coverage-copy (self <pango-coverage>) ⇒  (ret <pango-coverage>)

Copy an existing <pango-coverage>. (This function may now be unnecessary since we refcount the structure. File a bug if you use it.)

coverage
a <pango-coverage>
ret
the newly allocated <pango-coverage>, with a reference count of one, which should be freed with pango-coverage-unref.
— Function: pango-coverage-get (self <pango-coverage>) (index_ int) ⇒  (ret <pango-coverage-level>)

Determine whether a particular index is covered by coverage

coverage
a <pango-coverage>
index
the index to check
ret
the coverage level of coverage for character index.
— Function: pango-coverage-max (self <pango-coverage>) (other <pango-coverage>)

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.

coverage
a <pango-coverage>
other
another <pango-coverage>
— Function: pango-coverage-set (self <pango-coverage>) (index_ int) (level <pango-coverage-level>)

Modify a particular index within coverage

coverage
a <pango-coverage>
index
the index to modify
level
the new level for index