Easy.Tools.ThumbnailMaker 1.0.0

Easy.Tools.ThumbnailMaker

Easy.Tools.ThumbnailMaker is a lightweight and flexible .NET library that enables quick and easy creation of thumbnails (small preview images), resizing images, and adding text watermarks in your applications.

Features

• Asynchronous image loading and thumbnail generation
• Automatic EXIF orientation correction (auto-orient)
• Flexible resize modes: Fit, Cover, Pad, Crop, Contain
• Background color and padding support
• Text watermark with customizable position, font, color, size, and opacity
• JPEG and PNG output formats
• Metadata stripping options (EXIF, ICC, XMP profiles)
• Minimal external dependencies, high performance
• Cross‑platform (Windows, Linux, macOS)

Installation

Install via NuGet:

dotnet add package Easy.Tools.ThumbnailMaker

Usage

Simple thumbnail creation

using ThumbnailMakers;

// Input and output file paths
await using var input = File.OpenRead("test.jpeg");
await using var output = File.Create("test1.jpeg");

// Define thumbnail colors
var white = ThumbnailColor.White;
var red = new ThumbnailColor(255, 0, 0);
var semiTransparentBlue = new ThumbnailColor(0, 0, 255, 128);
var fromHex1 = ThumbnailColor.FromHex("#FF0000");        // RRGGBB
var fromHex2 = ThumbnailColor.FromHex("80FF0000");       // AARRGGBB

// Create a thumbnail with specific options
var opts = new ThumbnailOptions(320, 320)
{
    Mode = ThumbnailResizeMode.Cover,
    Output = OutputFormat.Jpeg(85),
    Watermark = Watermark.TextMark("© ACME", size: 18, opacity: 100f, color: red)

};

// Create the thumbnail
await Thumbnail.MakeAsync(input, output, opts);

Details

Thumbnail.MakeAsync(Stream input, ThumbnailOptions options, CancellationToken ct = default)

• input: Stream containing the source image
• options: Thumbnail creation options (ThumbnailOptions)
• ct: Cancellation token (optional)
• Returns: Byte array of the created thumbnail image

Thumbnail.MakeAsync(Stream input, Stream output, ThumbnailOptions options, CancellationToken ct = default)

• input: Stream containing the source image
• output: Stream containing the output image
• options: Thumbnail creation options (ThumbnailOptions)
• ct: Cancellation token (optional)
• Returns: Task representing the asynchronous operation

ThumbnailOptions

• int Width - Thumbnail width (required)
• int Height - Thumbnail height (required)
• ThumbnailResizeMode Mode - Resize mode (Fit, Cover, Pad, Crop, Contain)
• Anchor Anchor - Represents the anchor point for positioning elements in a thumbnail.
• bool AutoOrient - Apply EXIF orientation correction automatically
• bool StripMetadata - Remove metadata from output
• ColorBackground? Background - Background color (used in Pad mode)
• OutputFormat Output - Output file format and quality settings
• Watermark Watermark - Text watermark settings
• bool PreventUpscale - Prevents upscaling of the image if the source is smaller than the target size

Watermark

• string Text - Watermark text
• float FontSize - Font size
• float Opacity - Opacity (0 to 1)
• Anchor Position - Position (e.g. BottomRight)
• int Margin - Margin in pixels
• string FontFamily - Font family name
• ThumbnailColor color - Color (hex, Rgb, etc.)

Supported ThumbnailResizeModes

Requirements

• .NET 6 or later
• SixLabors.ImageSharp (internal dependency)
• SixLabors.Fonts (internal dependency)
• SixLabors.ImageSharp.Drawing (internal dependency)

License

This project is licensed under the MIT License. See the LICENSE file for details.

Contributing

Contributions and feedback are welcome! Please start by opening an issue.

Contact

For questions, contact us via elmin.alirzayev@gmail.com or GitHub.

© Elmin Alirzayev 2025 / Easy Code Tools