Arched Bar Graph

This object is similar to a linear bar graph, but has an arched shape. It is drawn around an Output Ellipse object that is enclosed by a defined rectangle. The angles are calculated from the positive x-axis in the mathematically positive (counterclockwise) direction. The position attribute always refers to the top left corner of the enclosing rectangle, regardless of orientation. The object is drawn transparently so that objects underneath can enhance the visual effect. A Change Size command may cause the “bar graph width” to reach or exceed half of the width or height of the object, but this does not cause the pool to be rejected. The Virtual Terminal may reduce the bar graph width value for drawing, but this reduced value is not stored in the object.

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.

Colour

A colour based on the index of the Colour Palette.

Target Line Colour

Target line colour (if drawn).

Options (Output Arched Bar Graph)

Logical bits indicating which parts shall be drawn.

Logical bits indicating which parts are to be drawn.

1 = TRUE

  • Bit 0 = Draw border: If this bit is TRUE (1), the border lines, including the start and end line, are always drawn.
  • Bit 1 = Draw target line: If TRUE, a target line is drawn.
  • Bit 2 = Not defined, recommended to set to 0.
  • Bit 3 = Bar graph type:
    • If FALSE (0), the bar graph is filled.
    • If TRUE (1), the bar graph is not filled, but shows the current value as a single line at the corresponding position within the bar graph.
  • Bit 4 = Deflection of the bar graph around the arc:
    • 0 = Counterclockwise.
    • 1 = Clockwise.
Start angle

Start angle/2 (in degrees) from the positive x-axis counterclockwise (90° is straight up). Start and end angle define the arc. If start and end angle are equal, the arc of the bar graph is closed (360°).

End angle

End angle/2 (in degrees) from the positive x-axis counterclockwise (90° is vertically upward). Start and end angle define the arc. If start and end angle are equal, the arc of the bar graph is closed (360°).

Bar Graph Width

Width of the bar graph in pixels. The width of the bar graph should be less than half of the total width or less than half of the total height, whichever is smaller.

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.

Variable Reference

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

Target Value Variable Reference

Object ID of a Number Variable object from which the target value of the bar graph is retrieved. If this attribute is set to NULL, the target value is retrieved directly from the “Target Value” attribute. The value of the referenced Number Variable must be in the range of 0 to 65535.

Target Value

Current target value. Used only if the “Target Value Variable Reference” attribute is NULL. The target value is displayed as a line in the bar graph to indicate a target or warning value. If the target value > maximum value or the target value < minimum value, the target line is displayed at one of the ends of the bar graph without an error being generated by the VT.

Value (Integer)

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

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.

Used in

Attribute
Description