ImageData

Image Data

A lightweight .NET library providing efficient handling of image data with support for multiple pixel formats and serialization.

Features

• 🖼 Image Data Handling — Encapsulates pixel buffers in the ImageData struct with width, height, stride, and format metadata.
• 🔄 Serialization Support — Convert images to and from byte arrays or streams for efficient storage and transfer.
• 🧩 Supported Formats — Multiple pixel formats such as Mono8, Mono16, Rgb24, Rgb32.
• ⚡ Zero-Copy Parsing — Optimized APIs like TryFromMemory avoid unnecessary allocations when possible.
• 🎯 Lightweight — Minimal dependencies, focused on core image data representation.

Installation

Add the project or library to your solution. If published as a NuGet package, install via:

dotnet add package ImageData

Working with ImageData

Serialize to Array

var camera = new DummyCamera();
ImageData img = camera.GetImage();

byte[] serialized = img.ToArray();

Deserialize from Array

ImageData img2 = ImageData.FromArray(serialized);

Zero-Copy Parse from Memory

if (ImageData.TryFromMemory(serialized, out var img3))
{
    Console.WriteLine($"Image parsed: {img3.Width}x{img3.Height}, {img3.Format}");
}

Read/Write from Stream

using var ms = new MemoryStream();
img.WriteTo(ms);

ms.Position = 0;
ImageData img4 = ImageData.ReadFrom(ms);

Supported Image Formats

• Mono8 – 8-bit grayscale
• Mono16 – 16-bit grayscale
• Rgb24 – 24-bit RGB
• Rgb32 – 32-bit RGB (with alpha or padding)
• Raw8 / Raw16 – Raw image buffers

License

MIT License — free to use, modify, and distribute.