PDF::API2::Resource::CIDFont::CJKFont(3)   User Contributed Perl Documentation


NAME
       PDF::API2::Resource::CIDFont::CJKFont - Deprecated base class for CJK
       fonts

DESCRIPTION
       This is not the CJK font support you are looking for.  It dates back to
       the days when Unicode was young and poorly supported.  PDFs created
       using this class are not portable.

       Instead, use a regular TrueType or OpenType font that includes Unicode
       support and create your PDF normally:

           use PDF::API2;
           use utf8;

           my $pdf = PDF::API2->new();
           my $font = $pdf->font('/path/to/font.ttf');
           my $page = $pdf->page();
           my $content = $page->text();
           $content->font($font, 24);

           # Chinese
           $content->translate(72, 72 * 9);
           $content->text('<?><?>');

           # Japanese
           $content->distance(0, -72);
           $content->text('<?><?><?><?><?>');

           # Korean
           $content->distance(0, -72);
           $content->text('<?><?><?><?><?>');

           $pdf->save('hello.pdf');

       Note: The maintainer is not familiar with CJK languages and has
       deprecated this class based on his current understanding of Unicode and
       from reading many bug reports.  If you are successfully using the CJK
       support from this class and think it should not be deprecated, please
       contact him to discuss.

DEPRECATED METHODS
       $font = $class->new($pdf, $cjk_font_name, %options)
           Returns a CJK font object.  The requested font will not be embedded
           in the PDF, so it will only be readable on computers that have the
           font installed.

           Available fonts:

           Chinese (Traditional)
               Ming, Ming-Bold, Ming-Italic, and Ming-BoldItalic

           Chinese (Simplified)
               Song, Song-Bold, Song-Italic, and Song-BoldItalic

           Korean
               MyungJo, MyungJo-Bold, MyungJo-Italic, and MyungJo-BoldItalic

           Japanese (Mincho Serif)
               KozMin, KozMin-Bold, KozMin-Italic, and KozMin-BoldItalic

           Japanese (Gothic Sans Serif)
               KozGo, KozGo-Bold, KozGo-Italic, KozGo-BoldItalic

           If the text isn't UTF-8, include an "-encode" option with the
           encoding to be used.

perl v5.38.1                      2023-12-21
                                      PDF::API2::Resource::CIDFont::CJKFont(3)