PDFlib 8 Windows COM/.NET Tutorial

The keepnative option is false by default. In order to avoid subtle problems in Acrobat
we recommend to set keepnative=false if no font embedding is desired, and to set
embedding=true if keepnative=true is desired.
Custom CJK font example with Chinese Unicode text. The following example uses the
ArialUnicodeMS font to display some Chinese text. The font must either be installed on
the system or must be configured according to Section 5.4.4, »Searching for Fonts«, page
132):
font = p.load_font("Arial Unicode MS", "unicode", "");
p.setfont(font, 24);
p.set_text_pos(50, 500);
p.show("\u4e00\u500b\u4eba");
Accessing individual fonts in a TrueType Collection (TTC). TTC files contain
multiple separate fonts. You can access each font by supplying its proper
name. However, if you don’t know which fonts are contained in a TTC file you
can numerically address each font by appending a colon character and the
number of the font within the TTC file (starting with 0). If the index is 0 it can
be omitted. For example, the TTC file msgothic.ttc contains multiple fonts which can be
addressed as follows in load_font( ) (each line contains equivalent font names):
msgothic:0 MS Gothic msgothic:
msgothic:1 MS PGothic
msgothic:2 MS UI Gothic
Note that msgothic (without any suffix) will not work as a font name since it does not
uniquely identify a font. Font name aliases (see »Sources of Font Data«, page 132) can be
used in combination with TTC indexing. If a font with the specified index cannot be
found, the function call will fail.
It is only required to configure the TTC font file once; all indexed fonts in the TTC file
will be found automatically. The following code is sufficient to configure all indexed
fonts in msgothic.ttc (see Section 5.4.4, »Searching for Fonts«, page 132):
p.set_parameter("FontOutline", "msgothic=msgothic.ttc");
6.5.3 EUDC and SING Fonts for Gaiji Characters
PDFlib supports Windows EUDC (end-user defined characters, *.tte) and SING fonts
(*.gai) which can be used to access custom Gaiji characters for CJK text. Most conveniently
fonts with custom characters are integrated into other fonts with the fallback font
mechanism. Gaiji characters will commonly be provided in EUDC or SING fonts. Alternatively,
Gaiji characters can also be supplied as Type 3 fonts, but this requires more
programming effort.
Using fallback fonts for Gaiji characters. Typically, Gaiji characters will be pulled from
Windows EUDC fonts or SING glyphlets, but the fallbackfonts option accepts any kind of
font. Therefore this approach is not limited to Gaiji characters, but can be used for any
kind of symbol (e.g. a company logo in a separate font). You can use the following font
6.5 Chinese, Japanese, and Korean Text Output 173