ClipEvenOddRule
ClipEvenOddRuleは、Apache PDFBoxライブラリにおいて、PDFドキュメント内のクリッピングパスに偶奇規則（even-odd rule）を実装するクラスです。
ClipEvenOddRuleは、Apache PDFBoxライブラリにおいて、PDFドキュメント内のクリッピングパスに偶奇規則（even-odd rule）を実装するクラスです。この規則は、 ( 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 ) で定義されているように、パスのワインディング数に基づいて、ページのどの領域を可視化またはマスクするかを決定します。偶奇規則は、複雑なパスや図形の内部を判定する際に、非ゼロワインディング数規則に代わる方法を提供します。
ClipEvenOddRuleは、Apache PDFBox内のJavaクラスで、PDFコンテンツをレンダリングする際にどの領域をクリッピング（非表示化）すべきかを決定する2つの方法のうちの1つを表します。偶奇規則は、任意の点から無限遠まで光線を引き、それが何本のパスセグメントと交差するかを数えることで機能します。交差回数が奇数の場合、その点はクリッピング領域の内側にあり、偶数の場合は外側にあります。これは、パスセグメントの方向を考慮して内部領域を判定する非ゼロワインディング数規則とは異なります。 ( 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用語では、偶奇規則はコンテンツストリーム内でW*演算子によって表され、非ゼロワインディング規則はW演算子を使用します。
PDF生成や操作を行う開発者にとって、クリッピング規則の理解は、複雑なグラフィックスの作成、透明度の管理、コンテンツの可視性制御に不可欠です。偶奇規則は、自己交差するパスや穴のある図形を扱う際に特に有用で、予測可能で直感的な結果をもたらします。 ( Citation: N.A., 2014 (N.A.). (2014). 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を処理する際、クリッピングパスを適切に処理することで、ドキュメントの論理構造を維持しながら視覚的なコンテンツが正しくレンダリングされることが保証されます。適切なクリッピング規則の選択は、重なり合う図形の相互作用に影響を与え、PDFグラフィックスの最終的な見た目に大きく影響します。
Apache PDFBoxが偶奇規則を使用したクリッピングパス操作に遭遇すると、定義されたパス境界に対して各ピクセルまたは点を評価します。アルゴリズムは、テスト対象の点から無限遠まで概念的に水平線を延ばし、この線がパスと交差する回数を数えます。交差回数が奇数の場合、その点はクリッピング領域内にあり可視化されます。偶数（ゼロを含む）の場合は、その点は外側にありクリッピングされます。この実装は、W*演算子に対して ( 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 ) で提供されている厳密な数学的定義に従っています。PDFBoxのClipEvenOddRuleクラスは、PDFレンダリングやコンテンツストリーム処理中にこの規則を適用するために必要な内部計算と座標変換を処理します。開発者は通常、PDFBoxのグラフィックス状態管理を使用する際や、カスタムPDFレンダリングロジックを実装する際にこのクラスを操作します。
- Clipping Path（クリッピングパス） – PDF内の可視コンテンツの境界を定義するベクトルパス
- Graphics State（グラフィックス状態） – PDFでグラフィカル要素のレンダリング方法を制御するパラメータの集合
- Content Stream（コンテンツストリーム） – PDFページの視覚的なコンテンツを記述する演算子とオペランドの並び
- Nonzero Winding Number Rule（非ゼロワインディング数規則） – 内部領域を判定する際にパスの方向を考慮する代替クリッピング規則
- Path Object（パスオブジェクト） – 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
- (N.A.) (2014)
- (N.A.). (2014). 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