pdf之三 文本输出形式

在网上有一些教程 可以添加JPG格式文件
代码如下：
int img =pdf.open_image_file("jpeg", "vckbase.jpg", "", 0);
pdf.place_image(img, 200,400, 1);
pdf.close_image(img);

PDFlib的textformat参数用以设定文本输入形式，其有效值如下:

 

bytes: 在字符串中每个字节对应于一个字符。主要应用于8位编码。


utf8：字符串是UTF-8编码。
   

 ebcdicutf8：字符串是EBCDIC的UTF-8编码，只应用于IBM iSeries和zSeries。
   

utf16：字符串是UTF-16编码。如果字符串是以Unicode的标记字节顺序号(BOM)开始，PDFlib会接收BOM信息后将其从字符串首移去。

如果字符串不带 BOM，字符串的字节顺序将取决于主机的字节顺序。

Intel x86系统是小尾（little-endian，0xFFFE ）, 而Sparc和PowerPC系统是大尾（big-endian,0xFEFF)。
   

 utf16be：字符串是大尾字节顺序的UTF-16编码。对BOM没有特殊处理。
   

utf16le：字符串是小尾字节顺序的UTF-16编码。对BOM没有特殊处理。
   

 auto:对于8位编码，它相当于“bytes”, 对于宽字符字符串(Unicode, glyphid, UCS2或UTF16 CMap)，它相当于“utf16”。

 

在编程语言里，我们将可以自动处理Unicode字符串的语言称为支持Unicode语言（Unicode-capable），它们是COM, .NET, Java, REALbasic及Tcl等。对于需对Unicode字符串进行特殊处理的语言称为不支持Unicode语言（non-Unicode-capable），它们是C, C++, Cobol, Perl, PHP, Python及RPG等。
   

 在non-Unicode-capable语言里，“auto”设置将会正确处理大部分文本字符串。
   对于Unicode-capable语言，textformat参数的缺省值是“utf16”；而non-Unicode-capable语言的缺省值是“auto”。
  

 除此之外，PDFlib还支持在SGML和HTML经常使用的字符引用方法（CharacterReference）。前提是将参数charref设成真, textformat设成“bytes”:


   PDF_set_parameter(p, "charref", "true");
   PDF_set_parameter(p, "textformat", "bytes");

下面给出一些有效的CharacterReference:
  

 ­ soft hyphen
  

 ­ soft hyphen
   

­ softhyphen
  

 € Euro glyph(hexadecimal)
   

 €Euro glyph (decimal)
   

 €Euro glyph (entity name)
   

 <less than sign
   

> greater thansign
  

 & ampersand sign
   

 ΑGreek Alpha
   

下面是一个相关的例子--C 源程序(附上生成的pdf文件–PDFlib_cs4.pdf)。


   
   

 #include<stdio.h>
   

 #include<stdlib.h>
   

 #include<string.h>
   

#include"pdflib.h"
   

 intmain(void)
   

 {
   

 PDF            *p = NULL;
   

 int           Font_E= 0, Font_H = 0, Font_CS = 0, Left = 50, y = 800, i =0;
   

 constint      INCRY = 25;
   

char             text[128], buf[128];
   
   

static const char byte_text[]=
   "\123\151\155\160\154\151\146\151\145\144\040\103\150\151\156\145\163\145";
   

static const int byte_len =18;
  

  static const charbyte2_text[] ={0x53,0x69,0x6D,0x70,0x6C,0x69,0x66,0x69,0x65,
   0x64,0x20,0x43,0x68,0x69,0x6E,0x65,0x73,0x65};
  

  static const intbyte2_len = 18;
   
  

  static constunsigned short utf16_text[] ={0x7B80,0x4F53,0x4E2D,0x6587};
  

  static const intutf16_len = 8;
   

 static const unsignedcharutf16be_text[]="\173\200\117\123\116\055\145\207";
   

 static const intutf16be_len = 8;
   

 static const unsignedchar utf16be_bom_text[] ="\376\377\173\200\117\123\116\055\145\207";
   

 static const intutf16be_bom_len = 10;
   

 static const unsignedchar utf16le_text[]="\200\173\123\117\055\116\207\145";
  

  static const intutf16le_len = 8;
 

  static const unsigned char utf16le_bom_text[] ="\377\376\200\173\123\117\055\116\207\145";
  

  static const intutf16le_bom_len = 10;
  

  static constunsigned char utf8_text[] ="\347\256\200\344\275\223\344\270\255\346\226\207";
  

  static const intutf8_len = 12;
   

 static const unsignedchar utf8_bom_text[] ="\xEF\xBB\xBF\xE7\xAE\x80\xE4\xBD\x93\xE4\xB8\xAD\xE6\x96\x87";
  

  static const intutf8_bom_len = 15;
   

 static const charhtmlutf16_text[] = "简体中文";
   

 static const inthtmlutf16_len = sizeof(htmlutf16_text) - 1;
  

  typedefstruct
   {
   

 char*textformat;
  

  char*encname;
  

  const char*textstring;
  

  constint  *textlength;
   

 const char*bomkind;
   

} TestCase;
   

 static const TestCasetable_8[] = {
   

{"bytes",     "winansi",  (const char*)byte_text,        &byte_len,     ""},
  

  {"auto",       "winansi",  (const char*)byte_text,        &byte_len,     ""},
  

  {"bytes",     "winansi",  (const char*)byte2_text,      &byte2_len,    ""},

};
  

  static constTestCase table_16[] =  {
  

  {"auto",  "unicode",  (const char*)utf16_text,      &utf16_len,     ""},
 

  { "utf16", "unicode",  (const char*)utf16_text,      &utf16_len,     ""},
   

 {"auto",  "unicode",  (const char*)utf16be_bom_text, &utf16be_bom_len, ",UTF-16+BE-BOM"},
  

  {"auto",    "unicode",    (const char *)utf16le_bom_text, &utf16le_bom_len,", UTF-16+LE-BOM"},
   

 { "utf16be","unicode",   (const char*)utf16be_text,        &utf16be_len,   ""},
  

  {"utf16le",  "unicode",   (const char*)utf16le_text,          &utf16le_len,   ""},
 

  {"utf8",      "unicode",   (const char*)utf8_text,              &utf8_len,      ""},
   

 {"auto",      "unicode",   (const char*)utf8_bom_text,     &utf8_bom_len, ", UTF-8+BOM"},
   

 { "bytes","unicode",   (const char*)htmlutf16_text, &htmlutf16_len, ", HTML unicodecharacter"}, };
 

  const int   tsize_8 = sizeoftable_8 / sizeof (TestCase);
  

  constint   tsize_16 = sizeof table_16/ sizeof (TestCase);
   
   

 if ((p = PDF_new()) ==(PDF *) 0)
   

 {
   printf("Couldn't create PDFlib object (out ofmemory)!\n");
   return(2);
   }
   

 PDF_TRY(p){
  

  if(PDF_begin_document(p, "pdflib_cs4.pdf", 0, "") ==-1)
   {
   printf("Error: %s\n", PDF_get_errmsg(p));
   return(2);
   }
  

  PDF_set_info(p,"Creator", "pdflib_cs4.c");
   

 PDF_set_info(p,"Author", "myi@pdflib.com");
  

  PDF_set_info(p,"Title", "Output Chinese Simplify with Differenttextformat");
   
  

 PDF_begin_page_ext(p, a4_width, a4_height, "");
 

  Font_H = PDF_load_font(p, "Helvetica-Bold", 0, "winansi","");
   
   

 Font_E =PDF_load_font(p, "Times", 0, "winansi", "");
 

  PDF_setfont(p, Font_H, 24);
  

  PDF_show_xy(p,"8-bit encoding", Left+40,  y);
 

  y -= 2*INCRY;
    for(i = 0; i < tsize_8; ++i)
   

 {
   PDF_setfont(p, Font_H, 14);
   sprintf(text, "%s encoding, %s textformat %s: ",table_8[i].encname,
   table_8[i].textformat, table_8[i].bomkind);
   PDF_show_xy(p, text, Left,  y);
    y -=INCRY;
   PDF_set_parameter(p, "textformat",table_8[i].textformat);
   PDF_setfont(p, Font_E, 14);
   

 PDF_show_xy(p,table_8[i].textstring, Left, y);
   

 y -=INCRY;
   

} 
   
   

 PDF_setfont(p, Font_H,24);
  

  y -=2*INCRY;
   

 PDF_show_xy(p, "16-bitencoding", Left+40,  y);
  

  y -=2*INCRY;
  

 PDF_set_parameter(p, "charref", "true");
  

  Font_CS =PDF_load_font(p, "STSong-Light", 0, "UniGB-UCS2-H","");
 

  for (i = 0; i < tsize_16; i++)
   

        {
   

PDF_setfont(p, Font_H,14);
  

sprintf(text, "%s encoding, %stextformat %s: ", table_16[i].encname,
   table_16[i].textformat, table_16[i].bomkind);
 

  PDF_show_xy(p, text, Left,  y);
  

  y -=INCRY;
   

 PDF_setfont(p, Font_CS,14);
   

 sprintf(buf,"textformat %s",table_16[i].textformat);
   

 PDF_fit_textline(p,table_16[i].textstring, *table_16[i].textlength,
   Left, y, buf);
   

y -= INCRY;
   

} 
   
  

 PDF_end_page_ext(p, "");
  

 PDF_end_document(p, "");
  

 }
   

 PDF_CATCH(p){
   printf("PDFlib exception occurred in pdflib_cs4sample:\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;
   

}