Image dictionary key /Height

/Heightキーは、image XObjectディクショナリ内の必須エントリであり、ソース画像の高さをサンプル（ピクセル）単位で指定します。 ( 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 ) で定義されているように、この値は/Widthと連携して、変換が適用される前の画像データの固有寸法を確立します。/Heightの値は、画像のサンプルグリッドの垂直解像度を表し、PDF文書内での適切な画像デコードとレンダリングに不可欠です。

/Heightキーは、image XObjectディクショナリ内の整数エントリであり、画像データ内の垂直サンプル（行）の数を定義します。この値は正の整数である必要があり、ページ上での最終的な表示方法とは独立した、画像自身の座標空間における固有の高さを表します。ページ上に画像を配置する変換マトリックスで指定される寸法とは異なり、/Heightは画像データそのものの本質的な構造、つまりPDFレンダラーがデコードする必要があるピクセルデータの行数を記述します。この区別は重要です。/Heightはソース画像の解像度を定義し、一方で現在の変換マトリックス（CTM）が最終的なレンダリングサイズを決定します。

/Heightを理解することは、画像処理、PDF生成、またはドキュメント操作を行う開発者にとって重要です。なぜなら、メモリ割り当て、デコード操作、レンダリング品質に直接影響するためです。プログラムでPDFを生成する際、誤った/Height値を指定すると、画像の破損や歪み、デコーダーエラー、または完全なレンダリング失敗につながる可能性があります。/Heightの値はパフォーマンスにも影響します。値が大きいほど処理する画像データが多くなり、ファイルサイズとレンダリング速度の両方に影響を与えます。PDFリーダーやバリデーターを実装する開発者にとって、/Heightが実際の画像データ構造と一致することを検証することは、ドキュメントの整合性を確保し、バッファオーバーフローや不正な形式の画像ストリームに関連するセキュリティ脆弱性を防ぐために不可欠です。

/Heightエントリは、image XObjectのディクショナリ構造の一部として機能し、PDFプロセッサに生の画像ストリームデータの解釈方法を伝えます。PDFレンダラーがimage XObjectに遭遇すると、/Widthと/Heightの両方を読み取ってサンプルグリッドの寸法を理解し、次に/BitsPerComponentや/ColorSpaceなどの他のディクショナリエントリと共にこれらの値を使用して、圧縮された画像ストリームを正しくデコードします。例えば、/Height 768、/Width 1024で、RGBカラースペースでコンポーネントあたり8ビットを使用する画像は、2,359,296バイトの非圧縮データ（1024 × 768 × 3）を含みます。レンダリングエンジンは、/Heightを使用して処理するスキャンラインの数を決定し、画像が配置される際に適用される変換マトリックスと組み合わせて、デコードされたサンプルを最終的な表示寸法にスケーリングします。/Heightの値は、画像がどのように変換されても一定のままです。回転、スケーリング、またはスキュー操作は表示ジオメトリを変更しますが、/Heightによって定義される基礎となるサンプル数は変更しません。

• Image XObject – Doオペレーターを使用してページ上に描画できる画像データを含むストリームオブジェクト
• /Width – 画像の水平方向の寸法をサンプル単位で指定する対となるディクショナリキー
• Transformation matrix（変換マトリックス） – レンダリング中に画像空間からユーザー空間へ画像寸法をマッピングする方法を制御するマトリックス
• /BitsPerComponent – 画像内の各カラーコンポーネントを表すために使用されるビット数を指定するディクショナリエントリ
• Sample（サンプル） – 画像データストリーム内の個別のデータ単位（ピクセルコンポーネント）