Siticone Logo
Siticone UI
DOCS
v2025.12.15
Docs Velocity Gauge

Siticone Velocity Gauge

The SiticoneVelocityGauge is a premium high-performance speedometer control designed for automotive and industrial dashboards. It features fluid needle animation, a digital odometer, customizable ticks, and a glowing center hub. It also includes an "UltraFastMode" for high-frequency updates where rendering speed is critical.

Appearance & Theme

Visual settings to control the gauge face, needle, and color schemes.

Property Type Description & Usage Example
VelocityTheme Enum gauge.VelocityTheme = VelocityGaugeTheme.Cyan; Built-in themes: Purple, Blue, Green, Orange, Red, Cyan, White.
GaugeBackgroundColor Color gauge.GaugeBackgroundColor = Color.Black;
RimColor Color gauge.RimColor = Color.Silver;
ShowRimBorder bool gauge.ShowRimBorder = true;
GlowColor Color gauge.GlowColor = Color.Cyan;
ShowGlowEffect bool gauge.ShowGlowEffect = true;
GlowIntensity float gauge.GlowIntensity = 1.5f;
NeedleStyle Enum gauge.NeedleStyle = VelocityNeedleStyle.Blade; Needle shape: Classic, Modern, Sleek, Minimal, Blade.
NeedleColor Color gauge.NeedleColor = Color.Red;
ShowCenterCircle bool gauge.ShowCenterCircle = true;

Data & Values

Configuring the speed range, current value, and digital readouts.

Property Type Description & Usage Example
SpeedValue float gauge.SpeedValue = 120; Current speed. Setting this triggers animation unless disabled.
MinimumSpeed float gauge.MinimumSpeed = 0;
MaximumSpeed float gauge.MaximumSpeed = 240;
OdometerValue long gauge.OdometerValue = 123456;
ShowOdometer bool gauge.ShowOdometer = true;
ShowDigitalSpeed bool gauge.ShowDigitalSpeed = true;
SpeedUnitText string gauge.SpeedUnitText = "km/h";
GaugeTitle string gauge.GaugeTitle = "VELOCITY";
DecimalPlaces int gauge.DecimalPlaces = 1;

Scale Configuration

Settings for the tick marks and labels around the gauge.

Property Type Description & Usage Example
MajorTickDivisions int gauge.MajorTickDivisions = 12;
MinorTickDivisions int gauge.MinorTickDivisions = 4;
ScaleStartAngle int gauge.ScaleStartAngle = 135;
ScaleSweepAngle int gauge.ScaleSweepAngle = 270;
ShowSpeedLabels bool gauge.ShowSpeedLabels = true;
ScaleTextColor Color gauge.ScaleTextColor = Color.White;

Performance & Animation

Optimize rendering and control visual feedback.

Property Type Description & Usage Example
UltraFastMode bool gauge.UltraFastMode = true; Disables glow, pulse, and smooth animation for maximum FPS. Ideal for embedded systems or high-frequency updates.
EnableFluidAnimation bool gauge.EnableFluidAnimation = true;
AnimationVelocity int gauge.AnimationVelocity = 25;
EnablePulseEffect bool gauge.EnablePulseEffect = true;

Public Methods

Programmatic Control
// Set speed with optional animation
// animate: true for smooth transition, false for instant jump
velocityGauge1.SetSpeed(120, true);

// Increment current speed
velocityGauge1.AddSpeed(10, true);

// Reset to minimum value
velocityGauge1.Reset(true);

Events

Event Handling
velocityGauge1.SpeedChanged += (s, e) => 
{
                Console.WriteLine($"Speed changed: {e.OldSpeed} -> {e.NewSpeed}");
};

velocityGauge1.AnimationCompleted += (s, e) =>
{
                Console.WriteLine("Needle stabilized.");
};

Example: Racing Dashboard

C# Setup
private void InitRacingGauge()
{
                // Theme
    velocityGauge1.VelocityTheme = VelocityGaugeTheme.Red;
    velocityGauge1.NeedleStyle = VelocityNeedleStyle.Blade;
    
                // Scale
    velocityGauge1.MinimumSpeed = 0;
    velocityGauge1.MaximumSpeed = 300;
    velocityGauge1.MajorTickDivisions = 15;
    velocityGauge1.SpeedUnitText = "KM/H";
    
                // Visuals
    velocityGauge1.ShowGlowEffect = true;
    velocityGauge1.GlowIntensity = 1.5f;
    velocityGauge1.EnablePulseEffect = true;
    
                // Data
    velocityGauge1.OdometerValue = 15420;
    velocityGauge1.SetSpeed(0, false);
}