DynaPDF Manual - Page 734

Previous Page 733   Index   Next Page 735

Function Reference
Page 734 of 839
cpCJK_GBK_Uni
DEFAULT_CHARSET
cpCJK_GB12345_Uni
DEFAULT_CHARSET
cpCJK_HZ_Uni
DEFAULT_CHARSET
cpCJK_2022_CN_Uni
DEFAULT_CHARSET
cpCJK_2022_JP_Uni
DEFAULT_CHARSET
cpCJK_2022_KR_Uni
DEFAULT_CHARSET
cpCJK_646_CN_Uni
DEFAULT_CHARSET
cpCJK_646_JP_Uni
DEFAULT_CHARSET
cpCJK_IR_165_Uni
DEFAULT_CHARSET
cpCJK_932_Uni
DEFAULT_CHARSET
cpCJK_949_Uni
DEFAULT_CHARSET
cpCJK_950_Uni
DEFAULT_CHARSET
cpCJK_JOHAB_Uni
DEFAULT_CHARSET
cpShiftJIS
SHIFTJIS_CHARSET
cpBig5
CHINESEBIG5_CHARSET
cpGB2312
GB2312_CHARSET
cpWansung
HANGUL_CHARSET
cpJohab
HANGUL_CHARSET
cpMacRoman
MAC_CHARSET
How to use CJK encodings?
DynaPDF supports two types of CJK fonts: Native CJK fonts which support native CJK character
sets such as cpShiftJIS, cpGB2312, cpWansung, and so on, and Unicode fonts which contains CJK
characters.
Pure Unicode fonts support, as the name suggests, Unicode code points and no mixed 8/16 bit CJK
encodings. Mixed 8/16 bit multi-byte strings must be converted to Unicode before they can be used
with Unicode fonts. This conversion is automatically applied when a code page is used which ends
with a "_Uni", e.g. cpCJK_Big5_Uni or cpCJK_932_Uni. The "CJK" in the code page name indicates
that mixed 8/16 bit CJK input character sequences must be used with this encoding.
The "_Uni" at the end of the name means that this code page can be used with a Unicode font. CJK
to Unicode conversion algorithms are available in the Ansi versions of string methods only. This is
normally no limitation because CJK strings are usually not defined as wide-strings.
The other CJK code pages which are available in DynaPDF are those without the "_Uni" at the end
of the name, such as cpShiftJIS, cpGB2312, and so on. These code pages represent character sets and
no code pages. The usage of a pure CJK encoding requires that the TrueType or OpenType font
contains a CMap in format 2. This is mostly the case in pure CJK fonts (fonts which provide no
Unicode based CMap). Unlike the CJK to Unicode code pages, these character sets can be used with
the Ansi and wide string versions of a text method. Native character sets are faster than Unicode
based versions because no string conversion is required.
In addition to the above code pages and character sets DynaPDF supports also the CID-Keyed font
architecture which was specifically designed to process Asian languages. See SetCIDFont() for
further information.
 

Previous topic: Code pages versus character sets

Next topic: GDI Font selection in comparison to DynaPDF, nHeight