Merge pull request #1545 from syncfusion-content/ES-852066-Update-FAQ-details

ES-852066 Update FAQ details of why images are preserved as RedX images in Word to PDF conversion

Author: MohanaselvamJothi

File-Formats/DocIO/FAQ.md

@@ -2758,12 +2758,17 @@ When the Word document contains metafile images (*.emf or *.wmf), we recommend u
 
 We have found metafile images (*.emf, *.wmf) that are not supported in Azure App Service while converting a Word document with metafile images into PDF or Image. And also, this is one of the known limitations in Azure App Service. In this scenario, internally, Essential DocIO preserves RedX images in the same size during the Word to PDF or Image conversions to avoid pagination problems.
 
-## Why images are preserved as RedX images in Word to PDF conversion?
-**In .NET Core targeting applications**, metafile images (*.wmf and *.emf) have some limitations. If the Word document contains metafile images (*.wmf" or *.emf") internally, Essential DocIO preserves those images as RedX images with the same size of original metafile images during the Word to PDF or Image conversions to avoid pagination problems.
+## Why images are preserved as RedX images in Word to PDF/Image conversion?
+**In .NET Core or .NET targeting applications**, metafile (*.wmf, *.emf) and TIFF images have some limitations in DocIORenderer. Internally, DocIORenderer used SkiaSharp graphics library to layout the text and images in PDF/Image conversion. And SkiaSharp library doesn’t support the metafile (“*.emf”, “*.wmf”) and TIFF images, so, it doesn’t preserve the images in the mentioned applications.
 
-To preserve the expected images in the PDF, we suggest you convert the metafile image formats to bitmap image format (JPEG or PNG) and then perform Word to PDF conversion.
+If the Word document contains metafile (*.wmf" or *.emf") and TIFF images, internally, DocIO preserves those images as RedX images with the same size of original images during the Word to PDF or Image conversions to avoid pagination problems.
 
-Otherwise, you can use the [WPF](https://www.nuget.org/packages/Syncfusion.DocToPDFConverter.Wpf/) or [Windows Forms](https://www.nuget.org/packages/Syncfusion.DocToPDFConverter.WinForms/) platform NuGet packages for .NET Core 3.0 or later versions targeting applications from v17.3.0.x and use the same [C# tab](https://help.syncfusion.com/file-formats/docio/word-to-pdf) code examples for it. But in Mac and Linux environment, using the [WPF](https://www.nuget.org/packages/Syncfusion.DocToPDFConverter.Wpf) or [Windows Forms](https://www.nuget.org/packages/Syncfusion.DocToPDFConverter.WinForms/) platform NuGet packages have limitations.
+To preserve the expected images in the PDF/Image conversion, we suggest you convert the metafile and Tiff image formats to bitmap image format (JPEG or PNG) and then perform Word to PDF/Image conversion.
+
+**Suggestions:**
+1. You can convert metafile image format to bitmap image format in the Word document using DocIO, you can refer to KB documentation link: [Convert and replace metafile image in word document to bitmap](https://support.syncfusion.com/kb/article/11331/how-to-convert-and-replace-emf-image-in-word-document-to-png-with-same-size?isInternalRefresh=False). As this approach uses System.Drawing.Common, it is known limitation in Linux or cross platforms.
+
+2. Otherwise, you can use the [WPF](https://www.nuget.org/packages/Syncfusion.DocToPDFConverter.Wpf/) or [Windows Forms](https://www.nuget.org/packages/Syncfusion.DocToPDFConverter.WinForms/) platform NuGet packages for .NET Core 3.0 or later versions targeting applications from v17.3.0.x and use the same [C# tab](https://help.syncfusion.com/file-formats/docio/word-to-pdf) code examples for it. But in Mac and Linux environment, using the [WPF](https://www.nuget.org/packages/Syncfusion.DocToPDFConverter.Wpf) or [Windows Forms](https://www.nuget.org/packages/Syncfusion.DocToPDFConverter.WinForms/) platform NuGet packages have limitations.
 
 ## What are the NuGet packages to be installed to perform Word to PDF conversion in Linux OS?
 In Linux OS, you can perform Word to PDF conversion using .NET Core (Targeting .netcoreapp) application. You can refer [Word to PDF conversion NuGet packages](https://help.syncfusion.com/file-formats/docio/nuget-packages-required#converting-word-document-to-pdf) to know about the packages required to deploy .NET Core (Targeting .netcoreapp) applications with Word to PDF conversion capabilities.

File-Formats/DocIO/Loading-and-Saving-document.md

@@ -632,6 +632,8 @@ return File(stream, "application/msword", "Result.docx");
 
 You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Read-and-Save-document/Send-Word-to-client-browser).
 
+N> If you are using [Syncfusion.DocIO.Net.Core](https://www.nuget.org/packages/Syncfusion.DocIO.Net.Core/) package, then the [Save](https://help.syncfusion.com/cr/file-formats/Syncfusion.DocIO.DLS.WordDocument.html#Syncfusion_DocIO_DLS_WordDocument_Save_System_String_Syncfusion_DocIO_FormatType_System_Web_HttpResponse_Syncfusion_DocIO_HttpContentDisposition_) API used in the above sample is not available in it. So, we suggest you to save the document as stream and then download. You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Read-and-Save-document/Send-Word-to-client-browser/ASP.NET).
+
 ## Closing a document
 
 Once the document manipulation and save operation are completed, you should close the instance of [WordDocument](https://help.syncfusion.com/cr/file-formats/Syncfusion.DocIO.DLS.WordDocument.html), in order to release all the memory consumed by DocIO’s DOM. The following code example illustrates how to close a WordDocument instance.
@@ -747,4 +749,4 @@ You can download a complete working sample from [GitHub](https://github.com/Sync
 * [How to open and read Word document in C#, VB.NET](https://www.syncfusion.com/kb/12990/how-to-open-and-read-word-document-in-c-vb-net)
 * [How to read Word document using C#, VB.NET](https://www.syncfusion.com/kb/10992/how-to-read-word-document-using-c-vb-net)
 * [How to send a word document in an email using C#, VB.NET](https://www.syncfusion.com/kb/10963/how-to-send-a-word-document-in-an-email-using-c-vb-net)
-* [How to store the document with the name having the value taken by Database](https://www.syncfusion.com/kb/280/how-to-store-the-document-with-the-name-having-the-value-taken-by-database)
+* [How to store the document with the name having the value taken by Database](https://www.syncfusion.com/kb/280/how-to-store-the-document-with-the-name-having-the-value-taken-by-database)

File-Formats/DocIO/Working-with-Word-document.md

@@ -411,7 +411,7 @@ End Using
 
 You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Word-document/Update-pages-count).
 
-N>  1. The word to PDF layout engine is used for updating the page count in word document. Due to its limitations it may result in an incorrect page count.
+N>  1. The word to PDF layout engine is used for updating the page count in word document. Due to its limitations, it may result in an incorrect page count and the execution of this process may take some time.
 N>  2. In ASP.NET Core and Xamarin platforms, to update page count in a Word document we recommend you to use Word to PDF [assemblies](https://help.syncfusion.com/file-formats/docio/assemblies-required#converting-word-document-to-pdf) or [NuGet](https://help.syncfusion.com/file-formats/docio/nuget-packages-required#converting-word-document-to-pdf) as a reference in your application to update page count in a Word document.
 
 ### Adding Custom Document properties
@@ -1047,4 +1047,4 @@ You can download a complete working sample from [GitHub](https://github.com/Sync
 * [Merging Word documents](https://help.syncfusion.com/file-formats/docio/word-document/merging-word-documents)
 * [Print Word documents](https://help.syncfusion.com/file-formats/docio/word-document/print-word-documents)
 * [Split Word documents](https://help.syncfusion.com/file-formats/docio/word-document/split-word-documents)
-* [Why it is not possible to access the Word document contents page by page](https://support.syncfusion.com/kb/article/4241/why-it-is-not-possible-to-access-the-word-document-contents-page-by-page-in-winforms-fileformat-libraries-)
+* [Why it is not possible to access the Word document contents page by page](https://support.syncfusion.com/kb/article/4241/why-it-is-not-possible-to-access-the-word-document-contents-page-by-page-in-winforms-fileformat-libraries-)

File-Formats/DocIO/word-to-pdf.md

@@ -1847,6 +1847,15 @@ Font kerning
 Partially supported. At present, the text in a line is scaled uniformly to match the width of kerned text, instead of adjusting the space between each pair of characters.
 </td>
 </tr>
+<tr>
+<td>
+Images
+</td>
+<td>
+
+In .NET Core and latest target, we have limitation in metafile and TIFF. Refer [here](https://help.syncfusion.com/file-formats/docio/faq#why-images-are-preserved-as-redx-images-in-word-to-pdf-conversion).
+</td>
+</tr>
 </table>
 
 ## See Also