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を通じた適切な設定がなければ、開発者は出力ファイルのサイズ過大、異なるブラウザでのテキストレンダリングの問題、アクセシビリティと保守性の両方に影響する重要なドキュメント構造の損失などの問題に直面する可能性があります。
Text modeは、PDFファイルからのテキストコンテンツをHTML出力でどのようにレンダリングするかを決定するBuildVuの設定オプションです。有効にすると、text modeはテキストを選択可能なHTMLテキスト要素として保持し、アクセシビリティと検索性を維持します。無効にすると、テキストは画像に変換されます。これは、
(
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
)
などの標準で求められるアクセシビリティ機能を犠牲にして、正確な視覚的外観を保持する必要がある場合に望ましい方法です。
BuildVuにおけるtext modeは、PDF-to-HTML変換時のテキストコンテンツの変換戦略を制御するブール値設定です。text modeが有効(デフォルトおよび推奨設定)の場合、BuildVuはPDF文書構造からテキストを抽出し、CSSを使用して配置とスタイリングを行いながら、ネイティブHTMLテキスト要素としてレンダリングします。このアプローチは、基盤となるテキストデータを保持し、選択、検索、およびスクリーンリーダーによるアクセスを可能にします。
text modeが無効の場合、BuildVuはテキストコンテンツを画像ファイルにラスタライズし、文字データではなくグラフィカル要素として扱います。この画像ベースのアプローチは、WebフォントとCSSで再現することが難しい複雑なタイポグラフィ、特殊フォント、または独特なテキストレンダリング効果をピクセル単位で完全に再現できます。ただし、テキストの意味的な意味と対話的プロパティは失われます。
thumbnailMaxHeight設定は、PDF変換時に生成されるサムネイル画像の最大高さをピクセル単位で制御するBuildVuの設定パラメータです。この設定は、Webベースの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
)
では直接規定されていませんが、サムネイル生成はWeb表示用のPDF変換における一般的な要件であり、ユーザーが文書ページを素早くナビゲートできるようにします。
thumbnailMaxHeightは、PDF-to-HTML変換プロセス中に作成されるサムネイル画像の垂直方向の寸法に上限を設定するBuildVu APIの設定です。BuildVuがPDF文書を処理する際、結果として生成されるWebアプリケーションのナビゲーションを強化するために、各ページのプレビューサムネイルを生成できます。このパラメータは、元のPDFページサイズやアスペクト比に関係なく、生成されるサムネイルが指定された高さ(ピクセル単位)を超えないようにします。幅は通常、元のページのアスペクト比を維持するために比例してスケーリングされます。これは、画像をトリミングまたは歪める可能性がある固定サイズのサムネイル設定とは異なり、thumbnailMaxHeightは最大境界を適用しながら比率を保持します。
WebベースのPDFビューアを構築する開発者にとって、サムネイルの寸法を制御することは、いくつかの実用的な理由から重要です。第一に、メモリ消費量と帯域幅使用量に直接影響します。過度に大きなサムネイルは、特に数百ページの文書の場合、ページ読み込み時間を大幅に遅らせ、データ転送コストを増加させる可能性があります。第二に、一貫したサムネイルサイズにより、予測可能でプロフェッショナルなユーザーインターフェースが確保され、さまざまなデバイスや画面サイズで機能するレスポンシブレイアウトの設計が容易になります。第三に、画質とパフォーマンスのバランスを提供します。適切な最大高さを設定することで、不必要にリソースを消費することなく、ナビゲーション目的に十分な明瞭さをサムネイルに保つことができます。これは、モバイルユーザーや帯域幅が制限されているユーザーにとって特に重要です。
thumbnailMaxWidth設定は、PDF変換時に生成されるサムネイル画像の最大ピクセル幅を制御するBuildVu APIパラメータです。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ドキュメントを処理する際、各ページのサムネイルプレビューを作成することで、Webアプリケーションにおける高速なナビゲーションとプレビュー機能を実現できます。この設定により、開発者は画像品質とファイルサイズ、読み込みパフォーマンスのバランスを調整できます。
thumbnailMaxWidthは、BuildVuのPDFからHTML5への変換ライブラリにおける設定オプションで、生成されるサムネイル画像の幅の上限を設定します。BuildVuがPDFページをWeb表示可能な形式に変換する際、各ページの小さなプレビュー画像を自動的に生成できます。thumbnailMaxWidthパラメータは、サムネイルを拡大縮小する際の最大幅をピクセル単位で表す整数値を受け取り、PDFページの元のアスペクト比を維持します。PDFページの本来の幅がこの値を超えるサムネイルを生成する場合、BuildVuは自動的にサムネイルを比例的に縮小します。これは絶対サイズパラメータとは異なり、固定寸法ではなく制約として機能するため、元のPDFのページ寸法に関係なく、サムネイルが指定された幅を超えないことを保証します。
WebベースのPDFビューアやドキュメント管理システムを構築する開発者にとって、サムネイルサイズの制御はユーザーエクスペリエンスとアプリケーションパフォーマンスの最適化に不可欠です。過度に大きなサムネイルは不要な帯域幅を消費し、ページの読み込み時間を増加させ、モバイルデバイスや多数のページを同時に表示する際にメモリの問題を引き起こす可能性があります。適切なthumbnailMaxWidthを設定することで、開発者は様々なページ寸法を持つドキュメント間で一貫したサムネイルサイズを確保し、予測可能なUIレイアウトを作成し、プレビュー画像の鮮明さとパフォーマンスのトレードオフを管理できます。これは、サムネイルギャラリーが異なる画面サイズに適応する必要があるレスポンシブWebアプリケーションや、限られた帯域幅や処理能力を持つユーザーにサービスを提供するアプリケーションにおいて特に重要です。
TiffMetadataは、JDeli画像ライブラリにおける特殊なメタデータクラスで、TIFF(Tagged Image File Format)画像からのメタデータの解析と抽出を処理します。このクラスは、TIFF ファイル内の画像プロパティ、技術仕様、および埋め込み情報へのプログラマティックなアクセスを開発者に提供します。TIFF ファイルは、文書イメージングや
(
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
)
ワークフローで一般的に使用されています。TiffMetadataにより、アプリケーションは適切なレンダリング、変換、およびアーカイブ目的に不可欠な画像特性を読み取り、解釈することができます。
TiffMetadataは、JDeli API内のJavaクラスで、TIFFイメージファイルに特化した解析済みメタデータのコレクションを表します。汎用的な画像メタデータハンドラとは異なり、TiffMetadataは圧縮タイプ、測光解釈、画像寸法、解像度データ、およびTIFF仕様構造に従ったタグベースのメタデータなど、TIFF固有の情報を抽出するように調整されています。このクラスは、メタデータフィールドへの型安全なアクセスを提供し、開発者がTIFFファイル構造を手動で解析することなく画像プロパティを照会できるようにします。これは、フォーマットのタグ-値の組織構造を理解し、複数ページのTIFF文書を適切に処理するTIFF対応の解析を提供することで、汎用メタデータクラスとは異なります。
文書処理、PDF生成、または画像変換ワークフローに携わる開発者にとって、TiffMetadataはアプリケーション内でTIFF画像を正しく処理するために必要な重要な情報を提供します。色空間、ビット深度、圧縮などの画像特性を理解することは、PDF文書に画像を埋め込む場合や、忠実度を維持しながらフォーマット間で変換する場合に不可欠です。このメタデータアクセスは、TIFFファイルがスキャンされた文書コンテナとして機能するエンタープライズ文書管理システムにおいて特に重要であり、適切なメタデータ処理によってアーカイブ標準およびアクセシビリティ要件への準拠が保証されます。このクラスは、TIFFメタデータ抽出という複雑なタスクを簡素化し、開発時間と潜在的な解析エラーを削減します。
WebpMetadataは、JDeli画像ライブラリにおける専門的なメタデータクラスで、WebP画像ファイルから抽出された解析済みメタデータ情報を表します。このクラスは、WebP形式の画像内に保存される画像プロパティ、技術的パラメータ、および埋め込みメタデータへのプログラマティックなアクセスを提供します。WebPは
(
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
)
で特に定義されているわけではない現代的なWeb最適化形式ですが、画像の処理、変換、またはPDF文書への埋め込みが必要なデジタル文書ワークフローで広く使用されています。
WebpMetadataは、JDeliライブラリ内のJavaクラスで、WebP画像形式に特有のメタデータ情報をカプセル化します。汎用的な画像メタデータクラスとは異なり、WebpMetadataはWebPファイル固有の特性とメタデータ構造を処理するように設計されており、非可逆圧縮および可逆圧縮パラメータ、アニメーションデータ、カラープロファイル情報、存在する場合のEXIFデータなどを扱います。このクラスは、JDeliのメタデータフレームワークを拡張または実装し、キャンバス寸法、アルファチャネル情報、フォーマットフラグなどのWebP固有プロパティへの型安全なアクセスを提供します。WebpMetadataは、VP8、VP8L、VP8Xビットストリームを含む異なるタイプの複数のチャンクを含むWebPのコンテナ構造を処理する必要がある点で、他の形式固有メタデータクラス(JPEGMetadataやPNGMetadataなど)とは異なります。
文書処理と画像操作を行う開発者にとって、WebpMetadataはPDFワークフローにおける画像処理について適切な判断を行うために不可欠です。画像メタデータを理解することで、開発者は画像変換プロセスを最適化し、形式変換時に重要な画像プロパティを保持し、画像をPDF文書に埋め込む際の互換性を確保できます。WebP画像はWebアプリケーションでますます一般的になっているため、正確なメタデータへのアクセスにより、画像をPDFや他の文書形式に組み込む前に適切なスケーリング、カラー管理、品質評価が可能になります。このクラスは、エンタープライズ文書ワークフローで現代的なWeb最適化画像を処理する際に、画像の忠実性を維持し、ファイルサイズを最適化するのに役立ちます。