Merge pull request #1766 from syncfusion-content/988636-Apply-Matte-To-Transparent-Images-hotfix

988636 - Added Apply Matte to transparent Image API details in DocIO UG

Author: MathanKumarVaradhaRajaPerumal

Document-Processing/Word/Conversions/Word-To-PDF/NET/Word-to-pdf-settings.md

@@ -1350,3 +1350,77 @@ document.Close()
 {% endtabs %}
 
 You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Word-to-PDF-Conversion/Restrict-permission-in-PDF).
+
+## Apply Matte to Transparent Images
+
+This setting allows you to determine whether to **apply a matte color to transparent images** during Word to PDF conversion, ensuring they render cleanly without unwanted borders or artifacts in the final PDF.
+
+The following code sample shows how to apply a matte color to transparent images during Word to PDF conversion.
+
+{% tabs %}
+
+{% highlight c# tabtitle="C# [Cross-platform]" %}
+
+FileStream fileStream = new FileStream("Template.docx", FileMode.Open);
+// Loads an existing Word document
+WordDocument wordDocument = new WordDocument(fileStream, FormatType.Docx);
+// Instantiates DocIORenderer instance for Word to PDF conversion
+DocIORenderer renderer = new DocIORenderer();
+// Set to true to apply a matte color to transparent images.
+renderer.Settings.ApplyMatteToTransparentImages = true;
+// Converts Word document into PDF document
+PdfDocument pdfDocument = renderer.ConvertToPDF(wordDocument);
+// Closes the instance of Word document object
+wordDocument.Close();
+// Releases the resources occupied by DocIORenderer instance
+renderer.Dispose();
+// Saves the PDF file  
+pdfDocument.Save(@"../../../Output/Result.pdf");
+// Closes the instance of PDF document object
+pdfDocument.Close();
+
+{% endhighlight %}
+
+{% highlight c# tabtitle="C# [Windows-specific]" %}
+ 
+// Loads an existing Word document
+WordDocument wordDocument = new WordDocument("Template.docx");
+// Creates an instance of the DocToPDFConverter - responsible for Word to PDF conversion
+DocToPDFConverter converter = new DocToPDFConverter();
+// Set to true to apply a matte color to transparent images.
+converter.Settings.ApplyMatteToTransparentImages = true;
+// Converts Word document into PDF document
+PdfDocument pdfDocument = converter.ConvertToPDF(wordDocument);
+// Closes the instance of Word document object
+wordDocument.Close();
+// Releases the resources occupied by DocToPDFConverter instance
+converter.Dispose();
+// Saves the PDF file  
+pdfDocument.Save(@"../../../Output/Result.pdf");
+// Closes the instance of PDF document object
+pdfDocument.Close();
+ 
+{% endhighlight %}
+
+{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %}
+
+' Loads an existing Word document
+Dim wordDocument As New WordDocument("Template.docx")
+' Creates an instance of the DocToPDFConverter - responsible for Word to PDF conversion
+Dim converter As New DocToPDFConverter()
+' Set to true to apply a matte color to transparent images
+converter.Settings.ApplyMatteToTransparentImages = True
+' Converts Word document into PDF document
+Dim pdfDocument As PdfDocument = converter.ConvertToPDF(wordDocument)
+' Closes the instance of Word document object
+wordDocument.Close()
+' Releases the resources occupied by DocToPDFConverter instance
+converter.Dispose()
+' Saves the PDF file
+pdfDocument.Save("../../../Output/Result.pdf")
+' Closes the instance of PDF document object
+pdfDocument.Close()
+
+{% endhighlight %}
+
+{% endtabs %}

Document-Processing/Word/Conversions/Word-To-PDF/NET/word-to-pdf.md

@@ -1,12 +1,12 @@
 ---
-title: Convert Word to PDF in C# | DocIO | Syncfusion
+title: Convert Word to PDF in C# using DocIO | Syncfusion
 description: Learn how to convert a Word document to PDF, PDF/A, and PDF/UA using the .NET Word (DocIO) library without Microsoft Word or interop dependencies.
 platform: document-processing
 control: DocIO
 documentation: UG
 ---
 
-# Convert Word to PDF using Syncfusion<sup>&reg;</sup> Word (DocIO) library 
+# Convert Word to PDF using Syncfusion® Word (DocIO) library
 
 Syncfusion<sup>&reg;</sup> Word library (DocIO) allows you to convert Word document to PDF within a few lines of code in .NET applications and also it does not require Adobe and Microsoft Word application to be installed in the machine. Using this, you can create an input Word document from scratch or load an existing Word document and then easily convert to PDF.  
 
@@ -238,6 +238,10 @@ You can preserve Ole Equation as bitmap image in the converted PDF document. For
 
 You can restrict all the permission in a PDF document using [PdfPermissionsFlags](https://help.syncfusion.com/cr/document-processing/Syncfusion.Pdf.Security.PdfPermissionsFlags.html). For further information, click [here](https://help.syncfusion.com/document-processing/word/conversions/word-to-pdf/net/word-to-pdf-settings#restrict-all-permission-in-a-pdf-document).
 
+### Apply Matte to Transparent Images
+
+This setting allows you to determine whether to **apply a matte color to transparent images** during Word to PDF conversion, ensuring they render cleanly without unwanted borders or artifacts in the final PDF. For further information, click [here](https://help.syncfusion.com/document-processing/word/conversions/word-to-pdf/net/word-to-pdf-settings#restrict-all-permission-in-a-pdf-document).
+
 ## Font Substitution
 
 When the necessary fonts used in the Word document has not been installed in the production machine, then Essential<sup>&reg;</sup> DocIO uses the ”Microsoft Sans Serif” as default font for rendering the text. This leads to preservation difference in generated PDF as each font has different glyphs for characters. 

Document-Processing/Word/Conversions/Word-To-PDF/overview.md

@@ -240,6 +240,10 @@ You can preserve Ole Equation as bitmap image in the converted PDF document. For
 
 You can restrict all the permission in a PDF document using [PdfPermissionsFlags](https://help.syncfusion.com/cr/document-processing/Syncfusion.Pdf.Security.PdfPermissionsFlags.html). For further information, click [here](https://help.syncfusion.com/document-processing/word/conversions/word-to-pdf/net/word-to-pdf-settings#restrict-all-permission-in-a-pdf-document).
 
+### Apply Matte to Transparent Images
+
+This setting allows you to determine whether to **apply a matte color to transparent images** during Word to PDF conversion, ensuring they render cleanly without unwanted borders or artifacts in the final PDF. For further information, click [here](https://help.syncfusion.com/document-processing/word/conversions/word-to-pdf/net/word-to-pdf-settings#restrict-all-permission-in-a-pdf-document).
+
 ## Font Substitution
 
 When the necessary fonts used in the Word document has not been installed in the production machine, then Essential<sup>&reg;</sup> DocIO uses the ”Microsoft Sans Serif” as default font for rendering the text. This leads to preservation difference in generated PDF as each font has different glyphs for characters.