PDFlib 8 Windows COM/.NET Tutorial

Query the font-specific name of a glyph specified by code, Unicode value, glyph ID, or
CID:
gn_idx = (int) p.info_font(font, "glyphname", "code=" + c);
gn_idx = (int) p.info_font(font, "glyphname", "unicode=" + uv);
gn_idx = (int) p.info_font(font, "glyphname", "glyphid=" + gid);
gn_idx = (int) p.info_font(font, "glyphname", "cid=" + cid);
/* retrieve the actual glyph name using the string index */
gn = p.get_parameter("string", gn_idx);
Checking glyph availability. Using info_font( ) you can check whether a particular font
contains the glyphs you need for your application. As an example, the following code
checks whether the Euro glyph is contained in a font:
/* We could also use "unicode=U+20AC" below */
if (p.info_font(font, "code", "unicode=euro") == -1)
{
/* no glyph for Euro sign available in the font */
}
Cookbook A full code sample can be found in the Cookbook topic fonts/glyph_availability.
Alternatively, you can call info_textline( ) to check the number of unmapped characters
for a given text string, i.e. the number of characters in the string for which no appropriate
glyph is available in the font. The following code fragment queries results for a
string containing a single Euro character (which is expressed with a glyph name reference).
If one unmapped character is found this means that the font does not contain
any glyph for the Euro sign:
String optlist = "font=" + font + " charref";
if (p.info_textline("€", "unmappedchars", optlist) == 1)
{
/* no glyph for Euro sign available in the font */
}
5.6.3 Querying Codepage Coverage and Fallback Fonts
info_font( ) can also be used to check whether a font is suited for creating text output in
a certain language or script, provided the codepage is known which is required for the
text. Codepage coverage is encoded in the OS/2 table of the font. Note that it is up to the
font designer to decide what exactly it means that a font support a particular codepage.
Even if a font claims to support a specific codepage this does not necessarily mean that
it contains glyphs for all characters in this codepage. If more precise coverage information
is required you can query the availability of all required characters as demonstrated
in Section 5.6.2, »Font-specific Encoding, Unicode, and Glyph Name Queries«, page
147.
The following fragment checks wheth-
Checking whether a font supports a codepage.
er a font supports a particular codepage:
String cp="cp1254";
result = (int) p.info_font(font, "codepage", "name=" + cp);
5.6 Querying Font Information 147