Merge pull request #610 from telerik/new-kb-convert-webp-to-png-radwordsprocessing-a0c5c6408d704606adfb13b53433269a

Added new kb article convert-webp-to-png-radwordsprocessing

Author: YoanKar

knowledge-base/convert-webp-to-png-radwordsprocessing.md

@@ -0,0 +1,92 @@
+---
+title: Handle WEBP Images in Word Documents using Telerik WordsProcessing
+description: Learn how to handle WEBP Images in Word documents when using Telerik WordsProcessing, by converting them to PNG.
+type: how-to
+page_title: Handle WEBP Images in Word Documents using Telerik WordsProcessing
+meta_title: Handle WEBP Images in Word Documents using Telerik WordsProcessing
+slug: convert-webp-to-png-radwordsprocessing
+tags: words, processing, telerik, document, image, webp, html, import, docx, export, png, convert
+res_type: kb
+ticketid: 1695863
+---
+
+## Environment
+| Version | Product | Author | 
+| ---- | ---- | ---- | 
+| 2025.2.520| RadWordsProcessing |[Desislava Yordanova](https://www.telerik.com/blogs/author/desislava-yordanova)| 
+
+## Description
+
+The current implementation of the [RadWordsProcessing]({%slug radwordsprocessing-overview%}) library cannot handle `WEBP` images when exporting Word documents. This article shows how to convert `WEBP` images to any of the already [supported formats]({%slug radwordsprocessing-model-imageinline%}) (like PNG), so they can be exported successfully.
+
+## Solution
+
+This solution uses an HTML document as an example. To handle its `WEBP` images by converting them to a supported format like `PNG`, follow the steps below:
+
+1. Install the `SixLabors.ImageSharp` NuGet package for image conversion.
+
+2. Import the HTML content using [HtmlFormatProvider]({%slug radwordsprocessing-formats-and-conversion-html-htmlformatprovider%}).
+
+3. Iterate through the images in the document and convert the `WEBP` images to `PNG`.
+
+4. Replace the `WEBP` image sources with the converted `PNG` sources.
+
+5. Export the document to [DOCX]({%slug radwordsprocessing-formats-and-conversion-docx-docxformatprovider%}).
+
+Here is the complete implementation:
+
+```csharp
+using Telerik.Windows.Documents.Flow.Model;
+using Telerik.Windows.Documents.Flow.Model.Editing;
+using Telerik.Windows.Documents.Flow.FormatProviders.Docx;
+using Telerik.Windows.Documents.Flow.FormatProviders.Html;
+using SixLabors.ImageSharp;
+using SixLabors.ImageSharp.Formats.Png;
+using System.IO;
+using System.Diagnostics;
+
+// Import HTML content
+RadFlowDocument document = new RadFlowDocument();
+DocxFormatProvider docxProvider = new DocxFormatProvider();
+HtmlFormatProvider htmlFormatProvider = new HtmlFormatProvider();
+
+string path = "sample.html";
+using (Stream stream = File.Open(path, FileMode.Open, FileAccess.Read))
+{
+    document = htmlFormatProvider.Import(stream, new TimeSpan(0, 0, 60));
+}
+
+// Convert inline Webp images to PNG
+ConvertInlineWebpImagesToPng(document);
+
+void ConvertInlineWebpImagesToPng(RadFlowDocument document)
+{
+    foreach (ImageInline imageInline in document.EnumerateChildrenOfType<ImageInline>())
+    {
+        if (imageInline.Image.ImageSource.Extension.Equals("webp", StringComparison.InvariantCultureIgnoreCase))
+        {
+            using (MemoryStream webpStream = new MemoryStream(imageInline.Image.ImageSource.Data))
+            {
+                using var image = SixLabors.ImageSharp.Image.Load(webpStream);
+                using var pngImageStream = new MemoryStream();
+                image.Save(pngImageStream, new PngEncoder());
+                imageInline.Image.ImageSource = new ImageSource(pngImageStream.ToArray(), "png");
+            }
+        }
+    }
+}
+
+// Export the document to DOCX
+string outputFilePath = "result.docx";
+using var ms = new MemoryStream();
+docxProvider.Export(document, ms, new TimeSpan(0, 0, 60));
+File.WriteAllBytes(outputFilePath, ms.ToArray());
+
+// Open the resulting DOCX
+Process.Start(new ProcessStartInfo() { FileName = outputFilePath, UseShellExecute = true });
+```
+
+## See Also
+
+- [Supported Image Formats]({%slug radwordsprocessing-model-imageinline%})
+- [RadWordsProcessing]({%slug radwordsprocessing-overview%})

libraries/radwordsprocessing/model/imageinline.md

@@ -9,8 +9,6 @@ position: 8
 
 # ImageInline
 
-
-
 __ImageInline__ element is an inline-level flow content element intended to contain an image object.
 
 ## Supported Image Extensions
@@ -144,3 +142,4 @@ This section explains the behavior of the __Size__ property of The __Image__ obj
  * [FloatingImage]({%slug radwordsprocessing-model-floatingimage%})
  * [Paragraph]({%slug radwordsprocessing-model-paragraph%})
  * [Converting WMF Images to PNG in RTF Documents with RadWordsProcessing]({%slug convert-wmf-to-png-radwordsprocessing%})
+ * [Converting WEBP Images to PNG in HTML Documents using Telerik WordsProcessing]({%slug convert-webp-to-png-radwordsprocessing%})