thumbnailMaxHeight

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ビューアを構築する開発者にとって、サムネイルの寸法を制御することは、いくつかの実用的な理由から重要です。第一に、メモリ消費量と帯域幅使用量に直接影響します。過度に大きなサムネイルは、特に数百ページの文書の場合、ページ読み込み時間を大幅に遅らせ、データ転送コストを増加させる可能性があります。第二に、一貫したサムネイルサイズにより、予測可能でプロフェッショナルなユーザーインターフェースが確保され、さまざまなデバイスや画面サイズで機能するレスポンシブレイアウトの設計が容易になります。第三に、画質とパフォーマンスのバランスを提供します。適切な最大高さを設定することで、不必要にリソースを消費することなく、ナビゲーション目的に十分な明瞭さをサムネイルに保つことができます。これは、モバイルユーザーや帯域幅が制限されているユーザーにとって特に重要です。

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文書を変換する際、各ページを処理し、対応するサムネイル画像を生成します。thumbnailMaxHeightパラメータは、この画像生成フェーズで適用されます。変換エンジンは、元のページのアスペクト比に基づいて適切な幅を計算し、高さが指定された最大値を超えないようにします。たとえば、thumbnailMaxHeightが200ピクセルに設定され、PDFページのアスペクト比が2:3の場合、結果として生成されるサムネイルは幅約133ピクセル、高さ200ピクセルになります。元のページが最大高さより小さい場合、BuildVuは通常、拡大せずに元の寸法を維持します。この設定は、画質設定や出力形式オプションなどの他のBuildVu設定パラメータと連携して、最終的なWebアプリケーション用に最適化されたサムネイルアセットを生成します。

• Thumbnail（サムネイル） – ナビゲーションとクイックリファレンスに使用されるPDFページの縮小プレビュー画像
• BuildVu – IDR SolutionsのPDF to HTML5コンバータで、PDF文書をWebベースのアプリケーションに変換します
• Page Navigation（ページナビゲーション） – ドキュメントビューアでユーザーがページ間を移動できるようにするインターフェース要素と機能
• Aspect Ratio（アスペクト比） – 画像またはページの幅と高さの比例関係
• Image Optimization（画像最適化） – 許容可能な品質を維持しながら、ファイルサイズを削減し、読み込み時間を改善する技術