Gauges

Overview

Gauges are the visual elements of a screen page. The various different gauge types available in Dash Design are described in this section.

Gauge Types

Gauge Support Matrix

GaugeCD34LDS4CD32LDS35LDS35_LCD6GLW-43LFRW-43ZDU-LZDU-P
Tacho Gauges Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes
Value Gauge Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes
Label Gauge Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes
Needle Gauge Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes
Image Gauge Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes
Animation Gauge Yes No Yes No No Yes No No No No
Warning Gauge Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes
Text Input Gauge Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes
Bar Gauges Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes
Shape Gauge Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes
Limiter Gauge Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes
Cross-Hair Gauge Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes
Graph Gauge Yes Yes Yes No No Yes Yes Yes No No
Gauge Groups Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes
Bit Gauge Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes
Menu Gauge Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes
Text Message Gauge Yes Yes Yes No No Yes Yes Yes No No
Arc Gauge No Yes No No No Yes Yes Yes No No
Camera Gauge No No Yes No No No No No No No

Subsections of Gauges

Animation Gauge

Overview

Gauge Icon Animation Gauges may be configured to display an animated gif image.

Animation gauges might be used to display a short animated splash screen when the display is switched on.

Properties

In addition to Standard Gauge Properties , the following properties may be configured:

Property Description
Animation File File to display.
Enable Preview Plays the animation in the editor. This option is not stored in the display setup.
Repeat Count If zero, the GIF loops continuously. Otherwise, this is the number of loops before playback stops; for example, 1 plays the animation once. On a splash screen, completing the repeat count triggers exit from the splash screen unless its timer expires first. Available on displays that support GIF repeat count.

Display Support

DisplaySupported?
CD34 Yes
LDS4 No
CD32 Yes
LDS35 No
LDS35_L No
CD6 Yes
GLW-43 No
LFRW-43 No
ZDU-L No
ZDU-P No

Arc Gauge

Overview

Gauge Icon The Arc Gauge renders a swept arc (annulus). As with Needle Gauge , the arc gauge can specify a background image.

Note

The arc gauge may require a firmware update to be supported on your display.

Properties

In addition to Standard Gauge Properties , the following properties may be configured:

Property Description
Type The type of gauge to be drawn, may be switched between Needle Gauge or Arc Gauge .
Background Image The image behind the arc. Clearing it removes the image.
Angle [degrees] Rotates the gauge by the specified angle.
Auto-size Automatically calculate the radii and centre of the arc from the gauge width and height.
X Centre, Y Centre Horizontal and vertical position of the arc centre, in pixels.
Outer Radius Distance from the centre to the outer edge of the arc, in pixels.
Inner Radius Distance from the centre to the inner edge of the arc, in pixels.
Thickness Thickness of the arc stroke in pixels (Outer Radius minus Inner Radius).
Start Degrees The number of degrees from 6 o’clock (the zero degree position) that the starting value of the gauge should be drawn.
End Degrees The number of degrees from 6 o’clock (the zero degree position) that the end value of the gauge should be drawn.
Transparent Mask Chroma-key colour in the background image to omit when masking is enabled.
Enable Transparent Mask Omit pixels matching Transparent Mask from the background image.

Display Support

DisplaySupported?
CD34 No
LDS4 Yes
CD32 No
LDS35 No
LDS35_L No
CD6 Yes
GLW-43 Yes
LFRW-43 Yes
ZDU-L No
ZDU-P No

Bar Gauges

Overview

There are 4 types of bar gauge - rectangle and triangle shaped bars in either horizontal or vertical orientation:

  • Gauge Icon Vertical Triangular
  • Gauge Icon Horizontal Triangular
  • Gauge Icon Vertical Rectangular
  • Gauge Icon Horizontal Rectangular

Segments

A bar contains a number of segments that divide the bar up between the minimum and maximum limits.

Properties

In addition to Standard Gauge Properties , the following properties may be configured:

Property Description
Separators Between Bars If checked, a separator line is drawn between each bar in the line colour. Otherwise, the bars run contiguously.
Fill From Centre (Rectangular Bars) If checked, the bar is drawn from the centre. For example, consider a bar gauge with the minimum set to -2 and the maximum set to +2, with Fill From Centre checked. If the value of the input is -2, the bar will be filled from the midpoint (0) to the left hand side. If the input is 0, the bar will be unfilled. If the input is 2, the bar will be filled from the midpoint to the right hand side.
Single Line Mode (Rectangular Bars) If checked, the bar is not filled; a single line moves across it to indicate the current value.
Square Mode (Rectangular Bars) If checked, then the bar will not have a chamfer at one end.

Rectangular bars also provide Corner Radius for rounded corners. On supported displays, Smooth Position interpolates the bar position between segments, while Flip X and Flip Y flip any bar variant horizontally or vertically.

Display Support

DisplaySupported?
CD34 Yes
LDS4 Yes
CD32 Yes
LDS35 Yes
LDS35_L Yes
CD6 Yes
GLW-43 Yes
LFRW-43 Yes
ZDU-L Yes
ZDU-P Yes

Bit Gauge

Overview

Gauge Icon The Bit Gauge displays the value of individual bits in the integer representation of the input channel value.

Properties

In addition to Standard Gauge Properties , the following properties may be configured:

Property Description
On The colour of bit elements for bits that are set in the input value.
Off The colour of bit elements for bits that are not set in the input value.
Spacing Spacing, in pixels, between bit elements in the gauge.
Box Width Width, in pixels, of bit elements in the gauge.
Box Height Height, in pixels, of bit elements in the gauge.
Corner Radius If non-zero, draws rectangular bit elements with the given corner radius, in pixels.
Circle Style Render bit elements as circles using Box Width as the diameter.
Bit Count The number of bit elements to render.
Items Lists the bit elements and allows arbitrary bits from the input value to be assigned to specific bit elements.

Display Support

DisplaySupported?
CD34 Yes
LDS4 Yes
CD32 Yes
LDS35 Yes
LDS35_L Yes
CD6 Yes
GLW-43 Yes
LFRW-43 Yes
ZDU-L Yes
ZDU-P Yes

Camera Gauge

Overview

Gauge Icon Camera Gauges are used to show the video feed from an attached camera on the display.

If no camera is connected, a standard colour bar test card is shown.

Properties

In addition to Standard Gauge Properties , the following properties may be configured:

Property Description
Mirror Image from Camera If checked, the feed from the camera will be reversed as if seen in a mirror. This is useful when a non-mirrored camera is used as a rear view camera. Disabled in Crop To Area mode.
Display Mode Sets how the camera image fits the gauge: Preserve Aspect Ratio adjusts the gauge to preserve the source aspect ratio; Crop fills the gauge and may crop the image; Scale fills the gauge and may distort the image; Crop To Area displays the area specified by the crop properties.
Crop Left Number of pixels to crop from the left of the camera image. Available in Crop To Area mode.
Crop Top Number of pixels to crop from the top of the camera image. Available in Crop To Area mode.
Crop Right Number of pixels to crop from the right of the camera image. Available in Crop To Area mode.
Crop Bottom Number of pixels to crop from the bottom of the camera image. Available in Crop To Area mode.

Display Support

DisplaySupported?
CD34 No
LDS4 No
CD32 Yes
LDS35 No
LDS35_L No
CD6 No
GLW-43 No
LFRW-43 No
ZDU-L No
ZDU-P No

Cross-Hair Gauge

Overview

Gauge Icon The Cross Hair Gauge uses two inputs to move a cross hair around a box.

Properties

In addition to Standard Gauge Properties , the following properties may be configured:

Property Description
Input X, Input Y Channels used to position the cursor on the X and Y axes.
Input Filter X, Input Filter Y Filters or modifiers applied independently to each axis input.
Input Value X, Input Value Y Design-time preview values for the X and Y axes.
Minimum X, Minimum Y Starting values for the X and Y axes.
Maximum X, Maximum Y End values for the X and Y axes.
Size Size of the cross-hair cursor, in pixels.
Shape Shape of the cross-hair cursor.
Thickness Thickness of the cursor lines, in pixels.
Background Image Image behind the cross hairs, useful for showing the meaning of a position. Clearing it removes the image.
Transparent Mask Chroma-key colour in the background image to omit when masking is enabled.
Enable Transparent Mask Omit pixels matching Transparent Mask from the background image.

Display Support

DisplaySupported?
CD34 Yes
LDS4 Yes
CD32 Yes
LDS35 Yes
LDS35_L Yes
CD6 Yes
GLW-43 Yes
LFRW-43 Yes
ZDU-L Yes
ZDU-P Yes

File Explorer Gauge

Overview

Gauge Icon The File Explorer Gauge provides access to files on the Display Module if supported. Some display types allow video playback and display of images from files via the file explorer.

Properties

In addition to Standard Gauge Properties , the following properties may be configured:

Title Tip
Up Button Input for Up button (scrolls file explorer selection).
Down Button Input for Down button (scrolls file explorer selection).
OK Button Input for OK button (accept selection).
Context Button Input for Context ‘menu’ / file management button.
Video Seek Offset Input for video seek offset.
Repeat Interval [ms] Auto-repeat interval for button inputs, set to zero for no auto-repeat.
Video Seek Interval [s] Jump length when seeking during video playback
Caption Title of the file explorer.
Line Spacing Spacing between lines in the menu.
Selected Fill Background colour of selected items
Font Font for normal items in the file explorer.
Text Colour Colour of normal items in the file explorer.
Selected Font Font for selected items in the file explorer.
Selected Text Colour Text colour of selected items in the file explorer.
Unsupported Text Colour Text colour of unsupported items in the file explorer.

Display Support

DisplaySupported?
CD34 No
LDS4 No
CD32 No
LDS35 No
LDS35_L No
CD6 No
GLW-43 No
LFRW-43 No
ZDU-L No
ZDU-P No

Graph Gauge

Overview

Gauge Icon The Graph Gauge plots values from its input channel(s) with respect to time.

Properties

In addition to Standard Gauge Properties , the following properties may be configured:

Property Description
Time Base The time range of the graph, in seconds.
Line Count The number of lines to display. Changing the count adds a set of properties for each line.
Input The input value for this line.
Input Filter Filtering to apply to this line’s input.
Colour The line colour.
Minimum The minimum value for this line.
Maximum The maximum value for this line.

Display Support

DisplaySupported?
CD34 Yes
LDS4 Yes
CD32 Yes
LDS35 No
LDS35_L No
CD6 Yes
GLW-43 Yes
LFRW-43 Yes
ZDU-L No
ZDU-P No

Image Gauge

Overview

Gauge Icon Image Gauges are used to show an image from a file or an image selector output (see Image Selectors Tab ).

Properties

In addition to Standard Gauge Properties , the following properties may be configured:

Property Description
Graphic/Input Image to display. May be an image list input.
Enable Transparent Mask Enables the chroma key colour for bitmap transparency. Available on supported displays.
Transparent Mask Chroma key colour for basic transparency of bitmaps (non-alpha blended). Available on supported displays.

The Graphic/Input property allows a file to be selected from disk using the Open button.

Use the … button to select from all Image and Image Selector assets in the setup.

Use the Reload Reload button to update / reload the selected image asset from disk.

Use the Reload Clear button to un-set the selected image. This will not remove the associated image asset from the setup. To remove image assets, see Images Tab

When loading an image, if it is too large to fit on the screen, the option to resize it will be offered.

Display Support

DisplaySupported?
CD34 Yes
LDS4 Yes
CD32 Yes
LDS35 Yes
LDS35_L Yes
CD6 Yes
GLW-43 Yes
LFRW-43 Yes
ZDU-L Yes
ZDU-P Yes

Label Gauge

Overview

Gauge Icon The Label Gauge is a static gauge (it has no input and does not change) that is normally used to label other gauges or provide fixed information.

Properties

In addition to Standard Gauge Properties , the following properties may be configured:

Property Description
Caption Caption text shown by the label gauge.
Direction Specifies the direction in which the text is drawn in.
  • Right - Left-to-right
  • Left - Right-to-left
  • Up - Render characters bottom-to-top
  • Down - Render characters top-to-bottom
  • Flip X - Mirror horizontally (vector fonts only)
  • Flip Y - Mirror vertically (vector fonts only)
  • Rotate CW - Rotate 90° clockwise (vector fonts only)
  • Rotate CCW - Rotate 90° counter-clockwise (vector fonts only)
  • Rotate 180 - Rotate 180° (vector fonts only)
Justification Specifies whether the text is aligned to the left, right or centre of the bounding rectangle.

Display Support

DisplaySupported?
CD34 Yes
LDS4 Yes
CD32 Yes
LDS35 Yes
LDS35_L Yes
CD6 Yes
GLW-43 Yes
LFRW-43 Yes
ZDU-L Yes
ZDU-P Yes

Limiter Gauge

Overview

Gauge Icon The Limiter Gauge is typically used to signal an approaching rev limit by means of several boxes that change colour as the rev limit approaches.

Properties

In addition to Standard Gauge Properties , the following properties may be configured:

Property Description
Circular Lights Draws lights with a circular shape.
Light Count The number of lights to draw.
Start For Limiter gauges, the value at which the gauge starts.
End For Limiter gauges, the end value for the last light.
Increment For Limiter gauges, the value added for each light limit.
Breakpoints Info Read-only information about the breakpoints of a Limiter gauge.

For example, a Start of 8000, Increment of 200 and Light Count of 3 sets light thresholds at 8000, 8200 and 8400.

Display Support

DisplaySupported?
CD34 Yes
LDS4 Yes
CD32 Yes
LDS35 Yes
LDS35_L Yes
CD6 Yes
GLW-43 Yes
LFRW-43 Yes
ZDU-L Yes
ZDU-P Yes

Menu Gauge

Overview

Gauge Icon The Menu Gauge allows a simple text menu to be drawn on the screen which allows navigation to various pages in the setup.

This is useful for seldom used configuration options such as Setting the time, setting the calibration factor or displaying the screen properties.

The menu events Menu Up and Menu Down are used to navigate up and down the menu and Menu Select jumps to the page associated with the current menu item.

Properties

In addition to Standard Gauge Properties , the following properties may be configured:

Property Description
Selected Colour of the selected menu item.
Line Spacing Spacing between lines in the menu.
Items The items to display in the menu and the pages they switch to. Each item has a text and page.
Property Description
Up Move the cursor up. Applies to all menu gauges.
Down Move the cursor down. Applies to all menu gauges.
Select Select the current item.

These events are available when a menu control output is assigned.

The menu item editor has two columns:

Column Description
Menu Item The text shown for the menu item.
Page The page to switch to when the item is selected.

Display Support

DisplaySupported?
CD34 Yes
LDS4 Yes
CD32 Yes
LDS35 Yes
LDS35_L Yes
CD6 Yes
GLW-43 Yes
LFRW-43 Yes
ZDU-L Yes
ZDU-P Yes

Needle Gauge

Overview

Gauge Icon The Needle Gauge allows a scaled pointer or needle to be drawn over a graphic image. This allows much more eye catching graphics to be used for round gauges than could otherwise be drawn dynamically by the display hardware.

Properties

In addition to Standard Gauge Properties , the following properties may be configured:

Property Description
Type The type of gauge to be drawn, may be switched between Needle Gauge or Arc Gauge .
Background Image The image behind the needle. Clearing it removes the image.
Angle [degrees] Rotates the gauge by the specified angle.
Auto-size Automatically calculate the length and centre of the needle from the gauge width and height.
X Centre, Y Centre Horizontal and vertical position of the centre of rotation, in pixels.
Centre Offset Distance from the centre of rotation to where the needle starts, in pixels.
Draw Centre Draw a circle at the base of the needle.
Needle Length Length of the needle, in pixels.
Base Width Width of the base of the needle, in pixels.
Start Degrees The number of degrees from 6 o’clock (the zero degree position) that the starting value of the gauge should be drawn.
End Degrees The number of degrees from 6 o’clock (the zero degree position) that the end value of the gauge should be drawn.
Transparent Mask Chroma-key colour in the background image to omit when masking is enabled.
Enable Transparent Mask Omit pixels matching Transparent Mask from the background image.

Display Support

DisplaySupported?
CD34 Yes
LDS4 Yes
CD32 Yes
LDS35 Yes
LDS35_L Yes
CD6 Yes
GLW-43 Yes
LFRW-43 Yes
ZDU-L Yes
ZDU-P Yes

Shape Gauge

Overview

Gauge Icon The Shape Gauge draws shapes on the screen. It has no main value input, but its colour can change when a colour source or warning is configured on supported displays.

Properties

In addition to Standard Gauge Properties , the following properties may be configured:

Property Description
Shape Choose Rectangle, Ellipse, Rounded Rectangle or, on supported displays, Marker.
Corner Radius Radius of the corners of a rounded rectangle, in pixels.
Arrow Aspect Ratio (Marker) Ratio of arrow length to width.
Shape Width % (Marker) Percentage of the computed shape length used for its width.
Angle [degrees] Rotates the shape on supported displays.
Thickness Thickness of the border drawn around the shape.

An optional gradient fill can be set instead of a solid fill colour:

Property Description
Enable Gradient Check to enable the gradient fill.
Direction Horizontal draws the gradient from left to right, Vertical draws the gradient from top to bottom.
Start Colour The colour at the start of the gradient.
End Colour The colour at the end of the gradient.

Display Support

DisplaySupported?
CD34 Yes
LDS4 Yes
CD32 Yes
LDS35 Yes
LDS35_L Yes
CD6 Yes
GLW-43 Yes
LFRW-43 Yes
ZDU-L Yes
ZDU-P Yes

Tacho Gauges

Overview

Gauge Icon Bar Tacho and Gauge Icon Round Tacho gauges are typically used with engine speed or road speed and are available as either a curved bar gauge or a round gauge. They use minimum, maximum and resolution in the same manner as bars but also have labeled segments, the frequency of which is specified by the label frequency property. The label values are divided by the label divisor property and then formatted.

See also Needle Gauge which can be used to draw a pointer over an image background.

Properties

In addition to Standard Gauge Properties , the following properties may be configured:

Property Description
Rectangular Tacho (Bar Tacho) Draw the tacho as a rectangle instead of an arc.
Smooth Edges (Bar Tacho) Draw smooth bar edges instead of stepped edges.
Separators Between Bars (Bar Tacho) Draw a separator in the line colour between bars instead of running them together.
Angle [degrees] (Round Tacho) Rotate the gauge by the specified angle.
Start Degrees (Round Tacho) The number of degrees from 6 o’clock (the zero degree position) at which the starting value of the gauge is drawn.
End Degrees (Round Tacho) The number of degrees from 6 o’clock (the zero degree position) at which the end value of the gauge is drawn.
Smooth Position On supported displays, interpolate the bar or needle position instead of snapping to the nearest segment.
Lower Limit Enabled (Bar Tacho) Draw the area below Lower Limit End in Lower Limit Colour.
Lower Limit End (Bar Tacho) Value where the lower limit area ends.
Lower Limit Colour (Bar Tacho) Colour of the lower limit area.
Upper Limit Enabled (Bar Tacho) Draw the area above Upper Limit Start in Upper Limit Colour.
Upper Limit Start (Bar Tacho) Value where the upper limit area starts.
Upper Limit Colour (Bar Tacho) Colour of the upper limit area.
Lower Limit Flash (Bar Tacho) Flash the lower limit area when the input falls below Lower Limit End.
Upper Limit Flash (Bar Tacho) Flash the upper limit area when the input rises above Upper Limit Start.
Flash All Enabled (Bar Tacho) Flash the entire gauge in Upper Limit Colour when the input exceeds Flash All Start.
Flash All Start (Bar Tacho) Value above which Flash All Enabled takes effect.
Flash Rate (Bar Tacho) Rate at which active flash modes flash, in milliseconds.

On supported displays (e.g. CD6), Round Tacho gauges also support background and fill gradients and the shared colour controller (see Colour Source in Standard Gauge Properties ). Round Tacho warning colours apply to the gauge background.

Note

When a Round Tacho gauge is rotated, or uses non-default start / end degrees, it is converted to a Needle Gauge with a generated background image when the setup is programmed into the display. This provides wider firmware compatibility.

Display Support

DisplaySupported?
CD34 Yes
LDS4 Yes
CD32 Yes
LDS35 Yes
LDS35_L Yes
CD6 Yes
GLW-43 Yes
LFRW-43 Yes
ZDU-L Yes
ZDU-P Yes

Text Input Gauge

Overview

Gauge Icon The Text Input Gauge is used to display text from a channel that produces a text output such as a Text channel.

Properties

Text Input gauges use the shared properties described in Standard Gauge Properties and have no additional property controls.

Warning

When a Background property is available, set it to match the colour of the surface behind the Text Input gauge. A different colour may corrupt the displayed text.

Display Support

DisplaySupported?
CD34 Yes
LDS4 Yes
CD32 Yes
LDS35 Yes
LDS35_L Yes
CD6 Yes
GLW-43 Yes
LFRW-43 Yes
ZDU-L Yes
ZDU-P Yes

Text Message Gauge

Overview

Gauge Icon The Text Message Gauge is used to display messages received from a GEMS radio messaging system or GEMS SMS1 text messaging system.

In addition to Standard Gauge Properties , the following properties may be configured:

Property Description
Urgent Only Only display messages marked as being urgent.
Newest in Bold Display the latest text message in the bold font.
Newest on Top Display the latest text message at the top of the list.
Font (Normal Font group) Normal font for all messages, or for historical messages when Newest in Bold is enabled.
Colour (Normal Font group) Colour for the normal font.
Font (Bold Font group) Bold font for the latest message when Newest in Bold is enabled.
Colour (Bold Font group) Colour for the bold font. The SMS1 only transmits small messages, so the bold font is not used for those messages.

Display Support

DisplaySupported?
CD34 Yes
LDS4 Yes
CD32 Yes
LDS35 No
LDS35_L No
CD6 Yes
GLW-43 Yes
LFRW-43 Yes
ZDU-L No
ZDU-P No

Value Gauge

Overview

Gauge Icon The Value Gauge shows the value of the output specified in the Input property according to the format specified in the Format property. The Justification property specifies whether the text is aligned to the left, right or centre of the bounding rectangle.

Warning

It is important to select the background colour of the value gauge to be the same as the colour of the background the gauge is over. Failure to do so may result in corruption of the value displayed.

The value gauge has an optional warning mode that changes the colour of the gauge when a warning limit for the input is exceeded or if a secondary channel is logically ’true'.

Properties

The Value Gauge uses the shared properties described in Standard Gauge Properties .

The following colour-mode controls are available where supported:

Property Description
Colour Mode Selects how the gauge colour responds to its input or a separate colour input.
Alarm Limit In limit mode, the input value must exceed this limit to activate the alarm colour.
Alarm Colour Colour used while the alarm is active.
Alarm Flash Makes the gauge flash while the alarm is active.
Colour Input In logic mode, a non-zero value activates the alarm. In direct-colour mode, supplies the colour value.
Colour Map In direct-colour mode, maps the colour input value to a colour.
Colour Preview A design-time colour input value used to preview the selected colour mode.

Special Formats

The Special Format property can be used to display internal system values. See Value Formatting .

The Channel Name and Channel Units Special Format values will cause Dash Design to replace the value gauge with a Text Input Gauge when programming the display containing the input channel name or units. This can be useful if creating Gauge Groups where the channel name, value and units should be shown; setting the Input channel property on the group will assign the value and also update the channel name and units.

Display Support

DisplaySupported?
CD34 Yes
LDS4 Yes
CD32 Yes
LDS35 Yes
LDS35_L Yes
CD6 Yes
GLW-43 Yes
LFRW-43 Yes
ZDU-L Yes
ZDU-P Yes

Warning Gauge

Overview

Gauge Icon The Warning Gauge, aka Alarm Bar is a block that changes colour depending on its input. Typically this is used to indicate out-of-range parameters.

For example, an Warning Gauge may be placed next to a gauge showing coolant temperature. The input to the Warning Gauge is configured to give an error signal if the coolant temperature rises above a pre-determined level. The bar colour changes from the specified background colour to the Fill Colour to give an easily seen warning indication.

Tip

It is possible to display a Warning Gauge underneath a value or text input gauge. For this to work correctly, the Warning Gauge must be bigger than the maximum likely size of the value gauge. When setting this up in the editor, it is easier to add the Warning Gauge to the page first then the value gauge; this ensures that the value gauge is visible and makes sizing the Warning Gauge correctly easier.

Properties

In addition to Standard Gauge Properties , the following properties may be configured:

Property Description
Borderless Do not draw a border.
Corner Radius Radius of rounded corners, in pixels.
Colour from input value Use the input value as the colour. Does not draw a border in this mode.
Colour Map Maps the gauge input value to a colour in legacy input-colour mode. This is distinct from the shared colour-source map described in Standard Gauge Properties .
Flash Causes the gauge to flash if a warning is active. Not supported in direct-colour mode.

Colour Input Values

When Colour from input value is enabled, the input is treated as a colour unless a Colour Map is configured. These legacy controls are disabled when a shared Colour Source is assigned; see Standard Gauge Properties .

Most Display Modules expect the colour value to be a 24 bit RGB value. The hexadecimal (and decimal) values of some common colours are shown below:

Colour Hexadecimal Decimal
Black 0x000000 0
White 0xFFFFFF 16777215
Red 0xFF0000 16711680
Green 0x00FF00 65280
Blue 0x0000FF 255

Some older firmware versions only support 16 bit RGB565 values as follows:

The 16 RGB colour value treats the top 5 bits as red intensity, the next 6 bits as green intensity and the lower 5 bits as blue intensity. Thus, it is possible to display any one of 65535 colours. The hexadecimal (and decimal) values of some common colours are shown below:

Colour Hexadecimal Decimal
Black 0x0000 0
White 0xFFFF 65535
Red 0xF800 63488
Green 0x07E0 2016
Blue 0x001F 31
Cyan 0x07FF 2047
Yellow 0xFFE0 65504

Typically, a function table would be used to map a given value to a specific colour. To avoid interpolation between the colour values, the function table should be set up such that a range of values defines one colour. For example, the following function table would map brake temperatures of 0 to 250 to blue, 251 to 500 to green, 501 to 700 to yellow and 701 to 1000 to red:

Input Output
0 31
250 31
251 2016
500 2016
501 65504
700 65504
701 63488
1000 63488

Display Support

DisplaySupported?
CD34 Yes
LDS4 Yes
CD32 Yes
LDS35 Yes
LDS35_L Yes
CD6 Yes
GLW-43 Yes
LFRW-43 Yes
ZDU-L Yes
ZDU-P Yes