mirror of https://github.com/SixLabors/ImageSharp
Browse Source
Former-commit-id: 9b7174022ac6745534acff3ed69718d143e91e6f Former-commit-id: f8d1e182dec104b3c77fec79cd4d7c00a299a70f Former-commit-id: 98f22a9d62b5133aeba4b4525a71b2e6c2b18133pull/1/head
James Jackson-South
10 years ago
41 changed files with 1039 additions and 1018 deletions
@ -1,103 +0,0 @@ |
|||
// <copyright file="IImage.cs" company="James Jackson-South">
|
|||
// Copyright (c) James Jackson-South and contributors.
|
|||
// Licensed under the Apache License, Version 2.0.
|
|||
// </copyright>
|
|||
|
|||
namespace ImageProcessorCore |
|||
{ |
|||
using System; |
|||
using System.Collections.Generic; |
|||
using System.IO; |
|||
|
|||
using ImageProcessorCore.Formats; |
|||
|
|||
/// <summary>
|
|||
/// Encapsulates an image, which consists of the pixel data for a graphics image and its attributes.
|
|||
/// </summary>
|
|||
public interface IImage : IImageBase |
|||
{ |
|||
/// <summary>
|
|||
/// Gets or sets the resolution of the image in x- direction. It is defined as
|
|||
/// number of dots per inch and should be an positive value.
|
|||
/// </summary>
|
|||
/// <value>The density of the image in x- direction.</value>
|
|||
double HorizontalResolution { get; set; } |
|||
|
|||
/// <summary>
|
|||
/// Gets or sets the resolution of the image in y- direction. It is defined as
|
|||
/// number of dots per inch and should be an positive value.
|
|||
/// </summary>
|
|||
/// <value>The density of the image in y- direction.</value>
|
|||
double VerticalResolution { get; set; } |
|||
|
|||
/// <summary>
|
|||
/// Gets the width of the image in inches. It is calculated as the width of the image
|
|||
/// in pixels multiplied with the density. When the density is equals or less than zero
|
|||
/// the default value is used.
|
|||
/// </summary>
|
|||
/// <value>The width of the image in inches.</value>
|
|||
double InchWidth { get; } |
|||
|
|||
/// <summary>
|
|||
/// Gets the height of the image in inches. It is calculated as the height of the image
|
|||
/// in pixels multiplied with the density. When the density is equals or less than zero
|
|||
/// the default value is used.
|
|||
/// </summary>
|
|||
/// <value>The height of the image in inches.</value>
|
|||
double InchHeight { get; } |
|||
|
|||
/// <summary>
|
|||
/// Gets a value indicating whether this image is animated.
|
|||
/// </summary>
|
|||
/// <value>
|
|||
/// <c>True</c> if this image is animated; otherwise, <c>false</c>.
|
|||
/// </value>
|
|||
bool IsAnimated { get; } |
|||
|
|||
/// <summary>
|
|||
/// Gets or sets the number of times any animation is repeated.
|
|||
/// <remarks>0 means to repeat indefinitely.</remarks>
|
|||
/// </summary>
|
|||
ushort RepeatCount { get; set; } |
|||
|
|||
/// <summary>
|
|||
/// Gets the currently loaded image format.
|
|||
/// </summary>
|
|||
IImageFormat CurrentImageFormat { get; } |
|||
|
|||
/// <summary>
|
|||
/// Gets the other frames for the animation.
|
|||
/// </summary>
|
|||
/// <value>The list of frame images.</value>
|
|||
IList<ImageFrame> Frames { get; } |
|||
|
|||
/// <summary>
|
|||
/// Gets the list of properties for storing meta information about this image.
|
|||
/// </summary>
|
|||
/// <value>A list of image properties.</value>
|
|||
IList<ImageProperty> Properties { get; } |
|||
|
|||
/// <summary>
|
|||
/// Saves the image to the given stream using the currently loaded image format.
|
|||
/// </summary>
|
|||
/// <param name="stream">The stream to save the image to.</param>
|
|||
/// <exception cref="ArgumentNullException">Thrown if the stream is null.</exception>
|
|||
void Save(Stream stream); |
|||
|
|||
/// <summary>
|
|||
/// Saves the image to the given stream using the given image format.
|
|||
/// </summary>
|
|||
/// <param name="stream">The stream to save the image to.</param>
|
|||
/// <param name="format">The format to save the image as.</param>
|
|||
/// <exception cref="ArgumentNullException">Thrown if the stream is null.</exception>
|
|||
void Save(Stream stream, IImageFormat format); |
|||
|
|||
/// <summary>
|
|||
/// Saves the image to the given stream using the given image encoder.
|
|||
/// </summary>
|
|||
/// <param name="stream">The stream to save the image to.</param>
|
|||
/// <param name="encoder">The encoder to save the image with.</param>
|
|||
/// <exception cref="ArgumentNullException">Thrown if the stream is null.</exception>
|
|||
void Save(Stream stream, IImageEncoder encoder); |
|||
} |
|||
} |
|||
@ -1,106 +0,0 @@ |
|||
// <copyright file="IImageBase.cs" company="James Jackson-South">
|
|||
// Copyright (c) James Jackson-South and contributors.
|
|||
// Licensed under the Apache License, Version 2.0.
|
|||
// </copyright>
|
|||
|
|||
namespace ImageProcessorCore |
|||
{ |
|||
using System; |
|||
using System.Runtime.CompilerServices; |
|||
|
|||
/// <summary>
|
|||
/// Encapsulates the basic properties and methods required to manipulate images.
|
|||
/// </summary>
|
|||
public interface IImageBase |
|||
{ |
|||
/// <summary>
|
|||
/// Gets the image pixels as byte array.
|
|||
/// </summary>
|
|||
/// <remarks>
|
|||
/// The returned array has a length of Width * Height * 4 bytes
|
|||
/// and stores the red, the green, the blue, and the alpha value for
|
|||
/// each pixel in this order.
|
|||
/// </remarks>
|
|||
float[] Pixels { get; } |
|||
|
|||
/// <summary>
|
|||
/// Gets the width in pixels.
|
|||
/// </summary>
|
|||
int Width { get; } |
|||
|
|||
/// <summary>
|
|||
/// Gets the height in pixels.
|
|||
/// </summary>
|
|||
int Height { get; } |
|||
|
|||
/// <summary>
|
|||
/// Gets the pixel ratio made up of the width and height.
|
|||
/// </summary>
|
|||
double PixelRatio { get; } |
|||
|
|||
/// <summary>
|
|||
/// Gets the <see cref="Rectangle"/> representing the bounds of the image.
|
|||
/// </summary>
|
|||
Rectangle Bounds { get; } |
|||
|
|||
/// <summary>
|
|||
/// Gets or sets th quality of the image. This affects the output quality of lossy image formats.
|
|||
/// </summary>
|
|||
int Quality { get; set; } |
|||
|
|||
/// <summary>
|
|||
/// Gets or sets the frame delay for animated images.
|
|||
/// If not 0, this field specifies the number of hundredths (1/100) of a second to
|
|||
/// wait before continuing with the processing of the Data Stream.
|
|||
/// The clock starts ticking immediately after the graphic is rendered.
|
|||
/// </summary>
|
|||
int FrameDelay { get; set; } |
|||
|
|||
/// <summary>
|
|||
/// Gets or sets the color of a pixel at the specified position.
|
|||
/// </summary>
|
|||
/// <param name="x">
|
|||
/// The x-coordinate of the pixel. Must be greater
|
|||
/// than zero and smaller than the width of the pixel.
|
|||
/// </param>
|
|||
/// <param name="y">
|
|||
/// The y-coordinate of the pixel. Must be greater
|
|||
/// than zero and smaller than the width of the pixel.
|
|||
/// </param>
|
|||
/// <returns>The <see cref="Color"/> at the specified position.</returns>
|
|||
Color this[int x, int y] { get; set; } |
|||
|
|||
/// <summary>
|
|||
/// Sets the pixel array of the image to the given value.
|
|||
/// </summary>
|
|||
/// <param name="width">The new width of the image. Must be greater than zero.</param>
|
|||
/// <param name="height">The new height of the image. Must be greater than zero.</param>
|
|||
/// <param name="pixels">
|
|||
/// The array with colors. Must be a multiple of four times the width and height.
|
|||
/// </param>
|
|||
/// <exception cref="ArgumentOutOfRangeException">
|
|||
/// Thrown if either <paramref name="width"/> or <paramref name="height"/> are less than or equal to 0.
|
|||
/// </exception>
|
|||
/// <exception cref="ArgumentException">
|
|||
/// Thrown if the <paramref name="pixels"/> length is not equal to Width * Height * 4.
|
|||
/// </exception>
|
|||
void SetPixels(int width, int height, float[] pixels); |
|||
|
|||
/// <summary>
|
|||
/// Sets the pixel array of the image to the given value, creating a copy of
|
|||
/// the original pixels.
|
|||
/// </summary>
|
|||
/// <param name="width">The new width of the image. Must be greater than zero.</param>
|
|||
/// <param name="height">The new height of the image. Must be greater than zero.</param>
|
|||
/// <param name="pixels">
|
|||
/// The array with colors. Must be a multiple of four times the width and height.
|
|||
/// </param>
|
|||
/// <exception cref="ArgumentOutOfRangeException">
|
|||
/// Thrown if either <paramref name="width"/> or <paramref name="height"/> are less than or equal to 0.
|
|||
/// </exception>
|
|||
/// <exception cref="ArgumentException">
|
|||
/// Thrown if the <paramref name="pixels"/> length is not equal to Width * Height * 4.
|
|||
/// </exception>
|
|||
void ClonePixels(int width, int height, float[] pixels); |
|||
} |
|||
} |
|||
@ -0,0 +1,164 @@ |
|||
// <copyright file="PixelAccessor.cs" company="James Jackson-South">
|
|||
// Copyright (c) James Jackson-South and contributors.
|
|||
// Licensed under the Apache License, Version 2.0.
|
|||
// </copyright>
|
|||
|
|||
namespace ImageProcessorCore |
|||
{ |
|||
using System; |
|||
using System.Runtime.InteropServices; |
|||
|
|||
/// <summary>
|
|||
/// Provides per-pixel access to an images pixels.
|
|||
/// </summary>
|
|||
public sealed unsafe class PixelAccessor : IDisposable |
|||
{ |
|||
/// <summary>
|
|||
/// The position of the first pixel in the bitmap.
|
|||
/// </summary>
|
|||
private float* pixelsBase; |
|||
|
|||
/// <summary>
|
|||
/// Provides a way to access the pixels from unmanaged memory.
|
|||
/// </summary>
|
|||
private GCHandle pixelsHandle; |
|||
|
|||
/// <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; |
|||
|
|||
/// <summary>
|
|||
/// Initializes a new instance of the <see cref="PixelAccessor"/> class.
|
|||
/// </summary>
|
|||
/// <param name="image">
|
|||
/// The image to provide pixel access for.
|
|||
/// </param>
|
|||
public PixelAccessor(ImageBase image) |
|||
{ |
|||
Guard.NotNull(image, nameof(image)); |
|||
Guard.MustBeGreaterThan(image.Width, 0, "image width"); |
|||
Guard.MustBeGreaterThan(image.Height, 0, "image height"); |
|||
|
|||
int size = image.Pixels.Length; |
|||
this.Width = image.Width; |
|||
this.Height = image.Height; |
|||
|
|||
// Assign the pointer.
|
|||
// If buffer is allocated on Large Object Heap, then we are going to pin it instead of making a copy.
|
|||
if (size > (85 * 1024)) |
|||
{ |
|||
this.pixelsHandle = GCHandle.Alloc(image.Pixels, GCHandleType.Pinned); |
|||
this.pixelsBase = (float*)this.pixelsHandle.AddrOfPinnedObject().ToPointer(); |
|||
} |
|||
else |
|||
{ |
|||
fixed (float* pbuffer = image.Pixels) |
|||
{ |
|||
this.pixelsBase = pbuffer; |
|||
} |
|||
} |
|||
} |
|||
|
|||
/// <summary>
|
|||
/// Finalizes an instance of the <see cref="PixelAccessor"/> class.
|
|||
/// </summary>
|
|||
~PixelAccessor() |
|||
{ |
|||
this.Dispose(); |
|||
} |
|||
|
|||
/// <summary>
|
|||
/// Gets the width of the image.
|
|||
/// </summary>
|
|||
public int Width { get; } |
|||
|
|||
/// <summary>
|
|||
/// Gets the height of the image.
|
|||
/// </summary>
|
|||
public int Height { get; } |
|||
|
|||
/// <summary>
|
|||
/// Gets or sets the color of a pixel at the specified position.
|
|||
/// </summary>
|
|||
/// <param name="x">
|
|||
/// The x-coordinate of the pixel. Must be greater
|
|||
/// than zero and smaller than the width of the pixel.
|
|||
/// </param>
|
|||
/// <param name="y">
|
|||
/// The y-coordinate of the pixel. Must be greater
|
|||
/// than zero and smaller than the width of the pixel.
|
|||
/// </param>
|
|||
/// <returns>The <see cref="Color"/> at the specified position.</returns>
|
|||
public Color this[int x, int y] |
|||
{ |
|||
get |
|||
{ |
|||
#if DEBUG
|
|||
if ((x < 0) || (x >= this.Width)) |
|||
{ |
|||
throw new ArgumentOutOfRangeException(nameof(x), "Value cannot be less than zero or greater than the bitmap width."); |
|||
} |
|||
|
|||
if ((y < 0) || (y >= this.Height)) |
|||
{ |
|||
throw new ArgumentOutOfRangeException(nameof(y), "Value cannot be less than zero or greater than the bitmap height."); |
|||
} |
|||
#endif
|
|||
return *((Color*)(this.pixelsBase + ((y * this.Width) + x) * 4)); |
|||
} |
|||
|
|||
set |
|||
{ |
|||
#if DEBUG
|
|||
if ((x < 0) || (x >= this.Width)) |
|||
{ |
|||
throw new ArgumentOutOfRangeException(nameof(x), "Value cannot be less than zero or greater than the bitmap width."); |
|||
} |
|||
|
|||
if ((y < 0) || (y >= this.Height)) |
|||
{ |
|||
throw new ArgumentOutOfRangeException(nameof(y), "Value cannot be less than zero or greater than the bitmap height."); |
|||
} |
|||
#endif
|
|||
*(Color*)(this.pixelsBase + (((y * this.Width) + x) * 4)) = value; |
|||
} |
|||
} |
|||
|
|||
/// <summary>
|
|||
/// Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.
|
|||
/// </summary>
|
|||
public void Dispose() |
|||
{ |
|||
if (this.isDisposed) |
|||
{ |
|||
return; |
|||
} |
|||
|
|||
if (this.pixelsHandle.IsAllocated) |
|||
{ |
|||
this.pixelsHandle.Free(); |
|||
} |
|||
|
|||
this.pixelsBase = null; |
|||
|
|||
// Note disposing is done.
|
|||
this.isDisposed = true; |
|||
|
|||
// This object will be cleaned up by the Dispose method.
|
|||
// Therefore, you should call GC.SuppressFinalize to
|
|||
// take this object off the finalization queue
|
|||
// and prevent finalization code for this object
|
|||
// from executing a second time.
|
|||
GC.SuppressFinalize(this); |
|||
} |
|||
} |
|||
} |
|||
Loading…
Reference in new issue