Siticone Scanner Control

The SiticoneScanner is a visually stunning, high-performance scanning UI component. It features advanced animations like sonar pulses, data bursts, and particle effects, designed for cybersecurity dashboards, system monitoring tools, and modern biometric interfaces. It supports extensive theming with over 30 presets including Cyberpunk, Neon, and Professional styles.

Core Features & Themes

Control the fundamental appearance and select from a vast library of pre-built visual styles.

Property	Type	Description & Usage Example
`SelectedTheme`	ThemePreset	scanner.SelectedTheme = ThemePreset.NeonSunset; Instantly applies a complete color scheme. Options include: `CyberBlue`, `Holographic`, `EmeraldGreen`, `CrimsonRed`, `DeepSpace`, and many more.
`IdleText`	string	scanner.IdleText = "START"; The text displayed in the center button when not scanning.
`ScanningText`	string	scanner.ScanningText = "{0}%"; Format string for displaying progress during a scan. `{0}` is replaced by the progress value.
`Progress`	int	scanner.Progress = 45; Current progress (0-100). Updates are smoothly animated.

Advanced Visual Effects

Toggle specific rendering layers to customize the complexity and style of the animation.

Property	Type	Description & Usage Example
`EnableSonarEffect`	bool	scanner.EnableSonarEffect = true; Emits expanding rings from the center, simulating a radar or sonar ping.
`EnableDataBurstEffect`	bool	scanner.EnableDataBurstEffect = true; Renders small bits of "data" flying outwards during the scan.
`EnableGlitchEffect`	bool	scanner.EnableGlitchEffect = true; Adds random visual artifacts to the ring ticks for a "hacked" or "cyber" aesthetic.
`EnableGridEffect`	bool	scanner.EnableGridEffect = true; Draws a rotating background grid for technical depth.
`EnableGlowEffect`	bool	scanner.EnableGlowEffect = true; Adds a pulsating ambient light behind the main ring.

Geometry & Layout

Fine-tune the dimensions of the scanner elements.

Property	Type	Description & Usage Example
`ProgressArcWidth`	float	scanner.ProgressArcWidth = 8f; Thickness of the progress bar arc.
`RingWidth`	float	scanner.RingWidth = 2f; Thickness of the decorative outer rings.
`TickWidth`	float	scanner.TickWidth = 3f; Thickness of the tick marks on the scale.

Control Methods

Programmatically manage the scanning state.

StartScan()

// Initiates the scanning animation and resets progress to 0.
siticoneScanner1.StartScan();

StopScan()

// Stops the scanning animation (completes the scan).
siticoneScanner1.StopScan();

CancelScan()

// Aborts the scan immediately without completing it.
siticoneScanner1.CancelScan();

Events

Event Handling

// 1. Scan Started
scanner.ScanStarted += (s, e) => 
{
    lblStatus.Text = "Scanning System...";
                StartAsyncProcess();
};

// 2. Progress Changed
scanner.ProgressChanged += (s, e) => 
{
                // e.CurrentProgress and e.TargetProgress are available
                Console.WriteLine($"Progress: {e.CurrentProgress}%");
};

// 3. Scan Completed
scanner.ScanCompleted += (s, e) => 
{
    lblStatus.Text = "System Secure";
                MessageBox.Show("Scan Finished Successfully");
};

// 4. Scan Button Click (Interception)
scanner.ScanButtonClick += (s, e) =>
{
                if (e.Starting) 
    {
                // Prevent start if conditions aren't met
                if (!CheckConnection()) e.Cancel = true;
    }
};

Detailed Usage Examples

Example 1: Antivirus Dashboard

A complete setup for a security application using the "Emerald Green" theme.

C# - Antivirus Setup

private SiticoneScanner CreateAntivirusScanner()
{
                var scanner = new SiticoneScanner
    {
        Size = new Size(300, 300),
        SelectedTheme = ThemePreset.EmeraldGreen,
        
                // Customize Text
        IdleText = "PROTECT",
        ScanningText = "checking...",
        
                // Enhance Visuals
        EnableSonarEffect = true,
        EnableDataBurstEffect = true,
        EnableGlitchEffect = false, // Keep it clean
        
                // Font Styling
        IdleFont = new Font("Segoe UI", 14f, FontStyle.Bold),
        ScanningFont = new Font("Consolas", 12f)
    };

                // Simulate scanning process
                var timer = new Timer { Interval = 100 };
    timer.Tick += (s, e) => 
    {
                if (scanner.Progress >= 100) 
        {
            timer.Stop();
            scanner.StopScan();
        }
                else
        {
            scanner.Progress += 2;
        }
    };

    scanner.ScanStarted += (s, e) => timer.Start();
    
                return scanner;
}

Example 2: Cyberpunk System Monitor

Uses the "Cyberpunk Pink" theme with glitch effects enabled for a futuristic aesthetic.

C# - Cyberpunk Style

private void ApplyCyberStyle(SiticoneScanner scanner)
{
    scanner.SelectedTheme = ThemePreset.CyberpunkPink;
    
                // Aggressive Visuals
    scanner.EnableGlitchEffect = true;
    scanner.EnableGridEffect = true;
    scanner.EnableParticleEffect = true;
    
                // Thicker geometry
    scanner.ProgressArcWidth = 10f;
    scanner.TickWidth = 4f;
    
    scanner.IdleText = "HACK";
    scanner.ProgressAnimationSpeed = 0.2f; // Fast updates
}