.

Author: SimonCropp

readme.md

@@ -127,7 +127,7 @@ The examples below use the SkiaSharp backend. To use ImageSharp instead, replace
 ```cs
 var converter = new WordRender.Skia.DocumentConverter();
 
-var result = converter.ConvertToImages(
+var result = await converter.ConvertToImages(
     "document.docx",
     "output-folder");
 
@@ -148,7 +148,7 @@ foreach (var path in result.ImagePaths)
 ```cs
 var converter = new WordRender.Skia.DocumentConverter();
 
-var imageData = converter.ConvertToImageData("document.docx");
+var imageData = await converter.ConvertToImageData("document.docx");
 
 foreach (var pngBytes in imageData)
 {
@@ -169,10 +169,10 @@ var converter = new WordRender.Skia.DocumentConverter();
 using var stream = File.OpenRead("document.docx");
 
 // From stream to files
-var result = converter.ConvertToImages(stream, "output-folder");
+var result = await converter.ConvertToImages(stream, "output-folder");
 
 // Or from stream to memory
-var imageData = converter.ConvertToImageData(stream);
+var imageData = await converter.ConvertToImageData(stream);
 ```
 <sup><a href='/src/Tests/ReadmeSamples.cs#L53-L65' title='Snippet source file'>snippet source</a> | <a href='#snippet-StreamBasedConversion' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
@@ -191,7 +191,7 @@ var options = new ConversionOptions
     FontWidthScale = 1.07
 };
 
-var result = converter.ConvertToImages(
+var result = await converter.ConvertToImages(
     "document.docx",
     "output-folder",
     options);

src/Benchmarks/Program.cs

@@ -35,25 +35,25 @@ public void Setup()
 
     [Benchmark(Baseline = true)]
     [BenchmarkCategory("Small")]
-    public IReadOnlyList<byte[]> Skia_Small() => skia.ConvertToImageData(new MemoryStream(smallBytes));
+    public async Task<IReadOnlyList<byte[]>> Skia_Small() => await skia.ConvertToImageData(new MemoryStream(smallBytes));
 
     [Benchmark]
     [BenchmarkCategory("Small")]
-    public IReadOnlyList<byte[]> ImageSharp_Small() => imageSharp.ConvertToImageData(new MemoryStream(smallBytes));
+    public async Task<IReadOnlyList<byte[]>> ImageSharp_Small() => await imageSharp.ConvertToImageData(new MemoryStream(smallBytes));
 
     [Benchmark(Baseline = true)]
     [BenchmarkCategory("Medium")]
-    public IReadOnlyList<byte[]> Skia_Medium() => skia.ConvertToImageData(new MemoryStream(mediumBytes));
+    public async Task<IReadOnlyList<byte[]>> Skia_Medium() => await skia.ConvertToImageData(new MemoryStream(mediumBytes));
 
     [Benchmark]
     [BenchmarkCategory("Medium")]
-    public IReadOnlyList<byte[]> ImageSharp_Medium() => imageSharp.ConvertToImageData(new MemoryStream(mediumBytes));
+    public async Task<IReadOnlyList<byte[]>> ImageSharp_Medium() => await imageSharp.ConvertToImageData(new MemoryStream(mediumBytes));
 
     [Benchmark(Baseline = true)]
     [BenchmarkCategory("Large")]
-    public IReadOnlyList<byte[]> Skia_Large() => skia.ConvertToImageData(new MemoryStream(largeBytes));
+    public async Task<IReadOnlyList<byte[]>> Skia_Large() => await skia.ConvertToImageData(new MemoryStream(largeBytes));
 
     [Benchmark]
     [BenchmarkCategory("Large")]
-    public IReadOnlyList<byte[]> ImageSharp_Large() => imageSharp.ConvertToImageData(new MemoryStream(largeBytes));
+    public async Task<IReadOnlyList<byte[]>> ImageSharp_Large() => await imageSharp.ConvertToImageData(new MemoryStream(largeBytes));
 }

src/Morph.OpenXml/DocumentConverter.cs

@@ -13,11 +13,12 @@ public abstract class DocumentConverter
     /// <param name="docxPath">Path to the DOCX file.</param>
     /// <param name="outputDirectory">Directory where PNG files will be saved.</param>
     /// <param name="options">Conversion options (optional).</param>
+    /// <param name="cancel">Cancellation token.</param>
     /// <returns>Result containing paths to generated images and page count.</returns>
-    public ConversionResult ConvertToImages(string docxPath, string outputDirectory, ConversionOptions? options = null)
+    public async Task<ConversionResult> ConvertToImages(string docxPath, string outputDirectory, ConversionOptions? options = null, CancellationToken cancel = default)
     {
         using var stream = File.OpenRead(docxPath);
-        return ConvertToImages(stream, outputDirectory, options);
+        return await ConvertToImages(stream, outputDirectory, options, cancel);
     }
 
     /// <summary>
@@ -26,13 +27,14 @@ public ConversionResult ConvertToImages(string docxPath, string outputDirectory,
     /// <param name="docxStream">Stream containing the DOCX document.</param>
     /// <param name="outputDirectory">Directory where PNG files will be saved.</param>
     /// <param name="options">Conversion options (optional).</param>
+    /// <param name="cancel">Cancellation token.</param>
     /// <returns>Result containing paths to generated images and page count.</returns>
-    public ConversionResult ConvertToImages(Stream docxStream, string outputDirectory, ConversionOptions? options = null)
+    public async Task<ConversionResult> ConvertToImages(Stream docxStream, string outputDirectory, ConversionOptions? options = null, CancellationToken cancel = default)
     {
         options ??= new();
         Directory.CreateDirectory(outputDirectory);
 
-        var document = parser.Parse(docxStream);
+        var document = await parser.Parse(docxStream, cancel);
         var imagePaths = new List<string>();
 
         var pageIndex = 0;
@@ -55,24 +57,26 @@ public ConversionResult ConvertToImages(Stream docxStream, string outputDirector
     /// </summary>
     /// <param name="docxPath">Path to the DOCX file.</param>
     /// <param name="options">Conversion options (optional).</param>
+    /// <param name="cancel">Cancellation token.</param>
     /// <returns>List of PNG image data for each page.</returns>
-    public IReadOnlyList<byte[]> ConvertToImageData(string docxPath, ConversionOptions? options = null)
+    public async Task<IReadOnlyList<byte[]>> ConvertToImageData(string docxPath, ConversionOptions? options = null, CancellationToken cancel = default)
     {
         using var stream = File.OpenRead(docxPath);
-        return ConvertToImageData(stream, options);
+        return await ConvertToImageData(stream, options, cancel);
     }
 
     /// <summary>
     /// Converts a DOCX stream to PNG image data in memory.
     /// </summary>
     /// <param name="docxStream">Stream containing the DOCX document.</param>
     /// <param name="options">Conversion options (optional).</param>
+    /// <param name="cancel">Cancellation token.</param>
     /// <returns>List of PNG image data for each page.</returns>
-    public IReadOnlyList<byte[]> ConvertToImageData(Stream docxStream, ConversionOptions? options = null)
+    public async Task<IReadOnlyList<byte[]>> ConvertToImageData(Stream docxStream, ConversionOptions? options = null, CancellationToken cancel = default)
     {
         options ??= new();
 
-        var document = parser.Parse(docxStream);
+        var document = await parser.Parse(docxStream, cancel);
         var imageData = new List<byte[]>();
 
         RenderPages(document, options, writePng =>