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

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 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 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:
|
| 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 |
|---|---|
| Moves the selected gauge(s) forward (drawn later) by 1 step | |
| Moves the selected gauge(s) backward (drawn earlier) by 1 step | |
| Moves the selected gauge(s) forward as far as possible (drawn last) | |
| 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
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 Ctrl + G.
Groups may be ungrouped using the command 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
- Animation Gauge
- Arc Gauge
- Bar Gauges
- Bit Gauge
- Camera Gauge
- Cross-Hair Gauge
- File Explorer Gauge
- Graph Gauge
- Image Gauge
- Label Gauge
- Limiter Gauge
- Menu Gauge
- Needle Gauge
- Shape Gauge
- Tacho Gauges
- Text Input Gauge
- Text Message Gauge
- Value Gauge
- Warning Gauge
Gauge Support Matrix
| Gauge | CD34 | LDS4 | CD32 | LDS35 | LDS35_L | CD6 | GLW-43 | LFRW-43 | ZDU-L | ZDU-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
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
| Display | Supported? |
|---|---|
| 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
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
| Display | Supported? |
|---|---|
| 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:
Vertical Triangular
Horizontal Triangular
Vertical Rectangular
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
| Display | Supported? |
|---|---|
| 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
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
| Display | Supported? |
|---|---|
| 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
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
| Display | Supported? |
|---|---|
| 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
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
| Display | Supported? |
|---|---|
| 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
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
| Display | Supported? |
|---|---|
| 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
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
| Display | Supported? |
|---|---|
| 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
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 button.
Use the … button to select from all Image and Image Selector assets in the setup.
Use the Reload button to update / reload the selected image asset from disk.
Use the 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
| Display | Supported? |
|---|---|
| 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
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.
|
| Justification | Specifies whether the text is aligned to the left, right or centre of the bounding rectangle. |
Display Support
| Display | Supported? |
|---|---|
| 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
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
| Display | Supported? |
|---|---|
| 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
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. |
Menu Events
| 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.
Menu Items
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
| Display | Supported? |
|---|---|
| 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
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
| Display | Supported? |
|---|---|
| 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
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
| Display | Supported? |
|---|---|
| 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
Bar Tacho and
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
| Display | Supported? |
|---|---|
| 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
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
| Display | Supported? |
|---|---|
| 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
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
| Display | Supported? |
|---|---|
| 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
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
| Display | Supported? |
|---|---|
| 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
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
| Display | Supported? |
|---|---|
| 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 |