Add support for overprinting by way of extended graphics states

synercoder · synercoder · commit 1972355e5aeb · 2024-10-18T14:23:28.000+02:00
diff --git a/Directory.Build.targets b/Directory.Build.targets
@@ -7,7 +7,7 @@
   </PropertyGroup>
 
   <ItemGroup>
-    <PackageReference Update="SixLabors.ImageSharp" Version="3.0.*" />
+    <PackageReference Update="SixLabors.ImageSharp" Version="3.1.*" />
   </ItemGroup>
 
   <!-- Disable auto imports/usings from ImageSharp -->
diff --git a/src/Synercoding.FileFormats.Pdf/ExtendedGraphicsState.cs b/src/Synercoding.FileFormats.Pdf/ExtendedGraphicsState.cs
@@ -0,0 +1,23 @@
+﻿namespace Synercoding.FileFormats.Pdf;
+
+/// <summary>
+/// Class representing an ExtGState dictionary.
+/// </summary>
+public sealed record class ExtendedGraphicsState
+{
+    /// <summary>
+    /// A flag specifying whether to apply overprint.
+    /// There are two separate overprint parameters: one for stroking and one for all other painting operations.
+    /// Specifying an <see cref="Overprint"/> entry sets both parameters
+    /// unless there is also an <see cref="OverprintNonStroking"/> entry in the same graphics state parameter dictionary,
+    /// in which case the <see cref="Overprint"/> entry sets only the overprint parameter for stroking.
+    /// </summary>
+    public bool? Overprint { get; set; }
+
+    /// <summary>
+    /// A flag specifying whether to apply overprint for painting operations other than stroking.
+    /// If this entry is absent, the <see cref="Overprint"/> entry, if any, sets this parameter.
+    /// </summary>
+    public bool? OverprintNonStroking { get; set; }
+}
+
diff --git a/src/Synercoding.FileFormats.Pdf/GraphicsState.cs b/src/Synercoding.FileFormats.Pdf/GraphicsState.cs
@@ -7,9 +7,9 @@ namespace Synercoding.FileFormats.Pdf;
 /// <summary>
 /// Class representing the grahpic state of a PDF at a certain moment in time.
 /// </summary>
-public sealed class GraphicState
+public sealed class GraphicsState
 {
-    internal GraphicState()
+    internal GraphicsState()
     {
         CTM = Matrix.Identity;
         Fill = PredefinedColors.Black;
@@ -111,9 +111,9 @@ internal GraphicState()
     /// </summary>
     public double TextRise { get; internal set; }
 
-    internal GraphicState Clone()
+    internal GraphicsState Clone()
     {
-        return new GraphicState()
+        return new GraphicsState()
         {
             CTM = CTM,
             Fill = Fill,
diff --git a/src/Synercoding.FileFormats.Pdf/IContentContext.cs b/src/Synercoding.FileFormats.Pdf/IContentContext.cs
@@ -19,7 +19,7 @@ public interface IContentContext<TSelf>
     /// <summary>
     /// Represents the current graphic state
     /// </summary>
-    GraphicState GraphicState { get; }
+    GraphicsState GraphicState { get; }
 
     /// <summary>
     /// Wrap the <paramref name="contentOperations"/> in save and restore state operators
@@ -40,7 +40,7 @@ public interface IContentContext<TSelf>
     Task<TSelf> WrapInStateAsync<T>(T data, Func<T, TSelf, Task> contentOperations);
 
     /// <summary>
-    /// Concatenate a matrix to <see cref="GraphicState.CTM"/>
+    /// Concatenate a matrix to <see cref="GraphicsState.CTM"/>
     /// </summary>
     /// <param name="matrix">The matrix to concat</param>
     /// <returns>This <see cref="IContentContext{TSelf}"/> to enable chaining operations</returns>
@@ -94,5 +94,12 @@ public interface IContentContext<TSelf>
     /// <param name="dashPattern">The dash pattern to set</param>
     /// <returns>This <see cref="IContentContext{TSelf}"/> to enable chaining operations</returns>
     TSelf SetDashPattern(Dash dashPattern);
+
+    /// <summary>
+    /// Set an extended graphics state (ExtGState) dictionary.
+    /// </summary>
+    /// <param name="extendedGraphicsState">The state to apply.</param>
+    /// <returns>This <see cref="IContentContext{TSelf}"/> to enable chaining operations</returns>
+    TSelf SetExtendedGraphicsState(ExtendedGraphicsState extendedGraphicsState);
 }
 
diff --git a/src/Synercoding.FileFormats.Pdf/ITextContentContext.cs b/src/Synercoding.FileFormats.Pdf/ITextContentContext.cs
@@ -101,7 +101,7 @@ public interface ITextContentContext : IContentContext<ITextContentContext>
     ITextContentContext ShowTextOnNextLine(string text);
 
     /// <summary>
-    /// Operation to show text on the next line and setting the <see cref="GraphicState.WordSpacing"/> and <see cref="GraphicState.CharacterSpacing"/>
+    /// Operation to show text on the next line and setting the <see cref="GraphicsState.WordSpacing"/> and <see cref="GraphicsState.CharacterSpacing"/>
     /// </summary>
     /// <param name="text">The text to show</param>
     /// <param name="wordSpacing">The word spacing to set</param>
diff --git a/src/Synercoding.FileFormats.Pdf/Internals/PageContentContext.cs b/src/Synercoding.FileFormats.Pdf/Internals/PageContentContext.cs
@@ -6,15 +6,15 @@ namespace Synercoding.FileFormats.Pdf.Internals;
 
 internal class PageContentContext : IPageContentContext
 {
-    public PageContentContext(ContentStream contentStream, GraphicState graphicState)
+    public PageContentContext(ContentStream contentStream, GraphicsState graphicState)
     {
         RawContentStream = contentStream;
         GraphicState = graphicState;
     }
 
     public ContentStream RawContentStream { get; }
 
-    public GraphicState GraphicState { get; }
+    public GraphicsState GraphicState { get; }
 
     public IPageContentContext AddImage(Image image)
     {
@@ -155,4 +155,11 @@ public async Task<IPageContentContext> AddShapesAsync<T>(T data, Func<T, IShapeC
 
         return this;
     }
+
+    public IPageContentContext SetExtendedGraphicsState(ExtendedGraphicsState extendedGraphicsState)
+    {
+        RawContentStream.SetExtendedGraphicsState(extendedGraphicsState);
+
+        return this;
+    }
 }
diff --git a/src/Synercoding.FileFormats.Pdf/Internals/ShapesContentContext.cs b/src/Synercoding.FileFormats.Pdf/Internals/ShapesContentContext.cs
@@ -6,15 +6,15 @@ namespace Synercoding.FileFormats.Pdf.Internals;
 
 internal class ShapesContentContext : IShapeContentContext
 {
-    public ShapesContentContext(ContentStream contentStream, GraphicState graphicState)
+    public ShapesContentContext(ContentStream contentStream, GraphicsState graphicState)
     {
         RawContentStream = contentStream;
         GraphicState = graphicState;
     }
 
     public ContentStream RawContentStream { get; }
 
-    public GraphicState GraphicState { get; }
+    public GraphicsState GraphicState { get; }
 
     public IShapeContentContext ConcatenateMatrix(Matrix matrix)
     {
@@ -204,4 +204,11 @@ public IShapeContentContext EndPathNoStrokeNoFill()
 
         return this;
     }
+
+    public IShapeContentContext SetExtendedGraphicsState(ExtendedGraphicsState extendedGraphicsState)
+    {
+        RawContentStream.SetExtendedGraphicsState(extendedGraphicsState);
+
+        return this;
+    }
 }
diff --git a/src/Synercoding.FileFormats.Pdf/Internals/TextContentContext.cs b/src/Synercoding.FileFormats.Pdf/Internals/TextContentContext.cs
@@ -7,15 +7,15 @@ namespace Synercoding.FileFormats.Pdf.Internals;
 
 internal class TextContentContext : ITextContentContext
 {
-    public TextContentContext(ContentStream contentStream, GraphicState graphicState)
+    public TextContentContext(ContentStream contentStream, GraphicsState graphicState)
     {
         RawContentStream = contentStream;
         GraphicState = graphicState;
     }
 
     public ContentStream RawContentStream { get; }
 
-    public GraphicState GraphicState { get; }
+    public GraphicsState GraphicState { get; }
 
     public ITextContentContext ConcatenateMatrix(Matrix matrix)
     {
@@ -225,4 +225,11 @@ public ITextContentContext ShowTextOnNextLine(string text, double wordSpacing, d
 
         return this;
     }
+
+    public ITextContentContext SetExtendedGraphicsState(ExtendedGraphicsState extendedGraphicsState)
+    {
+        RawContentStream.SetExtendedGraphicsState(extendedGraphicsState);
+
+        return this;
+    }
 }
diff --git a/src/Synercoding.FileFormats.Pdf/LowLevel/ContentStream.cs b/src/Synercoding.FileFormats.Pdf/LowLevel/ContentStream.cs
@@ -387,6 +387,20 @@ public ContentStream Paint(PdfName resource)
         return this;
     }
 
+    /// <summary>
+    /// Set an extended graphics state (ExtGState) dictionary using a gs operator..
+    /// </summary>
+    /// <param name="state">The state to apply.</param>
+    /// <returns>The <see cref="ContentStream"/> to support chaining operations.</returns>
+    public ContentStream SetExtendedGraphicsState(ExtendedGraphicsState state)
+    {
+        var name = Resources.AddExtendedGraphicsState(state);
+
+        InnerStream.Write(name).Space().Write("gs").NewLine();
+
+        return this;
+    }
+
     /// <summary>
     /// Write the operator (m) to the stream
     /// </summary>
diff --git a/src/Synercoding.FileFormats.Pdf/LowLevel/Graphics/LineJoinStyle.cs b/src/Synercoding.FileFormats.Pdf/LowLevel/Graphics/LineJoinStyle.cs
@@ -9,7 +9,7 @@ public enum LineJoinStyle
     /// The outer edges of the strokes for the two segments shall be extended until they meet at an angle.
     /// </summary>
     /// <remarks>
-    /// If the segments meet at too sharp an angle (see <see cref="GraphicState.MiterLimit"/>), a bevel join shall be used instead.
+    /// If the segments meet at too sharp an angle (see <see cref="GraphicsState.MiterLimit"/>), a bevel join shall be used instead.
     /// </remarks>
     MiterJoin = 0,
     /// <summary>
diff --git a/src/Synercoding.FileFormats.Pdf/LowLevel/Internal/PageResources.cs b/src/Synercoding.FileFormats.Pdf/LowLevel/Internal/PageResources.cs
@@ -9,12 +9,15 @@ internal sealed class PageResources : IDisposable
 {
     private const string PREFIX_IMAGE = "Im";
     private const string PREFIX_SEPARATION = "Sep";
+    private const string PREFIX_EXTGSTATE = "ExGs";
 
     private readonly TableBuilder _tableBuilder;
     private readonly Map<PdfName, Image> _images;
     private readonly Dictionary<Separation, (PdfName Name, PdfReference Id)> _separations;
     private readonly Dictionary<Type1StandardFont, PdfReference> _standardFonts;
+    private readonly Dictionary<ExtendedGraphicsState, PdfName> _extendedGraphicsStates;
 
+    private int _stateCounter = 0;
     private int _separationCounter = 0;
     private int _imageCounter = 0;
 
@@ -24,11 +27,15 @@ internal PageResources(TableBuilder tableBuilder)
         _images = new Map<PdfName, Image>();
         _separations = new Dictionary<Separation, (PdfName Name, PdfReference Id)>();
         _standardFonts = new Dictionary<Type1StandardFont, PdfReference>();
+        _extendedGraphicsStates = new Dictionary<ExtendedGraphicsState, PdfName>();
     }
 
     public IReadOnlyDictionary<PdfName, Image> Images
         => _images.Forward;
 
+    public IReadOnlyDictionary<ExtendedGraphicsState, PdfName> ExtendedGraphicsStates
+        => _extendedGraphicsStates;
+
     internal IReadOnlyDictionary<Separation, (PdfName Name, PdfReference Id)> SeparationReferences
         => _separations;
 
@@ -105,4 +112,16 @@ internal PdfName AddSeparation(Separation separation)
 
         return name;
     }
+
+    internal PdfName AddExtendedGraphicsState(ExtendedGraphicsState extendedGraphicsState)
+    {
+        if (_extendedGraphicsStates.TryGetValue(extendedGraphicsState, out var name))
+            return name;
+
+        var key = PREFIX_SEPARATION + Interlocked.Increment(ref _stateCounter).ToString().PadLeft(6, '0');
+        name = PdfName.Get(key);
+        _extendedGraphicsStates[extendedGraphicsState] = name;
+
+        return name;
+    }
 }
diff --git a/src/Synercoding.FileFormats.Pdf/LowLevel/ObjectStream.cs b/src/Synercoding.FileFormats.Pdf/LowLevel/ObjectStream.cs
@@ -159,6 +159,27 @@ public ObjectStream Write(PdfPage page)
                         }
                     }));
                 }
+
+                if (resources.ExtendedGraphicsStates.Count != 0)
+                {
+                    stream.Write(PdfName.Get("ExtGState"), resources.ExtendedGraphicsStates, static (extGStates, stream) => stream.Dictionary(extGStates, static (extendedGStates, extgstateDictionary) =>
+                    {
+                        foreach(var (state, name) in extendedGStates)
+                        {
+                            extgstateDictionary.Write(name, state, static (state, raw) =>
+                            {
+                                raw.Dictionary(state, static (state, dict) =>
+                                {
+                                    if (state.Overprint.HasValue)
+                                        dict.Write(PdfName.Get("OP"), state.Overprint.Value);
+                                    if (state.OverprintNonStroking.HasValue)
+                                        dict.Write(PdfName.Get("op"), state.OverprintNonStroking.Value);
+                                });
+                            });
+                        }
+                    }));
+                }
+
             }));
 
             // Content stream
diff --git a/src/Synercoding.FileFormats.Pdf/LowLevel/PdfDictionary.cs b/src/Synercoding.FileFormats.Pdf/LowLevel/PdfDictionary.cs
@@ -146,6 +146,22 @@ public PdfDictionary Write(PdfName key, int value)
         return this;
     }
 
+    /// <summary>
+    /// Write a boolean to the dictionary
+    /// </summary>
+    /// <param name="key">The key of the item in the dictionary</param>
+    /// <param name="value">The boolean to write</param>
+    /// <returns>The <see cref="PdfDictionary"/> to support chaining operations.</returns>
+    public PdfDictionary Write(PdfName key, bool value)
+    {
+        _stream
+            .Write(key)
+            .Space()
+            .Write(value);
+
+        return this;
+    }
+
     /// <summary>
     /// Write a text to the dictionary
     /// </summary>
diff --git a/src/Synercoding.FileFormats.Pdf/LowLevel/PdfStream.cs b/src/Synercoding.FileFormats.Pdf/LowLevel/PdfStream.cs
@@ -56,6 +56,18 @@ public PdfStream Write(char c)
         return WriteByte((byte)( c & 0xFF ));
     }
 
+    /// <summary>
+    /// Write a <see cref="bool"/> to the stream
+    /// </summary>
+    /// <param name="b">The boolean to write.</param>
+    /// <returns>The calling <see cref="PdfStream"/> to support chaining operations.</returns>
+    public PdfStream Write(bool b)
+    {
+        return b
+            ? Write("true")
+            : Write("false");
+    }
+
     /// <summary>
     /// Write a <see cref="int"/> to the stream
     /// </summary>
diff --git a/src/Synercoding.FileFormats.Pdf/PdfPage.cs b/src/Synercoding.FileFormats.Pdf/PdfPage.cs
@@ -26,7 +26,7 @@ internal PdfPage(TableBuilder tableBuilder, PageTree parent)
         Resources = new PageResources(_tableBuilder);
         var contentStream = new ContentStream(tableBuilder.ReserveId(), Resources);
 
-        Content = new PageContentContext(contentStream, new GraphicState());
+        Content = new PageContentContext(contentStream, new GraphicsState());
     }
 
     internal PdfReference Parent

Original file line number	Diff line number	Diff line change
`@@ -7,9 +7,9 @@ namespace Synercoding.FileFormats.Pdf;`
`7`	`7`	`/// <summary>`
`8`	`8`	`/// Class representing the grahpic state of a PDF at a certain moment in time.`
`9`	`9`	`/// </summary>`
`10`		`-public sealed class GraphicState`
	`10`	`+public sealed class GraphicsState`
`11`	`11`	`{`
`12`		`- internal GraphicState()`
	`12`	`+ internal GraphicsState()`
`13`	`13`	`{`
`14`	`14`	`CTM = Matrix.Identity;`
`15`	`15`	`Fill = PredefinedColors.Black;`
`@@ -111,9 +111,9 @@ internal GraphicState()`
`111`	`111`	`/// </summary>`
`112`	`112`	`public double TextRise { get; internal set; }`
`113`	`113`
`114`		`- internal GraphicState Clone()`
	`114`	`+ internal GraphicsState Clone()`
`115`	`115`	`{`
`116`		`- return new GraphicState()`
	`116`	`+ return new GraphicsState()`
`117`	`117`	`{`
`118`	`118`	`CTM = CTM,`
`119`	`119`	`Fill = Fill,`
Original file line number	Diff line number	Diff line change
`@@ -6,15 +6,15 @@ namespace Synercoding.FileFormats.Pdf.Internals;`
`6`	`6`
`7`	`7`	`internal class PageContentContext : IPageContentContext`
`8`	`8`	`{`
`9`		`- public PageContentContext(ContentStream contentStream, GraphicState graphicState)`
	`9`	`+ public PageContentContext(ContentStream contentStream, GraphicsState graphicState)`
`10`	`10`	`{`
`11`	`11`	`RawContentStream = contentStream;`
`12`	`12`	`GraphicState = graphicState;`
`13`	`13`	`}`
`14`	`14`
`15`	`15`	`public ContentStream RawContentStream { get; }`
`16`	`16`
`17`		`- public GraphicState GraphicState { get; }`
	`17`	`+ public GraphicsState GraphicState { get; }`
`18`	`18`
`19`	`19`	`public IPageContentContext AddImage(Image image)`
`20`	`20`	`{`
`@@ -155,4 +155,11 @@ public async Task<IPageContentContext> AddShapesAsync<T>(T data, Func<T, IShapeC`
`155`	`155`
`156`	`156`	`return this;`
`157`	`157`	`}`
	`158`	`+`
	`159`	`+ public IPageContentContext SetExtendedGraphicsState(ExtendedGraphicsState extendedGraphicsState)`
	`160`	`+ {`
	`161`	`+ RawContentStream.SetExtendedGraphicsState(extendedGraphicsState);`
	`162`	`+`
	`163`	`+ return this;`
	`164`	`+ }`
`158`	`165`	`}`
Original file line number	Diff line number	Diff line change
`@@ -6,15 +6,15 @@ namespace Synercoding.FileFormats.Pdf.Internals;`
`6`	`6`
`7`	`7`	`internal class ShapesContentContext : IShapeContentContext`
`8`	`8`	`{`
`9`		`- public ShapesContentContext(ContentStream contentStream, GraphicState graphicState)`
	`9`	`+ public ShapesContentContext(ContentStream contentStream, GraphicsState graphicState)`
`10`	`10`	`{`
`11`	`11`	`RawContentStream = contentStream;`
`12`	`12`	`GraphicState = graphicState;`
`13`	`13`	`}`
`14`	`14`
`15`	`15`	`public ContentStream RawContentStream { get; }`
`16`	`16`
`17`		`- public GraphicState GraphicState { get; }`
	`17`	`+ public GraphicsState GraphicState { get; }`
`18`	`18`
`19`	`19`	`public IShapeContentContext ConcatenateMatrix(Matrix matrix)`
`20`	`20`	`{`
`@@ -204,4 +204,11 @@ public IShapeContentContext EndPathNoStrokeNoFill()`
`204`	`204`
`205`	`205`	`return this;`
`206`	`206`	`}`
	`207`	`+`
	`208`	`+ public IShapeContentContext SetExtendedGraphicsState(ExtendedGraphicsState extendedGraphicsState)`
	`209`	`+ {`
	`210`	`+ RawContentStream.SetExtendedGraphicsState(extendedGraphicsState);`
	`211`	`+`
	`212`	`+ return this;`
	`213`	`+ }`
`207`	`214`	`}`
Original file line number	Diff line number	Diff line change
`@@ -7,15 +7,15 @@ namespace Synercoding.FileFormats.Pdf.Internals;`
`7`	`7`
`8`	`8`	`internal class TextContentContext : ITextContentContext`
`9`	`9`	`{`
`10`		`- public TextContentContext(ContentStream contentStream, GraphicState graphicState)`
	`10`	`+ public TextContentContext(ContentStream contentStream, GraphicsState graphicState)`
`11`	`11`	`{`
`12`	`12`	`RawContentStream = contentStream;`
`13`	`13`	`GraphicState = graphicState;`
`14`	`14`	`}`
`15`	`15`
`16`	`16`	`public ContentStream RawContentStream { get; }`
`17`	`17`
`18`		`- public GraphicState GraphicState { get; }`
	`18`	`+ public GraphicsState GraphicState { get; }`
`19`	`19`
`20`	`20`	`public ITextContentContext ConcatenateMatrix(Matrix matrix)`
`21`	`21`	`{`
`@@ -225,4 +225,11 @@ public ITextContentContext ShowTextOnNextLine(string text, double wordSpacing, d`
`225`	`225`
`226`	`226`	`return this;`
`227`	`227`	`}`
	`228`	`+`
	`229`	`+ public ITextContentContext SetExtendedGraphicsState(ExtendedGraphicsState extendedGraphicsState)`
	`230`	`+ {`
	`231`	`+ RawContentStream.SetExtendedGraphicsState(extendedGraphicsState);`
	`232`	`+`
	`233`	`+ return this;`
	`234`	`+ }`
`228`	`235`	`}`