Merge pull request #1718 from syncfusion-content/988636-Apply-Matte-To-Transparent-Images-development

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

@@ -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.