Rename Pixel Shader Extensions and Delegates

src/ImageSharp/Processing/Extensions/Effects/PixelRowDelegateExtensions.cs

@@ -0,0 +1,102 @@
+// Copyright (c) Six Labors and contributors.
+// Licensed under the Apache License, Version 2.0.
+
+using SixLabors.ImageSharp.PixelFormats;
+using SixLabors.ImageSharp.Processing.Processors.Effects;
+
+namespace SixLabors.ImageSharp.Processing
+{
+    /// <summary>
+    /// Defines extension methods that allow the application of user defined processing delegate to an <see cref="Image"/>.
+    /// </summary>
+    public static class PixelRowDelegateExtensions
+    {
+        /// <summary>
+        /// Applies a user defined processing delegate to the image.
+        /// </summary>
+        /// <param name="source">The image this method extends.</param>
+        /// <param name="rowOperation">The user defined processing delegate to use to modify image rows.</param>
+        /// <returns>The <see cref="IImageProcessingContext"/> to allow chaining of operations.</returns>
+        public static IImageProcessingContext ProcessPixelRowsAsVector4(this IImageProcessingContext source, PixelRowOperation rowOperation)
+            => ProcessPixelRowsAsVector4(source, rowOperation, PixelConversionModifiers.None);
+
+        /// <summary>
+        /// Applies a user defined processing delegate to the image.
+        /// </summary>
+        /// <param name="source">The image this method extends.</param>
+        /// <param name="rowOperation">The user defined processing delegate to use to modify image rows.</param>
+        /// <param name="modifiers">The <see cref="PixelConversionModifiers"/> to apply during the pixel conversions.</param>
+        /// <returns>The <see cref="IImageProcessingContext"/> to allow chaining of operations.</returns>
+        public static IImageProcessingContext ProcessPixelRowsAsVector4(this IImageProcessingContext source, PixelRowOperation rowOperation, PixelConversionModifiers modifiers)
+            => source.ApplyProcessor(new PixelRowDelegateProcessor(rowOperation, modifiers));
+
+        /// <summary>
+        /// Applies a user defined processing delegate to the image.
+        /// </summary>
+        /// <param name="source">The image this method extends.</param>
+        /// <param name="rowOperation">The user defined processing delegate to use to modify image rows.</param>
+        /// <param name="rectangle">
+        /// The <see cref="Rectangle"/> structure that specifies the portion of the image object to alter.
+        /// </param>
+        /// <returns>The <see cref="IImageProcessingContext"/> to allow chaining of operations.</returns>
+        public static IImageProcessingContext ProcessPixelRowsAsVector4(this IImageProcessingContext source, PixelRowOperation rowOperation, Rectangle rectangle)
+            => ProcessPixelRowsAsVector4(source, rowOperation, rectangle, PixelConversionModifiers.None);
+
+        /// <summary>
+        /// Applies a user defined processing delegate to the image.
+        /// </summary>
+        /// <param name="source">The image this method extends.</param>
+        /// <param name="rowOperation">The user defined processing delegate to use to modify image rows.</param>
+        /// <param name="rectangle">
+        /// The <see cref="Rectangle"/> structure that specifies the portion of the image object to alter.
+        /// </param>
+        /// <param name="modifiers">The <see cref="PixelConversionModifiers"/> to apply during the pixel conversions.</param>
+        /// <returns>The <see cref="IImageProcessingContext"/> to allow chaining of operations.</returns>
+        public static IImageProcessingContext ProcessPixelRowsAsVector4(this IImageProcessingContext source, PixelRowOperation rowOperation, Rectangle rectangle, PixelConversionModifiers modifiers)
+            => source.ApplyProcessor(new PixelRowDelegateProcessor(rowOperation, modifiers), rectangle);
+
+        /// <summary>
+        /// Applies a user defined processing delegate to the image.
+        /// </summary>
+        /// <param name="source">The image this method extends.</param>
+        /// <param name="rowOperation">The user defined processing delegate to use to modify image rows.</param>
+        /// <returns>The <see cref="IImageProcessingContext"/> to allow chaining of operations.</returns>
+        public static IImageProcessingContext ProcessPixelRowsAsVector4(this IImageProcessingContext source, PositionAwarePixelRowOperation rowOperation)
+            => ProcessPixelRowsAsVector4(source, rowOperation, PixelConversionModifiers.None);
+
+        /// <summary>
+        /// Applies a user defined processing delegate to the image.
+        /// </summary>
+        /// <param name="source">The image this method extends.</param>
+        /// <param name="rowOperation">The user defined processing delegate to use to modify image rows.</param>
+        /// <param name="modifiers">The <see cref="PixelConversionModifiers"/> to apply during the pixel conversions.</param>
+        /// <returns>The <see cref="IImageProcessingContext"/> to allow chaining of operations.</returns>
+        public static IImageProcessingContext ProcessPixelRowsAsVector4(this IImageProcessingContext source, PositionAwarePixelRowOperation rowOperation, PixelConversionModifiers modifiers)
+            => source.ApplyProcessor(new PositionAwarePixelRowDelegateProcessor(rowOperation, modifiers));
+
+        /// <summary>
+        /// Applies a user defined processing delegate to the image.
+        /// </summary>
+        /// <param name="source">The image this method extends.</param>
+        /// <param name="rowOperation">The user defined processing delegate to use to modify image rows.</param>
+        /// <param name="rectangle">
+        /// The <see cref="Rectangle"/> structure that specifies the portion of the image object to alter.
+        /// </param>
+        /// <returns>The <see cref="IImageProcessingContext"/> to allow chaining of operations.</returns>
+        public static IImageProcessingContext ProcessPixelRowsAsVector4(this IImageProcessingContext source, PositionAwarePixelRowOperation rowOperation, Rectangle rectangle)
+            => ProcessPixelRowsAsVector4(source, rowOperation, rectangle, PixelConversionModifiers.None);
+
+        /// <summary>
+        /// Applies a user defined processing delegate to the image.
+        /// </summary>
+        /// <param name="source">The image this method extends.</param>
+        /// <param name="rowOperation">The user defined processing delegate to use to modify image rows.</param>
+        /// <param name="rectangle">
+        /// The <see cref="Rectangle"/> structure that specifies the portion of the image object to alter.
+        /// </param>
+        /// <param name="modifiers">The <see cref="PixelConversionModifiers"/> to apply during the pixel conversions.</param>
+        /// <returns>The <see cref="IImageProcessingContext"/> to allow chaining of operations.</returns>
+        public static IImageProcessingContext ProcessPixelRowsAsVector4(this IImageProcessingContext source, PositionAwarePixelRowOperation rowOperation, Rectangle rectangle, PixelConversionModifiers modifiers)
+            => source.ApplyProcessor(new PositionAwarePixelRowDelegateProcessor(rowOperation, modifiers), rectangle);
+    }
+}

src/ImageSharp/Processing/PixelShader.cs → src/ImageSharp/Processing/PixelRowOperation.cs

@@ -7,9 +7,9 @@
 namespace SixLabors.ImageSharp.Processing
 {
     /// <summary>
-    /// A <see langword="delegate"/> representing a user defined pixel shader.
+    /// A <see langword="delegate"/> representing a user defined processing delegate to use to modify image rows.
     /// </summary>
     /// <param name="span">The target row of <see cref="Vector4"/> pixels to process.</param>
     /// <remarks>The <see cref="Vector4.X"/>, <see cref="Vector4.Y"/>, <see cref="Vector4.Z"/>, and <see cref="Vector4.W"/> fields map the RGBA channels respectively.</remarks>
-    public delegate void PixelShader(Span<Vector4> span);
+    public delegate void PixelRowOperation(Span<Vector4> span);
 }

src/ImageSharp/Processing/PositionAwarePixelShader.cs → src/ImageSharp/Processing/PositionAwarePixelRowOperation.cs

@@ -7,10 +7,10 @@
 namespace SixLabors.ImageSharp.Processing
 {
     /// <summary>
-    /// A <see langword="delegate"/> representing a user defined pixel shader.
+    /// A <see langword="delegate"/> representing a user defined, position aware, processing delegate to use to modify image rows.
     /// </summary>
     /// <param name="span">The target row of <see cref="Vector4"/> pixels to process.</param>
     /// <param name="offset">The initial horizontal and vertical offset for the input pixels to process.</param>
     /// <remarks>The <see cref="Vector4.X"/>, <see cref="Vector4.Y"/>, <see cref="Vector4.Z"/>, and <see cref="Vector4.W"/> fields map the RGBA channels respectively.</remarks>
-    public delegate void PositionAwarePixelShader(Span<Vector4> span, Point offset);
+    public delegate void PositionAwarePixelRowOperation(Span<Vector4> span, Point offset);
 }

src/ImageSharp/Processing/Processors/Effects/PixelRowDelegateProcessor.cs

@@ -0,0 +1,39 @@
+// Copyright (c) Six Labors and contributors.
+// Licensed under the Apache License, Version 2.0.
+
+using SixLabors.ImageSharp.PixelFormats;
+
+namespace SixLabors.ImageSharp.Processing.Processors.Effects
+{
+    /// <summary>
+    /// Applies a user defined row processing delegate to the image.
+    /// </summary>
+    public sealed class PixelRowDelegateProcessor : IImageProcessor
+    {
+        /// <summary>
+        /// Initializes a new instance of the <see cref="PixelRowDelegateProcessor"/> class.
+        /// </summary>
+        /// <param name="pixelRowOperation">The user defined, row processing delegate.</param>
+        /// <param name="modifiers">The <see cref="PixelConversionModifiers"/> to apply during the pixel conversions.</param>
+        public PixelRowDelegateProcessor(PixelRowOperation pixelRowOperation, PixelConversionModifiers modifiers)
+        {
+            this.PixelRowOperation = pixelRowOperation;
+            this.Modifiers = modifiers;
+        }
+
+        /// <summary>
+        /// Gets the user defined row processing delegate to the image.
+        /// </summary>
+        public PixelRowOperation PixelRowOperation { get; }
+
+        /// <summary>
+        /// Gets the <see cref="PixelConversionModifiers"/> to apply during the pixel conversions.
+        /// </summary>
+        public PixelConversionModifiers Modifiers { get; }
+
+        /// <inheritdoc />
+        public IImageProcessor<TPixel> CreatePixelSpecificProcessor<TPixel>(Configuration configuration, Image<TPixel> source, Rectangle sourceRectangle)
+            where TPixel : struct, IPixel<TPixel>
+            => new PixelRowDelegateProcessor<TPixel>(configuration, this, source, sourceRectangle);
+    }
+}