Performance Gauge

The Performance Gauge provides a means to automatically start and stop a timer through a pair of threshold settings, which are set against a chosen attribute. For example, you can implement a 0-60 timer by creating a performance gauge with the attribute set to ‘speedmph’, the start threshold set to 1 and the stop threshold set to 60. Obviously, for such a gauge to work you need a valid speed signal either from a VSS via your Speeduino, a Canbus based VSS, or a GPS based one.

Example:

<gauge>
    <name>ZEROSIXTY</name>
    <type>PerformanceGauge</type>
    <attribute>speedmph</attribute>
    <x>100</x>
    <y>500</y>
    <w>50</w>
    <h>50</h>
    <min>0</min>
    <max>40</max>
    <initial>0</initial>
    <visible>1</visible>
    <colours>255,255,255,255,255,255</colours>
    <fontsize>30</fontsize>
    <startthreshold>1</startthreshold>
    <stopthreshold>60</stopthreshold>
    <autoresettimeoutsecs>0</autoresettimeoutsecs>
</gauge>

Property	Mandatory?	Value Type	Description
attribute	Yes	string	The name of the attribute to use to trigger the timer
timerid	Yes	Integer	The id of this timer. Every timer you create should have a unique ID so that it can be identified when using touch actions or sending canbus commands to control it
startthreshold	Yes	Integer	The value of the attribute which should be used to start the timer. When the attribute’s value becomes equal to the startthreshold, the timer will start. In the case of speed, a 0-60 timer should use ‘1’ for the starthreshold, otherwise the timer would start when the car is stood still.
stopthreshold	Yes	Integer	The value of the attribute which should be used to stop the timer. In a 0-60 timer you should use 60 for this property.
x	Yes	Integer	The x coordinate of the bottom left of the gauge
y	Yes	Integer	The y coordinate of the bottom left of the gauge
w	Yes	Integer	The width of the gauge in pixels
h	Yes	Integer	The height of the gauge in pixels
colours	Yes	String	Standard colour string, used to draw the radar outline.
fontsize	Yes	Integer	The font size for the timer
font	No	string	The name of the font to use. Leave blank for the default font

Performance gauges can be reset using the ‘RESETPERFTIMER’ touch action. For this you require a touch screen, a rotary encoder, or an external canbus message.