> For the complete documentation index, see [llms.txt](https://docs-siticoneframework.gitbook.io/home/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs-siticoneframework.gitbook.io/home/net-framework-or-net-core-ui/gauges-and-measurement/siticone-gaugenumeric/3d-and-special-effects.md). # 3D and Special Effects A control feature that enables advanced visual enhancements—including 3D rendering, metallic surfaces, glass overlays, shadows, reflections, and dynamic visual effects—to enhance the gauge’s realism. ## Overview The 3D and Special Effects feature provides a suite of properties and methods that allow developers to apply realistic 3D rendering and various visual enhancements to the gauge. By toggling options such as `Use3DEffect`, `UseMetallicEffect`, and `UseGlassEffect`, and adjusting associated parameters (e.g., `MetalBaseColor`, `RimThickness`, `BevelDepth`, and `Glossiness`), the gauge can simulate depth, reflections, and other advanced visual effects. Additional settings control shadow, reflection, inner shadow, neon glow, pulse animation, dynamic lighting, texture overlay, and blur effects to tailor the gauge's appearance for different application themes and performance requirements. *** ### Key Points | Aspect | Description | Code Reference / Example | | ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 3D Rendering Toggle | Enables the overall 3D rendering of the gauge, activating additional visual enhancements such as metallic and bevel effects. | `csharp\nmyGauge.Use3DEffect = true;` | | Metallic Effects | Provides a metallic surface look using properties such as `MetalBaseColor`, `RimThickness`, and `UseMetallicEffect`, along with bevel adjustments. | `csharp\nmyGauge.MetalBaseColor = Color.FromArgb(180, 180, 180);\nmyGauge.RimThickness = 10f;\nmyGauge.UseMetallicEffect = true;\nmyGauge.BevelDepth = 2;` | | Glass Overlay | Adds a glass reflection effect over the gauge dial with controllable intensity using `UseGlassEffect` and `Glossiness`. | `csharp\nmyGauge.UseGlassEffect = true;\nmyGauge.Glossiness = 0.7f;` | | Shadow and Reflection Effects | Configures external shadows with `UseShadowEffect`, `ShadowColor`, `ShadowOffset`, and `ShadowOpacity`, and reflections with `UseReflection` and `ReflectionOpacity`. | `csharp\nmyGauge.UseShadowEffect = true;\nmyGauge.ShadowColor = Color.Black;\nmyGauge.ShadowOffset = 5;\nmyGauge.ShadowOpacity = 0.6f;\nmyGauge.UseReflection = true;\nmyGauge.ReflectionOpacity = 0.5f;` | | Additional Special Effects | Controls neon glow (`UseNeonEffect`, `NeonIntensity`), inner shadow (`UseInnerShadow`, `InnerShadowDepth`), pulse animation (`UsePulseAnimation`, `PulseIntensity`), dynamic lighting (`UseDynamicLighting`, `AmbientLightIntensity`), texture overlay (`UseTexture`, `TextureStyle`), and blur (`UseBlurEffect`, `BlurRadius`). | `csharp\nmyGauge.UseNeonEffect = true;\nmyGauge.NeonIntensity = 0.5f;\nmyGauge.UseInnerShadow = true;\nmyGauge.InnerShadowDepth = 5f;\nmyGauge.UsePulseAnimation = true;\nmyGauge.PulseIntensity = 0.2f;\nmyGauge.UseDynamicLighting = true;\nmyGauge.AmbientLightIntensity = 0.5f;\nmyGauge.UseTexture = true;\nmyGauge.TextureStyle = HatchStyle.LightDownwardDiagonal;\nmyGauge.UseBlurEffect = true;\nmyGauge.BlurRadius = 5;` | *** ### Best Practices | Recommendation | Details | Example / Explanation | | ------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | | Enable 3D Effects Selectively | Use the 3D and special effects only when the enhanced visuals are required, as excessive effects might impact performance or distract from key data. | `csharp\n// Enable 3D effects only for high-end dashboards\nmyGauge.Use3DEffect = true;\nmyGauge.UseMetallicEffect = true;\nmyGauge.UseGlassEffect = true;` | | Balance Visual Enhancements | Adjust properties like `BevelDepth`, `Glossiness`, and `RimThickness` to achieve a realistic yet unobtrusive appearance that complements the overall UI. | `csharp\nmyGauge.BevelDepth = 2;\nmyGauge.Glossiness = 0.6f;\nmyGauge.RimThickness = 8f;` | | Tune Special Effects for Readability | When using neon, shadow, or blur effects, ensure that these do not obscure the gauge’s primary data by fine-tuning intensities and opacities. | `csharp\nmyGauge.NeonIntensity = 0.4f;\nmyGauge.ShadowOpacity = 0.5f;\nmyGauge.BlurRadius = 3;` | *** ### Common Pitfalls | Issue | Details | Resolution / Code Example | | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Overusing Visual Effects | Applying too many effects at once (e.g., high neon intensity with heavy blur) can clutter the display and affect performance. | Gradually enable effects and test performance; for instance, start with moderate neon intensity and adjust: `csharp\nmyGauge.NeonIntensity = 0.3f; // Avoid 1.0 intensity which might be too strong` | | Inconsistent 3D Appearance | Setting conflicting 3D properties (such as mismatched metallic and glass settings) may lead to a disjointed look. | Ensure that related properties are coordinated; for example, if using metallic effects, choose a complementary `MetalBaseColor` and appropriate `RimThickness`: `csharp\nmyGauge.MetalBaseColor = Color.Gray;\nmyGauge.RimThickness = 8f;` | | Performance Degradation | Extensive use of dynamic effects (e.g., dynamic lighting, blur, and pulse animations) may slow down rendering on lower-end hardware. | Profile performance and consider disabling non-critical effects on lower-performance systems by setting properties like `UseDynamicLighting` and `UseBlurEffect` to false. | *** ### Usage Scenarios | Scenario | Description | Sample Code | | -------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | High-End Dashboard | Use comprehensive 3D and special effects to create a visually rich gauge for premium applications where performance is less of a concern. | `csharp\n// Configure gauge with full 3D and special effects for a high-end dashboard\nmyGauge.Use3DEffect = true;\nmyGauge.UseMetallicEffect = true;\nmyGauge.MetalBaseColor = Color.Silver;\nmyGauge.RimThickness = 10f;\nmyGauge.BevelDepth = 2;\nmyGauge.UseGlassEffect = true;\nmyGauge.Glossiness = 0.7f;\nmyGauge.UseShadowEffect = true;\nmyGauge.ShadowOpacity = 0.6f;\nmyGauge.UseReflection = true;\nmyGauge.ReflectionOpacity = 0.5f;\nmyGauge.UseNeonEffect = true;\nmyGauge.NeonIntensity = 0.5f;` | | Performance-Critical Application | For applications where performance is key, enable only essential 3D effects and disable dynamic effects such as blur or pulse animations. | `csharp\n// Minimal 3D effects for performance-sensitive applications\nmyGauge.Use3DEffect = true;\nmyGauge.UseMetallicEffect = true;\nmyGauge.BevelDepth = 1;\nmyGauge.UseGlassEffect = false;\nmyGauge.UseShadowEffect = true;\nmyGauge.ShadowOpacity = 0.4f;\nmyGauge.UseNeonEffect = false;\nmyGauge.UseDynamicLighting = false;\nmyGauge.UseBlurEffect = false;` | | Thematic Customization | Adjust the 3D and special effects to match a specific theme (e.g., futuristic, industrial, or classic) by carefully selecting color and effect intensities. | `csharp\n// Futuristic theme settings\nmyGauge.Use3DEffect = true;\nmyGauge.UseMetallicEffect = true;\nmyGauge.MetalBaseColor = Color.LightSteelBlue;\nmyGauge.RimThickness = 8f;\nmyGauge.BevelDepth = 2;\nmyGauge.UseGlassEffect = true;\nmyGauge.Glossiness = 0.8f;\nmyGauge.UseNeonEffect = true;\nmyGauge.NeonIntensity = 0.7f;` | *** ### Real Life Usage Scenarios | Scenario | Description | Sample Integration Code | | --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Premium Financial Dashboard | In a high-end financial dashboard, applying metallic and glass effects can give the gauge a polished, professional look while displaying performance metrics. | `csharp\n// Premium dashboard configuration with full 3D effects\nmyGauge.Use3DEffect = true;\nmyGauge.UseMetallicEffect = true;\nmyGauge.MetalBaseColor = Color.Silver;\nmyGauge.RimThickness = 10f;\nmyGauge.BevelDepth = 2;\nmyGauge.UseGlassEffect = true;\nmyGauge.Glossiness = 0.7f;\nmyGauge.UseShadowEffect = true;\nmyGauge.ShadowOpacity = 0.6f;` | | Industrial Control Panel | For an industrial application, subtle 3D effects and clear shadows help in reading critical data under various lighting conditions without compromising performance. | `csharp\n// Industrial control panel settings\nmyGauge.Use3DEffect = true;\nmyGauge.UseMetallicEffect = true;\nmyGauge.MetalBaseColor = Color.DarkGray;\nmyGauge.RimThickness = 8f;\nmyGauge.BevelDepth = 1;\nmyGauge.UseGlassEffect = false;\nmyGauge.UseShadowEffect = true;\nmyGauge.ShadowColor = Color.Black;\nmyGauge.ShadowOffset = 3;\nmyGauge.ShadowOpacity = 0.5f;` | | Modern Healthcare Display | In a healthcare device, using a combination of subtle glass overlays and soft shadows can create an easy-to-read, modern gauge without distracting neon effects. | `csharp\n// Healthcare gauge configuration\nmyGauge.Use3DEffect = true;\nmyGauge.UseMetallicEffect = false;\nmyGauge.UseGlassEffect = true;\nmyGauge.Glossiness = 0.65f;\nmyGauge.UseShadowEffect = true;\nmyGauge.ShadowOpacity = 0.4f;\nmyGauge.UseNeonEffect = false;` | *** ### Troubleshooting Tips | Tip | Explanation | Action | | ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Confirm Property Dependencies | Some 3D effects rely on others (e.g., metallic effect depends on `Use3DEffect` being true); ensure that all necessary toggles are enabled. | Verify that related properties are set together, e.g., if enabling `UseMetallicEffect`, also set `Use3DEffect` to true:`csharp\nmyGauge.Use3DEffect = true;\nmyGauge.UseMetallicEffect = true;` | | Balance Special Effects Intensities | Overly high values for properties like `NeonIntensity` or `Glossiness` can overwhelm the display; moderate these values for best results. | Experiment with lower intensity values:`csharp\nmyGauge.NeonIntensity = 0.4f;\nmyGauge.Glossiness = 0.6f;` | | Check Performance Impact | Extensive use of effects such as blur or dynamic lighting may slow down rendering; test on target hardware and disable non-critical effects if needed. | Use performance profiling tools and consider disabling effects such as `UseBlurEffect` or `UseDynamicLighting` on lower-end systems:`csharp\nmyGauge.UseBlurEffect = false;` | *** ### Review | Aspect | Comments | Suggestions | | ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- | | Visual Enhancement | Provides a wide range of customizable visual enhancements to create realistic and engaging gauges. | Developers should balance the number and intensity of effects to prevent visual clutter and performance issues. | | Flexibility and Customization | The feature offers granular control over various 3D and special effects, making it adaptable for multiple themes and performance requirements. | Consider creating theme presets that group related properties (e.g., a “futuristic” theme preset) for quick configuration. | | Integration Complexity | While powerful, the numerous properties may require careful tuning to ensure a coherent look without overwhelming the gauge’s primary data. | Refer to the provided integration samples and best practices to achieve a harmonious visual appearance. | *** ### Summary | Summary Point | Description | | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | | Feature Overview | Provides advanced 3D rendering and special visual effects, including metallic surfaces, glass overlays, shadows, reflections, and dynamic enhancements. | | Core Properties | Key properties include `Use3DEffect`, `MetalBaseColor`, `RimThickness`, `UseMetallicEffect`, `BevelDepth`, `UseGlassEffect`, `Glossiness`, and others. | | Integration and Customization | Enables detailed customization through straightforward property assignments to achieve the desired look while balancing performance and clarity. | | Best Practices and Troubleshooting | Adjust related properties in tandem, moderate intensity values, and test on target hardware to ensure optimal visual performance and appearance. | *** ### Integration Demo Below is a complete sample code snippet to demonstrate how to integrate and customize the 3D and Special Effects feature into a WinForms application: ```csharp using System; using System.Drawing; using System.Windows.Forms; using SiticoneNetFrameworkUI; // Use the namespace from your provided code public class ThreeDEffectsDemoForm : Form { private SiticoneGaugeNumeric myGauge; private Button toggleEffectsButton; public ThreeDEffectsDemoForm() { // Initialize the gauge with 3D and special effects settings myGauge = new SiticoneGaugeNumeric { MinValue = 0f, MaxValue = 100f, Value = 50f, AnimationSpeed = 5f, ShowAnimation = true, Size = new Size(300, 300), Location = new Point(50, 30), // Enable 3D effects and set metallic appearance Use3DEffect = true, UseMetallicEffect = true, MetalBaseColor = Color.Silver, RimThickness = 10f, BevelDepth = 2, // Enable glass overlay effect UseGlassEffect = true, Glossiness = 0.7f, // Configure shadow and reflection effects UseShadowEffect = true, ShadowColor = Color.Black, ShadowOffset = 5, ShadowOpacity = 0.6f, UseReflection = true, ReflectionOpacity = 0.5f, // Enable additional special effects UseNeonEffect = true, NeonIntensity = 0.5f, UsePulseAnimation = true, PulseIntensity = 0.2f, UseDynamicLighting = true, AmbientLightIntensity = 0.5f, UseTexture = true, TextureStyle = System.Drawing.Drawing2D.HatchStyle.LightDownwardDiagonal, UseBlurEffect = true, BlurRadius = 5 }; // Initialize a button to toggle some 3D effect properties for demonstration toggleEffectsButton = new Button { Text = "Toggle Effects", Location = new Point(50, 350), Width = 150 }; toggleEffectsButton.Click += ToggleEffectsButton_Click; // Add controls to the form Controls.Add(myGauge); Controls.Add(toggleEffectsButton); } private void ToggleEffectsButton_Click(object sender, EventArgs e) { // Example: Toggle the neon effect on and off myGauge.UseNeonEffect = !myGauge.UseNeonEffect; myGauge.Invalidate(); // Force the gauge to redraw with updated effects } [STAThread] static void Main() { Application.EnableVisualStyles(); Application.Run(new ThreeDEffectsDemoForm()); } } ``` *** ### API Reference
MemberTypeDescription
Use3DEffectboolEnables or disables 3D rendering effects on the gauge.
MetalBaseColorColorGets or sets the base color for metallic effects on the gauge.
RimThicknessfloatDetermines the thickness of the 3D rim effect.
UseMetallicEffectboolEnables or disables the metallic surface effect.
BevelDepthintSets the depth of the bevel effect around the gauge dial.
UseGlassEffectboolEnables or disables the glass overlay effect on the gauge.
GlossinessfloatControls the intensity of the glass reflection effect (0.0 to 1.0).
UseShadowEffectboolEnables or disables the drop shadow effect.
ShadowColorColorGets or sets the color of the shadow effect.
ShadowOffsetintDetermines the offset of the shadow effect in pixels.
ShadowOpacityfloatSets the opacity of the shadow effect (0.0 to 1.0).
UseReflectionboolEnables or disables the reflection effect.
ReflectionOpacityfloatControls the opacity of the reflection effect (0.0 to 1.0).
InnerShadowDepthfloatSets the depth of the inner shadow effect.
UseNeonEffectboolEnables or disables the neon glow effect.
NeonIntensityfloatControls the intensity of the neon effect (0.0 to 1.0).
UsePulseAnimationboolEnables or disables the pulse animation effect.
PulseIntensityfloatControls the intensity of the pulse animation (0.0 to 1.0).
UseDynamicLightingboolEnables or disables dynamic lighting effects.
AmbientLightIntensityfloatSets the intensity of the ambient lighting effect (0.0 to 1.0).
UseTextureboolEnables or disables the texture overlay effect.
TextureStyleHatchStyleSpecifies the hatch style for the texture overlay.
UseBlurEffectboolEnables or disables the blur effect.
BlurRadiusintSets the radius of the blur effect in pixels.
LightSourcePointDefines the position of the light source for dynamic lighting effects.
*** This documentation provides a thorough guide for integrating and customizing the 3D and Special Effects feature in your WinForms applications. Use the provided code examples, tables, and best practices to fine-tune the visual enhancements for a realistic and engaging gauge display.