Siticone Chrono Gauge

The SiticoneChronoGauge is a racing-inspired, high-performance semicircular gauge. It combines a digital readout with an analog arc, designed for applications requiring modern, high-contrast data visualization such as automotive dashboards, performance tuning tools, and gaming overlays.

Values & Behavior

Core properties for managing the gauge's data and range.

Property	Type	Description & Usage Example
`Value`	float	chrono.Value = 88.5f; The current value displayed. Setting this triggers a smooth animation to the new value (if enabled).
`Minimum`	float	chrono.Minimum = 0; The starting value of the scale.
`Maximum`	float	chrono.Maximum = 200; The ending value of the scale.

Appearance & Themes

Visual customization using built-in themes or individual color properties.

Property	Type	Description & Usage Example
`Theme`	ChronoGaugeTheme	chrono.Theme = ChronoGaugeTheme.Carbon; Applies a predefined color scheme. Options: `Midnight`, `Titanium`, `Carbon`, `Bronze`, `Cobalt`, `Aurora`, `Inferno`, `Monochrome`.
`TrackColor`	Color	chrono.TrackColor = Color.DarkGray; Color of the background arc track.
`ProgressColor`	Color	chrono.ProgressColor = Color.Cyan; The starting color of the filled progress arc.
`ProgressEndColor`	Color	chrono.ProgressEndColor = Color.Blue; The ending color of the filled progress arc (for gradients).
`IndicatorColor`	Color	chrono.IndicatorColor = Color.White; Color of the moving tip indicator.
`InfoBoxBackColor`	Color	chrono.InfoBoxBackColor = Color.Black; Background color of the digital value readout box.

Text & Formatting

Settings for the digital display and units.

Property	Type	Description & Usage Example
`ValueUnit`	string	chrono.ValueUnit = "MPH"; The unit label displayed below the value.
`ValueFormat`	string	chrono.ValueFormat = "F0"; Standard numeric format string (e.g., "F1" for 1 decimal).
`ValueFont`	Font	chrono.ValueFont = new Font("Segoe UI", 24); Font for the main digital readout.
`UnitFont`	Font	chrono.UnitFont = new Font("Segoe UI", 10); Font for the unit label.
`TextColor`	Color	chrono.TextColor = Color.White; Color for all text elements.

Animation & Performance

Control the smoothness and rendering quality.

Property	Type	Description & Usage Example
`EnableAnimation`	bool	chrono.EnableAnimation = true; Enables smooth interpolation between values.
`AnimationSpeed`	int	chrono.AnimationSpeed = 50; Speed of the value transition (1-100).
`UltraFastPerformance`	bool	chrono.UltraFastPerformance = true; Disables gradients and glow effects for maximum frame rate. Useful for rapid data streams.

Events

Events Wiring

// 1. ValueChanged Event
// Fires when the Value property is updated.
chronoGauge.ValueChanged += (s, e) => 
{
                Console.WriteLine("Value Updated");
};

// 2. AnimationCompleted Event
// Fires when the indicator reaches the target value.
chronoGauge.AnimationCompleted += (s, e) => 
{
                if (chronoGauge.Value >= chronoGauge.Maximum)
    {
                MessageBox.Show("Max Speed Reached!");
    }
};

Designer & Smart Tags

Visual Studio Designer features for rapid configuration.

Feature	Description
`Theme Presets`	Instantly switch between styles: Midnight: Dark blue/purple aesthetic. Titanium: Silver/metallic look. Carbon: Dark grey with red accents. Inferno: Red/Orange fiery style.
`Quick Config`	Easily set Value Unit, Value Format, and Animation Speed from the smart tag panel.

Detailed Usage Examples

Example 1: Automotive Speedometer

Creates a high-contrast speedometer using the Carbon theme.

C# - Speedometer

private void SetupSpeedometer()
{
    speedGauge.Theme = ChronoGaugeTheme.Carbon;
    speedGauge.Minimum = 0;
    speedGauge.Maximum = 220;
    speedGauge.ValueUnit = "KM/H";
    speedGauge.ValueFormat = "F0"; // No decimals
    
                // Animation
    speedGauge.EnableAnimation = true;
    speedGauge.AnimationSpeed = 60;
}

public void UpdateSpeed(float speed)
{
    speedGauge.Value = speed;
}

Example 2: Turbo Boost Gauge

A pressure gauge using the Cobalt theme with a custom range.

C# - Boost Gauge

private void SetupBoostGauge()
{
    boostGauge.Theme = ChronoGaugeTheme.Cobalt;
    boostGauge.Minimum = -30; // Vacuum
    boostGauge.Maximum = 30;  // Boost
    boostGauge.ValueUnit = "PSI";
    
                // Custom Colors
    boostGauge.ProgressColor = Color.DeepSkyBlue;
    boostGauge.ProgressEndColor = Color.Cyan;
}

Example 3: High-Performance RPM

Uses UltraFastPerformance for real-time, lag-free updates suitable for rapidly changing data like engine RPM.

C# - RPM Gauge

private void SetupRpmGauge()
{
    rpmGauge.Theme = ChronoGaugeTheme.Inferno;
    rpmGauge.Maximum = 9000;
    rpmGauge.ValueUnit = "RPM";
    
                // Optimize for speed
    rpmGauge.UltraFastPerformance = true; 
}

// Called frequently (e.g., 60 times/sec)
public void OnRpmUpdate(float currentRpm)
{
                // Updates instantly without animation lag
    rpmGauge.Value = currentRpm;
}