mirror of https://github.com/SixLabors/ImageSharp
James Jackson-South
8 years ago
26 changed files with 571 additions and 484 deletions
@ -1,56 +0,0 @@ |
|||||
// Copyright (c) Six Labors and contributors.
|
|
||||
// Licensed under the Apache License, Version 2.0.
|
|
||||
|
|
||||
namespace SixLabors.ImageSharp.Processing.Quantization |
|
||||
{ |
|
||||
/// <summary>
|
|
||||
/// Represents a box color cube.
|
|
||||
/// </summary>
|
|
||||
internal struct Box |
|
||||
{ |
|
||||
/// <summary>
|
|
||||
/// Gets or sets the min red value, exclusive.
|
|
||||
/// </summary>
|
|
||||
public int R0 { get; set; } |
|
||||
|
|
||||
/// <summary>
|
|
||||
/// Gets or sets the max red value, inclusive.
|
|
||||
/// </summary>
|
|
||||
public int R1 { get; set; } |
|
||||
|
|
||||
/// <summary>
|
|
||||
/// Gets or sets the min green value, exclusive.
|
|
||||
/// </summary>
|
|
||||
public int G0 { get; set; } |
|
||||
|
|
||||
/// <summary>
|
|
||||
/// Gets or sets the max green value, inclusive.
|
|
||||
/// </summary>
|
|
||||
public int G1 { get; set; } |
|
||||
|
|
||||
/// <summary>
|
|
||||
/// Gets or sets the min blue value, exclusive.
|
|
||||
/// </summary>
|
|
||||
public int B0 { get; set; } |
|
||||
|
|
||||
/// <summary>
|
|
||||
/// Gets or sets the max blue value, inclusive.
|
|
||||
/// </summary>
|
|
||||
public int B1 { get; set; } |
|
||||
|
|
||||
/// <summary>
|
|
||||
/// Gets or sets the min alpha value, exclusive.
|
|
||||
/// </summary>
|
|
||||
public int A0 { get; set; } |
|
||||
|
|
||||
/// <summary>
|
|
||||
/// Gets or sets the max alpha value, inclusive.
|
|
||||
/// </summary>
|
|
||||
public int A1 { get; set; } |
|
||||
|
|
||||
/// <summary>
|
|
||||
/// Gets or sets the volume.
|
|
||||
/// </summary>
|
|
||||
public int Volume { get; set; } |
|
||||
} |
|
||||
} |
|
||||
@ -0,0 +1,35 @@ |
|||||
|
// Copyright (c) Six Labors and contributors.
|
||||
|
// Licensed under the Apache License, Version 2.0.
|
||||
|
|
||||
|
using SixLabors.ImageSharp.PixelFormats; |
||||
|
using SixLabors.ImageSharp.Processing.Dithering.ErrorDiffusion; |
||||
|
|
||||
|
namespace SixLabors.ImageSharp.Processing.Quantization.FrameQuantizers |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// Provides methods to allow the execution of the quantization process on an image frame.
|
||||
|
/// </summary>
|
||||
|
/// <typeparam name="TPixel">The pixel format.</typeparam>
|
||||
|
public interface IFrameQuantizer<TPixel> |
||||
|
where TPixel : struct, IPixel<TPixel> |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// Gets a value indicating whether to apply dithering to the output image.
|
||||
|
/// </summary>
|
||||
|
bool Dither { get; } |
||||
|
|
||||
|
/// <summary>
|
||||
|
/// Gets the dithering algorithm to apply to the output image.
|
||||
|
/// </summary>
|
||||
|
IErrorDiffuser DitherType { get; } |
||||
|
|
||||
|
/// <summary>
|
||||
|
/// Quantize an image frame and return the resulting output pixels.
|
||||
|
/// </summary>
|
||||
|
/// <param name="image">The image to quantize.</param>
|
||||
|
/// <returns>
|
||||
|
/// A <see cref="QuantizedFrame{TPixel}"/> representing a quantized version of the image pixels.
|
||||
|
/// </returns>
|
||||
|
QuantizedFrame<TPixel> QuantizeFrame(ImageFrame<TPixel> image); |
||||
|
} |
||||
|
} |
||||
@ -0,0 +1,33 @@ |
|||||
|
// Copyright (c) Six Labors and contributors.
|
||||
|
// Licensed under the Apache License, Version 2.0.
|
||||
|
|
||||
|
using SixLabors.ImageSharp.PixelFormats; |
||||
|
using SixLabors.ImageSharp.Processing.Dithering.ErrorDiffusion; |
||||
|
using SixLabors.ImageSharp.Processing.Quantization.FrameQuantizers; |
||||
|
|
||||
|
namespace SixLabors.ImageSharp.Processing.Quantization |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// Provides methods for allowing quantization of images pixels with configurable dithering.
|
||||
|
/// </summary>
|
||||
|
public interface IQuantizer |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// Gets a value indicating whether to apply dithering to the output image.
|
||||
|
/// </summary>
|
||||
|
bool Dither { get; } |
||||
|
|
||||
|
/// <summary>
|
||||
|
/// Gets the dithering algorithm to apply to the output image.
|
||||
|
/// </summary>
|
||||
|
IErrorDiffuser DitherType { get; } |
||||
|
|
||||
|
/// <summary>
|
||||
|
/// Creates the generic frame quantizer
|
||||
|
/// </summary>
|
||||
|
/// <typeparam name="TPixel">The pixel format.</typeparam>
|
||||
|
/// <returns>The <see cref="IFrameQuantizer{TPixel}"/></returns>
|
||||
|
IFrameQuantizer<TPixel> CreateFrameQuantizer<TPixel>() |
||||
|
where TPixel : struct, IPixel<TPixel>; |
||||
|
} |
||||
|
} |
||||
@ -1,42 +0,0 @@ |
|||||
// Copyright (c) Six Labors and contributors.
|
|
||||
// Licensed under the Apache License, Version 2.0.
|
|
||||
|
|
||||
using SixLabors.ImageSharp.PixelFormats; |
|
||||
using SixLabors.ImageSharp.Processing.Dithering.ErrorDiffusion; |
|
||||
|
|
||||
namespace SixLabors.ImageSharp.Processing.Quantization |
|
||||
{ |
|
||||
/// <summary>
|
|
||||
/// Provides methods for for allowing quantization of images pixels with configurable dithering.
|
|
||||
/// </summary>
|
|
||||
/// <typeparam name="TPixel">The pixel format.</typeparam>
|
|
||||
public interface IQuantizer<TPixel> : IQuantizer |
|
||||
where TPixel : struct, IPixel<TPixel> |
|
||||
{ |
|
||||
/// <summary>
|
|
||||
/// Quantize an image and return the resulting output pixels.
|
|
||||
/// </summary>
|
|
||||
/// <param name="image">The image to quantize.</param>
|
|
||||
/// <param name="maxColors">The maximum number of colors to return.</param>
|
|
||||
/// <returns>
|
|
||||
/// A <see cref="T:QuantizedImage"/> representing a quantized version of the image pixels.
|
|
||||
/// </returns>
|
|
||||
QuantizedFrame<TPixel> Quantize(ImageFrame<TPixel> image, int maxColors); |
|
||||
} |
|
||||
|
|
||||
/// <summary>
|
|
||||
/// Provides methods for allowing quantization of images pixels with configurable dithering.
|
|
||||
/// </summary>
|
|
||||
public interface IQuantizer |
|
||||
{ |
|
||||
/// <summary>
|
|
||||
/// Gets or sets a value indicating whether to apply dithering to the output image.
|
|
||||
/// </summary>
|
|
||||
bool Dither { get; set; } |
|
||||
|
|
||||
/// <summary>
|
|
||||
/// Gets or sets the dithering algorithm to apply to the output image.
|
|
||||
/// </summary>
|
|
||||
IErrorDiffuser DitherType { get; set; } |
|
||||
} |
|
||||
} |
|
||||
@ -0,0 +1,75 @@ |
|||||
|
// Copyright (c) Six Labors and contributors.
|
||||
|
// Licensed under the Apache License, Version 2.0.
|
||||
|
|
||||
|
using SixLabors.ImageSharp.PixelFormats; |
||||
|
using SixLabors.ImageSharp.Processing.Dithering; |
||||
|
using SixLabors.ImageSharp.Processing.Dithering.ErrorDiffusion; |
||||
|
using SixLabors.ImageSharp.Processing.Quantization.FrameQuantizers; |
||||
|
|
||||
|
namespace SixLabors.ImageSharp.Processing.Quantization |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// Allows the quantization of images pixels using Octrees.
|
||||
|
/// <see href="http://msdn.microsoft.com/en-us/library/aa479306.aspx"/>
|
||||
|
/// </summary>
|
||||
|
public class OctreeQuantizer : IQuantizer |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// Initializes a new instance of the <see cref="OctreeQuantizer"/> class.
|
||||
|
/// </summary>
|
||||
|
public OctreeQuantizer() |
||||
|
: this(255) |
||||
|
{ |
||||
|
} |
||||
|
|
||||
|
/// <summary>
|
||||
|
/// Initializes a new instance of the <see cref="OctreeQuantizer"/> class.
|
||||
|
/// </summary>
|
||||
|
/// <param name="dither">Whether to apply dithering to the output image</param>
|
||||
|
public OctreeQuantizer(bool dither) |
||||
|
: this(dither, DiffuseMode.FloydSteinberg, 255) |
||||
|
{ |
||||
|
} |
||||
|
|
||||
|
/// <summary>
|
||||
|
/// Initializes a new instance of the <see cref="OctreeQuantizer"/> class.
|
||||
|
/// </summary>
|
||||
|
/// <param name="maxColors">The maximum number of colors to hold in the color palette</param>
|
||||
|
public OctreeQuantizer(int maxColors) |
||||
|
: this(true, DiffuseMode.FloydSteinberg, maxColors) |
||||
|
{ |
||||
|
} |
||||
|
|
||||
|
/// <summary>
|
||||
|
/// Initializes a new instance of the <see cref="OctreeQuantizer"/> class.
|
||||
|
/// </summary>
|
||||
|
/// <param name="dither">Whether to apply dithering to the output image</param>
|
||||
|
/// <param name="ditherType">The dithering algorithm to apply to the output image</param>
|
||||
|
/// <param name="maxColors">The maximum number of colors to hold in the color palette</param>
|
||||
|
public OctreeQuantizer(bool dither, IErrorDiffuser ditherType, int maxColors) |
||||
|
{ |
||||
|
Guard.NotNull(ditherType, nameof(ditherType)); |
||||
|
Guard.MustBeBetweenOrEqualTo(maxColors, 1, 255, nameof(maxColors)); |
||||
|
|
||||
|
this.Dither = dither; |
||||
|
this.DitherType = ditherType; |
||||
|
this.MaxColors = maxColors; |
||||
|
} |
||||
|
|
||||
|
/// <inheritdoc />
|
||||
|
public bool Dither { get; } |
||||
|
|
||||
|
/// <inheritdoc />
|
||||
|
public IErrorDiffuser DitherType { get; } |
||||
|
|
||||
|
/// <summary>
|
||||
|
/// Gets the maximum number of colors to hold in the color palette.
|
||||
|
/// </summary>
|
||||
|
public int MaxColors { get; } |
||||
|
|
||||
|
/// <inheritdoc />
|
||||
|
public IFrameQuantizer<TPixel> CreateFrameQuantizer<TPixel>() |
||||
|
where TPixel : struct, IPixel<TPixel> |
||||
|
=> new OctreeFrameQuantizer<TPixel>(this); |
||||
|
} |
||||
|
} |
||||
@ -0,0 +1,68 @@ |
|||||
|
// Copyright (c) Six Labors and contributors.
|
||||
|
// Licensed under the Apache License, Version 2.0.
|
||||
|
|
||||
|
using SixLabors.ImageSharp.PixelFormats; |
||||
|
using SixLabors.ImageSharp.Processing.Dithering; |
||||
|
using SixLabors.ImageSharp.Processing.Dithering.ErrorDiffusion; |
||||
|
using SixLabors.ImageSharp.Processing.Quantization.FrameQuantizers; |
||||
|
|
||||
|
namespace SixLabors.ImageSharp.Processing.Quantization |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// Allows the quantization of images pixels using web safe colors defined in the CSS Color Module Level 4.
|
||||
|
/// <see href="http://msdn.microsoft.com/en-us/library/aa479306.aspx"/>
|
||||
|
/// Override this class to provide your own palette.
|
||||
|
/// </summary>
|
||||
|
public class PaletteQuantizer : IQuantizer |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// Initializes a new instance of the <see cref="PaletteQuantizer"/> class.
|
||||
|
/// </summary>
|
||||
|
public PaletteQuantizer() |
||||
|
: this(true, DiffuseMode.FloydSteinberg) |
||||
|
{ |
||||
|
} |
||||
|
|
||||
|
/// <summary>
|
||||
|
/// Initializes a new instance of the <see cref="PaletteQuantizer"/> class.
|
||||
|
/// </summary>
|
||||
|
/// <param name="dither">Whether to apply dithering to the output image</param>
|
||||
|
public PaletteQuantizer(bool dither) |
||||
|
: this(dither, DiffuseMode.FloydSteinberg) |
||||
|
{ |
||||
|
} |
||||
|
|
||||
|
/// <summary>
|
||||
|
/// Initializes a new instance of the <see cref="PaletteQuantizer"/> class.
|
||||
|
/// </summary>
|
||||
|
/// <param name="dither">Whether to apply dithering to the output image</param>
|
||||
|
/// <param name="ditherType">The dithering algorithm to apply to the output image</param>
|
||||
|
public PaletteQuantizer(bool dither, IErrorDiffuser ditherType) |
||||
|
{ |
||||
|
Guard.NotNull(ditherType, nameof(ditherType)); |
||||
|
|
||||
|
this.Dither = dither; |
||||
|
this.DitherType = ditherType; |
||||
|
} |
||||
|
|
||||
|
/// <inheritdoc />
|
||||
|
public bool Dither { get; } |
||||
|
|
||||
|
/// <inheritdoc />
|
||||
|
public IErrorDiffuser DitherType { get; } |
||||
|
|
||||
|
/// <summary>
|
||||
|
/// Gets the palette to use to quantize the image.
|
||||
|
/// </summary>
|
||||
|
/// <typeparam name="TPixel">The pixel format.</typeparam>
|
||||
|
/// <returns>The <see cref="T:TPixel[]"/></returns>
|
||||
|
public virtual TPixel[] GetPalette<TPixel>() |
||||
|
where TPixel : struct, IPixel<TPixel> |
||||
|
=> NamedColors<TPixel>.WebSafePalette; |
||||
|
|
||||
|
/// <inheritdoc />
|
||||
|
public IFrameQuantizer<TPixel> CreateFrameQuantizer<TPixel>() |
||||
|
where TPixel : struct, IPixel<TPixel> |
||||
|
=> new PaletteFrameQuantizer<TPixel>(this); |
||||
|
} |
||||
|
} |
||||
@ -0,0 +1,75 @@ |
|||||
|
// Copyright (c) Six Labors and contributors.
|
||||
|
// Licensed under the Apache License, Version 2.0.
|
||||
|
|
||||
|
using SixLabors.ImageSharp.PixelFormats; |
||||
|
using SixLabors.ImageSharp.Processing.Dithering; |
||||
|
using SixLabors.ImageSharp.Processing.Dithering.ErrorDiffusion; |
||||
|
using SixLabors.ImageSharp.Processing.Quantization.FrameQuantizers; |
||||
|
|
||||
|
namespace SixLabors.ImageSharp.Processing.Quantization |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// Allows the quantization of images pixels using Xiaolin Wu's Color Quantizer.
|
||||
|
/// <see href="http://www.ece.mcmaster.ca/~xwu/cq.c"/>
|
||||
|
/// </summary>
|
||||
|
public class WuQuantizer : IQuantizer |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// Initializes a new instance of the <see cref="WuQuantizer"/> class.
|
||||
|
/// </summary>
|
||||
|
public WuQuantizer() |
||||
|
: this(255) |
||||
|
{ |
||||
|
} |
||||
|
|
||||
|
/// <summary>
|
||||
|
/// Initializes a new instance of the <see cref="WuQuantizer"/> class.
|
||||
|
/// </summary>
|
||||
|
/// <param name="dither">Whether to apply dithering to the output image</param>
|
||||
|
public WuQuantizer(bool dither) |
||||
|
: this(dither, DiffuseMode.FloydSteinberg, 255) |
||||
|
{ |
||||
|
} |
||||
|
|
||||
|
/// <summary>
|
||||
|
/// Initializes a new instance of the <see cref="WuQuantizer"/> class.
|
||||
|
/// </summary>
|
||||
|
/// <param name="maxColors">The maximum number of colors to hold in the color palette</param>
|
||||
|
public WuQuantizer(int maxColors) |
||||
|
: this(true, DiffuseMode.FloydSteinberg, maxColors) |
||||
|
{ |
||||
|
} |
||||
|
|
||||
|
/// <summary>
|
||||
|
/// Initializes a new instance of the <see cref="WuQuantizer"/> class.
|
||||
|
/// </summary>
|
||||
|
/// <param name="dither">Whether to apply dithering to the output image</param>
|
||||
|
/// <param name="ditherType">The dithering algorithm to apply to the output image</param>
|
||||
|
/// <param name="maxColors">The maximum number of colors to hold in the color palette</param>
|
||||
|
public WuQuantizer(bool dither, IErrorDiffuser ditherType, int maxColors) |
||||
|
{ |
||||
|
Guard.NotNull(ditherType, nameof(ditherType)); |
||||
|
Guard.MustBeBetweenOrEqualTo(maxColors, 1, 255, nameof(maxColors)); |
||||
|
|
||||
|
this.Dither = dither; |
||||
|
this.DitherType = ditherType; |
||||
|
this.MaxColors = maxColors; |
||||
|
} |
||||
|
|
||||
|
/// <inheritdoc />
|
||||
|
public bool Dither { get; } |
||||
|
|
||||
|
/// <inheritdoc />
|
||||
|
public IErrorDiffuser DitherType { get; } |
||||
|
|
||||
|
/// <summary>
|
||||
|
/// Gets the maximum number of colors to hold in the color palette.
|
||||
|
/// </summary>
|
||||
|
public int MaxColors { get; } |
||||
|
|
||||
|
/// <inheritdoc />
|
||||
|
public IFrameQuantizer<TPixel> CreateFrameQuantizer<TPixel>() |
||||
|
where TPixel : struct, IPixel<TPixel> |
||||
|
=> new WuFrameQuantizer<TPixel>(this); |
||||
|
} |
||||
|
} |
||||
Loading…
Reference in new issue