Add WatermarkAndRotate example and README sections

Jaben · Jaben · commit 4872a12236c0 · 2026-03-28T12:12:45.000-04:00
Add console example demonstrating watermark and rotation options.
Add README sections for watermark/rotation and split features.
diff --git a/README.md b/README.md
@@ -492,6 +492,38 @@ public async Task<Stream> FastConversion()
 }
 ```
 
+### Watermark & Rotation
+*Add text watermarks and rotate PDF pages — available on all request types:*
+
+```csharp
+public async Task<Stream> CreateWatermarkedPdf()
+{
+    var builder = new HtmlRequestBuilder()
+        .AddDocument(doc => doc.SetBody("<html><body><h1>Report</h1></body></html>"))
+        .SetWatermarkOptions(w => w.SetTextWatermark("DRAFT", "1-3"))
+        .SetRotationOptions(r => r.SetAngle(90).SetPages("2"))
+        .WithPageProperties(pp => pp.UseChromeDefaults());
+
+    var request = builder.Build();
+    return await _sharpClient.HtmlToPdfAsync(request);
+}
+```
+
+### Split PDFs
+*Split generated PDFs into chunks or extract specific pages:*
+
+```csharp
+public async Task<Stream> SplitPdf()
+{
+    var builder = new HtmlRequestBuilder()
+        .AddDocument(doc => doc.SetBody("<html><body>Multi-page content</body></html>"))
+        .SetSplitOptions(s => s.SplitByPages("1-3,5", unify: true));
+
+    var request = builder.Build();
+    return await _sharpClient.HtmlToPdfAsync(request);
+}
+```
+
 ### Custom Page Properties
 *Fine-tune page dimensions and properties:*
 
diff --git a/examples/WatermarkAndRotate/Program.cs b/examples/WatermarkAndRotate/Program.cs
@@ -0,0 +1,61 @@
+using Gotenberg.Sharp.API.Client;
+using Gotenberg.Sharp.API.Client.Domain.Builders;
+using Gotenberg.Sharp.API.Client.Domain.ValueObjects;
+using Gotenberg.Sharp.API.Client.Domain.Settings;
+using Gotenberg.Sharp.API.Client.Infrastructure.Pipeline;
+
+using Microsoft.Extensions.Configuration;
+
+var config = new ConfigurationBuilder()
+    .SetBasePath(AppContext.BaseDirectory)
+    .AddJsonFile("appsettings.json")
+    .Build();
+
+var options = new GotenbergSharpClientOptions();
+config.GetSection(nameof(GotenbergSharpClient)).Bind(options);
+
+var destinationDirectory = args.Length > 0 ? args[0] : Path.Combine(Directory.GetCurrentDirectory(), "output");
+Directory.CreateDirectory(destinationDirectory);
+
+var path = await CreateWatermarkedAndRotatedPdf(destinationDirectory, options);
+Console.WriteLine($"Watermarked & rotated PDF created: {path}");
+
+static async Task<string> CreateWatermarkedAndRotatedPdf(string destinationDirectory, GotenbergSharpClientOptions options)
+{
+    using var handler = new HttpClientHandler();
+    using var authHandler = !string.IsNullOrWhiteSpace(options.BasicAuthUsername) && !string.IsNullOrWhiteSpace(options.BasicAuthPassword)
+        ? new BasicAuthHandler(options.BasicAuthUsername, options.BasicAuthPassword) { InnerHandler = handler }
+        : null;
+
+    using var httpClient = new HttpClient(authHandler ?? (HttpMessageHandler)handler)
+    {
+        BaseAddress = options.ServiceUrl,
+        Timeout = options.TimeOut
+    };
+
+    var sharpClient = new GotenbergSharpClient(httpClient);
+
+    // Demonstrates watermark, stamp, rotation, and split options
+    var builder = new HtmlRequestBuilder()
+        .AddDocument(doc => doc.SetBody(@"
+            <html><body>
+                <h1>Cross-Cutting Features Demo</h1>
+                <p>This PDF has a text watermark and is rotated 90 degrees.</p>
+                <p>Page 2 content here...</p>
+            </body></html>"))
+        // Add a text watermark behind the content
+        .SetWatermarkOptions(w => w.SetTextWatermark("CONFIDENTIAL"))
+        // Rotate all pages 90 degrees
+        .SetRotationOptions(r => r.SetAngle(RotationAngle.Degrees90))
+        .WithPageProperties(pp => pp.UseChromeDefaults());
+
+    var request = builder.Build();
+    var response = await sharpClient.HtmlToPdfAsync(request);
+
+    var resultPath = Path.Combine(destinationDirectory, $"WatermarkRotate-{DateTime.Now:yyyyMMddHHmmss}.pdf");
+
+    await using var destinationStream = File.Create(resultPath);
+    await response.CopyToAsync(destinationStream, CancellationToken.None);
+
+    return resultPath;
+}
diff --git a/examples/WatermarkAndRotate/WatermarkAndRotate.csproj b/examples/WatermarkAndRotate/WatermarkAndRotate.csproj
@@ -0,0 +1,2 @@
+<Project Sdk="Microsoft.NET.Sdk">
+</Project>

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,2 @@`
	`1`	`+<Project Sdk="Microsoft.NET.Sdk">`
	`2`	`+</Project>`