HPPH.System.Drawing 1.0.0

.NET 8.0 This package targets .NET 8.0. The package is compatible with this framework or higher. 
dotnet add package HPPH.System.Drawing --version 1.0.0                

                    
                

            
NuGet\Install-Package HPPH.System.Drawing -Version 1.0.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="HPPH.System.Drawing" Version="1.0.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
paket add HPPH.System.Drawing --version 1.0.0                

                    
                

            
#r "nuget: HPPH.System.Drawing, 1.0.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
// Install HPPH.System.Drawing as a Cake Addin
#addin nuget:?package=HPPH.System.Drawing&version=1.0.0

// Install HPPH.System.Drawing as a Cake Tool
#tool nuget:?package=HPPH.System.Drawing&version=1.0.0

HPPH

C# High Performance Pixel Handling

Summary

This library contains helpers to work with color data (currently only 24 and 32 bit byte data) in a somewhat performance-optimized fully in C#.

It consists of the following packages:

Package Description
HPPH Core-package, containg all the features described below
HPPH.System.Drawing Contains extensions to convert Images from and to System.Drawing.Bitmaps
HPPH.SkiaSharp Contains extensions to convert Images from and to SkiaSharp images and bitmaps

Supported Operations

All of the currently supported operations are briefly described below. More are to come.

Benchmarks are all run on an Ryzen 9 5900X. Reference is always a simple approach like looping over the data performing the operation.
The data used is always the full set of sample_data to cover a variaty of images.

Image

An abstraction layer for handling pixel-grids.

Supports all of the operations below and things like allocation-free region selection, iteration and copying of rows, colums or whole images/regions.

Sum

Optimized summarization of colors into 4 longs (one for each channel).

Method Mean Error StdDev Allocated
PixelHelper_3BPP 107.3 μs 0.21 μs 0.20 μs 528 B
PixelHelper_4BPP 167.7 μs 0.85 μs 0.71 μs 528 B
Reference_3BPP 1,683.3 μs 18.87 μs 17.65 μs 529 B
Reference_4BPP 1,619.5 μs 9.08 μs 7.58 μs 529 B

Average

Averages some colors into a single color of the same format.

Method Mean Error StdDev Allocated
PixelHelper_3BPP 108.2 μs 0.41 μs 0.34 μs 56 B
PixelHelper_4BPP 169.0 μs 2.29 μs 2.14 μs 64 B
Reference_3BPP 1,654.9 μs 12.06 μs 11.28 μs 705 B
Reference_4BPP 1,613.4 μs 21.11 μs 18.71 μs 713 B

Min-Max

Gets the minimum and maximum value for each channel of the given color data.

Method Mean Error StdDev Allocated
PixelHelper_3BPP 106.2 μs 0.38 μs 0.35 μs 312 B
PixelHelper_4BPP 139.2 μs 1.94 μs 1.82 μs 312 B
Reference_3BPP 3,838.1 μs 35.40 μs 31.38 μs 314 B
Reference_4BPP 4,456.9 μs 21.06 μs 19.70 μs 315 B

Sort

Sorts color data by a single channel (Red, Green, Blue or Alpha).
The algorithm is stable.

This benchmark is somewhat flawed as it's effectivly running on pre-sorted data, which does not affect the PixelHelper, but might affect the Reference.

It's also using Linq.OrderBy which is not ideal performance-wise and requires some unneccessary allocations to fit the API, but Array/Span.Sort is not stable, which the PixelHelper is so that wouldn't be a fair comparison.)

Method Mean Error StdDev Allocated
PixelHelper_3BPP 4.084 ms 0.0084 ms 0.0075 ms 6 B
PixelHelper_4BPP 2.687 ms 0.0102 ms 0.0091 ms 3 B
Reference_3BPP 59.883 ms 0.5693 ms 0.5325 ms 43118222 B
Reference_4BPP 59.599 ms 0.4866 ms 0.4551 ms 52355952 B

Quantization

Creates a color-palette of a given size for some color-data.
Currently only a simple but fast variation using the median-cut algorithm is implemented. It's also limited to sizes being a power of 2.

A more quality focused implementation without the size limitation is planned.

Conversion

Converts from one color format to another.
All of the included formats can freely be converted between each other.

Allocation-free in-place conversion is only supported for formats of same size (both 24 or 32 bit).

Method Mean Error StdDev Allocated
RGBToBGR 6.272 ms 0.0288 ms 0.0240 ms 8.81 MB
RGBToBGRA 8.534 ms 0.0684 ms 0.0640 ms 11.75 MB
RGBAToABGR 8.128 ms 0.0927 ms 0.0867 ms 11.75 MB
ARGBToBGR 8.004 ms 0.0353 ms 0.0313 ms 8.81 MB
Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.0.0 250 7/21/2024