第7章 制限事項

[ 全般 ]

• PDF Tool API V6.0は、V3.1以前のPDF Tool APIとは互換はありません。

• PDF Tool API V6.0で取扱い可能なPDFファイルは、PDF リファレンスの仕様に準拠したファイルです。

• PDF Tool API V6.0で出力されるPDFファイルのPDFバージョンは、原則として入力ファイルの情報が引き継がれます。

• 入力ファイルとして読み込み（load）可能なPDFファイルのファイルサイズは2GBまでです。2GBを超えるPDFファイルの場合はload時エラーとなります。

• PDF Tool APIで保存されるPDFのファイルサイズの上限は2GBです。2GBを超える場合は、保存時に「103」となります。

出力ファイルサイズの上限判定は、PDF Tool APIでPDFの加工や編集を行い保存する結果が2GBを超えるかどうかです。たとえばPDFファイルを結合する場合、PDF Tool APIでは物理的にPDFファイルを結合する処理ではないため、結合前のPDFファイルサイズの合計が2GB未満であっても保存できない場合があります。

• 任意のPDFバージョン番号を設定することはできません。

• PDF/A、PDF/Xに対して編集を行った場合、PDF/A、PDF/Xの情報は破棄されます。

• 複数のスレッドでの同時利用はできません。

• PDF Tool API V6.0では保存処理においてPDF Tool API V3.1と異なる点があり、PDFファイルの構造によってはV3.1よりV6.0のほうが保存処理に時間がかかる場合があります。

PDFには、「オブジェクトストリーム」という構造によりオブジェクトを圧縮してファイルサイズを小さく抑えるしくみがあります。V3.1では、オブジェクトストリームという圧縮状態を解除して保存を行うため、保存後のPDFファイルサイズが大きくなるケースがありました。 V6.0では、オブジェクトストリームという圧縮状態のままオブジェクトを更新する保存処理となっています。保存を行っても圧縮された状態は保持されるためファイルサイズが極端に大きくなることはありません。ですが、オブジェクトストリームの中をすべて探査して更新処理を行うため処理時間がかかる場合があります。

• PDF Tool APIの処理対象PDFファイルについて、弊社において動作確認を行っているPDFは次のようなファイルです。
  • Adobe システムズ社の Acrobat によって作成された PDF 1.7 までの仕様に準拠したPDF ファイル
  • アンテナハウス製の PDF ドライバによって作成された PDF ファイル
  • その他の製品で作成された「ISO 32000-1:2008」に準拠したPDFファイル

上に示したもの以外に動作保証している特定の PDF 変換ソフトウェアはございません。

• PDF Tool APIのメインモジュールファイルとこれと依存関係にあるモジュールファイルは、必ず、同一の改訂版をご使用ください。メインモジュールと依存関係モジュールが異なる改訂版であるファイルや、他の製品でリリースされたファイルを依存関係モジュールとして使用しないでください。

[ フォント ]

• ビットマップフォント、Type3フォントには対応していません。

• 縦書きではイタリックの指定があってもフォントがグリフを持っていない場合はイタリックにはなりません。

• フォント埋め込み処理において、埋め込み対象となるフォントが動作環境に存在していなければなりません。

• フォント埋め込み処理において、フォントが埋め込み禁止である場合は埋め込み処理は行われません。

• フォント統合処理では重複するフォント情報をひとつに統合しますが、統合により必ずファイルサイズが小さくなるわけではありません。

[ 画像圧縮 ]

• ダウンサンプリングを行ったとき、カラースペースが元のデータとは異なる場合があります。

[ 透かし ]

• テキスト透かし処理において、タイリングあるいは角度付きのテキストの場合は、改行コードはサポートされません。

[ 閲覧制限 ]

• 閲覧制限設定を行ったPDFから閲覧制限設定を取り除くことはできません。

• 閲覧制限はAcrobat Java Scriptの機能を利用しています。したがって、Acrobat Java ScriptをサポートしていないPDFビューアや、Acrobat Java Scriptの機能が無効になっているPDFビューアでは設定された制限動作はせず、常に閲覧不可状態、もしくはページが真っ白な状態で表示されます。また、Acrobat Java Scriptをサポートしていても、PDFビューアによっては期待する制限動作をしない場合があります。

• 閲覧制限設定されたPDFをAcrobat/Adobe Readerで表示させたとき、閲覧できる状態であっても「サムネイル」ナビゲーションパネルでは内容が表示されません。

• 閲覧制限設定されたPDFのしおり、添付ファイル、文書情報は、閲覧不可やJava Scriptが無効な場合であっても非表示にはなりません。

• 閲覧制限設定されたPDFがポートフォリオの場合、ポートフォリオは添付ファイル機能であるため、閲覧不可やJava Scriptが無効な場合であっても非表示にはなりません。

• 閲覧制限設定されたPDFを閲覧不可やJava Scriptが無効なときにAcrobat / Adobe Readerで表示している場合、「注釈」ナビゲーションパネル（Adobe Reader XIでは「表示」‐「注釈」メニューで表示される注釈のリスト）は非表示にはなりません。

• 閲覧制限設定を行ったPDFファイルに対して追加した注釈やフォームは、閲覧不可やJava Scriptが無効な場合に非表示にはなりません。

• 閲覧制限設定されたPDFにおいて閲覧不可やJava Scriptが無効なときにページ上の注釈あるいはフォームを選択できた場合には、注釈、フォームは表示状態になります。

• 閲覧制限設定されたPDF をAcrobat Java Script機能を持たないPDFビューアで表示させた場合、まっしろなページではなく、閲覧不可のときの表示となる場合があります。

• 閲覧制限設定されたPDFが閲覧不可やJava Scriptが無効なとき、Acrobat / Adobe Reader以外のPDFビューアでは注釈とフォームが表示される場合があります。

• 閲覧制限設定処理において、閲覧制限時に表示する透かしは１つの「PtlParamWaterMark」のみ設定可能です。

• 閲覧制限を設定する場合、同時にセキュリティの権限とオーナーパスワードを設定することをおすすめします。

• すでに閲覧制限設定されたPDFに対し再度閲覧制限設定を行った場合、設定された閲覧制限の制限動作は保証されません。

• 閲覧制限設定においてappendValidURL()でパスを指定する場合、ファイル名やフォルダ名に使用できない文字（¥　/　:　*　?　"　<　>　|）やサロゲートペア文字は指定できません。指定された場合、動作結果は不定となります。

[ セキュリティ ]

• 添付ファイルのみを暗号化する場合（ENCRYPT_COMPONENT.ENCRYPT_ONLY_ATTACHED_FILE）は、「SetUserPassword」によるパスワード文字列設定が必須です。

• 添付ファイルのみの暗号化処理（ENCRYPT_COMPONENT.ENCRYPT_ONLY_ATTACHED_FILE）では、セキュリティの権限設定は行われません。したがって、「SetOwnerPassword」「SetPermission」は呼び出さないようにしてください。

[ 開き方 ]

• 開き方設定処理においてメニューバー非表示とWindowsコントロール非表示を同時に設定したPDFファイルをAcrobat/Acrobat Readerで開いた場合、メニューバーは表示されます。

[ データ削除 ]

• 画像の削除を行った場合、カラースペース/圧縮形式が元のデータとは異なる場合があります。

• ページコンテンツのパスを削除する場合、パス全体を矩形で囲むようにしてください。パスの部分削除は不可なため、パス全体が矩形内に含まれていない場合はそのパスは削除されません。

[ 画像抽出 ]

• 画像抽出処理は、オブジェクト1個をひとつの画像ファイルとして出力します。表示上は1個の画像であってもオブジェクトが細かく分かれている場合があり、このようなケースでは出力される画像ファイル数が多くなります。

• 画像抽出処理は、ページコンテンツ全体を対象としています。表示領域がページコンテンツの一部分である場合、表示されていない部分の画像も抽出対象となります。

• 画像抽出処理は、クリッピングされて表示されていない部分の画像も抽出対象となります。

[ テキスト抽出 ]

• テキスト抽出処理において、抽出を行う範囲を指定しない場合、ページコンテンツ全体が抽出対象となります。表示領域がページコンテンツの一部分である場合、表示されていない部分のテキストも抽出対象となります。

• テキスト抽出処理は、クリッピングされて表示されていない部分のテキストも抽出対象となります。

• 英語など欧文テキストに対しては、単語間のスペースが取り除かれた状態で抽出されます。

[ テキスト検索 ]

• テキスト検索処理は、ページコンテンツ全体が検索対象となります。表示領域がページコンテンツの一部分である場合、表示されていない部分のテキストも検索対象となります。

• テキスト検索処理は、クリッピングされて表示されていない部分のテキストも検索対象となります。

• PDFの表示上はテキストであっても、実体のオブジェクトの種類がテキストではなく画像やパスである場合があります。この場合、テキスト検索の対象とはなりません。

• テキスト検索処理において、キーワードがページをまたいでいる場合、その箇所は検索されません。

• 検索キーワードのスペースは、取り除いた状態で検索処理を行います。

[ 注釈 ]

• PDF Tool API V6.0において、新規に作成が可能な注釈の種類は、テキスト、スタンプ、ファイル添付、リンク、ハイライトの5種類です。

• ハイライト注釈を扱うPtlAnnotTextMarkupクラスのオブジェクトに対しては、基底クラスPtlAnnotのsetRect関数で矩形座標の設定は行わないでください。

• 処理対象のPDFファイル上にある既存の注釈に対しては、情報取得、削除ができます。

[ 文書情報 ]

• 文書情報にカスタムプロパティを設定する場合、次の単語はプロパティの名前として指定することはできません。エラーとなります。：Title , Author , Subject , Keywords , Creator , Producer , CreationDate , ModDate , Trapped

• 文書情報のキーワードとして設定した文字列に含まれる文字や記号の種類により、Acrobatで開いたとき、文書情報においてキーワードが二重に表示される場合があります。