====== API: Gauge Controls ======

API Reference for gauges and indicators.

===== TWvdSCircularGauge =====

Circular analog gauge.

==== Namespace ====

''WvdS.UI.Controls.Gauges''

==== PXAML ====

<code xml>
<CircularGauge Value="{Binding Speed}"
               Minimum="0" Maximum="200"
               StartAngle="-135" EndAngle="135">
  <CircularGauge.Ranges>
    <GaugeRange StartValue="0" EndValue="60" Color="Green" />
    <GaugeRange StartValue="60" EndValue="120" Color="Yellow" />
    <GaugeRange StartValue="120" EndValue="200" Color="Red" />
  </CircularGauge.Ranges>
</CircularGauge>
</code>

==== Properties ====

| Property | Type | Default | Description |
^ Value | Double | 0 | Current value |
^ Minimum | Double | 0 | Minimum value |
^ Maximum | Double | 100 | Maximum value |
^ StartAngle | Double | -135 | Start angle (degrees) |
^ EndAngle | Double | 135 | End angle (degrees) |
^ Ranges | TGaugeRangeCollection | nil | Value ranges |
^ ShowValue | Boolean | True | Show value |
^ ValueFormat | string | '0' | Value format |
^ NeedleColor | TWvdSColor | clRed | Needle color |

==== TUI Rendering ====

<code>
TUI representation (ASCII):
    .-"""-.
   /  120  \
  |    ^    |
   \  ___  /
    '-...-'
</code>

----

===== TWvdSLinearGauge =====

Linear bar gauge.

==== Namespace ====

''WvdS.UI.Controls.Gauges''

==== PXAML ====

<code xml>
<LinearGauge Value="{Binding Temperature}"
             Minimum="-20" Maximum="50"
             Orientation="Vertical">
  <LinearGauge.Ranges>
    <GaugeRange StartValue="-20" EndValue="0" Color="Blue" />
    <GaugeRange StartValue="0" EndValue="30" Color="Green" />
    <GaugeRange StartValue="30" EndValue="50" Color="Red" />
  </LinearGauge.Ranges>
</LinearGauge>
</code>

==== Properties ====

| Property | Type | Default | Description |
^ Value | Double | 0 | Current value |
^ Minimum | Double | 0 | Minimum value |
^ Maximum | Double | 100 | Maximum value |
^ Orientation | TWvdSOrientation | oHorizontal | Orientation |
^ ShowMarker | Boolean | True | Show marker |
^ MarkerStyle | TMarkerStyle | msTriangle | Marker style |

----

===== TWvdSDigitalGauge =====

Digital 7-segment display.

==== Namespace ====

''WvdS.UI.Controls.Gauges''

==== PXAML ====

<code xml>
<DigitalGauge Value="{Binding Counter}"
              DigitCount="6"
              ShowLeadingZeros="True" />
</code>

==== Properties ====

| Property | Type | Default | Description |
^ Value | Double | 0 | Value to display |
^ Text | string | '' | Text to display |
^ DigitCount | Integer | 4 | Number of digits |
^ ShowLeadingZeros | Boolean | False | Leading zeros |
^ SegmentColor | TWvdSColor | clGreen | Segment color |
^ BackgroundColor | TWvdSColor | clBlack | Background |

==== TUI Rendering ====

<code>
 ####  ####  ####  ####
   ##    ##    ##    ##
 ####  ####  ####  ####
 ##      ##    ##    ##
 ####  ####  ####  ####
</code>

----

===== TWvdSStateIndicator =====

State indicator (traffic light).

==== Namespace ====

''WvdS.UI.Controls.Gauges''

==== PXAML ====

<code xml>
<StateIndicator State="{Binding MachineState}">
  <StateIndicator.States>
    <IndicatorState Name="Off" Color="Gray" />
    <IndicatorState Name="Running" Color="Green" />
    <IndicatorState Name="Warning" Color="Yellow" />
    <IndicatorState Name="Error" Color="Red" Blink="True" />
  </StateIndicator.States>
</StateIndicator>
</code>

==== Properties ====

| Property | Type | Default | Description |
^ State | string | '' | Current state |
^ States | TIndicatorStateCollection | nil | State definitions |
^ Shape | TIndicatorShape | isCircle | Circle, Square, Triangle |
^ Size | Integer | 24 | Size in pixels |

----

===== TWvdSLED =====

Simple LED indicator.

==== Namespace ====

''WvdS.UI.Controls.Gauges''

==== PXAML ====

<code xml>
<LED IsOn="{Binding IsConnected}"
     OnColor="Green" OffColor="DarkGreen"
     Size="16" />
</code>

==== Properties ====

| Property | Type | Default | Description |
^ IsOn | Boolean | False | On/Off |
^ OnColor | TWvdSColor | clGreen | On color |
^ OffColor | TWvdSColor | clDarkGray | Off color |
^ Blink | Boolean | False | Blinking |
^ BlinkInterval | Integer | 500 | Blink interval (ms) |

----

===== TWvdSArcScaleGauge =====

Arc-shaped scale gauge.

==== Namespace ====

''WvdS.UI.Controls.Gauges''

==== PXAML ====

<code xml>
<ArcScaleGauge Value="{Binding Pressure}"
               Minimum="0" Maximum="100"
               ArcThickness="20" />
</code>

==== Properties ====

| Property | Type | Default | Description |
^ ArcThickness | Integer | 10 | Arc thickness |
^ StartAngle | Double | -180 | Start angle |
^ SweepAngle | Double | 180 | Arc angle |

----

===== TWvdSScaleIndicator =====

Scale-based indicator.

==== Namespace ====

''WvdS.UI.Controls.Gauges''

==== PXAML ====

<code xml>
<ScaleIndicator Value="{Binding Level}"
                ScaleType="Logarithmic"
                TickCount="10" />
</code>

==== Properties ====

| Property | Type | Default | Description |
^ ScaleType | TScaleType | stLinear | Linear, Logarithmic |
^ TickCount | Integer | 5 | Number of ticks |
^ ShowLabels | Boolean | True | Show labels |

----

===== TWvdSLevelBar =====

Level indicator.

==== Namespace ====

''WvdS.UI.Controls.Gauges''

==== PXAML ====

<code xml>
<LevelBar Value="{Binding FillLevel}"
          Minimum="0" Maximum="100"
          Orientation="Vertical"
          ShowPercentage="True" />
</code>

==== Properties ====

| Property | Type | Default | Description |
^ Value | Double | 0 | Fill level |
^ Minimum | Double | 0 | Minimum |
^ Maximum | Double | 100 | Maximum |
^ Orientation | TWvdSOrientation | oVertical | Orientation |
^ FillColor | TWvdSColor | clBlue | Fill color |
^ ShowPercentage | Boolean | True | Show percentage |

==== TUI Rendering ====

<code>
+----+
|####| 80%
|####|
|####|
|####|
|    |
+----+
</code>

----

===== TWvdSProgressGauge =====

Ring-shaped progress indicator.

==== Namespace ====

''WvdS.UI.Controls.Gauges''

==== PXAML ====

<code xml>
<ProgressGauge Value="{Binding Progress}"
               Maximum="100"
               Thickness="10"
               ShowPercentage="True" />
</code>

==== Properties ====

| Property | Type | Default | Description |
^ Value | Double | 0 | Progress |
^ Maximum | Double | 100 | Maximum |
^ Thickness | Integer | 8 | Ring thickness |
^ TrackColor | TWvdSColor | clLightGray | Background |
^ ProgressColor | TWvdSColor | clBlue | Progress color |

----

===== TWvdSThermometer =====

Thermometer display.

==== Namespace ====

''WvdS.UI.Controls.Gauges''

==== PXAML ====

<code xml>
<Thermometer Value="{Binding Temperature}"
             Minimum="-20" Maximum="50"
             Unit="C"
             ShowBulb="True" />
</code>

==== Properties ====

| Property | Type | Default | Description |
^ Value | Double | 0 | Temperature |
^ Minimum | Double | -20 | Minimum |
^ Maximum | Double | 50 | Maximum |
^ Unit | string | 'C' | Unit |
^ ShowBulb | Boolean | True | Show bulb |
^ MercuryColor | TWvdSColor | clRed | Mercury color |

==== TUI Rendering ====

<code>
 ^ 50
 |
 # 30
 #
 # 10
 |
 v-20
 o
</code>

----

===== See Also =====

  * [[.:control-bibliothek|Control Library]]
  * [[.:api-controls-charts|Charts API]]
  * [[.:tui-controls|TUI Controls]]