PDFlib 製品に関するよくある質問

たとえば、Windows用パッケージでは、C及びC++バインディングの設定方法は、doc/readme-binary.txt に記述されています。その他の言語バインディングについては、各バインディング用のバイナリー、サンプルプログラム等を収容している /bind 下の各言語ディレクトリー、例えばphpであれば、bind/php/のreadme.txt に設定方法が記載されています。またリファレンスマニュアルの各バインディングの説明中に設定に関する記述があることもありますので、こちらも参照ください。なお、readme.txtの記述は英語となっています。

■スクリプトまたはプログラムで実行時にライセンスキーを指定する方法

  $p = new PDFlib();
  $p->set_parameter("license", "...あなたのライセンスキー...");
     .
     .
     .
  $p = 0;

パラメータ license は PDF_new() などによりPDFlibのオブジェクトを初期化した直後に指定することが可能です。

■ライセンスファイルによりライセンスキーを指定する方法

下記のようなテキストファイル(ライセンスファイル)を作成し、ライセンスキーを指定す ることができます。

  PDFlib license file 1.0
  # Licensing information for PDFlib GmbH products
  PDFlib 8.0 ...あなたのライセンスキー...

このライセンスファイルには、PDFlibの複数のライセンスをそれぞれ別の行に記述することができます。

次に、ライセンスファイルのパスを下記のいずれかの方法で指定します。

1)下記のように licensefile パラメータをPDF_new() などによりPDFlibのオブジェクトを初期化した直後にただ一度だけ設定します。

  $p = new PDFlib();
  $p->set_parameter("licensefile", "/path/to/license/file");
     .
     .
     .
  $p = 0;

2)下記のようなコマンドで、環境変数 PDFLIBLICENSEFILE を設定します。(設定コマンドは処理系により異なります。)

export PDFLIBLICENSEFILE=/path/to/license/file

(注)/path/to/licennse/fileは、ライセンスファイルへのパスで処理系に応じた記述をする必要があります。

■個別のキーを複数適用する方法

複数のライセンスキーを別々の注文で購入した場合に、これらのキーをライセンスファイルにまとめて指定することにより合計のCPU数のライセンスを適用することができます。この場合、各ライセンスキーを１行ずつ指定します。また関数 PDF_set_parameter() を複数回呼び出して各ライセンスキーを指定することもできます。

■ライセンス適用を一時的に外す方法

ライセンスを適用したPDFlibは、購入したライセンス以外の機能は使用できなくなります。ライセンス適用後に通常使用できない上位のパッケージ機能を評価したい場合には、下記のようにダミーのライセンスキーを適用して全ての機能を使用することができます。この場合は全ての出力に評価版と同様のデモスタンプが表示されます。

  $p = new PDFlib();
  $p->set_parameter("license", "0");
     .
     .
     .
  $p = 0;

(注)本記述は、PDFlib リファレンスマニュアル 「0. PDFlibライセンスキーの適用」をもとにまとめたものです。正式の記述についてはマニュアルを参照してください。

  PDFlib license file 1.0
  # Licensing information for PDFlib GmbH products
  PDFlib 6.0.3 first key
  PDFlib 6.0.3 additinal key

set_paramaterを使用してライセンスキーを適用している場合、下記の様にしてください。

  $p = new PDFlib();
  $p->set_parameter("license", "first key");
  $p->set_parameter("license", "additinal key");
     .
     .
     .
  $p = 0;

PDF_begin_document( ) のcompatibility オプションを指定する事により、指定したバージョンでのPDFファイルの出力が可能です。 例えば、Acrobat Reader 4 ユーザー用にPDF 1.3 で出力する場合、下記の様に指定します。

  $p = new PDFlib();
  $p->begin_document("/sample/sample.pdf", "compatibility=1.3");
     .
     .
     .
  $p->end_document("");
  $p = 0;

但し下記の条件があります。

1. PDIやPPSでファイルを読み込んでPDFを生成する場合、読み込むPDFファイルは、出力しようとしているPDFファイルのファイルバージョンと同じか、より古いバージョンでなけばならない。
2. 指定したPDFフォーマットでサポートされていない機能を使用する事は出来ない。

PDF/X出力する場合、ファイルの特性上、下記の処理が必要になります。

1. フォントの埋め込み
2. 画像は実画像を埋め込む
3. 出力フォーマットに応じたPDFフォーマットの選択

  $p = new PDFlib();
  $optlist = sprintf("linearize=true ");
    ↑線形化を行う指定をします。
  $optlist .= sprintf("inmemory=true ");
    ↑線形化処理メモリ内で行う為の指定です。
  $p->begin_document("/sample/sample.pdf", $optlist);
     .
     .
     .
  $p->end_document("");
  $p = 0;

Web用PDFを有効に利用する為には、下記の制限があります。

1. Web サーバがバイトサービングに対応している事。
   基本的には現行のすべてのWeb サーバに実装されていますが、Apache 1.3.14 にはバグがありバイトサービングができません。（他のバージョンは可）
2. ユーザーは Acrobat をブラウザのプラグインとして使用する事。
3. Acrobatでページごとのダウンロードが有効になっている事。（デフォルトは有効になっています。）

CJKフォントは、Acrobatが標準でサポートしており、PDF文書に埋め込む必要の無いスタンダードCJKフォント及びユーザが指定するTrueTypeやOpenType形式のカスタムCJKフォントの2種類があります。PDFlib6からはフォントに関する制限がかなり緩和されましたが、スタンダードCJKフォントを非ユニコード系のCMapで使用する場合には以下の機能を使用できません

• PDF_stringwdith()関数での文字幅計算
• PDF_show_Boxed()関数でのボックス整形(UCS2でも不可)
• アンダーライン/オバーライン/ストライクアウトモードの指定
• textx/textyの位置の取得

カスタムフォントは、TrueType形式（TTC形式を含む）、OpenType形式のカスタムフォントに対応しています。
CJKフォントや日本語フォントの取扱いの詳細についてはリファレンスマニュアル「4.7 日本語･中国語･韓国語テキスト」に記述されています。 また当社ウェブ記事「PDFlib入門 5.テキストを出力する」でもご説明しています。

  $p = new PDFlib();
  $p->begin_document("/sample/sample.pdf", "");
  $p->set_parameter("SearchPath", "/usr/local/fonts");
    ↑フォントファイルの場所を指定します。
  $p->set_parameter("FontOutLine", "ABCMincho=ABCMincho.TTF");
    ↑フォントアウトラインを指定します。
  $optlist = sprintf("embedding=true ");
    ↑フォント埋め込みを行うように指示します。
  $optlist .= sprintf("autosubsetting=true ");
    ↑サブセッティングを行うように指示します。
  $p->load_font("ABCMincho", "unicode", $optlist);
     .
     .
     .
  $p->end_document("");
  $p = 0;

サブセッティングを行うと、フォント全てを埋め込む場合と比較してファイルサイズを小さくする事が可能です。日本語フォント等のファイルサイズの大きいフォントを埋め込む場合に有効な方法です。
サブセッティング処理を行うには、フォントが下記の必要があります。

1. TrueType フォント
2. PostScript かTrueType のアウトラインを持つOpenType フォント

  $p = new PDFlib();
  $p->begin_document("/sample/sample.pdf", "");
  $p->set_parameter("SearchPath", "../../../resource/cmap");
    ↑CMapsファイルの場所を指定します。
  $p->load_font("Arial Unicode MS", "cp932", "");
     .
     .
     .
  $p->end_document("");
  $p = 0;

※テクニカルトピックでもPDFlib 6 からの移行として詳しく説明しています。

なおPDFlib Personalization Server(PPS)では、フォームと類似した機能として、テキスト、イメージ及びPDFページを動的に挿入できるブロックという領域を利用できます。ブロックは、名前と属性を持つ領域で、PDFlib ブロックプラグインをインストールしたAcrobatによりPDF文書上に簡単に定義することができます。

また、PDI用によく使用される下記の関数が変更になりました。

上記を参考に、コードを書き換えてください。

※テクニカルトピックでもPDFlib 6 からの移行として詳しく説明しています。

デベロッパー様が開発に利用するライセンスについてもあわせてご購入をご検討いただくようお願いいたします。

(注)購入いただいたパッケージの種類に応じた利用機能の制限を受けます。

請求書、領収証については、ご購入時に購入フォームに選択欄がありますので、「郵送、FAXの別(両方でも可)」も合わせてご指定ください。