Channel List
The Channel List provides a customisable list of available channels. This is useful to group similar channels or those which are used together. The Channel List works in the same way as the Option Selection List, just for channels not options. For how to add objects see the Adding an Object section.
When the ECU is offline, the values in the Channel List are greyed out.
Adding Channels
When a Channel List is added you be shown a blank list with a single blank entry:


To add an channel simply start typing the name of the channel and GWv4 will provide a list of likely options or click the ‘…’ button and you will be shown a list of all available channels. Select the channel you want to display and click ‘OK’. This will add the selected channel to the list and provide a new blank entry from which to select another channel:


Adding Multiple Channels
From the channel selection list you can add multiple channels. Click on the ‘…’ button to bring up the available channels, then either click and drag over the channels, or use mouse click and either Shift or Ctrl keys to select separate items.
Once selected, click ‘OK’ and the items will be added to your selection list:


Setting up Limits
For each channel displayed you can set up limits. This can either be to set the range of values (view range) displayed by the bar or to set warnings if the value goes above or below certain values (alarm range). Right click on the channel in the list you want to set a limit for and click on limits, alternatively simply use the keyboard shortcut Alt+L and the following window will be displayed:


The view range, and alarm range can then be set for the channel. If set then they will automatically be enabled, though they can be disabled again by simply un-ticking the enable box.
If the channel then goes out of the alarm range, the channel will go red, as can be seen in the Bar section.
Locking the list
The list can be locked by clicking on the padlock icon in its title bar. This prevents items being added or removed from the list.
View Properties
Properties editable via the properties editor.
Property | Script ID | Description |
---|---|---|
Title | title |
The title of the window. |
Script ID | id |
The scripting ID of the window. Can be used as an alternative to the title for searching for windows from scripts. |
Tool Tip | tooltip |
Window tool tip. |
Display Units | display_units_text |
Show units after the number on the view. |
Display Units (Label) | display_units_label |
Show units after the label on the view. |
Prefix Text | prefix_text |
Text to display before the value. |
Postfix Text | postfix_text |
Text to display after the value. |
Limits | limits |
Set up alarm limits for this gauge. |
Show Value | show_value |
|
Show Label | show_label |
|
Label Font | label_font |
|
Value Font | value_font |
|
Value Height % | value_height_percent |
A value of zero disables auto font size fitting if Value Height Max is set |
Value Height Max [dp] | value_height_max_dp |
Maximum font height of the value text, in device pixels |
Label Height % | label_height_percent |
|
Label Height Max [dp] | label_height_max_dp |
Maximum font height of the label, in device pixels |
Label Text | label_text |
|
Label Align | label_align |
|
Label Vertical Align | label_valign |
|
Value Align | value_align |
|
Value Vertical Align | value_valign |
|
Low Limit Text | low_limit_text |
|
High Limit Text | high_limit_text |
|
Value Override Text | value_text |
|
Max length Text | max_length_text |
Leave blank for auto |
Background | bg_colour |
Background colour |
Text | text_colour |
Text colour |
Alarm Low Background | alarm_low_bg_colour |
Alarm Lower Limit Background colour |
Alarm Low Text | alarm_low_text_colour |
Alarm Lower Limit Text colour |
Alarm High Background | alarm_high_bg_colour |
Alarm Upper Limit Background colour |
Alarm High Text | alarm_high_text_colour |
Alarm Upper Limit Text colour |
Input Value | parameter |
The source of the value that will be displayed by the gauge. |
Update Rate | update_rate |
Rate at which the input value is requested from the ECU. |
Decimal Places | decimal_places |
Set to -1 for auto |