Normalize stroke docs.

Author: JimBobSquarePants

src/ImageSharp.Drawing/BooleanOperation.cs

@@ -3,29 +3,18 @@
 
 namespace SixLabors.ImageSharp.Drawing;
 
-/// <summary>
-/// Specifies the type of boolean operation to perform on polygons.
-/// </summary>
+/// <inheritdoc cref="PolygonClipper.BooleanOperation" />
 public enum BooleanOperation
 {
-    /// <summary>
-    /// The intersection operation, which results in the area common to both polygons.
-    /// </summary>
+    /// <inheritdoc cref="PolygonClipper.BooleanOperation.Intersection" />
     Intersection = 0,
 
-    /// <summary>
-    /// The union operation, which results in the combined area of both polygons.
-    /// </summary>
+    /// <inheritdoc cref="PolygonClipper.BooleanOperation.Union" />
     Union = 1,
 
-    /// <summary>
-    /// The difference operation, which subtracts the clipping polygon from the subject polygon.
-    /// </summary>
+    /// <inheritdoc cref="PolygonClipper.BooleanOperation.Difference" />
     Difference = 2,
 
-    /// <summary>
-    /// The exclusive OR (XOR) operation, which results in the area covered by exactly one polygon,
-    /// excluding the overlapping areas.
-    /// </summary>
+    /// <inheritdoc cref="PolygonClipper.BooleanOperation.Xor" />
     Xor = 3
 }

src/ImageSharp.Drawing/LineCap.cs

@@ -3,26 +3,15 @@
 
 namespace SixLabors.ImageSharp.Drawing;
 
-/// <summary>
-/// Specifies the shape to be used at the ends of open lines or paths when stroking.
-/// </summary>
+/// <inheritdoc cref="PolygonClipper.LineCap" />
 public enum LineCap
 {
-    /// <summary>
-    /// The stroke ends exactly at the endpoint.
-    /// No extension is added beyond the path's end coordinates.
-    /// </summary>
+    /// <inheritdoc cref="PolygonClipper.LineCap.Butt" />
     Butt,
 
-    /// <summary>
-    /// The stroke extends beyond the endpoint by half the line width,
-    /// producing a square edge.
-    /// </summary>
+    /// <inheritdoc cref="PolygonClipper.LineCap.Square" />
     Square,
 
-    /// <summary>
-    /// The stroke ends with a semicircular cap,
-    /// extending beyond the endpoint by half the line width.
-    /// </summary>
+    /// <inheritdoc cref="PolygonClipper.LineCap.Round" />
     Round
 }

src/ImageSharp.Drawing/LineJoin.cs

@@ -3,40 +3,21 @@
 
 namespace SixLabors.ImageSharp.Drawing;
 
-/// <summary>
-/// Specifies how the connection between two consecutive line segments (a join)
-/// is rendered when stroking paths or polygons.
-/// </summary>
+/// <inheritdoc cref="PolygonClipper.LineJoin" />
 public enum LineJoin
 {
-    /// <summary>
-    /// Joins lines by extending their outer edges until they meet at a sharp corner.
-    /// The miter length is limited by the miter limit; if exceeded, the join may fall back to a bevel.
-    /// </summary>
+    /// <inheritdoc cref="PolygonClipper.LineJoin.Miter" />
     Miter = 0,
 
-    /// <summary>
-    /// Joins lines by extending their outer edges to form a miter,
-    /// but if the miter length exceeds the miter limit, the join is truncated
-    /// at the limit distance rather than falling back to a bevel.
-    /// </summary>
+    /// <inheritdoc cref="PolygonClipper.LineJoin.MiterRevert" />
     MiterRevert = 1,
 
-    /// <summary>
-    /// Joins lines by connecting them with a circular arc centered at the join point,
-    /// producing a smooth, rounded corner.
-    /// </summary>
+    /// <inheritdoc cref="PolygonClipper.LineJoin.Round" />
     Round = 2,
 
-    /// <summary>
-    /// Joins lines by connecting the outer corners directly with a straight line,
-    /// forming a flat edge at the join point.
-    /// </summary>
+    /// <inheritdoc cref="PolygonClipper.LineJoin.Bevel" />
     Bevel = 3,
 
-    /// <summary>
-    /// Joins lines by forming a miter, but if the miter limit is exceeded,
-    /// the join falls back to a round join instead of a bevel.
-    /// </summary>
+    /// <inheritdoc cref="PolygonClipper.LineJoin.MiterRound" />
     MiterRound = 4
 }

src/ImageSharp.Drawing/PolygonGeometry/StrokedShapeGenerator.cs

@@ -98,8 +98,7 @@ private static PolygonClipper.StrokeOptions CreateStrokeOptions(StrokeOptions op
                 LineCap.Round => PolygonClipper.LineCap.Round,
                 LineCap.Square => PolygonClipper.LineCap.Square,
                 _ => PolygonClipper.LineCap.Butt,
-            },
-            NormalizeOutput = options.NormalizeOutput
+            }
         };
 
         return o;

src/ImageSharp.Drawing/Processing/StrokeOptions.cs

@@ -3,43 +3,21 @@
 
 namespace SixLabors.ImageSharp.Drawing.Processing;
 
-/// <summary>
-/// Provides configuration options for geometric stroke generation.
-/// </summary>
+/// <inheritdoc cref="PolygonClipper.StrokeOptions" />
 public sealed class StrokeOptions : IEquatable<StrokeOptions?>
 {
-    /// <summary>
-    /// Gets or sets the miter limit used to clamp outer miter joins.
-    /// </summary>
+    /// <inheritdoc cref="PolygonClipper.StrokeOptions.MiterLimit" />
     public double MiterLimit { get; set; } = 4D;
 
-    /// <summary>
-    /// Gets or sets the tessellation detail scale for round joins and round caps.
-    /// Higher values produce more vertices (smoother curves, more work).
-    /// Lower values produce fewer vertices.
-    /// </summary>
+    /// <inheritdoc cref="PolygonClipper.StrokeOptions.ArcDetailScale" />
     public double ArcDetailScale { get; set; } = 1D;
 
-    /// <summary>
-    /// Gets or sets the outer line join style used for stroking corners.
-    /// </summary>
+    /// <inheritdoc cref="PolygonClipper.StrokeOptions.LineJoin" />
     public LineJoin LineJoin { get; set; } = LineJoin.Bevel;
 
-    /// <summary>
-    /// Gets or sets the line cap style used for open path ends.
-    /// </summary>
+    /// <inheritdoc cref="PolygonClipper.StrokeOptions.LineCap" />
     public LineCap LineCap { get; set; } = LineCap.Butt;
 
-    /// <summary>
-    /// Gets or sets a value indicating whether stroked contours should be normalized
-    /// by resolving self-intersections and overlaps before returning.
-    /// </summary>
-    /// <remarks>
-    /// Defaults to false for maximum throughput. When disabled, callers should rasterize
-    /// with a non-zero winding fill rule.
-    /// </remarks>
-    public bool NormalizeOutput { get; set; }
-
     /// <inheritdoc/>
     public override bool Equals(object? obj) => this.Equals(obj as StrokeOptions);
 
@@ -49,15 +27,13 @@ public bool Equals(StrokeOptions? other)
            this.MiterLimit == other.MiterLimit &&
            this.ArcDetailScale == other.ArcDetailScale &&
            this.LineJoin == other.LineJoin &&
-           this.LineCap == other.LineCap &&
-           this.NormalizeOutput == other.NormalizeOutput;
+           this.LineCap == other.LineCap;
 
     /// <inheritdoc/>
     public override int GetHashCode()
         => HashCode.Combine(
             this.MiterLimit,
             this.ArcDetailScale,
             this.LineJoin,
-            this.LineCap,
-            this.NormalizeOutput);
+            this.LineCap);
 }

tests/ImageSharp.Drawing.Tests/Processing/DrawingCanvasTests.StrokeOptions.cs

@@ -11,7 +11,7 @@ public partial class DrawingCanvasTests
 {
     [Theory]
     [WithBlankImage(360, 220, PixelTypes.Rgba32)]
-    public void Draw_NormalizeOutputFalse_MatchesReference<TPixel>(TestImageProvider<TPixel> provider)
+    public void Draw_SelfIntersectingStroke_MatchesReference<TPixel>(TestImageProvider<TPixel> provider)
         where TPixel : unmanaged, IPixel<TPixel>
     {
         using Image<TPixel> target = provider.GetImage();