Skip to main content
Interwork Corporation
IDR Solutions Product Support Portal
PDF開発用語集 モードの切替 ダーク/ライト/自動 モードの切替 ダーク/ライト/自動 モードの切替 ダーク/ライト/自動

PDPageFitWidthDestination

概要

PDPageFitWidthDestinationは、Apache PDFBoxライブラリにおけるJavaクラスで、PDF文書内の特定の宛先タイプを表します。このクラスは、PDF仕様 ( Citation: N.A., (N.A.). (). Document management — Portable document format — Part 2: PDF 2.0 International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html ) で定義されている「FitH」宛先タイプを実装しており、特定の垂直位置を維持しながら、ページの幅をウィンドウ幅に合わせてスケーリングして表示します。PDFBoxの高レベルPDModel APIの一部として、PDFのナビゲーションとリンク動作をプログラムで管理するために使用されます。

定義

PDPageFitWidthDestinationは、ページの幅をビューアウィンドウに合わせる宛先を作成または操作するために、PDFBoxの宛先階層を拡張した具象実装クラスです。ユーザーがこの宛先タイプを使用したリンクやブックマークをたどると、PDFビューアは自動的にズームレベルを調整し、対象ページの幅全体が水平方向に表示領域を満たすようにしながら、指定された上部座標にページを配置します。

この宛先タイプは、他のPDFBox宛先クラス(ページ全体を合わせるPDPageFitDestinationや、明示的なズームと位置指定を使用するPDPageXYZDestination)とは異なります。PDPageFitWidthDestinationは特に水平方向の調整を優先するため、テキスト列やコンテンツの範囲を水平スクロールなしで完全に表示できるようにするのに最適です。

PDF仕様 ( Citation: N.A., (N.A.). (). Document management — Portable document format — Part 2: PDF 2.0 International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html ) では、これはFitH宛先配列形式に対応しており、ページ参照、キーワード「FitH」、およびページを表示する垂直位置を示すtopパラメータで構成されます。

全投稿を閲覧 gdoc_arrow_right_alt

PDPageLabelRange

概要

PDPageLabelRangeは、Apache PDFBoxの高レベルPDModel APIに含まれるクラスで、PDF文書内のページラベリング情報にプログラムからアクセスする機能を提供します。ページラベルを使用することで、PDF仕様 ( Citation: N.A., (N.A.). (). Document management — Portable document format — Part 2: PDF 2.0 International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html ) で定義されているように、文書内の物理的なページ位置とは異なるカスタムページ識別子(ローマ数字、アルファベット、カスタムプレフィックスなど)を表示できます。このクラスにより、開発者は既存のページラベル設定を読み取ったり、PDFページの新しいラベリングスキームを作成したりできます。

定義

PDPageLabelRangeは、PDF文書のページラベル辞書内の単一のページラベル範囲を表します。PDF文書では、単純な連番ではなく、異なる番号スタイルやプレフィックスでページにラベルを付けることができます。たとえば、前付けには小文字のローマ数字(i、ii、iii)を使用し、本文にはアラビア数字(1、2、3)を使用する場合があります。各PDPageLabelRangeオブジェクトは、番号スタイル、開始値、プレフィックステキストなど、そのような範囲のプロパティをカプセル化します。このクラスは、実際のページコンテンツを表すPDPageや、文書のページ階層を管理するPDPageTreeなど、他のページ関連PDFBoxクラスとは異なり、PDFビューアでの表示目的でページがどのようにラベル付けされるかに専念しています。

重要性

ページラベルを理解し適切に実装することは、非連続的または特殊なページ番号付けが必要な専門的な文書を扱う開発者にとって極めて重要です。法的文書、学術論文、書籍、技術マニュアルでは、異なるセクションに異なる番号スキームを使用することが頻繁にあります。アクセシビリティツールや支援技術は、ユーザーが文書を効果的にナビゲートできるように正確なページラベルに依存しており、これはPDF/UA準拠文書 ( Citation: N.A., (N.A.). (). Document management applications — Electronic document file format enhancement for accessibility — Part 1: Use of ISO 32000-1 (PDF/UA-1) International Organization for Standardization Retrieved from https://www.iso.org/standard/64599.html ) において特に重要です。PDF生成または操作ツールを構築する開発者にとって、PDPageLabelRangeは、従来の出版規則に合致し、文書ナビゲーションに対するユーザーの期待に応える文書を作成するために必要な機能を提供します。

全投稿を閲覧 gdoc_arrow_right_alt

PDPageLabels

概要

PDPageLabelsは、Apache PDFBox PDModel APIの高レベルクラスで、PDF文書内のページラベル情報へのプログラマティックなアクセスを提供します。ページラベルは、PDF閲覧ソフトでページ番号がどのように表示されるかを制御し、 ( Citation: N.A., (N.A.). (). Document management — Portable document format — Part 2: PDF 2.0 International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html ) で定義されているページラベル辞書に従って、文書の異なるセクションに異なる番号スタイル(ローマ数字、アルファベット、カスタムプレフィックス)を使用できるようにします。このクラスにより、開発者は既存のページラベル設定を読み取ったり、単純な連番を超えた洗練されたページ番号スキームを作成するために変更したりすることができます。

定義

PDPageLabelsは、Apache PDFBoxのorg.apache.pdfmodelパッケージ内のJavaクラスで、PDFのページラベル辞書構造のラッパーとして機能します。常に0から始まり順次増加する物理的なページインデックスとは異なり、ページラベルはPDF閲覧ソフトでユーザーに表示される論理的なページ識別子を定義します。例えば、前付けには「i, ii, iii」を使用し、本文には「1, 2, 3」を使用するといった形です。このクラスは、特定のページのラベル情報を取得したり、新しいラベル範囲を追加したり、これらの定義を格納する基盤となるNumberTreeNode構造を操作したりするメソッドを提供します。PDPageLabelsは個々のページオブジェクトを表すPDPageクラスとは異なり、PDF全体でのすべてのページの表示と参照方法に影響を与える文書レベルのメタデータを管理します。

重要性

ページラベリングは、前付け(序文、目次)に伝統的に小文字のローマ数字を使用し、本文にアラビア数字を使用するという印刷出版の慣習に合致した、プロフェッショナルな文書を作成するために不可欠です。文書生成、結合、操作を行う開発者にとって、PDPageLabelsは、異なる番号スキームを持つ文書を結合する場合や、異なる番号スタイルを持つ複数のセクションを含む文書を作成する場合に、適切なページ参照を維持するために必要な制御を提供します。これは ( Citation: N.A., (N.A.). (). Document management applications — Electronic document file format enhancement for accessibility — Part 1: Use of ISO 32000-1 (PDF/UA-1) International Organization for Standardization Retrieved from https://www.iso.org/standard/64599.html ) 準拠文書のアクセシビリティとナビゲーション機能において特に重要になります。正確なページラベリングは、ユーザーが大きな文書を効率的にナビゲートするのに役立ちます。適切なページラベル管理がなければ、結合またはプログラム的に生成されたPDFは、文書の構造と一致しない混乱した、または不正確なページ番号を表示する可能性があります。

全投稿を閲覧 gdoc_arrow_right_alt

PDPageTree

概要

PDPageTreeは、Apache PDFBoxの高レベルPDModel APIに含まれるJavaクラスで、PDF仕様 ( Citation: N.A., (N.A.). (). Document management — Portable document format — Part 2: PDF 2.0 International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html ) で定義された階層的なページツリー構造へのプログラマティックなアクセスを提供します。このクラスにより、開発者はPDFドキュメント内のページ、およびそれに関連するリソース、注釈、メタデータをナビゲート、読み取り、変更することができます。PDPageTreeは、JavaアプリケーションでPDFドキュメントを扱う際のページレベル操作における主要なエントリーポイントとして機能します。

定義

PDPageTreeは、 ( Citation: N.A., (N.A.). (). Document management — Portable document format — Part 2: PDF 2.0 International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html ) で規定されているPDFドキュメントのページツリー構造を表すApache PDFBoxの実装クラスです。PDF仕様では、ページは単純な配列ではなくツリー構造で組織化されており、多数のページを持つドキュメントにおいてページ情報の効率的な保存と取得を可能にしています。PDPageTreeクラスは、この基礎となるツリー構造を抽象化し、開発者にページの反復処理、インデックスによる個別ページへのアクセス、新規ページの追加、既存ページの削除、ページレベルのプロパティ操作を行うための便利なメソッドを提供します。

全投稿を閲覧 gdoc_arrow_right_alt

PDPageXYZDestination

概要

PDPageXYZDestinationは、Apache PDFBoxの高レベルPDModel APIにおけるクラスで、PDF文書内のXYZ形式の移動先(destination)を表現します。この移動先タイプは、開発者がページ上の水平(X)座標と垂直(Y)座標、さらにズーム係数(Z)を含むターゲット位置を指定できるようにし、 ( Citation: N.A., (N.A.). (). Document management — Portable document format — Part 2: PDF 2.0 International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html ) で定義された移動先の仕様に準拠しています。PDF内の特定の表示位置にユーザーを誘導する内部リンク、ブックマーク、ナビゲーション要素の作成に一般的に使用されます。

定義

PDPageXYZDestinationは、PDF仕様で利用可能な複数の明示的な移動先形式の一つであるXYZ移動先タイプをカプセル化したJavaクラスです。ページ全体を表示するFitや、ページ幅に合わせるFitHなどの他の移動先タイプとは異なり、XYZ移動先は3つのパラメータ(左(X)座標、上(Y)座標、ズームレベル(Z))を精密に制御できます。これらのパラメータはそれぞれ明示的に設定することも、nullのままにすることもでき、未指定の値についてはPDFビューアがユーザーの現在の位置やズームレベルを維持します。このクラスはPDDestination抽象クラスを拡張しており、Apache PDFBoxアプリケーション内でページ参照と位置座標をプログラム的に操作するためのgetterおよびsetterメソッドを提供します。

重要性

PDFのナビゲーションおよびアクセシビリティ機能を扱う開発者にとって、PDPageXYZDestinationは正確なユーザーエクスペリエンスを作成するために不可欠です。文書管理システム、レポートジェネレーター、 ( Citation: N.A., (N.A.). (). Document management applications — Electronic document file format enhancement for accessibility — Part 1: Use of ISO 32000-1 (PDF/UA-1) International Organization for Standardization Retrieved from https://www.iso.org/standard/64599.html ) に準拠したアクセシビリティ強化文書など、インタラクティブなPDFを生成するアプリケーションを構築する際、リンクやブックマークをたどったときにユーザーがどこに到達するかを正確に制御する能力は、ユーザビリティを大幅に向上させます。これは、一般的なページ位置ではなく特定のコンテンツ要素にユーザーを誘導する必要がある構造的ナビゲーションを持つTagged PDFにおいて特に重要です。適切な移動先管理がなければ、文書内部のリンクが意図したユーザーエクスペリエンスを提供できず、複雑な文書でのナビゲーションフローが機能しなくなったり、支援技術ユーザーにアクセシビリティの問題を引き起こす可能性があります。

全投稿を閲覧 gdoc_arrow_right_alt

PDPanose

概要

PDPanoseは、Apache PDFBoxライブラリにおいて、PDFドキュメント内のPANOSEフォント分類情報を表すクラスです。PANOSEは、書体の視覚的特性を数値で記述するフォント分類システムであり、元のフォントが利用できない場合にフォントマッチングと代替を可能にします。PDFBoxでは、PDPanoseクラスは ( Citation: N.A., (N.A.). (). Document management — Portable document format — Part 2: PDF 2.0 International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html ) で定義されているこれらのフォント記述子を読み取り、操作するためのメソッドを提供します。

定義

PDPanoseは、Apache PDFBoxの高レベルPDModel API内のJavaクラスで、PANOSE-1フォントメトリクスをカプセル化します。PANOSE-1は、ファミリータイプ、セリフスタイル、ウェイト、プロポーション、コントラスト、ストロークバリエーション、アームスタイル、レターフォーム、ミッドライン、x-heightなどのフォント特性を記述するために10個の数値を使用する標準化されたフォント分類システムです。さまざまなフォントメタデータを扱う汎用的なフォント記述子クラスとは異なり、PDPanoseは、フォント間の視覚的類似性を識別するのに役立つこれら10個の分類数値に特化しています。PDFドキュメントにフォント記述子が含まれている場合、PDPanoseクラスを使用することで、開発者はこれらのPANOSE値にプログラム的にアクセスし、変更できます。これらの値は通常、12バイトの配列として格納されます(最初のバイトは構造タイプを示し、残りのバイトに10個の分類値が含まれます)。

重要性

PDFドキュメントを扱う開発者にとって、PDPanoseは、元のフォントが埋め込まれていない、または利用できない場合に、堅牢なフォント代替ロジックを実装するために不可欠です。PDFリーダーが指定されたフォントにアクセスできない場合、PANOSE値は視覚的に類似した代替フォントを見つけるための体系的な方法を提供し、ドキュメントの忠実性を維持し、 ( Citation: N.A., (N.A.). (). Document management applications — Electronic document file format enhancement for accessibility — Part 1: Use of ISO 32000-1 (PDF/UA-1) International Organization for Standardization Retrieved from https://www.iso.org/standard/64599.html ) で概説されているアクセシビリティ準拠を確保するのに役立ちます。これは、フォントの利用可能性が異なるさまざまなシステム間でPDFを処理するアプリケーションや、一貫した視覚的表現を必要とするアクセシブルなドキュメントを生成する場合に特に重要です。PDPanoseを理解することで、開発者は、ドキュメントの外観や可読性を大幅に低下させることなく、欠落したフォントを適切に処理する、より回復力のあるPDF処理ワークフローを作成できます。

全投稿を閲覧 gdoc_arrow_right_alt

PDPanoseClassification

概要

PDPanoseClassificationは、PDF文書内のフォント分類システムであるPANOSEを表現する、Apache PDFBoxのPDModel APIに含まれるクラスです。PANOSEは ( Citation: N.A., (N.A.). (). Document management — Portable document format — Part 2: PDF 2.0 International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html ) で定義された標準化されたフォント分類・照合技術であり、10桁の数値記述子を使用して書体の視覚的属性を特徴付けます。この分類システムにより、PDFのレンダリングやアクセシビリティ処理の際に元のフォントが利用できない場合でも、適切なフォント代替と照合が可能になります。

定義

PDPanoseClassificationは、Apache PDFBoxの高レベルPDModel APIに含まれるJavaクラスで、PDFのフォント記述子辞書に格納されているPANOSEフォント分類データをカプセル化します。PANOSEシステムは、ファミリー種別、セリフスタイル、ウェイト、プロポーション、コントラスト、ストローク変化、アームスタイル、字形、中心線、x-heightを含む10個の異なる分類指標を通じてフォントを記述します。これら10個の指標はそれぞれ1桁の数字で表現され、結果として10バイトの配列がフォントの視覚的外観を一意に特徴付けます。 ( Citation: N.A., (N.A.). (). Document management — Portable document format — Part 2: PDF 2.0 International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html ) に準拠したPDF文書では、この情報はフォント記述子のPanoseエントリに格納され、埋め込まれたフォントや参照されたフォントがシステム上で利用できない場合に、PDFプロセッサが適切なフォント代替を行うための判断材料となります。

全投稿を閲覧 gdoc_arrow_right_alt

PDPattern

概要

PDPatternは、Apache PDFBoxの高レベルPDModel APIに含まれるクラスで、PDF文書内の複雑な塗りつぶしや線描画操作に使用されるパターンリソースを表します。PDFにおけるパターンは、 ( Citation: N.A., (N.A.). (). Document management — Portable document format — Part 2: PDF 2.0 International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html ) で定義されているように、繰り返しのグラフィック、グラデーション、タイリング効果を実現するペインティングリソースの一種です。このクラスは、Java開発者がPDFページ内でコンテンツがどのようにレンダリングされるかを制御するパターン辞書にアクセスし、操作し、作成するためのメソッドを提供します。

定義

PDPatternは、Apache PDFBoxライブラリの抽象基底クラスで、PDF仕様で定義されているさまざまなパターンタイプの親クラスとして機能します。このクラスはPatternリソースを表し、PDFにおける4つの基本的な色空間(DeviceRGB、DeviceCMYK、DeviceGrayと並ぶ)の1つです。PDPatternには2つの具象サブクラスがあります:繰り返しグラフィカルパターンを扱うPDTilingPatternと、滑らかな色の遷移やグラデーションを扱うPDShadingPatternです。単純な色とは異なり、パターンは、領域全体に繰り返しペイントできる、またはグラデーションとしてペイントできる再利用可能なグラフィック要素を定義することで、洗練された視覚効果を実現します。PDPatternオブジェクトは通常、ページのリソース辞書に格納され、パスの塗りつぶしや線描画の際にコンテンツストリーム演算子によって参照されます。

重要性

PDF生成または操作を行う開発者にとって、PDPatternは単純な単色を超えた視覚的に豊かなドキュメントを作成するための重要な機能を提供します。カスタムレンダリング効果の実装、複雑な塗りつぶしを使用する既存のPDF文書の解析、またはPDF変更操作中にパターンベースのスタイリングを保持する際には、このクラスを理解することが不可欠です。テクスチャ背景で企業ブランディングを再現したり、ウォーターマークシステムを実装したり、PDF文書の視覚的構成を分析したりする必要があるアプリケーションでは、パターンリソースの適切な処理が必要です。さらに、 ( Citation: N.A., (N.A.). (). Document management applications — Electronic document file format enhancement for accessibility — Part 1: Use of ISO 32000-1 (PDF/UA-1) International Organization for Standardization Retrieved from https://www.iso.org/standard/64599.html ) で概説されているアクセシブルなPDFを扱う際には、装飾的なパターンがコンテンツ構造を妨げないこと、および意味のある視覚情報がパターン塗りつぶしだけで伝達されないことを開発者は確認する必要があります。

全投稿を閲覧 gdoc_arrow_right_alt

PDPostScriptXObject

概要

PDPostScriptXObjectは、Apache PDFBox PDModel APIのクラスで、PDF文書構造内のPostScript XObjectを表現します。PostScript XObjectは ( Citation: N.A., (N.A.). (). Document management — Portable document format — Part 2: PDF 2.0 International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html ) で定義されている外部オブジェクトで、PostScript言語のフラグメントを含み、レガシーPostScriptコンテンツをPDFファイル内に埋め込むことができます。このクラスは、Java開発者がこのようなレガシーコンテンツを含むPDF文書を扱う際に、PostScript XObjectの読み取り、操作、作成にプログラム的にアクセスする手段を提供します。

定義

PDPostScriptXObjectは、Apache PDFBoxのPDModelパッケージに含まれる高レベルJavaクラスで、PDF仕様で定義されているPostScript XObjectをカプセル化します。PostScript XObjectは、外部オブジェクト(XObject)の特定の型であり、PostScript言語命令のストリームを含み、PDFコンテンツストリームから呼び出すことができます。より一般的なForm XObject(PDFormXObject)やImage XObject(PDImageXObject)とは異なり、PostScript XObjectは、PDFグラフィックスオペレーターやラスター画像データではなく、PostScriptコードを明確にカプセル化します。

このクラスは、低レベルのCOSDictionaryオブジェクトを高レベルの開発者フレンドリーなインターフェースでラップするという、PDFBoxの標準的なパターンを実装しています。PostScript XObjectは、XObject辞書内のSubtypeエントリが「/PS」であることで識別され、主にPostScriptワークフローとの後方互換性や、レガシーPostScriptコンテンツを埋め込む場合に使用されます。

全投稿を閲覧 gdoc_arrow_right_alt

PDPrintFieldAttributeObject

概要

PDPrintFieldAttributeObjectは、Apache PDFBoxライブラリの高レベルPDModel API内の特殊なクラスで、PDF文書内の印刷フィールド属性を表現します。このクラスは、印刷操作時にフォームフィールドがどのように動作するかをプログラム的に制御するアクセスを提供し、開発者はPDFが印刷される際にインタラクティブフォーム要素を表示するか非表示にするかを指定できます。印刷フィールド属性は、 ( Citation: N.A., (N.A.). (). Document management — Portable document format — Part 2: PDF 2.0 International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html ) で定義されているより広範な注釈およびフォームフィールド構造の一部です。

定義

PDPrintFieldAttributeObjectは、Apache PDFBox内のJavaクラスで、PDFフォームフィールドと注釈の印刷フィールド属性プロパティをカプセル化します。画面表示を制御する一般的な注釈外観クラスとは異なり、このクラスは特にフォームフィールドの印刷動作を管理します。PDFBox全体で使用されるPDModelパターンを実装し、印刷属性を定義する基礎となるPDF辞書構造にアクセスおよび変更するための高レベルなオブジェクト指向インターフェースを提供します。このクラスは、特定のフィールドが画面表示と比較して印刷出力で異なって表示される(または全く表示されない)必要がある、インタラクティブPDFフォームを扱う際に特に関連性があります。

重要性

PDFフォーム処理アプリケーションを構築する開発者にとって、PDPrintFieldAttributeObjectはインタラクティブ要素の印刷動作を制御するための必須機能を提供します。これは、機密情報が印刷されたコピーに表示されないようにするフォームの作成、ヘルパーテキストや指示が画面上でのみ表示されるように設計された文書、デジタル版とは異なるフィールド表現が必要なアクセシビリティ準拠の確保など、いくつかの実用的なシナリオで重要です。印刷フィールド属性を理解し適切に設定することで、開発者は異なる出力コンテキストで適切に動作する、よりプロフェッショナルで機能的なPDF文書を作成できます。これは、 ( Citation: N.A., (N.A.). (). Document management applications — Electronic document file format enhancement for accessibility — Part 1: Use of ISO 32000-1 (PDF/UA-1) International Organization for Standardization Retrieved from https://www.iso.org/standard/64599.html ) などの標準に準拠する必要があるフォームを扱う際に特に重要です。

全投稿を閲覧 gdoc_arrow_right_alt