AdvancedImageViewer.WinForms 1.0.1

AdvancedImageViewer.WinForms

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

Advanced Image Viewer Demo Theme Demo

Advanced Image Viewer Demo Other Demo

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 & Themes

• Styles: DashboardPremium, FluentGlass, MaterialFlat, SoftNeumorphic, Cyberpunk
• Themes: Built-in Light and Dark mode support.

HUD & Visuals

• Zoom percentage, Image dimensions, and Cursor X/Y coordinates
• Optional Crosshair and Scanlines
• Enhanced image scaling (smooth vs. sharp pixel rendering)

Installation

Package Manager Console

Install-Package AdvancedImageViewer.WinForms

.NET CLI

dotnet add package AdvancedImageViewer.WinForms

Quick Start

Create Viewer

using GRIT.UI.WinForms;

var viewer = new AdvancedImageViewer();
viewer.Dock = DockStyle.Fill;
this.Controls.Add(viewer);

Load Image

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

// For large images, use asynchronous loading
await viewer.LoadFromFileAsync(@"C:\photos\massive_image.png");

Customization

Theme & Style

viewer.ThemeMode = ThemeMode.Dark;
viewer.ControlStyle = ViewerStyle.Cyberpunk;

HUD & Image Quality

viewer.ShowHud = true;
viewer.ShowCrosshair = true;
viewer.ShowScanlines = true;
viewer.EnhanceImage = true; // true = smooth scaling, false = sharper pixels

Viewport Controls (Zoom & Pan)

viewer.AutoFit();       // Automatically scale and center image
viewer.Zoom = 1.5f;     // Set zoom to 150%
viewer.PanBy(100, 0);   // Move viewport horizontally

Custom Overlays

Use OverlayPaint to draw custom graphics over the image. The viewer automatically converts image coordinates to screen coordinates, so your overlay follows zoom and pan seamlessly.

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);
    }
};

Why AdvancedImageViewer?

Developed under the GRIT Ecosystem

Growth • Resilience • Intensity • Tenacity
Building zero-dependency, ultra-performance developer workflows and premium component layouts.