PDSoftMask

PDSoftMaskは、Apache PDFBox PDModel APIの高レベルJavaクラスで、PDF文書内のソフトマスク辞書を表現します。ソフトマスクは、グラフィックコンテンツのアルファチャンネルをどのように計算すべきかを定義することで、洗練された透明度とマスキング効果を実現します ( 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 ) 。このクラスは、開発者がソフトマスクのプロパティをプログラム的に読み取り、操作するためのアクセス手段を提供します。これは、さまざまなレベルの不透明度と透明度ブレンディングを持つ複雑なグラフィックスをレンダリングする際に不可欠です。

PDSoftMaskは、 ( 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ソフトマスク辞書構造をカプセル化するJavaラッパークラスです。ハードマスク（ピクセルが完全に不透明か完全に透明かのバイナリ透明度を使用）とは異なり、ソフトマスクは0.0（完全に透明）から1.0（完全に不透明）までの段階的な透明度レベルを持つアルファチャンネルをサポートします。このクラスは、サブタイプ（AlphaまたはLuminosity）、背景色、転送関数、マスク形状を定義するForm XObjectなど、ソフトマスクの属性にアクセスし、変更するためのメソッドを提供します。PDSoftMaskは、PDTransparencyGroupやPDExtendedGraphicsStateなどの関連クラスとは異なり、それらを参照する透明度グループやグラフィックス状態ではなく、マスク定義そのものを扱う点で区別されます。

PDF操作を行う開発者にとって、複雑なグラフィックス、透かし、または透明効果を持つレイヤー化されたコンテンツを含む文書を扱う際に、PDSoftMaskを理解することは非常に重要です。現代のPDF文書は、ドロップシャドウ、グラデーションフェード、画像合成などの視覚効果にソフトマスクを頻繁に使用しています。コンテンツを抽出する際、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ファイルを変換または表示する際に、レンダリングアーティファクト、コンテンツの欠落、または不正確な視覚出力が発生する可能性があります。

PDSoftMaskは、 ( 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辞書をラップすることで動作します。このクラスは、主要なプロパティのゲッターおよびセッターメソッドを提供します。サブタイプは、マスクがアルファ値に基づくか輝度計算に基づくかを決定し、Groupエントリは、レンダリング結果がマスクになる透明度グループXObjectを指定します。背景色（BC）や転送関数（TR）などのオプションパラメータは、マスクの計算と適用方法を制御します。グラフィックス状態がSMaskエントリを通じてソフトマスクを参照すると、PDFレンダラーはPDSoftMask定義を使用して、合成プロセス中に各ピクセルの実効不透明度を計算します。開発者は、新しいマスクコンテンツを作成する際にPDSoftMaskオブジェクトをインスタンス化したり、文書構造を分析する際にPDExtendedGraphicsStateオブジェクトから既存のインスタンスを取得したりできます。このクラスは低レベルのCOSDictionary操作を処理し、これらの透明度機能を扱うための型安全なJavaインターフェースを提供します。

• PDExtendedGraphicsState – 透明効果のためにソフトマスクを参照できるグラフィックス状態パラメータ辞書
• PDTransparencyGroup – 独立およびノックアウト透明度の動作を定義するグループXObject
• PDFormXObject – ソフトマスクのグラフィカルソースとして使用できる再利用可能なコンテンツストリーム
• COSDictionary – PDSoftMaskがラップするPDF辞書オブジェクトを表す低レベルPDFBoxクラス
• Alpha Channel – ソフトマスクがマスキング効果を作成するために操作する色の透明度成分