The linear gauge components draw a straight horizontal or vertical gauge.  It can be used simply as a gauge with multiple pointers, or it can act like a slider that one can interact with.

Properties:

Pointer:

Pointers: you can have multiple pointers in a single gauge.  Adding pointers is similar to adding any multi- property except there is no threshold.  Please see sections 7.4.2 for details on Multi- properties.  Each pointer has a number of properties listed at the bottom of this section.

Scale:

Vertical: if enabled, the gauge is drawn with the scale in the vertical direction.  If not enabled, the gauge is drawn horizontally.

RangeColors: you can have multiple background colors along the scale of the gauge.  Adding range colors is similar to adding pointers and thus any multi- property except there is no threshold.  Please see sections 7.4.2 for details on Multi- properties.  Each RangeColor has a number of properties, listed at the end of this page.

RangeMin: the value of the gauge at the bottom or left, usually the minimum.

RangeMax: the value of the gauge at the top or right, usually the maximum

ScaleOffset: the offset, in pixels, from the inside of the frame to the outside of the gauge ticks

Ticks:

MajorTickStyle: the style of the major ticks

MajorTickStep: how many minor ticks per major tick

MajorTickSize: the overall size of the major ticks, in pixels

MinorTickStyle: the style of the minor ticks

MinorTickStep: the size of the minor ticks, in pixels

MinorTickSize: spacing, in gauge units, between minor ticks

MinorTickLocation: the location of the minor ticks relative to the major ticks

TickMarkFillBrush, TickMarkFillBrushPreset: brush (color) used to fill the tick marks.  Does not apply to all tick styles.

TickMarkBorderBrush, TickMarkBorderBrushPreset: brush (color) used to draw the border of the tick marks

Labels:

Precision: number of digits after the decimal displayed in the labels

LabelTextFormat, LabelTextFormatPreset: the text format (font etc) for the labels

LabelTextBrush, LabelTextBrushPreset: brush (color) used to draw the labels

Frame:

FrameSize: size of the frame, in pixels

GaugeBackMultiBrush, GaugeBackMultiPreset, GaugeBackBrush, GaugeBackBrushPreset: brush (color) used to draw the background of the gauge

FrameFillBrush, FrameFillBrushPreset: brush (color) used to fill the frame

FrameBorderBrush, FrameBorderBrushPreset: brush (color) used to draw the frame border

Common Properties:

This component includes all the common properties of components described in section 7.4.4 including the background properties.

Pointer Properties:

Main:

Expression: the expression that when evaluated determines the location of the pointer on the scale.

OutputTarget: the channel or variable that is set with the value of the pointer if the pointer is dragged.  Leave blank to make the pointer an indicator and read-only.

Step: the minimum interval between pointer locations.  So, for example, if Step is 1, the pointer will only show integer values.

Format:

Style: the overall type of pointer displayed, for example Triangle, Circle, etc.

FillMultiBrush, FillMultiPreset, FillBrush, FillBrushPreset: determine the brush (color) use to fill the pointer.  Please see sections 7.4.2 and 7.4.3 for details on Multi- properties and presets.

BorderMultiBrush, BorderMultiPreset, BorderBrush, BorderBrushPreset: determine the brush (color) use to draw the border of the pointer.  Please see sections 7.4.2 and 7.4.3 for details on Multi- properties and presets.

Size:

Size:the overall size of the pointer relative to the size of the gauge.  A value of 1 draws the pointer all the way across the gauge to the outer frame.

Width: the width (along the scale axis) of the pointer in pixels.

Pointer Variables:

Position: accessible from script.  Provides the current position of the pointer.  Read-only.

 

RangeColor Properties:

Main:

Start: the starting point along the scale to start the given color

End: the ending point along the scale to stop the given color

FillMultiBrush, FillMultiPreset, FillBrush, FillBrushPreset: determine the brush (color) use to fill the space.  Please see sections 7.4.2 and 7.4.3 for details on Multi- properties and presets.

BorderMultiBrush, BorderMultiPreset, BorderBrush, BorderBrushPreset: determine the brush (color) used on the border of the space.  Please see sections 7.4.2 and 7.4.3 for details on Multi- properties and presets.

StartWidth: the width, in pixels, of the color bar at the starting point of the range

EndWidth: the width, in pixels, of the color bar at the ending point of the range

Offset: the offset, in pixels, of the color bar from the scale ticks.