ReaLTaiizor

https://github.com/taiizor/realtaiizor
Admin
ReaLTaiizor is a user-friendly and design-focused control library for .NET WinForms projects,...
Tokens:58,751
Snippets:462
Trust Score:10
License:MIT
Update:1 month ago
Show doc for...
Tokens:
Raw
### MaterialSkinManager Basic Setup Example

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/material-skin-manager.md

Example of initializing the MaterialSkinManager, enforcing background colors, and applying a color scheme within a MaterialForm.

```csharp
public partial class MaterialFormSample : MaterialForm
{
    private MaterialSkinManager materialSkinManager;

    public MaterialFormSample()
    {
        InitializeComponent();

        materialSkinManager = MaterialSkinManager.Instance;
        materialSkinManager.EnforceBackcolorOnAllComponents = true; // before AddFormToManage
        materialSkinManager.AddFormToManage(this);
        materialSkinManager.Theme = MaterialSkinManager.Themes.LIGHT;
        materialSkinManager.ColorScheme = new MaterialColorScheme(
            MaterialPrimary.Indigo500, MaterialPrimary.Indigo700, MaterialPrimary.Indigo100,
            MaterialAccent.Pink200, MaterialTextShade.LIGHT);
    }
}
```

--------------------------------

### Designer-file equivalent example

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/poison-style-manager.md

Demonstrates manual initialization and configuration of a PoisonStyleManager instance.

```csharp
var manager = new PoisonStyleManager();
manager.Owner = this;                 // a PoisonForm or plain container
manager.Style = ColorStyle.Teal;
manager.Theme = ThemeStyle.Dark;
manager.Update();
```

--------------------------------

### MoveAnimation Usage Example

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/animation.md

Demonstrates how to initialize a MoveAnimation, subscribe to the completion event, and start the animation.

```csharp
var move = new MoveAnimation();
move.AnimationCompleted += (s, e) => Console.WriteLine("arrived");
move.Start(panel, new Point(300, 200), TransitionType.EaseOutQuad, 400);
```

--------------------------------

### Initialize CyberController

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/cyber-controls.md

Example of instantiating the CyberController with a container and setting initial status and timer interval.

```csharp
var controller = new CyberController(components) { Status = true, TimerInterval = 100 };
// designer: Cyber controls tick through the controller once Status is enabled
```

--------------------------------

### Initialize PoisonForm Example

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/forms.md

Demonstrates how to instantiate a PoisonForm, configure its properties, and attach a PoisonStyleManager before running the application.

```csharp
var form = new PoisonForm
{
    Text = "My App",
    ShadowType = FormShadowType.DropShadow,
    DisplayHeader = true
};
var manager = new PoisonStyleManager { Owner = form, Style = ColorStyle.Blue, Theme = ThemeStyle.Dark };
Application.Run(form);
```

--------------------------------

### Initialize CyberButton

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/cyber-controls.md

Example of instantiating a CyberButton with custom rounding and style settings, then adding it to a form.

```csharp
var cyber = new CyberButton
{
    Text = "LAUNCH",
    Rounding = true,
    RoundingInt = 12,
    CyberButtonStyle = StateStyle.Custom
};
form.Controls.Add(cyber);
```

--------------------------------

### MaterialColorScheme Presets and Custom Initialization

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/colors.md

Examples of initializing MaterialColorScheme using enum presets and custom hex string values.

```csharp
MaterialSkinManager.Instance.ColorScheme = new MaterialColorScheme(
    MaterialPrimary.Green600, MaterialPrimary.Green700, MaterialPrimary.Green200,
    MaterialAccent.Red100, MaterialTextShade.LIGHT);

MaterialSkinManager.Instance.ColorScheme = new MaterialColorScheme(
    "#00480157", "#370142", "DC2EFF", "00BB5FCF", MaterialTextShade.LIGHT);
```

--------------------------------

### Basic MetroButton usage

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/metro-controls.md

Example of creating a MetroButton and associating it with a MetroStyleManager.

```csharp
var btn = new MetroButton { Text = "Save", Style = Style.Dark };
metroForm.Controls.Add(btn);

var manager = new MetroStyleManager(metroForm) { Style = Style.Dark };
```

--------------------------------

### Implementing a Custom SettingsWindow with MetroForm

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/forms.md

Example of creating a custom window by inheriting from MetroForm and configuring its properties in the constructor.

```csharp
public class SettingsWindow : MetroForm
{
    public SettingsWindow()
    {
        Text = "Settings";
        Style = Style.Dark;          // or drive via MetroStyleManager
        ShowHeader = true;
        DropShadowEffect = true;
    }
}

// standalone (MetroForm ctor is protected — derive from it)
Application.Run(new SettingsWindow());
```

--------------------------------

### PoisonButton basic usage

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/poison-controls.md

Example demonstrating how to instantiate and configure a basic PoisonButton.

```csharp
var loginButton = new PoisonButton
{
    Text = "Log in",
    Highlight = true,             // accent background
    FontSize = PoisonButtonSize.Medium,
    FontWeight = PoisonButtonWeight.Regular,
    UseStyleColors = true
};
form.Controls.Add(loginButton);

// theme from a manager
var manager = new PoisonStyleManager { Owner = form, Style = ColorStyle.Teal, Theme = ThemeStyle.Dark };
```

--------------------------------

### Save and load layout example

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/crown-docking.md

Demonstrates how to serialize the current dock panel state to JSON and restore it later using a content lookup function.

```csharp
DockPanelState state = dockPanel.GetDockPanelState();
string json = JsonConvert.SerializeObject(state);   // plain DTOs, no custom converters needed

// later, after recreating the panel and registering contents:
DockPanelState restored = JsonConvert.DeserializeObject<DockPanelState>(json);
dockPanel.RestoreDockPanelState(restored, key => registeredContents[key]);
```

--------------------------------

### Theme XML format example

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/metro-style-manager.md

Example of the XML structure used for defining Metro themes, including the Theme metadata and specific control styling.

```xml
<MetroTheme>
  <Theme>
    <Name>MyTheme</Name>
    <Author>Me</Author>
  </Theme>
  <Button>
    <ForeColor>#FFFFFF</ForeColor>
    <BackColor>#3F51B5</BackColor>
  </Button>
</MetroTheme>
```

--------------------------------

### Install ReaLTaiizor via NuGet

Source: https://github.com/taiizor/realtaiizor/blob/develop/README.md

Use this command to add the ReaLTaiizor package to your project.

```powershell
Install-Package ReaLTaiizor
```

--------------------------------

### Animate a Color

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/animation.md

Demonstrates initializing a ColorAnimate instance with update and completion callbacks, then starting the animation.

```csharp
var anim = new ColorAnimate
{
    Update = c => button.BackColor = c,
    Complete = () => Console.WriteLine("done")
};
anim.Start(600, Color.Red, Color.Blue, EasingType.QuadInOut);
```

--------------------------------

### ColorBlendAnimation and ExpandAnimation Usage Example

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/animation.md

Demonstrates triggering color blending and size expansion animations on UI controls.

```csharp
new ColorBlendAnimation().Start(button, "BackColor", Color.CornflowerBlue, 500);
new ExpandAnimation().Start(panel, new Size(320, 240), TransitionType.EaseInOutCubic, 300);
```

--------------------------------

### MaterialExtension usage example

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/extensions.md

Demonstrates common usage of MaterialExtension methods for color conversion and control identification.

```csharp
int argb = "#F44336".GetIntFromHexColor();       // extension on string via MaterialExtension
Color c = argb.ToColor();
bool isMat = someControl.IsMaterialControl();
```

--------------------------------

### PoisonMessageBox.Show usage example

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/poison-controls.md

Example of calling PoisonMessageBox.Show and handling the returned DialogResult.

```csharp
DialogResult r = PoisonMessageBox.Show(this, "Delete this record?", "Confirm",
    MessageBoxButtons.YesNo, MessageBoxIcon.Question);
if (r == DialogResult.Yes) { /* ... */ }
```

--------------------------------

### CyberLibrary Drawing Example

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/cyber-controls.md

Demonstrates creating a rounded rectangle path, applying a blurred drawing effect, and enabling the global RGB timer.

```csharp
using var path = CyberLibrary.Drawing.RoundedRectangle(new Rectangle(0, 0, 200, 60), 16);
CyberLibrary.Drawing.DrawBlurred(g, Color.Cyan, path, 60, 4);
CyberLibrary.Numeric.TimerGlobalRGB(true);   // enable global RGB cycling
```

--------------------------------

### MaterialForm implementation example

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/forms.md

A basic implementation of a custom form inheriting from MaterialForm with specific drawer and style configurations.

```csharp
public class MainWindow : MaterialForm
{
    public MainWindow()
    {
        FormStyle = FormStyles.ActionBar_56;
        DrawerTabControl = myMaterialTabControl;
        DrawerAutoShow = false;
        DrawerWidth = 180;
    }
}
```

--------------------------------

### MaterialButton basic usage

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/material-controls.md

A basic example of creating and adding a MaterialButton to a form.

```csharp
var button = new MaterialButton
{
    Text = "Save"
};
form.Controls.Add(button);
```

--------------------------------

### Animate a Double with Reverse

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/animation.md

Shows how to configure a DoubleAnimate instance, start it with specific settings, and trigger a reverse animation later.

```csharp
var anim = new DoubleAnimate();
anim.Update = v => gauge.Value = v;
anim.Start();
anim.Setting(1000, 0.0, 1.0);
// later
anim.Reverse();
```

--------------------------------

### Persist ThemeFile setting

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/configuration.md

Example of writing the last-used Metro custom theme path to the persisted user settings.

```csharp
Settings.Default.ThemeFile = value; Settings.Default.Save();
```

--------------------------------

### ObjectAnimator Usage Example

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/parrot-controls.md

Demonstrates how to instantiate the ObjectAnimator and apply form fading, standard control movement, and color fill animations.

```csharp
var animator = new ObjectAnimator();
animator.FormAnimate(loginForm, FormAnimation.FadeIn, 20);
animator.StandardAnimate(panel, StandardAnimation.SlideUp, 10);
animator.ColorAnimate(button, Color.Lime, ColorAnimation.StripeFill, false, 5);
```

--------------------------------

### MetroStyleManager basic setup

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/metro-style-manager.md

Initializes the MetroStyleManager with a form and sets the global style to Dark, which automatically updates all child IMetroControl elements.

```csharp
var metroManager = new MetroStyleManager(this);   // this : MetroForm (or any Form)
metroManager.Style = Style.Dark;                  // sets ThemeName "MetroDark", reapplies to all IMetroControl children
```

--------------------------------

### MaterialButton with accent and icon

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/material-controls.md

Example of configuring a MaterialButton with an icon, accent color, and dense layout, while demonstrating theme toggling.

```csharp
var button = new MaterialButton
{
    Text = "Star",
    Icon = starIcon,
    Type = MaterialButton.MaterialButtonType.TextWithIcon,
    UseAccentColor = true,
    Density = MaterialButton.MaterialButtonDensity.Dense
};
// Theme toggle affects the button automatically through MaterialSkinManager.Instance
MaterialSkinManager.Instance.Theme = MaterialSkinManager.Themes.DARK;
```

--------------------------------

### Concrete Animation Class Implementations

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/animation.md

Examples of defining custom animation classes by inheriting from Animate<T> and overriding the Value property.

```csharp
public class ColorAnimate : Animate<Color>
{
    public override Color Value => Color.FromArgb(...);   // lerp ARGB via Interpolation
}

public class DoubleAnimate : Animate<double>
{
    public override double Value => Interpolation.ValueAt(InitialValue, EndValue, Alpha, EasingType);
}

public class IntAnimate : Animate<int>
{
    public override int Value => (int)Interpolation.ValueAt(InitialValue, EndValue, Alpha, EasingType);
}

public class PointFAnimate : Animate<PointF>   // file PointFAnimate.cs
public class SizeFAnimate : Animate<SizeF>     // file SizeFAnimate.cs
```

--------------------------------

### PoisonButton custom paint hook

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/poison-controls.md

Example demonstrating how to use the CustomPaint event to draw custom graphics on a PoisonButton.

```csharp
var button = new PoisonButton { Text = "Press me" };
button.CustomPaint += (s, e) =>
{
    // e.Graphics / e.BackColor / e.ForeColor are already resolved for the current theme
    using var pen = new Pen(e.BackColor, 1f);
    e.Graphics.DrawEllipse(pen, 2, 2, 16, 16);
};
```

--------------------------------

### MetroButton per-control override

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/metro-controls.md

Example of configuring a MetroButton with custom colors by setting IsDerivedStyle to false.

```csharp
var btn = new MetroButton
{
    Text = "Danger",
    IsDerivedStyle = false,          // stop inheriting from manager palette
    NormalColor = Color.White,
    NormalBorderColor = Color.Firebrick,
    NormalTextColor = Color.Firebrick,
    HoverColor = Color.Firebrick,
    HoverTextColor = Color.White,
    PressColor = Color.DarkRed,
    PressTextColor = Color.White,
    DisabledBackColor = Color.Gainsboro,
    DisabledForeColor = Color.DimGray,
    DisabledBorderColor = Color.Gainsboro
};
```

--------------------------------

### PaintHelperA Redraw Suspension

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/core.md

Example of using PaintHelperA to suspend and resume redraw operations on a panel during batch mutations.

```csharp
PaintHelperA.Suspend(panel);
try { /* batch many child-control mutations */ }
finally { PaintHelperA.Resume(panel); }
```

--------------------------------

### ParrotButton Usage Example

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/parrot-controls.md

A basic implementation of a ParrotButton with custom text and corner radius, added to a form's controls.

```csharp
var play = new ParrotButton { ButtonText = "▶", CornerRadius = 10 };
play.Click += (s, e) => media.Start();
form.Controls.Add(play);
```

--------------------------------

### Applying ControlRenderer to MenuStrip

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/core.md

Examples of assigning a ControlRenderer to a MenuStrip, either using the default color table or a custom one.

```csharp
MenuStrip menu = new();
menu.Renderer = new ControlRenderer();           // default MSColorTable
menu.Renderer = new ControlRenderer(new MSColorTable());
```

--------------------------------

### Creating a Rounded Rectangle Path

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/core.md

Example usage of the RoundRectangle.RoundRect method to generate a GraphicsPath with a specified rectangle and curve radius.

```csharp
GraphicsPath path = RoundRectangle.RoundRect(new Rectangle(0, 0, 100, 40), 8);
```

--------------------------------

### Initialize PoisonStyleManager with Container

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/poison-style-manager.md

Demonstrates full initialization of a PoisonStyleManager using a container, setting the owner form, style, and theme. It also shows how to toggle the theme at runtime.

```csharp
IContainer components = new Container();
var form = new PoisonForm { StyleManager = null };

// Register first so Update() also themes component-only items (e.g. PoisonContextMenuStrip)
var styleManager = new PoisonStyleManager(components)
{
    Owner = form,
    Style = ColorStyle.Pink,
    Theme = ThemeStyle.Light
};

// Toggle theme at runtime
styleManager.Theme = styleManager.Theme == ThemeStyle.Dark ? ThemeStyle.Light : ThemeStyle.Dark;
```

--------------------------------

### DrawRoundedRectangle Usage

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/core.md

Example of using DrawRoundedRectangle to stroke a rounded rectangle with a gray pen.

```csharp
using (var pen = new Pen(Color.Gray))
{
    RectDrawing.DrawRoundedRectangle(e.Graphics, pen, 2, 2, 96, 24, 3);
}
```

--------------------------------

### Initialize CrownDockPanel and Add Content

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/crown-docking.md

Demonstrates creating a dock panel and adding document or tool window content to specific regions.

```csharp
var dockPanel = new CrownDockPanel { Dock = DockStyle.Fill };

var documents = new CrownDocument { DockText = "Main.cs", SerializationKey = "main" };
dockPanel.AddContent(documents);

dockPanel.Regions[DockArea.Bottom].AddContent(new CrownToolWindow { DockText = "Output" });
```

--------------------------------

### ISupportInitialize Methods

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/poison-style-manager.md

Explicit interface implementation for initializing the style manager.

```APIDOC
## void BeginInit()

### Description
Defers theme propagation.

## void EndInit()

### Description
Clears the initialization flag and calls Update().
```

--------------------------------

### Create a minimal Crown dock layout

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/crown-docking.md

Demonstrates how to initialize a CrownDockPanel, add document and tool window content, and set the active tab in a form.

```csharp
var dockPanel = new CrownDockPanel { Dock = DockStyle.Fill };

var doc = new CrownDocument { DockText = "Editor.cs", SerializationKey = "editor" };
dockPanel.AddContent(doc);                                  // docks in Document region

var tools = new CrownToolWindow { DockText = "Tools", SerializationKey = "tools", DefaultDockArea = DockArea.Right };
dockPanel.AddContent(tools);                                // docks right

form.Controls.Add(dockPanel);
form.Shown += (s, e) => dockPanel.ActiveContent = doc;      // activate the document tab
```

--------------------------------

### Switching Crown themes at runtime

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/crown-controls.md

Demonstrates how to change the global theme using the ThemeProvider, which triggers automatic repainting of Crown controls.

```csharp
// Pattern from demo (demo/ReaLTaiizor.UI/ReaLTaiizor.UI/Form21.cs)
ThemeProvider.Theme = new DarkTheme();   // switch theme
ThemeProvider.Theme = new LightTheme();
```

--------------------------------

### ISupportInitialize interface methods

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/poison-style-manager.md

Explicit interface implementation for initialization. BeginInit defers theme propagation, while EndInit clears the flag and triggers an update.

```csharp
void ISupportInitialize.BeginInit();
void ISupportInitialize.EndInit();
```

--------------------------------

### Load custom XML theme with MetroStyleManager

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/metro-style-manager.md

Demonstrates initializing a MetroStyleManager, assigning an owner form, and loading a custom XML theme file. It also includes a check for the CustomTheme property and accessing a value from the ButtonDictionary.

```csharp
var metroManager = new MetroStyleManager();
metroManager.OwnerForm = this;
metroManager.SetTheme(@"C:\themes\myTheme.xml");  // persists path, reads palettes, Style = Custom

// verify
if (metroManager.CustomTheme == null)
{
    // file missing -> manager has fallen back to Style.Light
}
string fg = metroManager.ButtonDictionary["ForeColor"]?.ToString();
```

--------------------------------

### Toggle runtime theme with events

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/material-skin-manager.md

Demonstrates how to subscribe to theme and color scheme change events and toggle the current theme between Light and Dark modes.

```csharp
MaterialSkinManager sm = MaterialSkinManager.Instance;
sm.ThemeChanged += sender => Console.WriteLine("theme changed");
sm.ColorSchemeChanged += sender => Console.WriteLine("colors changed");

sm.Theme = sm.Theme == MaterialSkinManager.Themes.DARK
    ? MaterialSkinManager.Themes.LIGHT
    : MaterialSkinManager.Themes.DARK;
```

--------------------------------

### Creating and theming a CrownButton

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/crown-controls.md

Shows how to instantiate a CrownButton with a specific style and trigger a theme update.

```csharp
var btn = new CrownButton { Text = "Build", ButtonStyle = ButtonStyle.Flat };
form.Controls.Add(btn);

// theme switch repaints automatically
CrownHelper.ThemeProvider.Theme = new CrownHelper.DarkTheme();
```

--------------------------------

### Initialize ParrotFormEllipse

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/parrot-controls.md

Demonstrates how to instantiate and attach a ParrotFormEllipse to a form to round its corners. Invoke the Attach method after the form is shown.

```csharp
var ellipse = new ParrotFormEllipse { Radius = 24 };
ellipse.Attach(this);   // invoke after form shown; repaint on resize handled internally
```

--------------------------------

### Custom Paint with PoisonPaint

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/util.md

Demonstrates how to override the OnPaint method to apply custom background and border colors using the PoisonPaint utility based on the current control theme.

```csharp
protected override void OnPaint(PaintEventArgs e)
{
    base.OnPaint(e);
    ThemeStyle theme = Theme;   // your control's current ThemeStyle
    Color bg = PoisonPaint.BackColor.Button.Normal(theme);
    Color border = PoisonPaint.BorderColor.Button.Normal(theme);
    e.Graphics.Clear(bg);
    ControlPaint.DrawBorder(e.Graphics, ClientRectangle, border, ButtonBorderStyle.Solid);
}
```

--------------------------------

### Utilites Brush and Color Helpers

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/extensions.md

Provides utilities for creating brushes, pens, and handling alpha-hex colors.

```csharp
public static class Utilites
{
    public static PathGradientBrush GlowBrush(Color CenterColor, Color SurroundColor, Point P, Rectangle Rect);
    public static SolidBrush SolidBrushRGBColor(int R, int G, int B, int A = 0);
    public static Pen PenRGBColor(int red, int green, int blue, int alpha, float size);
    public static Color GetAlphaHexColor(int alpha, string hexColor);
    public static void NormalCursor(ref Message message, Cursor Cursor);
}
```

--------------------------------

### Animation Classes

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/animation.md

Concrete animation classes allow for animating specific types like Color, double, int, PointF, and SizeF. These classes provide a consistent interface for starting, updating, and completing animations.

```APIDOC
## Animation Classes (ColorAnimate, DoubleAnimate, IntAnimate, PointFAnimate, SizeFAnimate)

### Description
These classes inherit from Animate<T> and provide specialized interpolation for different data types. Users can define an Update callback to apply the animated value and a Complete callback for when the animation finishes.

### Methods
- **Start(int duration, T start, T end, EasingType easing)**: Starts the animation with a specified duration, start value, end value, and easing function.
- **Setting(int duration, T start, T end)**: Configures the animation parameters.
- **Reverse()**: Reverses the current animation direction.

### Example
```csharp
var anim = new ColorAnimate
{
    Update = c => button.BackColor = c,
    Complete = () => Console.WriteLine("done")
};
anim.Start(600, Color.Red, Color.Blue, EasingType.QuadInOut);
```
```

--------------------------------

### SetTheme

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/metro-style-manager.md

Sets the application style to Custom and applies the theme from the specified path.

```APIDOC
## SetTheme

### Description
Sets Style = Style.Custom then CustomTheme = path.

### Signature
`public void SetTheme(string path)`

### Parameters
- **path** (string) - Required - The file path to the theme XML.
```

--------------------------------

### ExtensionLost Methods

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/extensions.md

Utility methods for color shading and string manipulation.

```APIDOC
## Color Shade(Color baseColor, int shades, int index)

### Description
Returns an interpolated shade of the baseColor at a specific index of total shade steps.

## string Between(string s, string start, string end)

### Description
Returns the substring located between the first occurrence of the start marker and the first occurrence of the end marker.
```

--------------------------------

### OpenTheme

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/metro-style-manager.md

Displays an OpenFileDialog to select an XML theme file and assigns the selection to the CustomTheme property.

```APIDOC
## OpenTheme

### Description
Shows an OpenFileDialog (filter: Xml File (*.xml)|*.xml); on DialogResult.OK assigns the selection to CustomTheme.

### Signature
`public void OpenTheme()`
```

--------------------------------

### Metro Style Manager Methods

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/metro-style-manager.md

The primary methods for interacting with theme files and applying custom styles.

```csharp
public void OpenTheme();
public void SaveTheme();
public void SetTheme(string path);
public static string PathTheme();
```

--------------------------------

### CrownHelper.ThemeProvider

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/crown-controls.md

Manages the current application theme, allowing for runtime theme switching between Dark and Light palettes.

```APIDOC
## CrownHelper.ThemeProvider

### Description
Provides access to the current application theme and allows for runtime theme swapping.

### Properties
- **Theme** (ITheme) - Gets or sets the current theme (defaults to DarkTheme).

### Example
```csharp
// Switch to Light Theme at runtime
CrownHelper.ThemeProvider.Theme = new CrownHelper.LightTheme();
```
```

--------------------------------

### PaintHelperA and PaintHelperB Class Definitions

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/core.md

Abstract classes for managing WinForms redraw states. PaintHelperA uses P/Invoke for SendMessage, while PaintHelperB uses NativeWindow.DefWndProc.

```csharp
public abstract class PaintHelperA
{
    [DllImport("user32.dll")]
    public static extern int SendMessage(IntPtr hWnd, int wMsg, bool wParam, int lParam);
    public static void Suspend(Control Parent);
    public static void Resume(Control Parent);
}

public abstract class PaintHelperB
{
    public static void Suspend(Control Parent);
    public static void Resume(Control Parent);
}
```

--------------------------------

### PathTheme

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/metro-style-manager.md

Returns the system path where theme files are stored.

```APIDOC
## PathTheme

### Description
Returns Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.Templates), "ThemeFile.xml").

### Signature
`public static string PathTheme()`
```

--------------------------------

### CrownDockPanel state methods

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/crown-docking.md

Methods available on the dock panel for capturing and restoring the layout state.

```csharp
public DockPanelState GetDockPanelState();
public void RestoreDockPanelState(DockPanelState state, Func<string, CrownDockContent> getContentBySerializationKey);
```

--------------------------------

### PoisonStyleManager Parameterless Constructor

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/poison-style-manager.md

Initializes a new instance of the PoisonStyleManager with default Style and Theme settings.

```csharp
public PoisonStyleManager()
```

--------------------------------

### Clone method

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/poison-style-manager.md

Returns a new PoisonStyleManager with a copy of the current theme and style fields. The clone has no Owner and is not registered in any container.

```csharp
public object Clone()
```

--------------------------------

### MaterialExtension Methods

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/extensions.md

A collection of static extension methods for objects, strings, and colors within the ReaLTaiizor.Extension namespace.

```APIDOC
## MaterialExtension Methods

### Description
Provides utility methods for reflection, color conversion, and string obfuscation.

### Methods
- **HasProperty(object objectToCheck, string propertyName)** (bool) - Checks if an object has a public non-static property.
- **IsMaterialControl(object obj)** (bool) - Checks if an object implements MaterialControlI.
- **ToSecureString(string plainString)** (string) - Performs reversible obfuscation on a string.
- **ToColor(int argb)** (Color) - Converts an ARGB integer to a Color object.
- **RemoveAlpha(Color color)** (Color) - Removes the alpha channel from a Color.
- **PercentageToColorComponent(int percentage)** (int) - Maps a 0-100 percentage to a 0-255 color component scale.
- **Clamp(int value, int min, int max)** (int) - Clamps an integer value between a minimum and maximum.
- **GetIntFromHexColor(string HexColor)** (int) - Converts a hex color string to an ARGB integer.

### Example
```csharp
int argb = "#F44336".GetIntFromHexColor();
Color c = argb.ToColor();
bool isMat = someControl.IsMaterialControl();
```
```

--------------------------------

### Runtime Theme Swap

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/crown-controls.md

Updates the application theme at runtime by assigning a new theme instance to the ThemeProvider.

```csharp
CrownHelper.ThemeProvider.Theme = new CrownHelper.LightTheme();
```

--------------------------------

### Update method

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/poison-style-manager.md

Re-applies the current Style and Theme to the Owner control tree and IPoisonComponent instances. Safe to call repeatedly.

```csharp
public void Update()
```

--------------------------------

### Methods Graphics and Image Utilities

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/extensions.md

Contains helper methods for drawing images, handling Base64 strings, and creating rounded rectangles.

```csharp
public static class Methods
{
    public static void DrawImageFromBase64(Graphics graphics, string base64Image, Rectangle rect);
    public static void DrawImageWithColor(Graphics G, Rectangle r, Image image, Color c);
    public static void DrawImageWithColor(Graphics G, Rectangle r, string image, Color c);
    public static float[][] ColorToMatrix(float alpha, Color c);   // 5x5 color matrix for ImageAttributes
    public static Image ImageFromBase64(string base64Image);
    public static GraphicsPath RoundRec(Rectangle r, int curve, bool topLeft = true, bool topRight = true, bool bottomLeft = true, bool bottomRight = true);
    public static GraphicsPath RoundRec(int x, int y, int width, int height, int curve, bool topLeft = true, bool topRight = true, bool bottomLeft = true, bool bottomRight = true);
}
```

--------------------------------

### ExtensionLost Utility Methods

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/extensions.md

Provides static extension methods for color shading and string manipulation located in src/ReaLTaiizor/Extension/Lost.cs.

```csharp
public static class ExtensionLost
{
    public static Color Shade(this Color baseColor, int shades, int index);
    public static string Between(this string s, string start, string end);
}
```

--------------------------------

### MetroStyleManager Constructors

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/metro-style-manager.md

Constructors for initializing the MetroStyleManager with an owner form or default settings.

```csharp
public MetroStyleManager(Form ownerForm)
```

```csharp
public MetroStyleManager()
```

--------------------------------

### CrownDockPanel Class

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/crown-docking.md

The primary host component for managing dockable windows and documents.

```APIDOC
## CrownDockPanel

### Description
Represents the main container for the docking system, managing regions and dockable content.

### Methods
- **AddContent(CrownDockContent dockContent)**: Adds content to the panel.
- **AddContent(CrownDockContent dockContent, CrownDockGroup dockGroup)**: Adds content to a specific dock group.
- **InsertContent(CrownDockContent dockContent, CrownDockGroup dockGroup, DockInsertType insertType)**: Inserts content into a group using a specific insertion type.
- **RemoveContent(CrownDockContent dockContent)**: Removes content from the panel.
- **ContainsContent(CrownDockContent dockContent)**: Checks if the panel contains the specified content.
- **GetDocuments()**: Returns a list of all document-type content.
- **DragContent(CrownDockContent content)**: Initiates an interactive drag operation for the specified content.

### Properties
- **ActiveContent** (CrownDockContent): The currently active dock content.
- **Regions** (Dictionary<DockArea, CrownDockRegion>): Access to the dock regions (Document, Left, Right, Bottom).
- **Splitters** (List<CrownDockSplitter>): List of resize splitters.

### Events
- **ActiveContentChanged**: Raised when the active content changes.
- **ContentAdded**: Raised when new content is added.
- **ContentRemoved**: Raised when content is removed.
```

--------------------------------

### MetroStyleManager Constructors

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/metro-style-manager.md

Initializes a new instance of the MetroStyleManager component.

```APIDOC
## Constructor: MetroStyleManager(Form ownerForm)

### Description
Initializes a new instance of the MetroStyleManager with a specified owner form.

### Parameters
- **ownerForm** (Form) - Required - The form to be managed by this instance.

## Constructor: MetroStyleManager()

### Description
Initializes a new instance of the MetroStyleManager with default settings, loading the theme from the persisted custom-theme path or embedded resources.
```

--------------------------------

### CyberController Constructor

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/cyber-controls.md

Initializes a new instance of the CyberController class, registering it with the provided container for designer support.

```APIDOC
## CyberController(IContainer Container)

### Description
Initializes a new instance of the CyberController class. This constructor is designer-friendly and registers the controller with the supplied container.

### Parameters
#### Path Parameters
- **Container** (IContainer) - Required - The container to register the controller with.
```

--------------------------------

### ExpandAnimation.Start

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/animation.md

Animates the size of a control to a target size using a specified transition type.

```APIDOC
## ExpandAnimation.Start

### Description
Animates the size of the provided control from its current size to the target size.

### Parameters
- **control** (Control) - The UI control to animate.
- **targetSize** (Size) - The destination size.
- **transitionType** (TransitionType) - The easing curve to apply.
- **duration** (int) - The duration of the animation in milliseconds.
```

--------------------------------

### MoveAnimation.Start

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/animation.md

Animates the location of a control to a target point using a specified transition type.

```APIDOC
## MoveAnimation.Start

### Description
Animates the location of the provided control from its current position to the target point.

### Parameters
- **control** (Control) - The UI control to animate.
- **targetPoint** (Point) - The destination coordinate.
- **transitionType** (TransitionType) - The easing curve to apply.
- **duration** (int) - The duration of the animation in milliseconds.
```

--------------------------------

### ControlRenderer Constructor

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/core.md

Initializes a new instance of the ControlRenderer class, optionally with a custom ColorTable.

```APIDOC
## Constructor: ControlRenderer()

### Description
Initializes a new instance of the ControlRenderer class using the default MSColorTable.

## Constructor: ControlRenderer(ColorTable ColorTable)

### Description
Initializes a new instance of the ControlRenderer class with a custom ColorTable.

### Parameters
- **ColorTable** (ColorTable) - Required - Custom color table applied to the renderer
```

--------------------------------

### MaterialColorHelper

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/util.md

Provides static methods for manipulating System.Drawing.Color objects, including lightening, darkening, and HSL conversion.

```APIDOC
## MaterialColorHelper

### Description
Utility class for color manipulation in Material design contexts.

### Methods
- **Lighten(Color color, float percent)**: Returns a lighter version of the color.
- **Darken(Color color, float percent)**: Returns a darker version of the color.
- **FromHsl(int alpha, float hue, float saturation, float lighting)**: Creates a Color from HSL values.
- **RemoveAlpha(Color foreground, Color background)**: Removes alpha channel by blending with a background color.
```

--------------------------------

### Methods (Graphics Utilities)

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/extensions.md

Collection of helper methods for graphics manipulation, image rendering, and path generation.

```APIDOC
## Graphics Utility Methods

### Description
Provides tools for drawing images from Base64 strings, color matrix transformations, and creating rounded rectangle paths.

### Key Methods
- **DrawImageFromBase64(Graphics graphics, string base64Image, Rectangle rect)**: Renders an image from a Base64 string onto the graphics surface.
- **ImageFromBase64(string base64Image)**: Converts a Base64 string to an Image object.
- **RoundRec(...)**: Generates a GraphicsPath for a rectangle with rounded corners, supporting individual corner toggles.
```

--------------------------------

### MetroStyleManager Initialization

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/metro-style-manager.md

Initializes the MetroStyleManager for a form and applies a theme style to all child controls.

```APIDOC
## MetroStyleManager Initialization

### Description
Initializes the manager with a target form and sets the global style, which triggers a theme reapplication to all IMetroControl children.

### Usage
```csharp
var metroManager = new MetroStyleManager(this); // this : MetroForm (or any Form)
metroManager.Style = Style.Dark;                  // sets ThemeName "MetroDark", reapplies to all IMetroControl children
```
```

--------------------------------

### PoisonStyleManager Container Constructor

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/poison-style-manager.md

Initializes a new instance of the PoisonStyleManager with a parent container.

```csharp
public PoisonStyleManager(IContainer parentContainerr)
```

--------------------------------

### ColorTable abstract class

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/core.md

Defines the base color contract for menu strips.

```csharp
public abstract class ColorTable
{
    public abstract XColorTable CommonColorTable { get; }
    public abstract Color BackgroundTopGradient { get; }
    public abstract Color BackgroundBottomGradient { get; }
    public abstract Color DroppedDownItemBackground { get; }
    public abstract Color DropdownTopGradient { get; }
    public abstract Color DropdownBottomGradient { get; }
    public abstract Color Separator { get; }
    public abstract Color ImageMargin { get; }
}
```

--------------------------------

### Update()

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/poison-style-manager.md

Re-applies the current Style and Theme to the whole Owner control tree and to every IPoisonComponent or PoisonContextMenuStrip in the parent container.

```APIDOC
## public void Update()

### Description
Re-applies the current Style and Theme to the whole Owner control tree and to every IPoisonComponent or PoisonContextMenuStrip in the constructor-provided parentContainer. Safe to call repeatedly; used internally after property changes and after EndInit.
```

--------------------------------

### Clone()

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/poison-style-manager.md

Creates a copy of the current PoisonStyleManager instance.

```APIDOC
## public object Clone()

### Description
Returns a new PoisonStyleManager carrying a copy of the current poisonTheme and poisonStyle fields. The clone has no Owner and is not registered in any container.

## public object Clone(ContainerControl owner)

### Description
Clones the manager, and if owner is IPoisonForm it sets Owner = owner, assigns form.StyleManager = clonedManager, and applies the theme to every IPoisonComponent component and every PoisonContextMenuStrip found in that container.

### Parameters
- **owner** (ContainerControl) - Required - Destination owner container
```

--------------------------------

### Material Skin Manager Font API Methods

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/material-skin-manager.md

A collection of methods for retrieving fonts and logical font handles, including scaling support and device DPI factor calculations.

```csharp
public Font GetFontByType(FontType type);
public Font GetFontByType(FontType type, float scaleRatio);

public IntPtr GetTextBoxFontBySize(int size);
public IntPtr GetTextBoxFontBySize(int size, float scaleRatio);

public IntPtr GetLogFontByType(FontType type);
public IntPtr GetLogFontByType(FontType type, float scaleRatio);

public float GetDeviceScaleFactor(Control control);
public float GetDeviceScaleFactorSqrt(Control control);
```

--------------------------------

### Material Skin Manager Enums

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/material-skin-manager.md

Defines the available themes and font types used throughout the application.

```csharp
public enum Themes : byte
{
    LIGHT,
    DARK
}

public enum FontType
{
    H1, H2, H3, H4, H5, H6,
    Subtitle1, Subtitle2, SubtleEmphasis,
    Body1, Body2,
    Button, Caption, Overline
}
```

--------------------------------

### MaterialSkinManager Singleton Instance

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/material-skin-manager.md

The static Instance property used to access the singleton instance of the MaterialSkinManager.

```csharp
public static MaterialSkinManager Instance => field ?? (field = new MaterialSkinManager());
```

--------------------------------

### MaterialColorHelper and MaterialDrawHelper classes

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/util.md

Provides static methods for color manipulation and drawing shapes like rounded rectangles and shadows, along with the MaterialControlI interface and MaterialMouseState enum.

```csharp
public static class MaterialColorHelper
{
    public static Color Lighten(this Color color, float percent);
    public static Color Darken(this Color color, float percent);
    public static Color FromHsl(int alpha, float hue, float saturation, float lighting);
    public static Color RemoveAlpha(Color foreground, Color background);
}

public static class MaterialDrawHelper
{
    public static GraphicsPath CreateRoundRect(float x, float y, float width, float height, float radius);
    public static GraphicsPath CreateRoundRect(Rectangle rect, float radius);
    public static GraphicsPath CreateRoundRect(RectangleF rect, float radius);
    public static Color BlendColor(Color backgroundColor, Color frontColor, double blend);
    public static Color BlendColor(Color backgroundColor, Color frontColor);
    public static void DrawSquareShadow(Graphics g, Rectangle bounds);
    public static void DrawRoundShadow(Graphics g, Rectangle bounds);
}

public interface MaterialControlI
{
    int Depth { get; set; }
    MaterialSkinManager SkinManager { get; }
    MaterialMouseState MouseState { get; set; }
}

public enum MaterialMouseState
{
    HOVER,
    DOWN,
    OUT
}
```

--------------------------------

### RestoreDockPanelState(state, getContentBySerializationKey)

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/crown-docking.md

Rebuilds the dock panel layout from a previously saved DockPanelState object.

```APIDOC
## RestoreDockPanelState(state, getContentBySerializationKey)

### Description
Rebuilds groups in the saved order and re-docks each content item. Missing keys are skipped during the restoration process.

### Method
public void RestoreDockPanelState(DockPanelState state, Func<string, CrownDockContent> getContentBySerializationKey)

### Parameters
- **state** (DockPanelState) - The state object to restore.
- **getContentBySerializationKey** (Func<string, CrownDockContent>) - A delegate function that maps a SerializationKey to a specific CrownDockContent instance.
```

--------------------------------

### MetroStyleManager.SetTheme(string path)

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/metro-style-manager.md

Sets the custom theme for the manager by loading an XML file from the specified path.

```APIDOC
## SetTheme(string path)

### Description
Loads a custom theme from an XML file and applies it to the manager. This persists the file path and updates the style to Custom.

### Parameters
- **path** (string) - Required - The file system path to the XML theme file.

### Example
```csharp
var metroManager = new MetroStyleManager();
metroManager.SetTheme(@"C:\themes\myTheme.xml");
```
```

--------------------------------

### Clone method with owner

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/poison-style-manager.md

Clones the manager and assigns it to the specified owner container. If the owner is an IPoisonForm, it applies the theme to all components found via reflection.

```csharp
public object Clone(ContainerControl owner)
```

--------------------------------

### MetroStyleManager Properties

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/metro-style-manager.md

Key properties for configuring the theme author, name, owner form, style, and custom theme file path.

```csharp
[Category("Metro"), Description("Gets or sets the The Author name associated with the theme.")]
public string ThemeAuthor { get; set; }

[Category("Metro"), Description("Gets or sets the The Theme name associated with the theme.")]
public string ThemeName { get; set; }

[Category("Metro"), Description("Gets or sets the form (MetroForm) to Apply themes for.")]
public Form OwnerForm { get; set; }

[Category("Metro"), Description("Gets or sets the style.")]
public Style Style { get; set; }

[Editor(typeof(FileNamesEditor), typeof(UITypeEditor)), Category("Metro"), Description("Gets or sets the custom theme file.")]
public string CustomTheme { get; set; }
```

--------------------------------

### MaterialColorScheme Class Definition

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/colors.md

The MaterialColorScheme class definition showing available fields and constructor overloads for initializing color schemes.

```csharp
public class MaterialColorScheme
{
    public readonly Pen PrimaryPen, DarkPrimaryPen, LightPrimaryPen, AccentPen, TextPen;
    public readonly Brush PrimaryBrush, DarkPrimaryBrush, LightPrimaryBrush, AccentBrush, TextBrush;
    public readonly Color PrimaryColor, DarkPrimaryColor, LightPrimaryColor, AccentColor, TextColor;

    public MaterialColorScheme();
    public MaterialColorScheme(MaterialPrimary primary, MaterialPrimary darkPrimary, MaterialPrimary lightPrimary, MaterialAccent accent, MaterialTextShade textShade);
    public MaterialColorScheme(string customPrimary, string customDarkPrimary, string customLightPrimary, string customAccent, MaterialTextShade textShade);
    public MaterialColorScheme(string customPrimary, string customDarkPrimary, string customLightPrimary, string customAccent, string textShade);
    public MaterialColorScheme(int primary, int darkPrimary, int lightPrimary, int accent, MaterialTextShade textShade);
    public MaterialColorScheme(int primary, int darkPrimary, int lightPrimary, int accent, int textShade);
    public MaterialColorScheme(Color primary, Color darkPrimary, Color lightPrimary, Color accent, MaterialTextShade textShade);
    public MaterialColorScheme(Color primary, Color darkPrimary, Color lightPrimary, Color accent, Color textShade);
}
```

--------------------------------

### MetroStyleManager Properties

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/metro-style-manager.md

Key properties for configuring the MetroStyleManager instance.

```APIDOC
## Properties

### OwnerForm
- **Type**: Form
- **Description**: Gets or sets the form associated with the manager.

### CustomTheme
- **Type**: Object
- **Description**: Returns the currently loaded custom theme object, or null if no theme is loaded.

### ButtonDictionary
- **Type**: Dictionary
- **Description**: Provides access to button style properties such as ForeColor.
```

--------------------------------

### MaterialNativeTextRenderer Class

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/util.md

A GDI text renderer designed for crisp Material text rendering, implementing IDisposable.

```csharp
public sealed class MaterialNativeTextRenderer : IDisposable
{
    public MaterialNativeTextRenderer(Graphics g);
    public Size MeasureString(string str, Font font);
    public Size MeasureLogString(string str, IntPtr LogFont);
    public Size MeasureString(string str, Font font, float maxWidth, out int charFit, out int charFitWidth);
    public void DrawString(string str, Font font, Color color, Point point);
    public void DrawString(string str, Font font, Color color, Rectangle rect, TextFormatFlags flags);
    public void DrawTransparentText(string str, Font font, Color color, Point point, Size size, TextAlignFlags flags);
    public void DrawTransparentText(string str, IntPtr LogFont, Color color, Point point, Size size, TextAlignFlags flags);
    public void DrawMultilineTransparentText(string str, Font font, Color color, Point point, Size size, TextAlignFlags flags);
    public void DrawMultilineTransparentText(string str, IntPtr LogFont, Color color, Point point, Size size, TextAlignFlags flags);
    public void Dispose();
    public enum TextFormatFlags : uint { ... }
    public enum TextAlignFlags : uint { ... }
    public enum logFontWeight : int { FW_NORMAL, FW_MEDIUM, FW_BOLD, ... }
    public class LogFont { lfHeight, lfWidth, lfEscapement, lfOrientation, lfWeight, lfItalic, lfUnderline, lfStrikeOut, lfCharSet, lfOutPrecision, lfClipPrecision, lfQuality, lfPitchAndFamily, lfFaceName }
    public static extern bool DeleteObject(IntPtr hObject);
    public static extern bool DeleteDC(IntPtr hdc);
    public static extern IntPtr CreateFontIndirect([In, MarshalAs(UnmanagedType.LPStruct)] LogFont lplf);
    public static extern IntPtr AddFontMemResourceEx(byte[] pbFont, int cbFont, IntPtr pdv, out uint pcFonts);
}
```

--------------------------------

### Concrete Animation Classes

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/animation.md

Definitions for concrete animation classes that inherit from Animate to perform specific UI property transitions.

```csharp
public sealed class ColorBlendAnimation : Animate    // Animate/Poison/ColorBlendAnimation.cs
{
    public void Start(Control control, string property, Color targetColor, int duration);
}

public sealed class ExpandAnimation : Animate        // Animate/Poison/ExpandAnimation.cs
{
    public void Start(Control control, Size targetSize, TransitionType transitionType, int duration);
}

public sealed class MoveAnimation : Animate          // Animate/Poison/MoveAnimation.cs
{
    public void Start(Control control, Point targetPoint, TransitionType transitionType, int duration);
}
```

--------------------------------

### CrownHelper Class Structure

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/crown-controls.md

Defines the structure of the CrownHelper class, including theme definitions and the ThemeProvider.

```csharp
public class CrownHelper
{
    public class DarkTheme : ITheme { ... }   // Sizes + CrownColors (dark palette)
    public class LightTheme : ITheme { ... }  // Sizes + CrownColors (light palette)
    public class ThemeProvider
    {
        public static event PropertyChangedEventHandler PropertyChanged;
        public event PropertyChangedEventHandler PropertyChangedInstance;
        public static ITheme Theme { get; set; }   // defaults to new DarkTheme()
        public void OnPropertyChangedInstance(string name);
        public static void OnPropertyChanged(string name);
    }
}
```

--------------------------------

### GetDockPanelState()

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/crown-docking.md

Captures the current layout state of the dock panel, including regions, groups, and content visibility, into a serializable DockPanelState object.

```APIDOC
## GetDockPanelState()

### Description
Snapshots every region and group within the dock panel. For each group, it records the SerializationKey of each content and the SerializationKey of the currently visible content.

### Method
public DockPanelState GetDockPanelState()

### Returns
- **DockPanelState** - A serializable object containing the current layout configuration.
```

--------------------------------

### SaveTheme

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/metro-style-manager.md

Writes the embedded Metro_Theme XML resource to the system template path.

```APIDOC
## SaveTheme

### Description
Writes the embedded Resources.Metro_Theme XML to PathTheme() and returns nothing.

### Signature
`public void SaveTheme()`
```

--------------------------------

### MaterialAnimations Class

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/util.md

Provides animation utilities and configuration for Material controls, including hover and focus transitions.

```csharp
public class MaterialAnimations
{
    public enum AnimationRunType
    {
        Normal,
        Fast
    }

    public static AnimationRunType AnimationRun { get; set; } = AnimationRunType.Normal;
    public static class AnimationEaseOut { public static double CalculateProgress(double progress); }
    public static class AnimationCustomQuadratic { public static double CalculateProgress(double progress); }

    // internal: AnimationType (Linear, EaseOut, EaseInOut, CustomQuadratic),
    // AnimationDirection (In, Out, InOutIn, InOutOut, InOutRepeatingIn, InOutRepeatingOut)
    // + internal AnimationManager used by Material controls for hover/focus animations
}
```

--------------------------------

### Parrot math helper classes

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/parrot-controls.md

Defines the Percentage and RoundInt static classes used for math operations within the Parrot utility set.

```csharp
public static class Percentage
{
    // Percentage(progress, total) family
}

public static class RoundInt
{
    // Round(PointF) -> Point, Round(SizeF) -> Size helping methods
}
```

--------------------------------

### MetroButton constructor

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/metro-controls.md

The constructor for the MetroButton control.

```csharp
public MetroButton()
```

--------------------------------

### ITheme Interface Definition

Source: https://github.com/taiizor/realtaiizor/blob/develop/_autodocs/api-reference/crown-controls.md

The interface required for implementing custom themes within the Crown system.

```csharp
public interface ITheme
{
    Sizes Sizes { get; }
    CrownColors Colors { get;
}
```
Tokens:
Raw