1. PLOP_create_file() の削除

既存の PDF に PLOP で処理を行った結果の PDF を作成する関数 PLOP_create_file() は削除され、PLOP 5 では使用できません。代わりに、PLOP 5 では PLOP_create_document() を使用します。また PLOP_create_document() では、input オプションで処理を行う PDF のドキュメントハンドルを明示的に指定する必要があります。

   $p = new PLOP();
   $doc = p->open_document("infile.pdf", "");
   $p->create_document("outfile.pdf", "input=$doc");
     …
 

2. PLOP_close_document() の引数の追加

PLOP 4 の PLOP_close_document() では、PLOP オブジェクトと PDF ドキュメントハンドルを引数にしていました。PLOP 5 の PLOP_close_document() では、この他に文字列型の optlist を引数に与える必要があります。引数が足りない場合は他の関数と同様にエラーになりますので、オプションを使用しない場合でも空文字 ("") を与える必要があります。

   $p = new PLOP();
   $doc = $p->open_document("infile.pdf", "");
     …
   $p->close_document($doc, "");
 

PLOP_close_document() の optlist では "lastinthread" オプションを使用することができます。

3. PLOP_create_file() の compatibility オプションの廃止

PLOP 4 の PLOP_create_file() には compatibility オプションがあり、出力する PDF のバージョンを指定することができました。PLOP 5 では PLOP_create_file() の代わりに PLOP_create_document() を使用しますが、PLOP_create_document() には compatibility オプションはありません。出力する PDF のバージョンは、常に元になった PDF のバージョンと同じになります。

4. optimize オプションのデフォルト値の変更

PLOP 4 の PLOP_create_file() には optimize オプションがあり、このデフォルトは "all" (PLOP で実行可能なすべての最適化処理を実行) でした。PLOP 5 で PLOP_create_file() を置き換える PLOP_create_document() にも optimize オプションはありますが、デフォルトは "none" (最適化処理を行わない) になっています。optimize による PDF の最適化 (冗長なオブジェクトの削除) を行う場合、明示的に "optimize=all" を指定する必要があります。

   $p = new PLOP();
   $doc = $p->open_document("infile.pdf", "");
   $p->create_document("outfile.pdf", "indoc=$doc optimize=all");
     …
 

optimize を使用すると PDF 文書内に同じ画像ファイルが複数含まれるといった冗長性が排除され、ファイルサイズの縮小が期待できます。一方、最適化を行う分だけ処理に時間がかかります。

5. pdfa1 サブオプションの非推奨化

PLOP_create_file の sacrifice オプションのサブオプション pdfa1 は、PLOP 5 の PLOP_create_document() では非推奨になります。代わりに pdfa サブプションを使用します。

   $p = new PLOP();
   $doc = $p->open_document("infile.pdf", "");
   $p->create_document("outfile.pdf", "indoc=$doc sacrifile={pdfa}");
     …
 

6. 非推奨関数の廃止

PLOP 4.1 までに非推奨になっていた下記の関数が削除されています。

• PLOP_utf16_to_utf32()、PLOP_utf8_to_utf16()、PLOP_utf8_to_utf32()
  → PLOP_convert_to_unicode() を使用
• PLOP_open_document_mem()
  → PVF でメモリ上に仮想ファイルを作成して PLOP_open_document() する
• PLOP_get_value()、PLOP_set_value()、PLOP_get_parameter()、PLOP_set_parameter()
  → PLOP_get_option()、PLOP_set_option() を使用
• PLOP_open_file()、PLOP_close()、PLOP_open_mem()、PLOP_open_callback()
  → PLOP_open_document()、PLOP_close_document() を使用

1. sign オプションの削除

電子署名を行う際、PLOP DS 4 では PLOP_create_file() の sign オプションを使用していましたが、PLOP DS 5 の PLOP_create_document() では sign オプションが削除されています。代わりに、新たに追加された関数 PLOP_prepare_signature() を PLOP_create_document() より前で呼び出します。

   $p = new PLOP();
   $doc = $p->open_document("infile.pdf", "");
   $p->create_document("outfile", "");
   $p->prepare_signature("engine=builtin ".
                         "digitalid={filename=demorsa2048.p12}".
                         "password={demo}");
     …