PDF文件格式以其安全可靠,易於交換,及保真度高而成為電子文檔的標准。PDFlib是一套在國際上非常流行的在服務器端批量生成PDF文檔的功能強大的軟件包。國外許多政府,稅務,銀行,水電,郵電部門用其在線生成PDF格式的單據及報表。
對於國內用戶來說,如何使用PDFlib輸出簡體中文會是我們最關心的問題。在這裡我將於大家一起分享自己的一些心得體會,不對之處請指正,若我所說於PDFlib手冊有沖突,請以手冊為准。我的郵箱是 :[email protected] 。
對於沒有接觸過PDFlib的朋友,如果你們感興趣,可以從這個鏈接 下載PDFlib軟件包。(也可以到下載) 在沒有license的情況下,你仍可使用其所有功能,只是生成的PDF文檔帶有PDFlib的水印。
PDFlib提供C,C++, Java, Perl, PHP, Python, Tcl 及RealBasic的語言接口。以下所有的例子將采用C。
如何使用Acrobat 標准的簡體中文字體
PDFlib自帶STSong-Light,AdobeSongStd-Light-Acro,及STSongStd-Light-Acro三種簡體中文字體。這三種字體同時也是Acrobat的簡體中文標准字體。
以上三種字體均支持以下幾種編碼(Encoding):UniGB-UCS2-H,UniGB-UCS2-V,UniGB-UTF16-H,UniGB-UTF16-V,GB-EUC-H,GB-EUC-V,GBpc-EUC-H,GBpc-EUC-V,GBK-EUC-H,GBK-EUC-V,GBKp-EUC-H,GBKp-EUC-V,GBK2K-H,及GBK2K-V。各編碼的定義請見下表1.1:
表1.1
Encoding Character set and text format UniGB-UCS2-HUniGB-UCS2-V
Unicode (UCS-2) encoding for the Adobe-GB1 character collection UniGB-UTF16-HUniGB-UTF16-V
Unicode (UTF-16BE) encoding for the Adobe-GB1 character collection.Contains mappings for all characters in the GB18030-2000 character set. GB-EUC-HGB-EUC-V
Microsoft Code Page 936 (charset 134), GB 2312-80 character set, EUC-CN encoding GBpc-EUC-HGBpc-EUC-V
Macintosh, GB 2312-80 character set, EUC-CN encoding, Script Managercode 2 GBK-EUC-HGBK-EUC-V
Microsoft Code Page 936 (charset 134), GBK character set, GBK encoding GBKp-EUC-HGBKp-EUC-V
Same as GBK-EUC-H, but replaces half-width Latin characters withproportional forms and maps code 0x24 to dollar ($) instead of yuan (¥). GBK2K-HGBK2K-V
GB 18030-2000 character set, mixed 1-, 2-, and 4-byte encoding
編碼以-H結尾的,表示字體將會橫向輸出;以 –V結尾的,表示字體將會縱向輸出。以Uni開頭的是Unicode類編碼,如果你的輸入字符串是Unicode,則應選擇此類編碼。以GB開頭的是CP936類編碼,如果你的輸入字符串是Code Page 936,則應選擇此類編碼。
在PDFlib中若想調用以上其中一種字體,可直接用字體名和相應的編碼:
int Font_CS;
Font_CS = PDF_load_font(p, " STSong-Light ", 0, " ", " UniGB-UTF16-H");
不久,你們將會發現,字體與編碼間可有非常多的組合,而PDFlib的字體功能(function)並不支持所有的組合。最為保險的組合是PDFlib自帶三種字體與Unicode類編碼的組合。
下面是一個使用PDFlib自帶字體及編碼的C 源程序
/*******************************************************************/ /* This example demostrates the usage of PDFlib builtin fonts /* based on Chinese Simplifed Windows. /*******************************************************************/ #include <stdio.h> #include <stdlib.h> #include <string.h> #include "pdflib.h" int main(void) { PDF *p = NULL; int i = 0, j = 0, Left = 50, Top = 800; int Font_E = 0, Font_CS = 0; char TextUnicode[] = "\x80\x7B\x53\x4F\x2D\x4E\x87\x65"; char TextCp936[] = "\xBC\xF2\xCC\xE5\xD6\xD0\xCE\xC4"; char EncodingName[100]; static const char *ChineseFont[] = {"STSong-Light", "AdobeSongStd-Light-Acro", "STSongStd-Light-Acro", }; static const char *Encoding[] = { "UniGB-UCS2-H", "UniGB-UCS2-V", "UniGB-UTF16-H", "UniGB-UTF16-V", "GB-EUC-H", "GB-EUC-V", "GBpc-EUC-H", "GBpc-EUC-V", "GBK-EUC-H", "GBK-EUC-V", "GBKp-EUC-H", "GBKp-EUC-V", "GBK2K-H", "GBK2K-V", }; const int fsize = sizeof ChineseFont / sizeof (char *); const int esize = sizeof Encoding / sizeof (char *); /* create a new PDFlib object */ if ((p = PDF_new()) == (PDF *) 0) { printf("Couldn''t create PDFlib object (out of memory)!\n"); return(2); } PDF_TRY(p) { if (PDF_begin_document(p, "pdflib_cs1.pdf", 0, "") == -1) { printf("Error: %s\n", PDF_get_errmsg(p)); return(2); } PDF_set_info(p, "Creator", "pdflib_cs1.c"); PDF_set_info(p, "Author", "[email protected]"); PDF_set_info(p, "Title", "Output Chinese Simplify with PDFlib builtin font"); Font_E = PDF_load_font(p, "Helvetica-Bold", 0, "winansi", ""); for (i = 0; i < fsize; i++) { /*Start a new page. */ Top = 800; PDF_begin_page_ext(p, a4_width, a4_height, ""); PDF_setfont(p, Font_E, 24); PDF_show_xy(p, ChineseFont[i] , Left + 50, Top); Top -= 30; for (j = 0; j < esize; j++) { Font_CS = PDF_load_font(p, ChineseFont[i], 0, Encoding[j], ""); PDF_setfont(p, Font_E, 12); strcpy(EncodingName, ""); strcat(EncodingName, Encoding[j]); strcat(EncodingName, ":"); PDF_show_xy(p, EncodingName , Left, Top); PDF_setfont(p, Font_CS, 12); if (strstr(Encoding[j], "-H") != NULL) { /* It''s horizontal encoding. */ Top -= 15; } if (strstr(Encoding[j], "UniGB") != NULL) { /* It''s unicode encoding. */ PDF_show_xy2(p, TextUnicode, 8, Left, Top); } else { /* It''s code page 936 encoding. */ PDF_show_xy2(p, TextCp936, 8, Left, Top); } if (strstr(Encoding[j], "-H") != NULL) { /* It''s horizontal encoding. */ Top -= 25; } else { /* It''s vertical encoding. */ Top -= 65; } } /* for */ /* End of page. */ PDF_end_page_ext(p, ""); } /* for */ PDF_end_document(p, ""); } PDF_CATCH(p) { printf("PDFlib exception occurred in pdflib_cs1 sample:\n"); printf("[%d] %s: %s\n", PDF_get_errnum(p), PDF_get_apiname(p), PDF_get_errmsg(p)); PDF_delete(p); return(2); } PDF_delete(p); return 0; }
本文配套源碼