thumbnailMaxWidth

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アプリケーションや、限られた帯域幅や処理能力を持つユーザーにサービスを提供するアプリケーションにおいて特に重要です。

BuildVuがPDFドキュメントを処理する際、各ページの寸法を調べ、thumbnailMaxWidth設定に基づいて適切なサムネイルサイズを計算します。変換プロセスは次の手順に従います。まず、BuildVuはドキュメント構造から各PDFページの本来の寸法を決定します。次に、ページ幅がthumbnailMaxWidth値を超える場合、BuildVuはthumbnailMaxWidthを実際のページ幅で割ることで縮小係数を計算します。第三に、元のアスペクト比を維持するために、幅と高さの両方にこの縮小係数を乗算します。最後に、BuildVuは計算されたサムネイル寸法でページをレンダリングし、指定された画像形式（通常はJPEGまたはPNG）で保存します。元のページ幅がthumbnailMaxWidthより小さい場合、他の拡大縮小パラメータが設定されていない限り、サムネイルはページの本来のサイズで生成される可能性があります。開発者は通常、UIの要件に基づいてこの値を設定し、アプリケーションの設計とターゲットデバイスに応じて150から400ピクセルの範囲の値が一般的です。

• BuildVu – IDR SolutionsのPDFからHTML5への変換ライブラリで、PDFドキュメントをWeb表示可能な形式に変換します
• Page dimensions（ページ寸法） – ドキュメント構造で定義されるPDFページの幅と高さの測定値
• Aspect ratio（アスペクト比） – 画像を拡大縮小する際に維持する必要がある幅と高さの比例関係
• Thumbnail image（サムネイル画像） – ナビゲーションとプレビュー目的で使用される、フルページの縮小版
• Scaling factor（縮小係数） – アスペクト比を維持しながら画像を比例的にリサイズするために使用される数学的比率