Table 263 – Entries in a number format dictionary

Key

Type

Value

Type

name

(Optional) The type of PDF object that this dictionary describes; shall be NumberFormat for a number format dictionary.

U

text string

(Required) A text string specifying a label for displaying the units represented by this dictionary in a user interface; the label should use a universally recognized abbreviation.

C

number

(Required) The conversion factor used to multiply a value in partial units of the previous number format array element to obtain a value in the units of this dictionary. When this entry is in the first number format dictionary in the array, its meaning (that is, what it shall be multiplied by) depends on which entry in the rectilinear measure dictionary (see Ta b l e 262 ) references the number format array.

F

name

(Optional; meaningful only for the last dictionary in a number format array) A name indicating whether and in what manner to display a fractional value from the result of converting to the units of this dictionary by means of the Centry. Valid values shall be:

DShow as decimal to the precision specified by the D entry.

F Show as a fraction with denominator specified by the D entry.

RNo fractional part; round to the nearest whole unit.

TNo fractional part; truncate to achieve whole units.

Default value: D.

D

integer

(Optional; meaningful only for the last dictionary in a number format array) A positive integer that shall specify the precision or denominator of a fractional amount:

When the value of F is D, this entry shall be the precision of a decimal display; it shall be a multiple of 10. Low-order zeros may be truncated unless FD is true. Default value: 100 (hundredths, corresponding to two decimal digits).

When the value of F is F, this entry shall be the denominator of a fractional display. The fraction may be reduced unless the value of FD is true. Default value: 16.

FD

boolean

(Optional; meaningful only for the last dictionary in a number format array) If true, a fractional value formatted according to the D entry may not have its denominator reduced or low-order zeros truncated.

Default value: false.

RT

text string

(Optional) Text that shall be used between orders of thousands in display of numerical values. An empty string indicates that no text shall be added.

Default value: COMMA (2Ch).

RD

text string

(Optional) Text that shall be used as the decimal position in displaying numerical values. An empty string indicates that the default shall be used.

Default value: PERIOD (2Eh).

PS

text string

(Optional) Text that shall be concatenated to the left of the label specified by U. An empty string indicates that no text shall be added.

Default value: A single ASCII SPACE character (20h).

SS

text string

(Optional) Text that shall be concatenated after the label specified by U. An empty string indicates that no text shall be added.

Default value: A single ASCII SPACE character (20h).

O

name

(Optional) A name indicating the position of the label specified by U with respect to the calculated unit value. Valid values shall be:

S The label is a suffix to the value.

PThe label is a prefix to the value.

The characters specified by PS and SS shall be concatenated before considering this entry.

Default value: S.