ConversionOptions

ConversionOptionsは、BuildVu APIにおける設定オブジェクトで、開発者がPDF文書をHTML5、SVG、または画像形式に変換する方法を制御できるようにします。このオブジェクトは、変換プロセス中のページ範囲、フォント処理、画像スケーリング、テキストレンダリングモード、およびさまざまな出力動作を決定する設定へのプログラマティックなアクセスを提供します。ConversionOptionsを適切に設定することで、開発者は ( 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文書を扱う際に、Web表示、アクセシビリティ、またはファイルサイズの制約に関する特定の要件を満たすように変換出力を最適化できます。

ConversionOptionsは、BuildVu API内のJavaクラスで、PDF変換操作のための集約されたパラメータオブジェクトとして機能します。コマンドラインフラグや設定ファイルとは異なり、ConversionOptionsは実行時に変換パラメータを指定するための型安全でオブジェクト指向のインターフェースを提供します。このオブジェクトは、ページ選択(開始ページと終了ページ)、フォント変換戦略(埋め込みフォントとシステムフォント)、画像スケーリング係数、テキストレンダリングモード(実テキストとベクターテキスト)、出力形式の選択、最適化フラグなど、数十の設定をカプセル化します。各オプションはセッターメソッドを通じて独立して設定でき、開発者はグローバル設定を変更したり複雑な設定階層を作成したりすることなく、変換プロセスを細かく調整できます。これは ( 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プロパティとは異なり、ConversionOptionsはPDFコンテンツ自体を記述するのではなく、変換動作を制御します。

PDF-to-Web変換をアプリケーションに統合する開発者にとって、ConversionOptionsは特定の技術的およびビジネス要件を満たす出力を生成するために不可欠です。ページ範囲を制御する機能により、大きな文書の選択的な変換が可能になり、処理時間とストレージコストを削減できます。フォント処理オプションは、テキストの検索性、外観の一貫性、およびファイルサイズに直接影響します。これらはユーザーエクスペリエンスとSEOにとって重要な要素です。スケーリングオプションにより、開発者は視覚的な品質と帯域幅の制約のバランスを取ることができ、特にモバイルアプリケーションや高トラフィックのWebサービスで重要です。 ( 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を扱う際、適切なConversionOptions設定により、HTML5出力でセマンティック構造とアクセシビリティ機能が保持されます。ConversionOptionsによる適切な設定がない場合、開発者はフォントの欠落、過大な出力ファイル、インタラクティブ機能の喪失、または高コストな後処理修正を必要とする低品質なレンダリングなどの問題に遭遇する可能性があります。

ConversionOptionsは、ビルダーパターンオブジェクトとして機能し、インスタンス化され、設定され、変換プロセスを開始する前にBuildVuコンバータに渡されます。開発者は新しいConversionOptionsインスタンスを作成し、さまざまなセッターメソッドを呼び出して特定の動作を設定します。例えば、setPageRange(1, 10)で最初の10ページのみを変換したり、setTextMode(TextMode.REALTEXT)で出力で選択可能なテキストを保持したりします。オプションオブジェクトは、便利な設定のためにメソッドチェーンをサポートしています。フォント処理オプションは、フォントをWebフォント(WOFF/WOFF2)として埋め込むか、SVGパスに変換するか、システムフォントとして参照するかを決定し、忠実度とファイルサイズの両方に影響します。画像スケーリングオプションは、乗数値(例:元のサイズの場合は1.0、半分の解像度の場合は0.5)を使用して出力解像度を制御します。コンバータが ( 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構造を処理する際、各決定ポイントでConversionOptionsオブジェクトを参照します。どのページを処理するか、各フォント参照をどのように処理するか、ラスタライズされたコンテンツにどの解像度を使用するか、どの最適化技術を適用するかを決定します。高度なオプションは、フォームフィールド変換、注釈処理、レイヤー(OCG)処理、およびで説明されているTagged PDF構造のサポートなどの機能を制御します。設定されたオプションは変換中は不変のままであり、複数ページの文書全体で一貫した動作を保証します。

• BuildVu API – PDF文書をHTML5、SVG、および画像形式に変換するためのJavaライブラリ
• Font Embedding(フォント埋め込み) – 一貫したテキストレンダリングを保証するために、PDFまたはWeb文書内にフォントデータを含めるプロセス
• Page Range(ページ範囲) – 変換中に処理するソース文書のどのページを指定する設定
• Text Mode(テキストモード) – テキストを選択可能な文字として保持するか、ベクターグラフィックスに変換するかを決定する設定オプション
• Conversion Pipeline(変換パイプライン) – PDFコンテンツをWeb互換形式に変換する処理ステップのシーケンス