Design Tab

Overview

The Design Tab is used to configure a Screen (commonly referred to as a Page).

Design Tab Design Tab

Gauge Structure Tree

Displays a tree that describes the layout of the screen.

Gauges may be grouped together and appear as an item in the gauge structure list with child gauges within the next level of the tree. Grouped gauges may be collectively positioned and their properties may be collectively edited.

Items may be selected by clicking. Hold the Shift key to select a range of items and the Ctrl key to add/remove single items from the selection.

The Gauge Structure Tree indicates the Z-order, with items at the top of the list being rendered ‘below’ items further down the list.

The Z-order may be modified by dragging items in the Gauge Structure Tree to the desired position.

Design Area

In the center of the Design Tab is the Design Area. This shows an interactive visual representation of the screen layout.

Gauge Palette

At the top of the design area is the Gauge Palette from which new gauges may be added to the screen design.

Properties

To the right of the Design Area are the Properties. The list of properties changes in depending upon the selection in the Design Area.

The properties may be edited to adjust the visual appearance, input channel(s) and behaviour of screens and gauges.

If no gauges are selected then the properties of the screen itself are displayed.

Screen Properties

Property Description
Screen The number or type of the screen page.
Name The name of the screen.
Colour The background colour of the screen.
Screen Enabled Includes the screen when programming the setup into the display. Uncheck to hide the screen. Available on applicable displays.
Tags Tags for filtering screens in the Screens Tab and screen library views.
Favourite Marks the screen as a favourite for filtering purposes.
Duration [s] For the splash screen, the time in seconds for which it is displayed. A value of zero disables the splash screen.
Enable AA / Enable Font AA Overrides the anti-aliasing settings for gauges on this screen, where supported. Default uses the setting from the General setup page.
Defaults: Background, Line, Fill, Text, Warning, Font The default colours and font for gauges added to this screen.

Alarm and on-change screens also list the logic channels and on-change channels that trigger the screen.

Multiple gauges may be selected by click & drag in the Design Area or by selecting items in the Gauge Structure tree.

When multiple gauges are selected, their Properties are merged and can be collectively edited to apply the same changes to all gauges in the selection.

Properties Copy & Paste

Properties may be copied from one gauge and pasted to another gauge using the right-click context menu on the properties list:

  • Copy “Property Name” - copies the value of the clicked property to the clipboard
  • Copy… - Select the properties to copy to the clipboard from a pop-up list of all properties for the selected gauge(s). This allows multiple properties to be copied at once.
  • Paste “Property Name” - pastes the value from the clipboard to the clicked property
  • Paste N Properties - pastes multiple properties from the clipboard to the selected gauge(s). The properties that are pasted are those that were copied from the source gauge.

View Controls

At the bottom of the Design Area are several controls:

Screen Selector

Click the Screen button to pop up a list of screens similar to the Screens Tab to allow quick switching between screens. On the left and right are arrow buttons to move to the next/prior screen.

Snap To Grid

The Snap To Grid Snap toggle button enables grid snapping so that gauges can be more easily positioned on a regularly spaced grid. To the right of the Snap button, the grid spacing may be selected.

Display Scaling

To the right of the View Controls is a zoom slider which can be used to zoom-in on the screen for more precise positioning of gauges.

The zoom level is displayed as a percentage and may be entered in as a number using the keyboard.

The Fit Screen To Window Fit button may be checked to automatically set the zoom level so that the screen fills the Design Area.

Subsections of Design Tab

Standard Gauge Properties

Overview

Most gauges share a standard set of gauge properties described below. The available properties depend on the gauge type, display model and firmware support. In addition to these standard properties, many gauges have additional properties that are described in their relevant section.

Standard Properties

The standard gauge properties are as follows:

Property Description
Name The name is used to identify the gauge. Dash Design assigns a name to a new gauge automatically. The gauge is also automatically renamed when changing the gauge text for Text Label gauges or changing the Input for all other gauges. This makes it easy to identify the purpose of a gauge in any lists or editors.
Input The output used by the gauge.
Display Name An editable display name for gauges whose Name is read-only. Shown in gauge structure tree view.
Input Filter Opens the input filtering/modifier settings used to process the value before it reaches the gauge. See Filter Channel for filter types.
Input Value A design-time input value used to preview the gauge’s appearance. This is a preview control, not a replacement for the assigned input on the display.
Visibility Input The output used to control whether the gauge is shown. A value of zero hides the gauge; any non-zero value shows it. When assigned, this input overrides the Visible flag. When no visibility input is assigned, the Visible flag determines whether the gauge is shown. Available on supported displays.
Visible The visibility flag used when no Visibility Input is assigned. Enabled by default: enable it to show the gauge or disable it to hide the gauge. Available on supported displays.
Minimum The value at which a gauge starts, for example the start value of a bar gauge.
Maximum The value at which a gauge finishes, for example the end value of a bar gauge.
Resolution The resolution of the bar or tacho gauge. This is the value change that will move the bar or tacho to the next segment.
Label Frequency Labels are drawn at every Label Frequency multiplied by the resolution.
Label Divisor Divides tacho label values before displaying them. For example, a divisor of 1000 displays 8000 as 8.
Label Font The font used for tacho labels. See Font Editor .
Label Colour The colour of tacho labels.
Font The font used by the gauge. See Font Editor . The Font property also allows changing the size and style of the font in-place.
Justify Aligns text to the left, right or centre of the gauge’s bounding rectangle.
Direction Controls text orientation or the direction in which gauge elements are arranged. The available choices depend on the gauge type; see Label Gauge and Bit Gauge .
Enable AA Enables anti-aliasing to reduce jagged edges when drawing the gauge. The default inherits the screen setting, which in turn inherits the General display setting. Anti-aliasing may affect performance on some displays.
Format Determines how numbers are formatted in the gauge. See the Value Formatting section for more information.
Special Format Displays internal system values. See the Value Formatting section for more information.
Left The left most (x) position of the gauge.
Top The top most (y) position of the gauge.
Width The width of the gauge. Some gauges are sized implicitly on their contents in which case the Width property will not be available.
Height The height of the gauge. Some gauges are sized implicitly on their contents in which case the Height property will not be available.
Background Colour of the gauge background.
Transparent Background Makes the gauge background transparent so that content behind it remains visible.
Background Gradient Sets a gradient for the background of supported bar gauges instead of a single background colour.
Line Colour of the graticules and/or outline of the gauge.
Fill Colour in which to draw a filled part of the gauge, for example the part of a bar graph that has data.
Fill Gradient Sets a gradient for the filled part of supported bar gauges instead of a single fill colour.
Text Colour of all text in the gauge.
Colour Mode Selects input-driven or alarm-based colouring where supported. The associated Colour Input, Colour Preview, Alarm Limit, Alarm Colour and Alarm Flash controls depend on the mode. See Value Gauge .
Colour Source, Colour Map, Colour Preview Control input-driven colouring on displays with the shared colour controller. See Colour Source.

Colour Source

On supported gauges and displays, the shared colour controller provides a colour source and up to four warning levels. These settings are separate from the older Colour Mode controls described for individual gauge types.

Property Description
Colour Source Selects the channel that drives the gauge colour. Without a Colour Map, its value is interpreted as an RGB colour. The gauge’s fixed fill setting(s) are used until a colour source value has been received.
Colour Map Maps the colour source value through a colour gradient, allowing an ordinary numeric channel to control the colour. Available when a Colour Source is assigned.
Colour Preview Supplies a design-time colour source value to preview the resulting colour. Available when a Colour Source is assigned.

Warning Levels

The shared colour controller provides Warning 1 through Warning 4. Each level compares its own source channel against a threshold and applies a warning colour when the comparison is true. Higher-numbered warnings take priority over lower-numbered warnings: Warning 1 has the lowest priority and Warning 4 the highest.

Assign a Source to configure a warning level. Its comparison, colour, flash and preview controls are available once a source is assigned.

Property Description
Source The channel whose value is compared with the warning threshold.
Priority Read-only information identifying Warning 1 as the lowest-priority level and Warning 4 as the highest-priority level.
Comparator The comparison operator used to test the source value against the threshold.
Threshold The value against which the warning source is compared.
Tolerance Allows for small floating-point inaccuracies when comparing values.
Colour The gauge colour used while this warning is active.
Flash Rate [ms] A positive value makes the warning colour flash at the specified rate in milliseconds. Zero disables flashing.
Preview A design-time warning source value used to preview the warning’s effect.

Value Formatting

Format Gauge Property

Many gauges can use a Format property in order to control how values are displayed.

The following table shows the standard formatting characters that can be used:

Character Description Notes
X or x Display in hexadecimal Must be first character in format
B or b Display in binary Must be first character in format
- Force leading sign character e.g. +5.3 is displayed instead of 5.3
# Indicates an optional digit e.g. ### gives 93
9 Indicates a required digit e.g. 999 gives 093
5 Indicates rounding to the nearest 5 e.g. ##5# gives 2450 instead of 2448
0 Indicates rounding to the nearest 10 e.g. ##0# gives 2400 instead of 2448
. Indicates position of decimal place

Time Formats

Gauges using time outputs use a different set of format strings:

Character Description
H Displays the hours in 24 hour format.
h Displays the hours in 12 hour format.
m Displays the minutes.
M Displays the total minutes (including hours) if there is no preceding h or H in the format string.
s Displays the seconds.
S Displays the total seconds (including hours and minutes) if there is no preceding m or M in the format string.
f Displays tenths of seconds.
ff Displays hundredths of seconds.
fff Displays thousandths of seconds (only works for lap time via CAN).
y Displays the date in dd-mm-yy format
z Displays the date with text for the month, eg 01 Jan 09

Example Time Formats

Format Output Example
Hms 24:00:00
hmsf 12:00:00.0
hmsff 12:00:00.00
y 01-01-09
hmsz 12:00:00 01 Jan 09

For an example of the total minutes or total seconds formatting (typically used with stopwatches or lap times) consider a stopwatch at 1h02m03s.45. The following results can be obtained:

Format Output Example
hmsf 01:02:03.45
msf 02:03.45
Msf 62:03.45
sf 03.45
Sf 3723.45

Special Formats / System Information

System information can be shown by adding a value gauge to the screen and setting the Format property as follows:

Special Format Format Description
Serial Number vs Shows the serial number of the display.
Version Number vv Shows the version of the colour display firmware.
Setup Name vz Shows the setup name, if set. See Setup Name .
Log Support vl Shows the logger status (see below).
Usage Hours vu Shows the usage (on time) of the display in hours.
Reset Count vr Shows the reset counter - the number of power on events since the last setup upload.
File Name vc Shows the filename of the setup file used to program the display (up to 24 characters).
Frame Rate va Shows the number of times the screen is being refreshed per second (frames per second), in the form “fps:xx”.
Processor Speed vp Shows the CPU clock speed / Memory Bus Speed. Not available on all displays.
FRAM Size vf Shows the size of the Ferromagnetic RAM as “FRAM xxxKb”.
Boot Version vw Shows the version of the display boot loader.
PCB Serial vg Shows the serial number of the PCB, which may differ from Serial Number. Not supported by all display types.
Network Status vn For ethernet enabled displays, shows the network status. IP address (e.g. NET 192.168.0.99), if connected.

Other possible values:
  • NET Initialising
  • NET ERROR
  • NET Link Down
  • NET {ip address}
  • NET UNKNOWN
Client Network Status vnc For ethernet enabled displays, indicates if a client is connected over the network. e.g. NET NO CLIENT when no client connection, NET CLIENT 192.168.0.30 when there is an active client TCP connection.
Channel Name @channel Shows the name of the selected input channel. When used on a Value Gauge , Dash Design will replace the gauge with a static label. This can be useful in gauge groups where a label should show the channel name used by a value.
Channel Units @units Shows the units of the selected input channel. When used on a Value Gauge , Dash Design will replace the gauge with a static label. This can be useful in gauge groups where a label should show the channel units used by a value.

Log Support (Logger Status)

Logging Status Description
Logging not Supported This firmware does not support logging.
Logging Stopped The device is not currently logging.
Logging Running The device is currently logging.
Log Looped The log has looped.
Log Memory Space Low There is less than 5 % of the memory remaining.
Log Memory Full The logging memory is full and logging has stopped.
Log Initializing The logger is currently processing the setup.
Log Setup Error There is a problem with the logger setup.
Log Overrun Reduce the # of channels or the screen complexity.
Log Memory Worn Flash worn, Log will continue at reduced capacity.

Gauge Z-Order

Overview

The gauges on a screen are drawn (rendered) in a specific order. If gauges overlap then the gauge that was drawn first will be overdrawn by the next one. This ordering is referred to as the Z-order.

If the horizontal position of gauges is considered to be the X-axis and the vertical position the Y-axis, then the Z-axis is the depth (i.e. drawing order).

Changing the Z-Order

The Z order can be changed using menu commands and by using the Gauge Structure Tree.

Using menu commands

Command Description
Edit | Bring Forward Moves the selected gauge(s) forward (drawn later) by 1 step
Edit | Send Back Moves the selected gauge(s) backward (drawn earlier) by 1 step
Edit | Bring to Front Moves the selected gauge(s) forward as far as possible (drawn last)
Edit | Send to Back Moves the selected gauge(s) backward as far as possible (drawn first)
Tip

If frequently using these commands, custom keyboard shortcuts may be assigned to them.

Using the Gauge Structure Tree

The Gauge Structure Tree indicates the Z-order, with items at the top of the list being rendered ‘below’ items further down the list.

The Z-order may be modified by dragging items in the Gauge Structure Tree to the desired position.

Gauge Groups

Overview

Gauge Icon Gauges may be grouped together so that they are collectively edited as a group.

Creating Gauge Groups

Select gauges in the Design Area or in the Gauge Structure Tree, either use the right-click context menu or the command Edit | Group Ctrl + G.

Groups may be ungrouped using the command Edit | Ungroup Ctrl + Shift + G.

Properties

The properties of groups are merged from the gauges within the group and edited collectively.

Tip

Use Value Gauge with special formats to display the input Channel Name / Channel Units specified on the group.

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