PDFlib 8 Windows COM/.NET Tutorial

Fonts with encodings other than a CMap can be used for vertical writing mode by
supplying the vertical font option.
> Font names starting with an ’@’ character will always be processed in vertical mode.
Note The character spacing must be negative in order to spread characters apart in vertical writing
mode.
Standard CJK font example. Standard CJK fonts can be selected with the load_font( ) interface,
supplying the CMap name as the encoding parameter. However, you must take
into account that a given CJK font supports only a certain set of CMaps (see Table 6.6),
and that Unicode-aware language bindings support only UCS2-compatible CMaps. The
KozMinPro-Regular-Acro sample in Table 6.6 can been generated with the following code:
font = p.load_font("KozMinPro-Regular-Acro", "UniJIS-UCS2-H", "");
if (font == -1) { ... }
p.setfont(font, 24);
p.set_text_pos(50, 500);
p.show("\u65E5\u672C\u8A9E");
These statements locate one of the Japanese standard fonts, choosing a Unicode CMap
(UniJIS-UCS2-H) with horizontal writing mode (H). The fontname parameter must be the
exact name of the font without any encoding or writing mode suffixes. The encoding parameter
is the name of one of the supported CMaps (the choice depends on the font)
and will also indicate the writing mode (see above). PDFlib supports all of Acrobat’s default
CMaps, and will complain when it detects a mismatch between the requested font
and the CMap. For example, PDFlib will reject a request to use a Korean font with a Japanese
encoding.
Forcing monospaced fonts. Some applications are not prepared to deal with proportional
CJK fonts, and calculate the extent of text based on a constant glyph width and
the number of glyphs. PDFlib can be instructed to force monospaced glyphs even for
fonts that usually have glyphs with varying widths. Use the monospace option of load_
font( ) to specify the desired width for all glyphs. For standard CJK fonts the value 1000
will result in pleasing results:
font = p.load_font("KozMinPro-Regular-Acro", "UniJIS-UCS2-H", "monospace=1000");
The monospace option is only recommended for standard CJK fonts.
6.5.2 Custom CJK Fonts
Note PDFlib GmbH offers the MS Gothic and MS Mincho fonts for free download at www.pdflib.com.
PDFlib licensees are entitled to use these fonts without having to obtain a separate
font license.
In addition to Acrobat’s standard CJK fonts PDFlib supports custom CJK fonts (fonts outside
the list in Table 6.6) in the TrueType (including TrueType Collections, TTC) and
OpenType formats. Custom CJK fonts will be processed as follows:
> If the embedding option is true, the font will be converted to a CID font and embedded
in the PDF output.
> CJK host font names on Windows can be supplied to load_font( ) as UTF-16. Non-Latin
host font names are not supported on the Mac, though.
172 Chapter 6: Text Output (Edition for COM, .NET, and REALbasic)