Fix orientation, update ref output

Author: JimBobSquarePants

src/ImageSharp.Drawing/Processing/Backends/CompositionCommand.cs

@@ -18,6 +18,7 @@ public struct CompositionCommand
     private readonly Matrix4x4 transform;
     private readonly IReadOnlyList<IPath>? clipPaths;
     private readonly ShapeOptions shapeOptions;
+    private readonly bool enforceFillOrientation;
 
     private CompositionCommand(
         int definitionKey,
@@ -29,7 +30,8 @@ private CompositionCommand(
         Pen? pen,
         Matrix4x4 transform,
         IReadOnlyList<IPath>? clipPaths,
-        ShapeOptions shapeOptions)
+        ShapeOptions shapeOptions,
+        bool enforceFillOrientation)
     {
         this.DefinitionKey = definitionKey;
         this.sourcePath = sourcePath;
@@ -42,6 +44,7 @@ private CompositionCommand(
         this.transform = transform;
         this.clipPaths = clipPaths;
         this.shapeOptions = shapeOptions;
+        this.enforceFillOrientation = enforceFillOrientation;
     }
 
     /// <summary>
@@ -92,6 +95,10 @@ private CompositionCommand(
     /// <param name="rasterizerOptions">Rasterizer options used to generate coverage.</param>
     /// <param name="shapeOptions">Shape options for clip operations.</param>
     /// <param name="transform">Transform matrix to apply during preparation.</param>
+    /// <param name="enforceFillOrientation">
+    /// When <see langword="true"/>, preparation normalizes closed contour orientation before rasterization.
+    /// Callers should only enable this when they explicitly want contour winding rewritten.
+    /// </param>
     /// <param name="destinationOffset">Absolute destination offset where coverage is composited.</param>
     /// <param name="pen">Optional pen for stroke commands. The batcher expands strokes to fills.</param>
     /// <param name="clipPaths">Optional clip paths to apply during preparation.</param>
@@ -103,6 +110,7 @@ public static CompositionCommand Create(
         in RasterizerOptions rasterizerOptions,
         ShapeOptions shapeOptions,
         Matrix4x4 transform,
+        bool enforceFillOrientation,
         Point destinationOffset = default,
         Pen? pen = null,
         IReadOnlyList<IPath>? clipPaths = null)
@@ -119,7 +127,8 @@ public static CompositionCommand Create(
             pen,
             transform,
             clipPaths,
-            shapeOptions);
+            shapeOptions,
+            enforceFillOrientation);
     }
 
     /// <summary>
@@ -178,7 +187,7 @@ internal void Prepare(GeometryPreparationCache? geometryCache = null)
     /// </summary>
     /// <returns>The geometry preparation cache key.</returns>
     internal readonly GeometryPreparationCache.GeometryPreparationKey CreateGeometryPreparationKey()
-        => new(this.sourcePath, this.transform, this.pen, this.clipPaths, this.shapeOptions);
+        => new(this.sourcePath, this.transform, this.pen, this.clipPaths, this.shapeOptions, this.enforceFillOrientation);
 
     /// <summary>
     /// Builds prepared geometry for this command without consulting any external cache.
@@ -207,7 +216,7 @@ internal readonly PreparedGeometry BuildPreparedGeometry()
         }
 
         // Line preparation happens here so backends no longer need to traverse IPath.
-        return PreparedGeometry.Create(path, enforceFillOrientation: this.pen is null);
+        return PreparedGeometry.Create(path, enforceFillOrientation: this.enforceFillOrientation);
     }
 
     /// <summary>