// -------------------------------------------------------------------------------------------------------------------- // // Copyright (c) James South. // Licensed under the Apache License, Version 2.0. // // // Resizes an image to the given dimensions. // // -------------------------------------------------------------------------------------------------------------------- namespace ImageProcessor.Processors { #region Using using System; using System.Collections.Generic; using System.Drawing; using System.Drawing.Drawing2D; using System.Drawing.Imaging; using System.Linq; using System.Text; using System.Text.RegularExpressions; using ImageProcessor.Extensions; using ImageProcessor.Imaging; #endregion /// /// Resizes an image to the given dimensions. /// public class Resize : IGraphicsProcessor { /// /// The regular expression to search strings for. /// private static readonly Regex QueryRegex = new Regex(@"((width|height)=\d+)|(mode=(pad|stretch|crop|max))|(anchor=(top|bottom|left|right|center))|(center=\d+(.\d+)?[,-]\d+(.\d+))|(bgcolor=(transparent|\d+,\d+,\d+,\d+|([0-9a-fA-F]{3}){1,2}))|(upscale=false)", RegexOptions.Compiled); /// /// The regular expression to search strings for the size attribute. /// private static readonly Regex SizeRegex = new Regex(@"(width|height)=\d+", RegexOptions.Compiled); /// /// The regular expression to search strings for the mode attribute. /// private static readonly Regex ModeRegex = new Regex(@"mode=(pad|stretch|crop|max)", RegexOptions.Compiled); /// /// The regular expression to search strings for the anchor attribute. /// private static readonly Regex AnchorRegex = new Regex(@"anchor=(top|bottom|left|right|center)", RegexOptions.Compiled); /// /// The regular expression to search strings for the center attribute. /// private static readonly Regex CenterRegex = new Regex(@"center=\d+(.\d+)?[,-]\d+(.\d+)", RegexOptions.Compiled); /// /// The regular expression to search strings for the color attribute. /// private static readonly Regex ColorRegex = new Regex(@"bgcolor=(transparent|\d+,\d+,\d+,\d+|([0-9a-fA-F]{3}){1,2})", RegexOptions.Compiled); /// /// The regular expression to search strings for the upscale attribute. /// private static readonly Regex UpscaleRegex = new Regex(@"upscale=false", RegexOptions.Compiled); #region IGraphicsProcessor Members /// /// Gets the regular expression to search strings for. /// public Regex RegexPattern { get { return QueryRegex; } } /// /// Gets or sets DynamicParameter. /// public dynamic DynamicParameter { get; set; } /// /// Gets the order in which this processor is to be used in a chain. /// public int SortOrder { get; private set; } /// /// Gets or sets any additional settings required by the processor. /// public Dictionary Settings { get; set; } /// /// The position in the original string where the first character of the captured substring was found. /// /// /// The query string to search. /// /// /// The zero-based starting position in the original string where the captured substring was found. /// public int MatchRegexIndex(string queryString) { int index = 0; // Set the sort order to max to allow filtering. this.SortOrder = int.MaxValue; // First merge the matches so we can parse . StringBuilder stringBuilder = new StringBuilder(); foreach (Match match in this.RegexPattern.Matches(queryString)) { if (match.Success) { if (index == 0) { // Set the index on the first instance only. this.SortOrder = match.Index; } stringBuilder.Append(match.Value); index += 1; } } // Match syntax string toParse = stringBuilder.ToString(); Size size = this.ParseSize(toParse); ResizeLayer resizeLayer = new ResizeLayer(size) { ResizeMode = this.ParseMode(toParse), AnchorPosition = this.ParsePosition(toParse), BackgroundColor = this.ParseColor(toParse), Upscale = !UpscaleRegex.IsMatch(toParse), }; resizeLayer.CenterCoordinates = this.ParseCoordinates(toParse); this.DynamicParameter = resizeLayer; return this.SortOrder; } /// /// Processes the image. /// /// /// The the current instance of the class containing /// the image to process. /// /// /// The processed image from the current instance of the class. /// public Image ProcessImage(ImageFactory factory) { int width = this.DynamicParameter.Size.Width ?? 0; int height = this.DynamicParameter.Size.Height ?? 0; ResizeMode mode = this.DynamicParameter.ResizeMode; AnchorPosition anchor = this.DynamicParameter.AnchorPosition; Color backgroundColor = this.DynamicParameter.BackgroundColor; bool upscale = this.DynamicParameter.Upscale; float[] centerCoordinates = this.DynamicParameter.CenterCoordinates; int defaultMaxWidth; int defaultMaxHeight; string restrictions; this.Settings.TryGetValue("RestrictTo", out restrictions); int.TryParse(this.Settings["MaxWidth"], out defaultMaxWidth); int.TryParse(this.Settings["MaxHeight"], out defaultMaxHeight); List restrictedSizes = this.ParseRestrictions(restrictions); return this.ResizeImage(factory, width, height, defaultMaxWidth, defaultMaxHeight, restrictedSizes, backgroundColor, mode, anchor, upscale, centerCoordinates); } #endregion /// /// The resize image. /// /// /// The the current instance of the class containing /// the image to process. /// /// /// The width to resize the image to. /// /// /// The height to resize the image to. /// /// /// The default max width to resize the image to. /// /// /// The default max height to resize the image to. /// /// /// A containing image resizing restrictions. /// /// /// The background color to pad the image with. /// /// /// The mode with which to resize the image. /// /// /// The anchor position to place the image at. /// /// /// Whether to allow up-scaling of images. (Default true) /// /// /// If the resize mode is crop, you can set a specific center coordinate, use as alternative to anchorPosition /// /// /// The processed image from the current instance of the class. /// private Image ResizeImage( ImageFactory factory, int width, int height, int defaultMaxWidth, int defaultMaxHeight, List restrictedSizes, Color backgroundColor, ResizeMode resizeMode = ResizeMode.Pad, AnchorPosition anchorPosition = AnchorPosition.Center, bool upscale = true, float[] centerCoordinates = null) { Bitmap newImage = null; Image image = factory.Image; try { int sourceWidth = image.Width; int sourceHeight = image.Height; int destinationWidth = width; int destinationHeight = height; int maxWidth = defaultMaxWidth > 0 ? defaultMaxWidth : int.MaxValue; int maxHeight = defaultMaxHeight > 0 ? defaultMaxHeight : int.MaxValue; // Fractional variants for preserving aspect ratio. double percentHeight = Math.Abs(height / (double)sourceHeight); double percentWidth = Math.Abs(width / (double)sourceWidth); int destinationX = 0; int destinationY = 0; // Change the destination rectangle coordinates if padding and // there has been a set width and height. if (resizeMode == ResizeMode.Pad && width > 0 && height > 0) { double ratio; if (percentHeight < percentWidth) { ratio = percentHeight; destinationX = (int)((width - (sourceWidth * ratio)) / 2); destinationWidth = (int)Math.Ceiling(sourceWidth * percentHeight); } else { ratio = percentWidth; destinationY = (int)((height - (sourceHeight * ratio)) / 2); destinationHeight = (int)Math.Ceiling(sourceHeight * percentWidth); } } // Change the destination rectangle coordinates if cropping and // there has been a set width and height. if (resizeMode == ResizeMode.Crop && width > 0 && height > 0) { double ratio; if (percentHeight < percentWidth) { ratio = percentWidth; if (centerCoordinates != null && centerCoordinates.Any()) { double center = -(ratio * sourceHeight) * centerCoordinates[0]; destinationY = (int)center + (height / 2); if (destinationY > 0) { destinationY = 0; } if (destinationY < (int)(height - (sourceHeight * ratio))) { destinationY = (int)(height - (sourceHeight * ratio)); } } else { switch (anchorPosition) { case AnchorPosition.Top: destinationY = 0; break; case AnchorPosition.Bottom: destinationY = (int)(height - (sourceHeight * ratio)); break; default: destinationY = (int)((height - (sourceHeight * ratio)) / 2); break; } } destinationHeight = (int)Math.Ceiling(sourceHeight * percentWidth); } else { ratio = percentHeight; if (centerCoordinates != null && centerCoordinates.Any()) { double center = -(ratio * sourceWidth) * centerCoordinates[1]; destinationX = (int)center + (width / 2); if (destinationX > 0) { destinationX = 0; } if (destinationX < (int)(width - (sourceWidth * ratio))) { destinationX = (int)(width - (sourceWidth * ratio)); } } else { switch (anchorPosition) { case AnchorPosition.Left: destinationX = 0; break; case AnchorPosition.Right: destinationX = (int)(width - (sourceWidth * ratio)); break; default: destinationX = (int)((width - (sourceWidth * ratio)) / 2); break; } } destinationWidth = (int)Math.Ceiling(sourceWidth * percentHeight); } } // Constrain the image to fit the maximum possible height or width. if (resizeMode == ResizeMode.Max) { if (sourceWidth > width || sourceHeight > height) { double ratio = Math.Abs(height / width); double sourceRatio = Math.Abs(sourceHeight / sourceWidth); if (sourceRatio < ratio) { height = 0; } else { width = 0; } } } // If height or width is not passed we assume that the standard ratio is to be kept. if (height == 0) { destinationHeight = (int)Math.Ceiling(sourceHeight * percentWidth); height = destinationHeight; } if (width == 0) { destinationWidth = (int)Math.Ceiling(sourceWidth * percentHeight); width = destinationWidth; } // Restrict sizes if (restrictedSizes.Any()) { bool reject = true; foreach (Size restrictedSize in restrictedSizes) { if (restrictedSize.Height == 0 || restrictedSize.Width == 0) { if (restrictedSize.Width == width || restrictedSize.Height == height) { reject = false; } } else if (restrictedSize.Width == width && restrictedSize.Height == height) { reject = false; } } if (reject) { return image; } } if (width > 0 && height > 0 && width <= maxWidth && height <= maxHeight) { // Exit if upscaling is not allowed. if ((width > sourceWidth || height > sourceHeight) && upscale == false && resizeMode != ResizeMode.Stretch) { return image; } newImage = new Bitmap(width, height, PixelFormat.Format32bppPArgb); using (Graphics graphics = Graphics.FromImage(newImage)) { // We want to use two different blending algorithms for enlargement/shrinking. // Bicubic is better enlarging for whilst Bilinear is better for shrinking. // http://www.codinghorror.com/blog/2007/07/better-image-resizing.html if (image.Width < destinationWidth && image.Height < destinationHeight) { // We are making it larger. graphics.SmoothingMode = SmoothingMode.AntiAlias; graphics.InterpolationMode = InterpolationMode.HighQualityBicubic; graphics.PixelOffsetMode = PixelOffsetMode.HighQuality; graphics.CompositingQuality = CompositingQuality.HighQuality; } else { // We are making it smaller. graphics.SmoothingMode = SmoothingMode.None; graphics.InterpolationMode = InterpolationMode.HighQualityBilinear; graphics.PixelOffsetMode = PixelOffsetMode.HighQuality; graphics.CompositingQuality = CompositingQuality.HighQuality; } // An unwanted border appears when using InterpolationMode.HighQualityBicubic to resize the image // as the algorithm appears to be pulling averaging detail from surrounding pixels beyond the edge // of the image. Using the ImageAttributes class to specify that the pixels beyond are simply mirror // images of the pixels within solves this problem. using (ImageAttributes wrapMode = new ImageAttributes()) { wrapMode.SetWrapMode(WrapMode.TileFlipXY); graphics.Clear(backgroundColor); Rectangle destRect = new Rectangle(destinationX, destinationY, destinationWidth, destinationHeight); graphics.DrawImage(image, destRect, 0, 0, sourceWidth, sourceHeight, GraphicsUnit.Pixel, wrapMode); } // Reassign the image. image.Dispose(); image = newImage; } } } catch { if (newImage != null) { newImage.Dispose(); } } return image; } /// /// Returns the correct for the given string. /// /// /// The input string containing the value to parse. /// /// /// The . /// private Size ParseSize(string input) { const string Width = "width"; const string Height = "height"; Size size = new Size(); // First merge the matches so we can parse . StringBuilder stringBuilder = new StringBuilder(); foreach (Match match in SizeRegex.Matches(input)) { stringBuilder.Append(match.Value); } // First cater for single dimensions. string value = stringBuilder.ToString(); if (input.Contains(Width) && !input.Contains(Height)) { size = new Size(value.ToPositiveIntegerArray()[0], 0); } if (input.Contains(Height) && !input.Contains(Width)) { size = new Size(0, value.ToPositiveIntegerArray()[0]); } // Both dimensions supplied. if (input.Contains(Height) && input.Contains(Width)) { int[] dimensions = value.ToPositiveIntegerArray(); // Check the order in which they have been supplied. size = input.IndexOf(Width, StringComparison.Ordinal) < input.IndexOf(Height, StringComparison.Ordinal) ? new Size(dimensions[0], dimensions[1]) : new Size(dimensions[1], dimensions[0]); } return size; } /// /// Returns the correct for the given string. /// /// /// The input string containing the value to parse. /// /// /// The correct . /// private ResizeMode ParseMode(string input) { foreach (Match match in ModeRegex.Matches(input)) { // Split on = string mode = match.Value.Split('=')[1]; switch (mode) { case "stretch": return ResizeMode.Stretch; case "crop": return ResizeMode.Crop; case "max": return ResizeMode.Max; default: return ResizeMode.Pad; } } return ResizeMode.Pad; } /// /// Returns the correct for the given string. /// /// /// The input string containing the value to parse. /// /// /// The correct . /// private AnchorPosition ParsePosition(string input) { foreach (Match match in AnchorRegex.Matches(input)) { // Split on = string anchor = match.Value.Split('=')[1]; switch (anchor) { case "top": return AnchorPosition.Top; case "bottom": return AnchorPosition.Bottom; case "left": return AnchorPosition.Left; case "right": return AnchorPosition.Right; default: return AnchorPosition.Center; } } return AnchorPosition.Center; } /// /// Returns the correct for the given string. /// /// /// The input string containing the value to parse. /// /// /// The correct /// private Color ParseColor(string input) { foreach (Match match in ColorRegex.Matches(input)) { string value = match.Value.Split('=')[1]; if (value == "transparent") { return Color.Transparent; } if (value.Contains(",")) { int[] split = value.ToPositiveIntegerArray(); byte red = split[0].ToByte(); byte green = split[1].ToByte(); byte blue = split[2].ToByte(); byte alpha = split[3].ToByte(); return Color.FromArgb(alpha, red, green, blue); } // Split on color-hex return ColorTranslator.FromHtml("#" + value); } return Color.Transparent; } /// /// Returns a of sizes to restrict resizing to. /// /// /// The input. /// /// /// The to restrict resizing to. /// private List ParseRestrictions(string input) { List sizes = new List(); if (!string.IsNullOrWhiteSpace(input)) { sizes.AddRange(input.Split(',').Select(this.ParseSize)); } return sizes; } /// /// Parses the coordinates. /// /// The input. /// The array containing the coordinates private float[] ParseCoordinates(string input) { float[] floats = { }; foreach (Match match in CenterRegex.Matches(input)) { floats = match.Value.ToPositiveFloatArray(); } return floats; } } }