LibDithering 1.2.0

dotnet add package LibDithering --version 1.2.0
                    
NuGet\Install-Package LibDithering -Version 1.2.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="LibDithering" Version="1.2.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="LibDithering" Version="1.2.0" />
                    
Directory.Packages.props
<PackageReference Include="LibDithering" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add LibDithering --version 1.2.0
                    
#r "nuget: LibDithering, 1.2.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.
#:package LibDithering@1.2.0
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=LibDithering&version=1.2.0
                    
Install as a Cake Addin
#tool nuget:?package=LibDithering&version=1.2.0
                    
Install as a Cake Tool

CSharp-Dithering

CSharp (C#) versions of certain dithering algorithms. This project is .NET 10 and .NET 11 compatible, managed and available as Nuget!

Examples

Use Atkinson dithering with web safe color reduction for 24 bit PNG input with System.Drawing (this example is Windows only)

public void DoAtkinsonDithering()
{
    AtkinsonDitheringRGB<byte> atkinson = new AtkinsonDitheringRGB<byte>(TrueColorBytesToWebSafeColorBytes);

    using(FileStream pngStream = new FileStream("half.png", FileMode.Open, FileAccess.Read))
    using(var image = new Bitmap(pngStream))
    {
        byte[,,] bytes = ReadBitmapToColorBytes(image);

        TempByteImageFormat temp = new TempByteImageFormat(bytes);
        atkinson.DoDithering(temp);

        WriteToBitmap(image, temp.GetPixelChannels);

        image.Save("test.png");
    }
}

private static void TrueColorBytesToWebSafeColorBytes(in byte[] input, ref byte[] output)
{
    for (int i = 0; i < input.Length; i++)
    {
        output[i] = (byte)(Math.Round(input[i] / 51.0) * 51);
    }
}

private static byte[,,] ReadBitmapToColorBytes(Bitmap bitmap)
{
    byte[,,] returnValue = new byte[bitmap.Width, bitmap.Height, 3];
    for (int x = 0; x < bitmap.Width; x++)
    {
        for (int y = 0; y < bitmap.Height; y++)
        {
            Color color = bitmap.GetPixel(x, y);
            returnValue[x, y, 0] = color.R;
            returnValue[x, y, 1] = color.G;
            returnValue[x, y, 2] = color.B;
        }
    }
    return returnValue;
}

private static void WriteToBitmap(Bitmap bitmap, Func<int, int, byte[]> reader)
{
    for (int x = 0; x < bitmap.Width; x++)
    {
        for (int y = 0; y < bitmap.Height; y++)
        {
            byte[] read = reader(x, y);
            Color color = Color.FromArgb(read[0], read[1], read[2]);
            bitmap.SetPixel(x, y, color);
        }
    }
}
Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed.  net11.0 is compatible. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • net10.0

    • No dependencies.
  • net11.0

    • No dependencies.

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.2.0 0 11/19/2026
1.1.1 493 12/3/2025
1.1.0 1,897 2/10/2025
1.0.1 2,552 11/18/2023
1.0.0 1,914 5/29/2022
0.9.3 1,233 9/17/2020
0.9.2 661 9/10/2020
0.9.1 674 9/3/2020
0.9.0 695 7/30/2020

## Version 1.2.0 (released 2026-11-19)
- Support net11.0 (**FEATURE**)
- Drop support for .NET 8 (**BREAKING**)
- Use `Dithering` namespace (**BREAKING**)

## Version 1.1.1 (released 2025-12-03)
- Update to .NET 10 (**FEATURE**)
- Experimental blue noise dithering (**FEATURE**)

## Version 1.1.0 (released 2025-02-10)
- Removed .NET Standard 2.0 support (**BREAKING**)
- Use generic math to limit supported formats (**BREAKING**)

## Version 1.0.1 (released 2023-11-17)
- Update to .NET 8 (**FEATURE**)
- Trimmable support (**FEATURE**)

## Version 1.0.0 (released 2022-05-29)
- Deterministic build (**FEATURE**)

## Version 0.9.3 (released 2020-09-17)
- Better TempDoubleImageFormat (**IMPROVEMENT**)
- Add Get Raw Content (**FEATURE**)

## Version 0.9.2 (released 2020-09-10)
- Fix 1d data of TempByteImageFormat (**BUGFIX**)
- Reduce allocations (**IMPROVEMENT**)

## Version 0.9.1 (released 2020-09-03)
- Refactored IImageFormat to generics (**BREAKING**)

## Version 0.9.0 (released 2020-07-30)
- Initial Nuget release