PDLineDashPattern
PDLineDashPatternは、Apache PDFBox PDModel APIのクラスで、PDFグラフィックスのストローク操作で使用される破線パターンを表します。
PDLineDashPatternは、Apache PDFBox PDModel APIのクラスで、PDFグラフィックスのストローク操作で使用される破線パターンを表します。このクラスは、PDFコンテンツストリーム内で定義された線の破線パターンを読み取りおよび変更するための高レベルなJavaインターフェースを提供し、破線や点線がレンダリング時にどのように表示されるかを制御します。破線パターンは、 ( Citation: N.A., 2020 (N.A.). (2020). Document management — Portable document format — Part 2: PDF 2.0 . International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html ) で規定されているグラフィックス状態パラメータの一部であり、PDF文書内のストロークされたパスの視覚的な外観を決定します。
PDLineDashPatternは、Apache PDFBoxのorg.apache.pdfbox.pdmodel.graphics.stateパッケージ内の具象Javaクラスで、PDFグラフィックス状態の破線パターンプロパティをカプセル化します。実線とは異なり、破線は特定のパターンに従って、描画される（不透明な）セグメントと描画されない（透明な）セグメントを交互に繰り返します。このクラスは2つの主要なコンポーネントをラップします。破線と間隔の長さを交互に指定する破線配列（dash array）と、パターン内の開始オフセットを決定する破線位相（dash phase）です。基礎となるPDF仕様では破線パターンを単純な数値配列として定義していますが、PDLineDashPatternは、Java開発者が生のPDF構文を直接操作することなく、プログラムでこれらのパターンを扱いやすくするオブジェクト指向のアクセスメソッドを提供します。
PDF生成や操作を行う開発者にとって、PDLineDashPatternは、境界線、下線、フォームフィールド、またはベクターグラフィックスのカスタム線スタイルを作成する際に不可欠です。このクラスを理解することで、視覚的表現を正確に制御できるようになります。これは、エンジニアリング図面、署名欄付きの法律文書、またはアクセシブルなフォームなど、特定のスタイル標準を必要とする文書において特に重要です。破線パターンをプログラムで設定および取得する機能により、開発者は生成された文書全体で視覚的な一貫性を維持したり、PDFを変更する際に既存の線スタイルを複製したり、単純な実線以外の独特な線処理を求めるデザイン仕様を実装したりできます。
PDLineDashPatternは、
(
Citation: N.A., 2020
(N.A.).
(2020).
Document management — Portable document format — Part 2: PDF 2.0
.
International Organization for Standardization
Retrieved from
https://www.iso.org/standard/75839.html
)
で定義された破線パターンの2つのパラメータを格納し、アクセスを提供することで動作します。破線配列は、パターンを指定する数値のシーケンスです。最初の数値は最初の破線の長さを示し、2番目の数値は続く間隔の長さを示し、3番目の数値は次の破線を示す、というように続きます。配列の要素数が奇数の場合、パターンは配列を自身と連結することで繰り返されます。破線位相は、パターン内で開始する位置までの距離を指定し、パターンをサイクル内の任意の点から開始できるようにします。例えば、[3, 2]の破線配列で位相が0の場合、3単位の破線と2単位の間隔を繰り返すパターンが作成されます。同じ配列で位相が1の場合、最初の破線の1単位目から開始されます。開発者は、既存のパターンを読み取るためにgetDashArray()やgetPhase()などのメソッドを使用し、クラスのコンストラクタまたはセッターメソッドを使用して新しいパターンを作成できます。このクラスは、ページまたはコンテンツストリームにグラフィックス状態パラメータを設定するためのPDExtendedGraphicsStateと統合されています。
- PDExtendedGraphicsState – 線の破線パターンやその他のレンダリングパラメータを含む拡張グラフィックス状態辞書を表すクラス
- PDGraphicsState – ストロークプロパティ、変換、カラースペースを含む完全なグラフィックス状態スタックを管理するクラス
- PDPageContentStream – 破線パターンが後続のストローク操作に適用されるコンテンツストリームを書き込むために使用されるクラス
- COSDictionary – グラフィックス状態パラメータを格納するPDF辞書オブジェクトを表す低レベルクラス
- Stroking operations – 現在のグラフィックス状態プロパティを使用して線や曲線を描画するPDFパス描画操作
- (N.A.) (2020)
- (N.A.). (2020). Document management — Portable document format — Part 2: PDF 2.0 . International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html