Image dictionary key /Width

/Widthキーは、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キーと連携して、画像自身の座標空間における本来の寸法を定義します。

/Width辞書キーは、PDFのImage XObject辞書における必須の整数エントリであり、画像のネイティブサンプル空間における水平方向の寸法を定義します。この値は、ソース画像データに実際に存在するピクセル列の数を表し、最終的にページ上でどのように表示されるかとは独立しています。画像のレンダリングサイズ（変換行列によって制御される）とは異なり、/Widthは画像自体の生データ構造を記述します。値は正の整数である必要があり、画像のデータストリームにおける1行あたりのサンプル数に直接対応します。例えば、/Width 1024の画像は、最終ページで2インチまたは2センチメートルでレンダリングされるかどうかに関係なく、ソースデータの水平方向に1024サンプル（ピクセル）を含んでいます。

/Widthキーの理解は、PDFの画像処理、抽出、または生成を行う開発者にとって不可欠です。この値は、画像ストリームをデコードする際のメモリ割り当て要件と処理パフォーマンスに直接影響します。PDFから画像をプログラムで抽出する場合、/Widthと/Heightを組み合わせることで、受け取るビットマップデータの正確な寸法がわかります。PDF生成ワークフローでは、誤った/Width値を設定すると、画像の歪み、レンダリングの失敗、またはドキュメントの破損を引き起こす可能性があります。/Widthの値は、画像データのデコード方法にも影響します。特に圧縮フォーマットの場合、デコーダはビットストリームを適切に解釈するために行の長さを知る必要があるためです。 ( 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 ) 標準に準拠したアクセシビリティ実装では、正確な画像寸法により、支援技術が視覚コンテンツの正確な代替表現を提供できるようになります。

/Widthキーは、Image XObjectのストリーム辞書内で構造記述子として機能し、他のエントリと連携して適切な画像のデコードとレンダリングを可能にします。PDFプロセッサがImage XObjectに遭遇すると、/Width値を読み取り、画像データの各行を構成するサンプル数を決定します。この情報は、関連するストリーム内のバイナリデータを解釈するために重要であり、特に各サンプルの構造を定義する/BitsPerComponentおよび/ColorSpaceエントリと組み合わせた場合に重要です。例えば、/Width 800、/BitsPerComponent 8、/DeviceRGBカラースペースを持つ画像は、1行あたり2,400バイトを必要とします（800サンプル × 3色成分 × 8ビット ÷ 8ビット/バイト）。レンダリングエンジンは、変換行列が適用される前のネイティブ画像空間座標系において/Widthを使用します。この座標系では、画像は水平方向に0から/Widthまで広がります。レンダリング中、現在の変換行列（CTM）は、画像の本来の寸法（/Widthと/Heightで定義される）から、ページ上の希望するサイズと位置へとスケーリングおよび配置を行います。 ( 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値は実際の画像データ構造を正確に反映している必要があります。宣言された/Widthと実際のデータとの不一致は、デコードエラーやレンダリング失敗を引き起こします。

• Image XObject – 画像データとその関連プロパティを辞書内に含むPDFストリームオブジェクト
• /Height – 画像の垂直方向の寸法をサンプル単位で指定する対応する辞書キー
• /BitsPerComponent – 画像サンプル内の各色成分を表すビット数を定義する辞書エントリ
• /ColorSpace – レンダリング中に画像内の色値をどのように解釈すべきかを指定する辞書エントリ
• Transformation Matrix – PDFページ上で画像コンテンツをスケーリング、回転、および配置する数学的構造