Siticone Logo
Siticone UI
DOCS
v2025.12.15
Docs Quantix Gauge

Siticone Quantix Gauge

The SiticoneQuantixGauge is a state-of-the-art circular meter offering maximum control over visual styles. It supports gradient needles, multiple easing animations (Bounce, Elastic), and complex tick mark styles (Diamond, Circle, Line).

Values & Scale

Core properties for setting the gauge's measurement.

Property Type Description & Usage Example
Value double quantix.Value = 65.0; The current reading. Triggers smooth animation when changed.
MinimumValue double quantix.MinimumValue = 0; The starting value of the scale.
MaximumValue double quantix.MaximumValue = 100; The ending value of the scale.

Appearance & Style

Customize colors, gradients, and visual themes.

Property Type Description & Usage Example
DesignStyle DesignStyle quantix.DesignStyle = AdvancedGaugeDesignStyle.Modern; Presets: Modern, Classic, Minimal, Industrial, Futuristic.
NeedleStyle NeedleStyle quantix.NeedleStyle = AdvancedGaugeNeedleStyle.Sleek; Needle shapes: Arrow, Line, Triangular, Diamond, Sleek.
EnableNeedleGradient bool quantix.EnableNeedleGradient = true; Applies a gradient fill to the needle for depth.
EnableRimGradient bool quantix.EnableRimGradient = true; Adds a gradient to the outer rim.

Animation Physics

Control the motion of the needle with easing functions.

Property Type Description & Usage Example
AnimationMode AnimationMode quantix.AnimationMode = AdvancedGaugeAnimationMode.Elastic; Linear, EaseOut, Bounce, Elastic, Spring.
AnimationSpeed double quantix.AnimationSpeed = 0.15; Speed factor (0.01 to 1.0).
Damping double quantix.Damping = 0.85; Physics damping for spring/bounce effects.

Public Methods

SetValueWithAnimation(double, AnimationMode)
// Sets value with a specific one-time animation effect.
quantix.SetValueWithAnimation(85, AdvancedGaugeAnimationMode.Bounce);
AddZone(string, double, double, Color)
// Adds a colored zone to the scale.
quantix.AddZone("Redline", 80, 100, Color.Red);
AddCustomTick(double, string, bool)
// Adds a specific tick mark at a value.
quantix.AddCustomTick(50, "Half", true);

Events

Events Wiring
// 1. ValueChanged Event
quantix.ValueChanged += (s, e) => 
{
                Console.WriteLine($"Value: {e.NewValue}");
};

// 2. ZoneChanged Event
quantix.ZoneChanged += (s, e) => 
{
                if (e.IsEntering)
                MessageBox.Show($"Entered {e.Zone.Name}");
};

Designer & Smart Tags

Visual Studio integration.

Feature Description
Quick Themes Ocean Blue: Professional blue theme.
Sunset Orange: Warm gradient.
Forest Green: Nature inspired.
Cyberpunk: High contrast neon.
Testing Test Animation: Cycles through animation modes.
Test Zones: Moves needle through zones.

Detailed Usage Examples

Example 1: Performance Dashboard

A modern gauge with smooth elasticity for CPU load.

C# - Elastic Gauge
private void SetupCpuGauge()
{
    quantix.DesignStyle = AdvancedGaugeDesignStyle.Modern;
    quantix.AnimationMode = AdvancedGaugeAnimationMode.Elastic;
    quantix.TitleText = "CPU Load";
    quantix.UnitLabel = "%";
    
                // Visuals
    quantix.NeedleColor = Color.DodgerBlue;
    quantix.EnableNeedleGradient = true;
    quantix.EnableNeedleGlow = true;
}

Example 2: Retro Analog Meter

Configures the gauge to look like a vintage instrument using the Retro style.

C# - Retro Style
private void SetupRetroMeter()
{
    quantix.DesignStyle = AdvancedGaugeDesignStyle.Retro;
    quantix.NeedleStyle = AdvancedGaugeNeedleStyle.Arrow;
    quantix.GaugeBackColor = Color.Beige;
    quantix.ScaleColor = Color.Black;
    
                // Disable modern effects
    quantix.EnableGlassEffect = false;
    quantix.EnableNeedleGlow = false;
}