Etymon.ImageHelper 1.0.5

Etymon.ImageHelper

Etymon.ImageHelper is a lightweight, cross-platform C# image processing library designed for modern .NET applications.
It provides a clean, high-performance abstraction for:

• Image resizing
• Compression
• WebP conversion
• Padding (canvas resizing)
• Local file uploads
• Azure Blob Storage uploads

Powered by SkiaSharp for safe, fast, cross-platform image handling.

🚀 Features

• ✨ Cross-platform image processing (SkiaSharp – no System.Drawing)
• 🖼️ Resize, scale, pad with background color
• 🌐 Convert images to WebP
• 📦 Compress images (JPEG quality control)
• 💾 Save files locally (unique file naming)
• ☁️ Upload to Azure Blob Storage with full HTTP header control
• 🔐 Prevent filename collisions (local + cloud)
• 🔧 Clean, modular architecture

📦 Installation

dotnet add package Etymon.ImageHelper

🧩 Components Overview

Everything is dependency-free except SkiaSharp + Azure.Storage.Blobs.

🖼️ Basic Usage

1️⃣ Resize an Image

using Etymon.ImageHelper;

using var stream = File.OpenRead("input.jpg");
var bitmap = ImageProcessor.Resize(
    ImageProcessor.Load(stream),
    maxWidth: 800,
    maxHeight: 800,
    force: false
);

var bytes = ImageProcessor.Encode(bitmap, ".jpg", 85);
File.WriteAllBytes("output.jpg", bytes);

2️⃣ Convert to WebP

using var stream = File.OpenRead("input.png");
var webpBytes = ImageProcessor.ConvertToWebp(stream);
File.WriteAllBytes("output.webp", webpBytes);

3️⃣ Add Padding (Fixed Canvas)

var padded = ImageProcessor.ResizeWithPadding(
    srcBitmap,
    canvasW: 600,
    canvasH: 600,
    bgColor: new SKColor(255, 255, 255)
);

💾 Local File Upload

var storage = new LocalFileStorageService(webRootPath);

string fileName = storage.Save(formFile, "uploads/images");
// returns safe, unique file name

☁️ Azure Blob Storage Upload

var blobService = new AzureBlobStorageService(
    connectionString,
    containerName
);

var result = await blobService.UploadAsync(
    fileControl,
    folder: "product-images",
    existingNames: existingBlobNames
);

if (result.Success)
{
    Console.WriteLine(result.OriginalImageFullPath);
}

📘 Sample Response Model

{
  "success": true,
  "originalImageFullPath": "https://yourstorage.blob.core.windows.net/container/upload/image1.jpg"
}

📐 File Naming Utilities

string safe = FileNameHelper.GetSafeFileName("My Image 2025!!.jpg");
// my_image_2025.jpg

string unique = FileNameHelper.GetUniqueFileName("/app/wwwroot/uploads", safe);

🔧 Why SkiaSharp?

System.Drawing.Common is not supported on:

• Linux
• macOS
• Docker
• Azure App Service (Linux)
• .NET 7+

SkiaSharp:

✔ cross-platform
✔ GPU-optimized
✔ production-safe
✔ Google’s Skia engine (Chrome, Android)

🛠️ Project Structure

/Etymon.ImageHelper
 ├── ImageProcessor.cs
 ├── LocalFileStorageService.cs
 ├── AzureBlobStorageService.cs
 ├── FileNameHelper.cs
 ├── FileUploadResponseModel.cs
 └── README.md

🧭 Roadmap (Upcoming Features)

• AVIF encoding support
• EXIF metadata utilities
• Automatic image orientation (based on EXIF rotation)
• Streaming-based transformations
• Built-in validation (max size, allowed types, etc.)

❤️ Contribute / Feedback

This library is maintained by Etymon Technologies.
Feedback, improvements, or feature requests are welcome!