mirror of https://github.com/SixLabors/ImageSharp
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
1132 lines
40 KiB
1132 lines
40 KiB
// --------------------------------------------------------------------------------------------------------------------
|
|
// <copyright file="ImageFactory.cs" company="James South">
|
|
// Copyright (c) James South.
|
|
// Licensed under the Apache License, Version 2.0.
|
|
// </copyright>
|
|
// <summary>
|
|
// Encapsulates methods for processing image files.
|
|
// </summary>
|
|
// --------------------------------------------------------------------------------------------------------------------
|
|
|
|
namespace ImageProcessor
|
|
{
|
|
#region Using
|
|
using System;
|
|
using System.Collections.Concurrent;
|
|
using System.Collections.Generic;
|
|
using System.Diagnostics.CodeAnalysis;
|
|
using System.Drawing;
|
|
using System.Drawing.Imaging;
|
|
using System.IO;
|
|
using System.Linq;
|
|
using System.Threading;
|
|
using ImageProcessor.Extensions;
|
|
using ImageProcessor.Imaging;
|
|
using ImageProcessor.Imaging.Filters;
|
|
using ImageProcessor.Processors;
|
|
#endregion
|
|
|
|
/// <summary>
|
|
/// Encapsulates methods for processing image files.
|
|
/// </summary>
|
|
public class ImageFactory : IDisposable
|
|
{
|
|
#region Fields
|
|
/// <summary>
|
|
/// The default quality for jpeg files.
|
|
/// </summary>
|
|
private const int DefaultJpegQuality = 90;
|
|
|
|
/// <summary>
|
|
/// The backup image format.
|
|
/// </summary>
|
|
private ImageFormat backupImageFormat;
|
|
|
|
/// <summary>
|
|
/// The memory stream for storing any input stream to prevent disposal.
|
|
/// </summary>
|
|
private MemoryStream inputStream;
|
|
|
|
/// <summary>
|
|
/// Whether the image is indexed.
|
|
/// </summary>
|
|
private bool isIndexed;
|
|
|
|
/// <summary>
|
|
/// A value indicating whether this instance of the given entity has been disposed.
|
|
/// </summary>
|
|
/// <value><see langword="true"/> if this instance has been disposed; otherwise, <see langword="false"/>.</value>
|
|
/// <remarks>
|
|
/// If the entity is disposed, it must not be disposed a second
|
|
/// time. The isDisposed field is set the first time the entity
|
|
/// is disposed. If the isDisposed field is true, then the Dispose()
|
|
/// method will not dispose again. This help not to prolong the entity's
|
|
/// life in the Garbage Collector.
|
|
/// </remarks>
|
|
private bool isDisposed;
|
|
#endregion
|
|
|
|
#region Constructors
|
|
/// <summary>
|
|
/// Initializes a new instance of the <see cref="ImageFactory"/> class.
|
|
/// </summary>
|
|
/// <param name="preserveExifData">
|
|
/// Whether to preserve exif metadata. Defaults to false.
|
|
/// </param>
|
|
public ImageFactory(bool preserveExifData = false)
|
|
{
|
|
this.PreserveExifData = preserveExifData;
|
|
this.ExifPropertyItems = new ConcurrentDictionary<int, PropertyItem>();
|
|
}
|
|
#endregion
|
|
|
|
#region Destructors
|
|
/// <summary>
|
|
/// Finalizes an instance of the <see cref="T:ImageProcessor.ImageFactory">ImageFactory</see> class.
|
|
/// </summary>
|
|
/// <remarks>
|
|
/// Use C# destructor syntax for finalization code.
|
|
/// This destructor will run only if the Dispose method
|
|
/// does not get called.
|
|
/// It gives your base class the opportunity to finalize.
|
|
/// Do not provide destructors in types derived from this class.
|
|
/// </remarks>
|
|
~ImageFactory()
|
|
{
|
|
// Do not re-create Dispose clean-up code here.
|
|
// Calling Dispose(false) is optimal in terms of
|
|
// readability and maintainability.
|
|
this.Dispose(false);
|
|
}
|
|
#endregion
|
|
|
|
#region Properties
|
|
/// <summary>
|
|
/// Gets the local image for manipulation.
|
|
/// </summary>
|
|
public Image Image { get; private set; }
|
|
|
|
/// <summary>
|
|
/// Gets the path to the local image for manipulation.
|
|
/// </summary>
|
|
public string ImagePath { get; private set; }
|
|
|
|
/// <summary>
|
|
/// Gets the query-string parameters for web image manipulation.
|
|
/// </summary>
|
|
public string QueryString { get; private set; }
|
|
|
|
/// <summary>
|
|
/// Gets a value indicating whether the image factory should process the file.
|
|
/// </summary>
|
|
public bool ShouldProcess { get; private set; }
|
|
|
|
/// <summary>
|
|
/// Gets the file format of the image.
|
|
/// </summary>
|
|
public ImageFormat ImageFormat { get; private set; }
|
|
|
|
/// <summary>
|
|
/// Gets the mime type.
|
|
/// </summary>
|
|
public string MimeType
|
|
{
|
|
get
|
|
{
|
|
return this.ImageFormat.GetMimeType();
|
|
}
|
|
}
|
|
|
|
/// <summary>
|
|
/// Gets or sets a value indicating whether to preserve exif metadata.
|
|
/// </summary>
|
|
public bool PreserveExifData { get; set; }
|
|
|
|
/// <summary>
|
|
/// Gets or sets the exif property items.
|
|
/// </summary>
|
|
public ConcurrentDictionary<int, PropertyItem> ExifPropertyItems { get; set; }
|
|
|
|
/// <summary>
|
|
/// Gets or sets the original extension.
|
|
/// </summary>
|
|
internal string OriginalExtension { get; set; }
|
|
|
|
/// <summary>
|
|
/// Gets or sets the quality of output for jpeg images as a percentile.
|
|
/// </summary>
|
|
internal int JpegQuality { get; set; }
|
|
#endregion
|
|
|
|
#region Methods
|
|
/// <summary>
|
|
/// Loads the image to process. Always call this method first.
|
|
/// </summary>
|
|
/// <param name="memoryStream">
|
|
/// The <see cref="T:System.IO.MemoryStream"/> containing the image information.
|
|
/// </param>
|
|
/// <returns>
|
|
/// The current instance of the <see cref="T:ImageProcessor.ImageFactory"/> class.
|
|
/// </returns>
|
|
public ImageFactory Load(MemoryStream memoryStream)
|
|
{
|
|
// Set our image as the memory stream value.
|
|
this.Image = Image.FromStream(memoryStream, true);
|
|
|
|
// Store the stream so we can dispose of it later.
|
|
this.inputStream = memoryStream;
|
|
|
|
// Set the other properties.
|
|
this.JpegQuality = DefaultJpegQuality;
|
|
this.ImageFormat = this.Image.RawFormat;
|
|
this.backupImageFormat = this.ImageFormat;
|
|
this.isIndexed = ImageUtils.IsIndexed(this.Image);
|
|
|
|
// Always load the data.
|
|
foreach (PropertyItem propertyItem in this.Image.PropertyItems)
|
|
{
|
|
this.ExifPropertyItems[propertyItem.Id] = propertyItem;
|
|
}
|
|
|
|
this.ShouldProcess = true;
|
|
|
|
return this;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Loads the image to process. Always call this method first.
|
|
/// </summary>
|
|
/// <param name="imagePath">The absolute path to the image to load.</param>
|
|
/// <returns>
|
|
/// The current instance of the <see cref="T:ImageProcessor.ImageFactory"/> class.
|
|
/// </returns>
|
|
public ImageFactory Load(string imagePath)
|
|
{
|
|
// Remove any querystring parameters passed by web requests.
|
|
string[] paths = imagePath.Split('?');
|
|
string path = paths[0];
|
|
string query = string.Empty;
|
|
|
|
if (paths.Length > 1)
|
|
{
|
|
query = paths[1];
|
|
}
|
|
|
|
if (File.Exists(path))
|
|
{
|
|
this.ImagePath = path;
|
|
this.QueryString = query;
|
|
|
|
// Open a file stream to prevent the need for lock.
|
|
using (FileStream fileStream = new FileStream(path, FileMode.Open, FileAccess.Read))
|
|
{
|
|
MemoryStream memoryStream = new MemoryStream();
|
|
|
|
// Copy the stream.
|
|
fileStream.CopyTo(memoryStream);
|
|
|
|
// Set the position to 0 afterwards.
|
|
fileStream.Position = memoryStream.Position = 0;
|
|
|
|
// Set our image as the memory stream value.
|
|
this.Image = Image.FromStream(memoryStream, true);
|
|
|
|
// Store the stream so we can dispose of it later.
|
|
this.inputStream = memoryStream;
|
|
|
|
// Set the other properties.
|
|
this.JpegQuality = DefaultJpegQuality;
|
|
ImageFormat imageFormat = this.Image.RawFormat;
|
|
this.backupImageFormat = imageFormat;
|
|
this.OriginalExtension = Path.GetExtension(this.ImagePath);
|
|
this.ImageFormat = imageFormat;
|
|
this.isIndexed = ImageUtils.IsIndexed(this.Image);
|
|
|
|
// Always load the data.
|
|
foreach (PropertyItem propertyItem in this.Image.PropertyItems)
|
|
{
|
|
this.ExifPropertyItems[propertyItem.Id] = propertyItem;
|
|
}
|
|
|
|
this.ShouldProcess = true;
|
|
}
|
|
}
|
|
|
|
return this;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Updates the specified image. Used by the various IProcessors.
|
|
/// </summary>
|
|
/// <param name="image">The image.</param>
|
|
/// <returns>
|
|
/// The current instance of the <see cref="T:ImageProcessor.ImageFactory"/> class.
|
|
/// </returns>
|
|
public ImageFactory Update(Image image)
|
|
{
|
|
if (this.ShouldProcess)
|
|
{
|
|
this.Image = image;
|
|
}
|
|
|
|
return this;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Resets the current image to its original loaded state.
|
|
/// </summary>
|
|
/// <returns>
|
|
/// The current instance of the <see cref="T:ImageProcessor.ImageFactory"/> class.
|
|
/// </returns>
|
|
public ImageFactory Reset()
|
|
{
|
|
if (this.ShouldProcess)
|
|
{
|
|
// Set our new image as the memory stream value.
|
|
Image newImage = Image.FromStream(this.inputStream, true);
|
|
|
|
// Dispose and reassign the image.
|
|
this.Image.Dispose();
|
|
this.Image = newImage;
|
|
|
|
// Set the other properties.
|
|
this.JpegQuality = DefaultJpegQuality;
|
|
this.ImageFormat = this.backupImageFormat;
|
|
this.isIndexed = ImageUtils.IsIndexed(this.Image);
|
|
}
|
|
|
|
return this;
|
|
}
|
|
|
|
#region Manipulation
|
|
/// <summary>
|
|
/// Adds a query-string to the image factory to allow auto-processing of remote files.
|
|
/// </summary>
|
|
/// <param name="query">The query-string parameter to process.</param>
|
|
/// <returns>
|
|
/// The current instance of the <see cref="T:ImageProcessor.ImageFactory"/> class.
|
|
/// </returns>
|
|
public ImageFactory AddQueryString(string query)
|
|
{
|
|
if (this.ShouldProcess)
|
|
{
|
|
this.QueryString = query;
|
|
}
|
|
|
|
return this;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Changes the opacity of the current image.
|
|
/// </summary>
|
|
/// <param name="percentage">
|
|
/// The percentage by which to alter the images opacity.
|
|
/// Any integer between 0 and 100.
|
|
/// </param>
|
|
/// <returns>
|
|
/// The current instance of the <see cref="T:ImageProcessor.ImageFactory"/> class.
|
|
/// </returns>
|
|
public ImageFactory Alpha(int percentage)
|
|
{
|
|
if (this.ShouldProcess)
|
|
{
|
|
// Sanitize the input.
|
|
if (percentage > 100 || percentage < 0)
|
|
{
|
|
percentage = 0;
|
|
}
|
|
|
|
Alpha alpha = new Alpha { DynamicParameter = percentage };
|
|
this.ApplyProcessor(alpha.ProcessImage);
|
|
}
|
|
|
|
return this;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Performs auto-rotation to ensure that EXIF defined rotation is reflected in
|
|
/// the final image.
|
|
/// </summary>
|
|
/// <returns>
|
|
/// The current instance of the <see cref="T:ImageProcessor.ImageFactory"/> class.
|
|
/// </returns>
|
|
public ImageFactory AutoRotate()
|
|
{
|
|
if (this.ShouldProcess)
|
|
{
|
|
AutoRotate autoRotate = new AutoRotate();
|
|
this.ApplyProcessor(autoRotate.ProcessImage);
|
|
}
|
|
|
|
return this;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Changes the brightness of the current image.
|
|
/// </summary>
|
|
/// <param name="percentage">
|
|
/// The percentage by which to alter the images brightness.
|
|
/// Any integer between -100 and 100.
|
|
/// </param>
|
|
/// <returns>
|
|
/// The current instance of the <see cref="T:ImageProcessor.ImageFactory"/> class.
|
|
/// </returns>
|
|
public ImageFactory Brightness(int percentage)
|
|
{
|
|
if (this.ShouldProcess)
|
|
{
|
|
// Sanitize the input.
|
|
if (percentage > 100 || percentage < -100)
|
|
{
|
|
percentage = 0;
|
|
}
|
|
|
|
Brightness brightness = new Brightness { DynamicParameter = percentage };
|
|
this.ApplyProcessor(brightness.ProcessImage);
|
|
}
|
|
|
|
return this;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Constrains the current image, resizing it to fit within the given dimensions whilst keeping its aspect ratio.
|
|
/// </summary>
|
|
/// <param name="size">
|
|
/// The <see cref="T:System.Drawing.Size"/> containing the maximum width and height to set the image to.
|
|
/// </param>
|
|
/// <returns>
|
|
/// The current instance of the <see cref="T:ImageProcessor.ImageFactory"/> class.
|
|
/// </returns>
|
|
public ImageFactory Constrain(Size size)
|
|
{
|
|
if (this.ShouldProcess)
|
|
{
|
|
ResizeLayer layer = new ResizeLayer(size, Color.Transparent, ResizeMode.Max);
|
|
|
|
return this.Resize(layer);
|
|
}
|
|
|
|
return this;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Changes the contrast of the current image.
|
|
/// </summary>
|
|
/// <param name="percentage">
|
|
/// The percentage by which to alter the images contrast.
|
|
/// Any integer between -100 and 100.
|
|
/// </param>
|
|
/// <returns>
|
|
/// The current instance of the <see cref="T:ImageProcessor.ImageFactory"/> class.
|
|
/// </returns>
|
|
public ImageFactory Contrast(int percentage)
|
|
{
|
|
if (this.ShouldProcess)
|
|
{
|
|
// Sanitize the input.
|
|
if (percentage > 100 || percentage < -100)
|
|
{
|
|
percentage = 0;
|
|
}
|
|
|
|
Contrast contrast = new Contrast { DynamicParameter = percentage };
|
|
this.ApplyProcessor(contrast.ProcessImage);
|
|
}
|
|
|
|
return this;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Crops the current image to the given location and size.
|
|
/// </summary>
|
|
/// <param name="rectangle">
|
|
/// The <see cref="T:System.Drawing.Rectangle"/> containing the coordinates to crop the image to.
|
|
/// </param>
|
|
/// <returns>
|
|
/// The current instance of the <see cref="T:ImageProcessor.ImageFactory"/> class.
|
|
/// </returns>
|
|
public ImageFactory Crop(Rectangle rectangle)
|
|
{
|
|
if (this.ShouldProcess)
|
|
{
|
|
CropLayer cropLayer = new CropLayer(rectangle.Left, rectangle.Top, rectangle.Width, rectangle.Height, CropMode.Pixels);
|
|
return this.Crop(cropLayer);
|
|
}
|
|
|
|
return this;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Crops the current image to the given location and size.
|
|
/// </summary>
|
|
/// <param name="cropLayer">
|
|
/// The <see cref="T:CropLayer"/> containing the coordinates and mode to crop the image with.
|
|
/// </param>
|
|
/// <returns>
|
|
/// The current instance of the <see cref="T:ImageProcessor.ImageFactory"/> class.
|
|
/// </returns>
|
|
public ImageFactory Crop(CropLayer cropLayer)
|
|
{
|
|
if (this.ShouldProcess)
|
|
{
|
|
Crop crop = new Crop { DynamicParameter = cropLayer };
|
|
this.ApplyProcessor(crop.ProcessImage);
|
|
}
|
|
|
|
return this;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Applies a filter to the current image.
|
|
/// </summary>
|
|
/// <param name="filterName">
|
|
/// The name of the filter to add to the image.
|
|
/// </param>
|
|
/// <returns>
|
|
/// The current instance of the <see cref="T:ImageProcessor.ImageFactory"/> class.
|
|
/// </returns>
|
|
[Obsolete("Will be removed in next major version. Filter(IMatrixFilter matrixFilter) instead.")]
|
|
public ImageFactory Filter(string filterName)
|
|
{
|
|
if (this.ShouldProcess)
|
|
{
|
|
Filter filter = new Filter { DynamicParameter = filterName };
|
|
this.ApplyProcessor(filter.ProcessImage);
|
|
}
|
|
|
|
return this;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Applies a filter to the current image. Use the <see cref="MatrixFilters"/> class to
|
|
/// assign the correct filter.
|
|
/// </summary>
|
|
/// <param name="matrixFilter">
|
|
/// The <see cref="IMatrixFilter"/> of the filter to add to the image.
|
|
/// </param>
|
|
/// <returns>
|
|
/// The current instance of the <see cref="T:ImageProcessor.ImageFactory"/> class.
|
|
/// </returns>
|
|
public ImageFactory Filter(IMatrixFilter matrixFilter)
|
|
{
|
|
if (this.ShouldProcess)
|
|
{
|
|
Filter filter = new Filter { DynamicParameter = matrixFilter };
|
|
this.ApplyProcessor(filter.ProcessImage);
|
|
}
|
|
|
|
return this;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Flips the current image either horizontally or vertically.
|
|
/// </summary>
|
|
/// <param name="flipVertically">
|
|
/// Whether to flip the image vertically.
|
|
/// </param>
|
|
/// <returns>
|
|
/// The current instance of the <see cref="T:ImageProcessor.ImageFactory"/> class.
|
|
/// </returns>
|
|
public ImageFactory Flip(bool flipVertically)
|
|
{
|
|
if (this.ShouldProcess)
|
|
{
|
|
RotateFlipType rotateFlipType = flipVertically == false
|
|
? RotateFlipType.RotateNoneFlipX
|
|
: RotateFlipType.RotateNoneFlipY;
|
|
|
|
Flip flip = new Flip { DynamicParameter = rotateFlipType };
|
|
this.ApplyProcessor(flip.ProcessImage);
|
|
}
|
|
|
|
return this;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Sets the output format of the current image to the matching <see cref="T:System.Drawing.Imaging.ImageFormat"/>.
|
|
/// </summary>
|
|
/// <param name="imageFormat">The <see cref="T:System.Drawing.Imaging.ImageFormat"/>. to set the image to.</param>
|
|
/// <param name="indexedFormat">Whether the pixel format of the image should be indexed. Used for generating Png8 images.</param>
|
|
/// <returns>
|
|
/// The current instance of the <see cref="T:ImageProcessor.ImageFactory"/> class.
|
|
/// </returns>
|
|
[SuppressMessage("StyleCop.CSharp.DocumentationRules", "SA1650:ElementDocumentationMustBeSpelledCorrectly", Justification = "Reviewed. Suppression is OK here.")]
|
|
public ImageFactory Format(ImageFormat imageFormat, bool indexedFormat = false)
|
|
{
|
|
if (this.ShouldProcess)
|
|
{
|
|
this.isIndexed = indexedFormat;
|
|
this.ImageFormat = imageFormat;
|
|
}
|
|
|
|
return this;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Uses a Gaussian kernel to blur the current image.
|
|
/// <remarks>
|
|
/// <para>
|
|
/// The sigma and threshold values applied to the kernel are
|
|
/// 1.4 and 0 respectively.
|
|
/// </para>
|
|
/// </remarks>
|
|
/// </summary>
|
|
/// <param name="size">
|
|
/// The size to set the Gaussian kernel to.
|
|
/// </param>
|
|
/// <returns>
|
|
/// The current instance of the <see cref="T:ImageProcessor.ImageFactory"/> class.
|
|
/// </returns>
|
|
public ImageFactory GaussianBlur(int size)
|
|
{
|
|
if (this.ShouldProcess && size > 0)
|
|
{
|
|
GaussianLayer layer = new GaussianLayer(size);
|
|
return this.GaussianBlur(layer);
|
|
}
|
|
|
|
return this;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Uses a Gaussian kernel to blur the current image.
|
|
/// </summary>
|
|
/// <param name="gaussianLayer">
|
|
/// The <see cref="T:ImageProcessor.Imaging.GaussianLayer"/> for applying sharpening and
|
|
/// blurring methods to an image.
|
|
/// </param>
|
|
/// <returns>
|
|
/// The current instance of the <see cref="T:ImageProcessor.ImageFactory"/> class.
|
|
/// </returns>
|
|
public ImageFactory GaussianBlur(GaussianLayer gaussianLayer)
|
|
{
|
|
if (this.ShouldProcess)
|
|
{
|
|
GaussianBlur gaussianBlur = new GaussianBlur { DynamicParameter = gaussianLayer };
|
|
this.ApplyProcessor(gaussianBlur.ProcessImage);
|
|
}
|
|
|
|
return this;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Uses a Gaussian kernel to sharpen the current image.
|
|
/// <remarks>
|
|
/// <para>
|
|
/// The sigma and threshold values applied to the kernel are
|
|
/// 1.4 and 0 respectively.
|
|
/// </para>
|
|
/// </remarks>
|
|
/// </summary>
|
|
/// <param name="size">
|
|
/// The size to set the Gaussian kernel to.
|
|
/// </param>
|
|
/// <returns>
|
|
/// The current instance of the <see cref="T:ImageProcessor.ImageFactory"/> class.
|
|
/// </returns>
|
|
public ImageFactory GaussianSharpen(int size)
|
|
{
|
|
if (this.ShouldProcess && size > 0)
|
|
{
|
|
GaussianLayer layer = new GaussianLayer(size);
|
|
return this.GaussianSharpen(layer);
|
|
}
|
|
|
|
return this;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Uses a Gaussian kernel to sharpen the current image.
|
|
/// </summary>
|
|
/// <param name="gaussianLayer">
|
|
/// The <see cref="T:ImageProcessor.Imaging.GaussianLayer"/> for applying sharpening and
|
|
/// blurring methods to an image.
|
|
/// </param>
|
|
/// <returns>
|
|
/// The current instance of the <see cref="T:ImageProcessor.ImageFactory"/> class.
|
|
/// </returns>
|
|
public ImageFactory GaussianSharpen(GaussianLayer gaussianLayer)
|
|
{
|
|
if (this.ShouldProcess)
|
|
{
|
|
GaussianSharpen gaussianSharpen = new GaussianSharpen { DynamicParameter = gaussianLayer };
|
|
this.ApplyProcessor(gaussianSharpen.ProcessImage);
|
|
}
|
|
|
|
return this;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Alters the output quality of the current image.
|
|
/// <remarks>
|
|
/// This method will only effect the output quality of jpeg images
|
|
/// </remarks>
|
|
/// </summary>
|
|
/// <param name="percentage">A value between 1 and 100 to set the quality to.</param>
|
|
/// <returns>
|
|
/// The current instance of the <see cref="T:ImageProcessor.ImageFactory"/> class.
|
|
/// </returns>
|
|
public ImageFactory Quality(int percentage)
|
|
{
|
|
if (this.ShouldProcess)
|
|
{
|
|
this.JpegQuality = percentage;
|
|
}
|
|
|
|
return this;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Resizes the current image to the given dimensions.
|
|
/// </summary>
|
|
/// <param name="size">
|
|
/// The <see cref="T:System.Drawing.Size"/> containing the width and height to set the image to.
|
|
/// </param>
|
|
/// <returns>
|
|
/// The current instance of the <see cref="T:ImageProcessor.ImageFactory"/> class.
|
|
/// </returns>
|
|
public ImageFactory Resize(Size size)
|
|
{
|
|
if (this.ShouldProcess)
|
|
{
|
|
int width = size.Width;
|
|
int height = size.Height;
|
|
|
|
ResizeLayer resizeLayer = new ResizeLayer(new Size(width, height));
|
|
return this.Resize(resizeLayer);
|
|
}
|
|
|
|
return this;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Resizes the current image to the given dimensions.
|
|
/// </summary>
|
|
/// <param name="resizeLayer">
|
|
/// The <see cref="ResizeLayer"/> containing the properties required to resize the image.
|
|
/// </param>
|
|
/// <returns>
|
|
/// The current instance of the <see cref="T:ImageProcessor.ImageFactory"/> class.
|
|
/// </returns>
|
|
public ImageFactory Resize(ResizeLayer resizeLayer)
|
|
{
|
|
if (this.ShouldProcess)
|
|
{
|
|
var resizeSettings = new Dictionary<string, string> { { "MaxWidth", resizeLayer.Size.Width.ToString("G") }, { "MaxHeight", resizeLayer.Size.Height.ToString("G") } };
|
|
|
|
Resize resize = new Resize { DynamicParameter = resizeLayer, Settings = resizeSettings };
|
|
this.ApplyProcessor(resize.ProcessImage);
|
|
}
|
|
|
|
return this;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Rotates the current image by the given angle.
|
|
/// </summary>
|
|
/// <param name="rotateLayer">
|
|
/// The <see cref="T:ImageProcessor.Imaging.RotateLayer"/> containing the properties to rotate the image.
|
|
/// </param>
|
|
/// <returns>
|
|
/// The current instance of the <see cref="T:ImageProcessor.ImageFactory"/> class.
|
|
/// </returns>
|
|
public ImageFactory Rotate(RotateLayer rotateLayer)
|
|
{
|
|
if (this.ShouldProcess)
|
|
{
|
|
// Sanitize the input.
|
|
if (rotateLayer.Angle > 360 || rotateLayer.Angle < 0)
|
|
{
|
|
rotateLayer.Angle = 0;
|
|
}
|
|
|
|
Rotate rotate = new Rotate { DynamicParameter = rotateLayer };
|
|
this.ApplyProcessor(rotate.ProcessImage);
|
|
}
|
|
|
|
return this;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Adds rounded corners to the current image.
|
|
/// </summary>
|
|
/// <param name="roundedCornerLayer">
|
|
/// The <see cref="T:ImageProcessor.Imaging.RoundedCornerLayer"/> containing the properties to round corners on the image.
|
|
/// </param>
|
|
/// <returns>
|
|
/// The current instance of the <see cref="T:ImageProcessor.ImageFactory"/> class.
|
|
/// </returns>
|
|
public ImageFactory RoundedCorners(RoundedCornerLayer roundedCornerLayer)
|
|
{
|
|
if (this.ShouldProcess)
|
|
{
|
|
if (roundedCornerLayer.Radius < 0)
|
|
{
|
|
roundedCornerLayer.Radius = 0;
|
|
}
|
|
|
|
RoundedCorners roundedCorners = new RoundedCorners { DynamicParameter = roundedCornerLayer };
|
|
this.ApplyProcessor(roundedCorners.ProcessImage);
|
|
}
|
|
|
|
return this;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Changes the saturation of the current image.
|
|
/// </summary>
|
|
/// <param name="percentage">
|
|
/// The percentage by which to alter the images saturation.
|
|
/// Any integer between -100 and 100.
|
|
/// </param>
|
|
/// <returns>
|
|
/// The current instance of the <see cref="T:ImageProcessor.ImageFactory"/> class.
|
|
/// </returns>
|
|
public ImageFactory Saturation(int percentage)
|
|
{
|
|
if (this.ShouldProcess)
|
|
{
|
|
// Sanitize the input.
|
|
if (percentage > 100 || percentage < -100)
|
|
{
|
|
percentage = 0;
|
|
}
|
|
|
|
Saturation saturate = new Saturation { DynamicParameter = percentage };
|
|
this.ApplyProcessor(saturate.ProcessImage);
|
|
}
|
|
|
|
return this;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Tints the current image with the given color.
|
|
/// </summary>
|
|
/// <param name="color">
|
|
/// The <see cref="T:System.Drawing.Color"/> to tint the image with.
|
|
/// </param>
|
|
/// <returns>
|
|
/// The current instance of the <see cref="T:ImageProcessor.ImageFactory"/> class.
|
|
/// </returns>
|
|
public ImageFactory Tint(Color color)
|
|
{
|
|
if (this.ShouldProcess)
|
|
{
|
|
Tint tint = new Tint { DynamicParameter = color };
|
|
this.ApplyProcessor(tint.ProcessImage);
|
|
}
|
|
|
|
return this;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Adds a vignette image effect to the current image.
|
|
/// </summary>
|
|
/// <returns>
|
|
/// The current instance of the <see cref="T:ImageProcessor.ImageFactory"/> class.
|
|
/// </returns>
|
|
public ImageFactory Vignette()
|
|
{
|
|
if (this.ShouldProcess)
|
|
{
|
|
Vignette vignette = new Vignette();
|
|
this.ApplyProcessor(vignette.ProcessImage);
|
|
}
|
|
|
|
return this;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Adds a text based watermark to the current image.
|
|
/// </summary>
|
|
/// <param name="textLayer">
|
|
/// The <see cref="T:ImageProcessor.Imaging.TextLayer"/> containing the properties necessary to add
|
|
/// the text based watermark to the image.
|
|
/// </param>
|
|
/// <returns>
|
|
/// The current instance of the <see cref="T:ImageProcessor.ImageFactory"/> class.
|
|
/// </returns>
|
|
public ImageFactory Watermark(TextLayer textLayer)
|
|
{
|
|
if (this.ShouldProcess)
|
|
{
|
|
Watermark watermark = new Watermark { DynamicParameter = textLayer };
|
|
this.ApplyProcessor(watermark.ProcessImage);
|
|
}
|
|
|
|
return this;
|
|
}
|
|
#endregion
|
|
|
|
/// <summary>
|
|
/// Saves the current image to the specified file path.
|
|
/// </summary>
|
|
/// <param name="filePath">The path to save the image to.</param>
|
|
/// <returns>
|
|
/// The current instance of the <see cref="T:ImageProcessor.ImageFactory"/> class.
|
|
/// </returns>
|
|
public ImageFactory Save(string filePath)
|
|
{
|
|
if (this.ShouldProcess)
|
|
{
|
|
// We need to check here if the path has an extension and remove it if so.
|
|
// This is so we can add the correct image format.
|
|
int length = filePath.LastIndexOf(".", StringComparison.Ordinal);
|
|
string extension = this.ImageFormat.GetFileExtension(this.OriginalExtension);
|
|
|
|
if (length == -1)
|
|
{
|
|
filePath = filePath + extension;
|
|
}
|
|
|
|
// Fix the colour palette of indexed images.
|
|
this.FixIndexedPallete();
|
|
|
|
// Set the property item information from any Exif metadata.
|
|
// We do this here so that they can be changed between processor methods.
|
|
if (this.PreserveExifData)
|
|
{
|
|
foreach (KeyValuePair<int, PropertyItem> propertItem in this.ExifPropertyItems)
|
|
{
|
|
try
|
|
{
|
|
this.Image.SetPropertyItem(propertItem.Value);
|
|
}
|
|
// ReSharper disable once EmptyGeneralCatchClause
|
|
catch
|
|
{
|
|
// Do nothing. The image format does not handle EXIF data.
|
|
// TODO: empty catch is fierce code smell.
|
|
}
|
|
}
|
|
}
|
|
|
|
// ReSharper disable once AssignNullToNotNullAttribute
|
|
DirectoryInfo directoryInfo = new DirectoryInfo(Path.GetDirectoryName(filePath));
|
|
|
|
if (this.ImageFormat.Equals(ImageFormat.Jpeg))
|
|
{
|
|
// Jpegs can be saved with different settings to include a quality setting for the JPEG compression.
|
|
// This improves output compression and quality.
|
|
using (EncoderParameters encoderParameters = ImageUtils.GetEncodingParameters(this.JpegQuality))
|
|
{
|
|
ImageCodecInfo imageCodecInfo =
|
|
ImageCodecInfo.GetImageEncoders()
|
|
.FirstOrDefault(ici => ici.MimeType.Equals(this.MimeType, StringComparison.OrdinalIgnoreCase));
|
|
|
|
if (imageCodecInfo != null)
|
|
{
|
|
for (int i = 0; i < 3; i++)
|
|
{
|
|
try
|
|
{
|
|
if (!directoryInfo.Exists)
|
|
{
|
|
directoryInfo.Create();
|
|
}
|
|
|
|
this.Image.Save(filePath, imageCodecInfo, encoderParameters);
|
|
break;
|
|
}
|
|
catch (Exception)
|
|
{
|
|
Thread.Sleep(200);
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
else
|
|
{
|
|
for (int i = 0; i < 3; i++)
|
|
{
|
|
try
|
|
{
|
|
if (!directoryInfo.Exists)
|
|
{
|
|
directoryInfo.Create();
|
|
}
|
|
|
|
this.Image.Save(filePath, this.ImageFormat);
|
|
break;
|
|
}
|
|
catch (Exception)
|
|
{
|
|
Thread.Sleep(200);
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
return this;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Saves the current image to the specified output stream.
|
|
/// </summary>
|
|
/// <param name="memoryStream">
|
|
/// The <see cref="T:System.IO.MemoryStream"/> to save the image information to.
|
|
/// </param>
|
|
/// <returns>
|
|
/// The current instance of the <see cref="T:ImageProcessor.ImageFactory"/> class.
|
|
/// </returns>
|
|
public ImageFactory Save(MemoryStream memoryStream)
|
|
{
|
|
if (this.ShouldProcess)
|
|
{
|
|
// Fix the colour palette of gif and png8 images.
|
|
this.FixIndexedPallete();
|
|
|
|
// Set the property item information from any Exif metadata.
|
|
// We do this here so that they can be changed between processor methods.
|
|
if (this.PreserveExifData)
|
|
{
|
|
foreach (KeyValuePair<int, PropertyItem> propertItem in this.ExifPropertyItems)
|
|
{
|
|
try
|
|
{
|
|
this.Image.SetPropertyItem(propertItem.Value);
|
|
}
|
|
// ReSharper disable once EmptyGeneralCatchClause
|
|
catch
|
|
{
|
|
// Do nothing. The image format does not handle EXIF data.
|
|
// TODO: empty catch is fierce code smell.
|
|
}
|
|
}
|
|
}
|
|
|
|
if (this.ImageFormat.Equals(ImageFormat.Jpeg))
|
|
{
|
|
// Jpegs can be saved with different settings to include a quality setting for the JPEG compression.
|
|
// This improves output compression and quality.
|
|
using (EncoderParameters encoderParameters = ImageUtils.GetEncodingParameters(this.JpegQuality))
|
|
{
|
|
ImageCodecInfo imageCodecInfo =
|
|
ImageCodecInfo.GetImageEncoders().FirstOrDefault(
|
|
ici => ici.MimeType.Equals(this.MimeType, StringComparison.OrdinalIgnoreCase));
|
|
|
|
if (imageCodecInfo != null)
|
|
{
|
|
this.Image.Save(memoryStream, imageCodecInfo, encoderParameters);
|
|
}
|
|
}
|
|
}
|
|
else
|
|
{
|
|
this.Image.Save(memoryStream, this.ImageFormat);
|
|
}
|
|
}
|
|
|
|
return this;
|
|
}
|
|
|
|
#region IDisposable Members
|
|
/// <summary>
|
|
/// Disposes the object and frees resources for the Garbage Collector.
|
|
/// </summary>
|
|
public void Dispose()
|
|
{
|
|
this.Dispose(true);
|
|
|
|
// This object will be cleaned up by the Dispose method.
|
|
// Therefore, you should call GC.SupressFinalize to
|
|
// take this object off the finalization queue
|
|
// and prevent finalization code for this object
|
|
// from executing a second time.
|
|
GC.SuppressFinalize(this);
|
|
}
|
|
|
|
/// <summary>
|
|
/// Disposes the object and frees resources for the Garbage Collector.
|
|
/// </summary>
|
|
/// <param name="disposing">If true, the object gets disposed.</param>
|
|
protected virtual void Dispose(bool disposing)
|
|
{
|
|
if (this.isDisposed)
|
|
{
|
|
return;
|
|
}
|
|
|
|
if (disposing)
|
|
{
|
|
// Dispose of any managed resources here.
|
|
if (this.Image != null)
|
|
{
|
|
// Dispose of the memory stream from Load and the image.
|
|
if (this.inputStream != null)
|
|
{
|
|
this.inputStream.Dispose();
|
|
this.inputStream = null;
|
|
}
|
|
|
|
this.Image.Dispose();
|
|
this.Image = null;
|
|
}
|
|
}
|
|
|
|
// Call the appropriate methods to clean up
|
|
// unmanaged resources here.
|
|
// Note disposing is done.
|
|
this.isDisposed = true;
|
|
}
|
|
#endregion
|
|
|
|
/// <summary>
|
|
/// Uses the <see cref="T:ImageProcessor.Imaging.ColorQuantizer"/>
|
|
/// to fix the color palette of gif images.
|
|
/// </summary>
|
|
private void FixIndexedPallete()
|
|
{
|
|
ImageFormat format = this.ImageFormat;
|
|
|
|
// Fix the colour palette of indexed images.
|
|
if (this.isIndexed || format.Equals(ImageFormat.Gif))
|
|
{
|
|
ImageInfo imageInfo = this.Image.GetImageInfo(format, false);
|
|
|
|
if (!imageInfo.IsAnimated)
|
|
{
|
|
this.Image = new OctreeQuantizer(255, 8).Quantize(this.Image);
|
|
}
|
|
}
|
|
}
|
|
|
|
/// <summary>
|
|
/// Applies the given processor the current image.
|
|
/// </summary>
|
|
/// <param name="processor">
|
|
/// The processor delegate.
|
|
/// </param>
|
|
private void ApplyProcessor(Func<ImageFactory, Image> processor)
|
|
{
|
|
ImageInfo imageInfo = this.Image.GetImageInfo(this.ImageFormat);
|
|
|
|
if (imageInfo.IsAnimated)
|
|
{
|
|
OctreeQuantizer quantizer = new OctreeQuantizer(255, 8);
|
|
|
|
// We don't dispose of the memory stream as that is disposed when a new image is created and doing so
|
|
// beforehand will cause an exception.
|
|
MemoryStream stream = new MemoryStream();
|
|
using (GifEncoder encoder = new GifEncoder(stream, null, null, imageInfo.LoopCount))
|
|
{
|
|
foreach (GifFrame frame in imageInfo.GifFrames)
|
|
{
|
|
this.Image = frame.Image;
|
|
frame.Image = quantizer.Quantize(processor.Invoke(this));
|
|
encoder.AddFrame(frame);
|
|
}
|
|
}
|
|
|
|
stream.Position = 0;
|
|
this.Image = Image.FromStream(stream);
|
|
}
|
|
else
|
|
{
|
|
this.Image = processor.Invoke(this);
|
|
}
|
|
}
|
|
#endregion
|
|
}
|
|
}
|
|
|