数値オブジェクト（Numeric object）

数値オブジェクトは、整数と実数の両方を含む数値を表現する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 ) で定義されているように、数値オブジェクトはPDF文書全体で使用され、座標、寸法、変換マトリックス、色値、および文書のレンダリングと動作を制御する様々なパラメータを指定します。これらのオブジェクトは、PDFがページコンテンツとレイアウトを正確に記述するための数学的基盤を形成します。

PDFにおける数値オブジェクトは、標準化された形式で記述された整数または実数(浮動小数点数)を表現するプリミティブデータ型です。整数の数値オブジェクトは1つ以上の数字で構成され、オプションでプラス記号またはマイナス記号を前に付けることができます(例:42、-17、+123)。実数の数値オブジェクトは小数点を含み、標準的な10進表記(例:3.14、-2.5、0.001)または、サポートされている場合は指数表記で記述できます。整数型と浮動小数点型を異なるデータ構造で区別するプログラミング言語とは異なり、PDFでは両方を同じ構文カテゴリ内の数値オブジェクトとして扱いますが、コンテキストに応じて処理方法が異なる場合があります。

数値オブジェクトは、文字列オブジェクト(テキストを表現)や名前オブジェクト(識別子として機能)とは異なります。文字列が「123」という文字を含む場合、これは数学的な値ではなくテキストを表現します。数値オブジェクトは常に、数学的演算や比較に参加できる量として解釈されます。

PDF生成、操作、またはレンダリングに取り組む開発者にとって、数値オブジェクトの理解は不可欠です。なぜなら、これらはPDF文書の視覚的および構造的側面を制御するためです。PDFの座標系における座標は、数値オブジェクトを使用してテキストとグラフィックをサブピクセル精度で配置します。また、変換マトリックスは6つの数値を使用してコンテンツの拡大縮小、回転、平行移動を行います。色値、線幅、フォントサイズ、ページ寸法はすべて、その仕様に数値オブジェクトを使用しています。

PDFコンテンツストリームを作成または解析する際、開発者はPDF構文規則に従って数値オブジェクトが正しくフォーマットされていることを確認する必要があります。不適切なフォーマットは、解析エラーや予期しないレンダリング動作につながる可能性があります。さらに、数値の精度と範囲は、異なるPDFプロセッサやプラットフォーム間での文書の移植性とレンダリングの一貫性に影響を与えます。

PDFにおける数値オブジェクトは、数学的な値を表すASCII文字としてファイル内に直接記述されます。整数は単純な数字の連続であり、実数には小数点を含める必要があります。先頭のゼロや小数点以降の末尾のゼロは許可されますが、必須ではありません。PDFプロセッサはこれらの文字列を解析し、処理用の内部数値表現に変換します。

PDFレンダラーがコンテンツストリーム内で数値オブジェクトに遭遇すると、現在のオペレーターコンテキストに応じてそれらを解釈します。たとえば、テキスト配置操作では、2つの数値オブジェクトがx座標とy座標を表します。色指定では、3つの数値オブジェクトが通常0から1の範囲の値を持つRGB色成分を表す場合があります。

PDF仕様は、相互運用性を確保するために数値の実用的な制限を定義しています。正確な制限はPDFプロセッサ間で異なる場合がありますが、準拠した実装は妥当な範囲の値を処理する必要があります。実数は通常、実際には約6桁の小数精度に制限されますが、ファイルにはより高い精度が保存される場合があります。

数値オブジェクトは、コンテンツストリームや辞書内の直接オブジェクトとして、または文書内の複数の場所から参照される場合は間接オブジェクトとして表示されます。コンテンツストリームでは、数値オブジェクトの連続がしばしばオペレーターのオペランドとして機能し、値の数と意味は呼び出される特定のオペレーターによって決定されます。

• コンテンツストリーム (Content stream) – パラメータに数値オブジェクトを使用して、ページコンテンツを記述するオペレーターとオペランドの連続
• 座標系 (Coordinate system) – PDFページ上の要素を配置する数値座標値によって定義される数学的空間
• オブジェクト型 (Object types) – 数値、文字列、名前、配列、辞書、ストリームオブジェクトを含むPDFのデータ構造のカテゴリ
• 実数 (Real number) – 分数値を表現するために小数点を含む数値オブジェクト
• 変換マトリックス (Transformation matrix) – PDFコンテンツの幾何学的変換を定義する6つの数値オブジェクトの配列