Please enable JavaScript to view this site.

DAQFactory User's Guide

Navigation: 7 Pages and Components > 7.18 The Components > 7.18.3 Gauges

7.18.3.2 Angular Gauge Component

Scroll Prev Top Next More

The angular gauge components draw a circular gauge like a speedometer in a car.   It is very similar to a linear gauge with many of the same properties:

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.

ShadowBrush, ShadowBrushPreset: brush (color) used to draw a shadow under the pointers.

UpdateInterval: Minimum time (in seconds) between output updates as a pointer is dragged.  Set to 0 to disable.  Only applies if one of the pointers has OutputTarget set.

Scale:

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 AngleStart, usually the minimum.

RangeMax: the value of the gauge at the AngleEnd, usually the maximum.

AngleStart: the angle (in degrees) that the gauge starts at.  0 is to the right with positive going counter-clockwise.

AngleEnd: the angle (in degrees) that the gauge stops at.  0 is to the right, with positive going counter-clockwise.

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

ShapeByScale: if enabled, the gauge shape will be determined by the start/end angles instead of being round.

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

TicksOutsideFrame: if enabled, the ticks will be drawn outside the gauge frame

TextBeforeTicks: if enabled, the text labels are drawn on the other side of the 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

Rotate Labels: if enabled the labels are rotated as they go around the gauge

Cap:

CapSize: size in pixels of the center cap of the gauge.

CapFillMultiBrush, CapFillMultiPreset, CapFillBrush, CapFillBrushPreset: brush (color) used to draw the center cap on the gauge

CapBorderMultiBrush, CapBorderMultiPreset, CapBorderBrush, CapBorderBrushPreset: brush (color) used to draw the border of the center cap on the gauge

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

FrameFillInvBrush, FrameFillInvBrushPreset: brush (color) used to fill the inverted part frame that helps give it a 3d look.

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.

ExtraLength: if enabled, the pointer will have a tail extending on the other side of the center cap

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.