SVGConversionOptions

SVGConversionOptionsは、BuildVu APIにおける設定クラスで、PDFドキュメントをScalable Vector Graphics形式に変換する際のSVG固有の出力設定を制御します。このクラスは、 ( 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コンテンツをSVG要素に変換する方法について、きめ細かな制御を提供します。これらのオプションを設定することで、開発者はWeb表示、アクセシビリティ要件、ファイルサイズの制約など、特定のユースケースに最適化されたSVGファイルを生成できます。

SVGConversionOptionsは、BuildVuライブラリ内のJavaクラスで、SVG出力生成に特化した設定パラメータをカプセル化します。すべての出力形式に適用される一般的な変換設定とは異なり、SVGConversionOptionsは、テキストのレンダリングモード（テキストをパスに変換するか、テキスト要素として保持するか）、画像処理戦略、座標系変換、SVG構造の最適化など、SVG関連の動作のみに焦点を当てています。このクラスは通常、BuildVuのメイン変換エンジンと連携して動作し、開発者がSVGConversionOptionsのインスタンスを渡すことで、PDFコンテンツストリームの解釈とSVGマークアップとしてのレンダリング方法をカスタマイズできます。このクラスで設定されるオプションは、生成されるSVG出力の忠実度、アクセシビリティ、パフォーマンス特性に直接影響します。

PDFからSVGへの変換を行う開発者にとって、SVGConversionOptionsは出力品質と互換性に関する重要な制御を提供します。テキストレンダリングの設定機能は、アクセシビリティ要件と視覚的忠実度のバランスを取る上で特に重要です。テキストをパスに変換すると正確な外観は保持されますが、検索可能性やスクリーンリーダーの互換性が失われます。これは ( 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 ) などのアクセシビリティ標準を満たす必要があるドキュメントにとって重要です。ファイルサイズ最適化オプションは、ブラウザで高速に読み込めるWeb対応のSVGファイルを作成するのに役立ち、画像処理設定では埋め込みリソースとリンクリソースの制御が可能です。SVGConversionOptionsを通じた適切な設定がなければ、開発者は出力ファイルのサイズ過大、異なるブラウザでのテキストレンダリングの問題、アクセシビリティと保守性の両方に影響する重要なドキュメント構造の損失などの問題に直面する可能性があります。

SVGConversionOptionsは、BuildVuの変換エンジンがPDF処理パイプライン中に読み取るセッターメソッドまたは設定プロパティを提供することで動作します。BuildVuが ( 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ドキュメント構造を解析する際、SVGConversionOptionsインスタンスを参照して、各コンテンツタイプの処理方法を決定します。テキストオブジェクトの場合、オプションはフォント情報を保持してSVGテキスト要素としてレンダリングするか、正確な視覚的再現のためにグリフをパスデータに変換するかを指定します。画像処理設定は、圧縮レベル、フォーマット変換、画像データをSVGに直接埋め込むか外部ファイルを参照するかを制御します。このクラスには、透明グループ、ブレンドモード、クリッピングパスなどの複雑なPDF機能を処理するオプションも含まれ、これらがSVGの同等機能にどのように変換されるかを決定します。高度なオプションでは、関連要素をグループ化するか、で説明されているTagged PDF構造と同様にアクセシビリティのための記述的メタデータを追加するか、特定のビューポート寸法に合わせて座標系を最適化するかなど、SVG構造を制御できます。開発者は通常、SVGConversionOptionsをインスタンス化し、必要なプロパティを設定してから、PDF処理を開始する前にBuildVuの変換メソッドにオブジェクトを渡します。

• BuildVu – SVGConversionOptionsを使用するPDFからHTML5/SVGへの変換ライブラリ
• ConversionOptions – フォーマット非依存の変換設定の基底クラスまたはインターフェース
• SVG (Scalable Vector Graphics) – 出力形式として使用されるXMLベースのベクター画像形式
• PDF Content Stream – BuildVuが変換時に解釈する低レベルのPDF命令
• Text Rendering Mode – PDFテキストをSVGに変換する方法を制御する設定オプション