Number (Input)

This object formats, displays and changes a numeric value based on an integer value. The equation for the displayed value is: Displayed value = (Value attribute + Offset) × Scale factor

The displayed values are truncated or rounded depending on the “Options” attribute. The VT should use double precision to minimise rounding errors. When the operator presses the “Enter” key, the new value is only accepted if it is within the scaled min/max range. Otherwise the input object remains open. If the value is valid, the Value attribute is set according to the equation: Value attribute = (new value / Scale factor) − Offset

The Working Set can change values by pool upload or the “Change Numeric Value” command.

Attributes

AID

Attribute

Description

Object Id

Unique identifier of the object. This must be unique within the object pool (2 bytes, 0-65534).

Type

The type of the object.

Width

Width of the object in pixels.

Height

Height of the object in pixels.

Background Colour

Background colour. A colour based on the index of the Colour Palette.

Font Attributes

Object Id of a Font Attributes object for display formatting of this field.

Options (Number Representation)

Logical bits indicating options. 1 = TRUE.

Bit 0 = Transparent: If TRUE, the input field is displayed with a transparent background instead of using the background colour attributes.
Bit 1 = Display leading zeros: If TRUE, the field is padded with zeros left-justified to the field width; justification is applied after padding with zeros.
Bit 2 = Display zero as blank: If TRUE, the field is displayed blank, but only if the displayed value of the object is exactly zero. Except when the field is blank, the VT must always display at least one digit before the decimal point (examples: “2.2”, “0.2”).
Bit 3 = Truncate: If TRUE, the value is truncated to the specified number of decimal places. Otherwise, the value is rounded to the specified number of decimal places.

Note for designers: When considering leading zeros and the field width, a leading minus sign (unary minus) should also be included.

Variable Reference

Reference to a Variable object from which the value is taken.

Min value

Raw minimum value for the input before scaling. Offset and scale must be applied to determine the actual minimum value.

Max Value

Raw maximum value for the input. Offset and scale must be applied to determine the actual maximum value.

Offset

Offset applied to the value. Displayed value = (Value attribute + Offset) × Scale factor.

Scale

Scale to be applied to the input value as well as to the min/max values.

Number of decimals

Specifies the number of decimal places to be displayed after the decimal point.

Format (Number)

0 = Display in fixed decimal format (####.nn)
1 = Use of exponential format ([-]###.nnE[+/-]## where n is specified by the

Number of decimals attribute).

Justification

Horizontal/vertical alignment of the content.

Value (Integer)

Current integer value of the object if no variable reference is used.

Options 2

Logical bits indicating options.

1 = TRUE.
Bit 0 = Enabled. If TRUE, the object is enabled. If FALSE, the object is disabled.
Bit 1 = Real-time editing. (VT Version 4 and later) If TRUE, the value is transmitted to the Working Set Master while it is being changed (see real-time in section 4.2).

‍

Number of Macros to follow

Number of contained macro references, even if it is zero.

Each macro reference consists of 2 bytes: one for the event Id and one for the macro Id.

When the specified event occurs, the associated macro is executed. VT version 5 and later: A reference to a macro with a 16-bit Object Id counts as 2 macro references in the context of this attribute.