C# High Performance Pixel Handling
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 |
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.
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.
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 |
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 |
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 |
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 |
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.
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 |
