AdvancedImageViewer.WinForms 1.0.0

Advanced Image Viewer for WinForms

High-performance image viewer for Windows Forms with smooth pan, precision zoom, dynamic scaling, themes, and optimized rendering.

Preview

<p align="center"> <img src="https://raw.githubusercontent.com/COxRIPMIZO/GRIT.UI.Controls/master/Demo%20%26%20Images/ImageViewer/ImageViewerDemo.gif" alt="Advanced Image Viewer Demo" width="900" /> </p>

Overview

AdvancedImageViewer is a modern, high-performance replacement for the standard WinForms PictureBox.

It provides smooth image navigation, high-resolution rendering, customizable themes, and programmatic control over zooming, panning, and overlays.

Built for:

• .NET Framework 4.7.2+
• .NET 6.0
• .NET 8.0+

Features

Performance

• Double-buffered rendering
• Premultiplied-ARGB image caching
• Reduced flickering during panning
• Optimized rendering for large images
• Smooth interaction with HD, 4K, and 8K images

Zoom & Pan

• Scroll-wheel zoom
• Mouse drag panning
• Zoom range from 5% to 10000%
• Automatic image fitting
• Programmatic zoom control
• Programmatic panning

Built-in Styles

Choose from five visual styles:

• DashboardPremium
• FluentGlass
• MaterialFlat
• SoftNeumorphic
• Cyberpunk

Themes

Built-in theme support:

• Light
• Dark

HUD

Optional on-screen information:

• Zoom percentage
• Image dimensions
• Cursor X/Y coordinates

Additional visual options:

• Crosshair
• Scanlines
• Enhanced image scaling

Installation

Install using NuGet Package Manager:

Install-Package AdvancedImageViewer.WinForms

Or search for:

AdvancedImageViewer.WinForms

inside Visual Studio NuGet Package Manager.

Quick Start

Create Viewer

using GRIT.UI.WinForms;

var viewer = new AdvancedImageViewer();

viewer.Dock = DockStyle.Fill;

this.Controls.Add(viewer);

Load Image

Load an image synchronously:

viewer.LoadFromFile(@"C:\photos\sample.jpg");

For large images, use asynchronous loading:

await viewer.LoadFromFileAsync(
    @"C:\photos\massive_image.png"
);

Customization

Theme

viewer.ThemeMode = ThemeMode.Dark;

Style

viewer.ControlStyle = ViewerStyle.Cyberpunk;

Available styles:

DashboardPremium
FluentGlass
MaterialFlat
SoftNeumorphic
Cyberpunk

HUD

viewer.ShowHud = true;
viewer.ShowCrosshair = true;
viewer.ShowScanlines = true;

Image Quality

viewer.EnhanceImage = true;

EnhanceImage controls image scaling quality:

• true — smooth image scaling
• false — sharper pixel rendering

Zoom & Pan

Auto Fit

Automatically scale and center image:

viewer.AutoFit();

Zoom

Set zoom to 150%:

viewer.Zoom = 1.5f;

Pan

Move viewport horizontally:

viewer.PanBy(100, 0);

Custom Overlays

Use OverlayPaint to draw custom graphics over the image.

Example:

viewer.OverlayPaint += (s, e) =>
{
    // Define rectangle using RAW image coordinates
    Rectangle rawFaceRect =
        new Rectangle(500, 200, 300, 300);

    // Convert image coordinates to screen coordinates
    RectangleF screenRect =
        viewer.ImageToScreenF(rawFaceRect);

    // Draw overlay
    using (Pen pen = new Pen(e.Palette.Accent, 2f))
    {
        e.Graphics.DrawRectangle(
            pen,
            screenRect.X,
            screenRect.Y,
            screenRect.Width,
            screenRect.Height
        );
    }
};

The viewer automatically converts image coordinates to screen coordinates.

Your overlay follows zoom and pan automatically.

Complete Example

using GRIT.UI.WinForms;

public partial class MainForm : Form
{
    private readonly AdvancedImageViewer viewer;

    public MainForm()
    {
        InitializeComponent();

        viewer = new AdvancedImageViewer
        {
            Dock = DockStyle.Fill,
            ThemeMode = ThemeMode.Dark,
            ControlStyle = ViewerStyle.DashboardPremium,
            ShowHud = true,
            ShowCrosshair = true,
            EnhanceImage = true
        };

        Controls.Add(viewer);

        viewer.LoadFromFile(
            @"C:\photos\sample.jpg"
        );
    }
}

API Overview

Image Loading

viewer.LoadFromFile(path);

await viewer.LoadFromFileAsync(path);

Viewport

viewer.AutoFit();

viewer.Zoom = 1.5f;

viewer.PanBy(100, 0);

Appearance

viewer.ThemeMode = ThemeMode.Dark;

viewer.ControlStyle = ViewerStyle.Cyberpunk;

HUD

viewer.ShowHud = true;

viewer.ShowCrosshair = true;

viewer.ShowScanlines = true;

Image Rendering

viewer.EnhanceImage = true;

Coordinate Conversion

RectangleF screenRect =
    viewer.ImageToScreenF(rawRect);

Custom Rendering

viewer.OverlayPaint += OnOverlayPaint;

Supported Frameworks

Use Cases

Why AdvancedImageViewer?

The standard WinForms PictureBox works well for basic image display.

AdvancedImageViewer adds the features needed for professional image-based applications.

<p align="center"> <strong>AdvancedImageViewer.WinForms</strong> <br /> High-performance image viewing for Windows Forms. </p>