From 0dd05e20fc4a349e20dbd472d4d2f10d28583f01 Mon Sep 17 00:00:00 2001 From: AkashArul26 <95226047+AkashArul26@users.noreply.github.com> Date: Thu, 12 Oct 2023 18:51:39 +0530 Subject: [PATCH 1/9] Updated the Why images are preserved as RedX images in Word to PDF conversion FAQ --- File-Formats/DocIO/FAQ.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/File-Formats/DocIO/FAQ.md b/File-Formats/DocIO/FAQ.md index f87864c2f..2437b2d4b 100644 --- a/File-Formats/DocIO/FAQ.md +++ b/File-Formats/DocIO/FAQ.md @@ -2759,10 +2759,12 @@ 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. +**In .NET Core targeting applications**, metafile images (*.wmf and *.emf) have some limitations. In .NET Core (DocIORenderer), we have used SkiaSharp graphics library to render the text and images in PDF. And SkiaSharp doesn’t support the metafile images (“.emf”, “.wmf”), so, it doesn’t preserve the images in ASP.NET Core platform. If the Word document contains metafile images (*.wmf" or *.emf") internally, 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. 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. +N> For more information on performing the conversion of metafile image format to bitmap image format 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) + 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? From 364e1e1a0129089e22cc0045c7ab8c8c97985352 Mon Sep 17 00:00:00 2001 From: AkashArul26 <95226047+AkashArul26@users.noreply.github.com> Date: Wed, 18 Oct 2023 15:43:41 +0530 Subject: [PATCH 2/9] Update FAQ.md by adding the tiff format --- File-Formats/DocIO/FAQ.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/File-Formats/DocIO/FAQ.md b/File-Formats/DocIO/FAQ.md index 2437b2d4b..ec64c004e 100644 --- a/File-Formats/DocIO/FAQ.md +++ b/File-Formats/DocIO/FAQ.md @@ -2759,7 +2759,7 @@ 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. In .NET Core (DocIORenderer), we have used SkiaSharp graphics library to render the text and images in PDF. And SkiaSharp doesn’t support the metafile images (“.emf”, “.wmf”), so, it doesn’t preserve the images in ASP.NET Core platform. If the Word document contains metafile images (*.wmf" or *.emf") internally, 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. +**In .NET Core targeting applications**, metafile images (*.wmf, *.emf and *.tiff) have some limitations. In .NET Core (DocIORenderer), we have used SkiaSharp graphics library to render the text and images in PDF. And SkiaSharp doesn’t support the metafile images (“*.emf”, “*.wmf” and *.tiff), so, it doesn’t preserve the images in ASP.NET Core platform. If the Word document contains metafile images (*.wmf" or *.emf" or "*.tiff") internally, 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. 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. From 1b81bc717c027ae1add0d6d010659f1433b523ff Mon Sep 17 00:00:00 2001 From: AkashArul26 <95226047+AkashArul26@users.noreply.github.com> Date: Wed, 18 Oct 2023 16:07:56 +0530 Subject: [PATCH 3/9] Update word-to-pdf.md unsupported elements --- File-Formats/DocIO/word-to-pdf.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/File-Formats/DocIO/word-to-pdf.md b/File-Formats/DocIO/word-to-pdf.md index 0cd2eb0c1..1baadc59a 100644 --- a/File-Formats/DocIO/word-to-pdf.md +++ b/File-Formats/DocIO/word-to-pdf.md @@ -1847,6 +1847,14 @@ 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. + + +Images + + +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). + + ## See Also From 4f6b6a3de3ba8d4f85ac831e401c60496d817b99 Mon Sep 17 00:00:00 2001 From: AkashArul26 <95226047+AkashArul26@users.noreply.github.com> Date: Wed, 18 Oct 2023 17:31:52 +0530 Subject: [PATCH 4/9] Added note in Sending to a client browser --- File-Formats/DocIO/Loading-and-Saving-document.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/File-Formats/DocIO/Loading-and-Saving-document.md b/File-Formats/DocIO/Loading-and-Saving-document.md index fbaa7af10..362ddff76 100644 --- a/File-Formats/DocIO/Loading-and-Saving-document.md +++ b/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. + ## 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) \ No newline at end of file +* [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) From 504e93ab466f1c068cc15e3627f2ae21f2687ef9 Mon Sep 17 00:00:00 2001 From: AkashArul26 <95226047+AkashArul26@users.noreply.github.com> Date: Wed, 18 Oct 2023 17:34:45 +0530 Subject: [PATCH 5/9] Changed the notes in the Working-with-Word-document.md --- File-Formats/DocIO/Working-with-Word-document.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/File-Formats/DocIO/Working-with-Word-document.md b/File-Formats/DocIO/Working-with-Word-document.md index 1fdba684e..6ca094cb3 100644 --- a/File-Formats/DocIO/Working-with-Word-document.md +++ b/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-) \ No newline at end of file +* [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-) From 425db01b563bdb2b78b13cb5e82bf855b1cdcdea Mon Sep 17 00:00:00 2001 From: AkashArul26 <95226047+AkashArul26@users.noreply.github.com> Date: Wed, 18 Oct 2023 18:15:32 +0530 Subject: [PATCH 6/9] Made the hyperlink work --- File-Formats/DocIO/word-to-pdf.md | 1 + 1 file changed, 1 insertion(+) diff --git a/File-Formats/DocIO/word-to-pdf.md b/File-Formats/DocIO/word-to-pdf.md index 1baadc59a..b175af00b 100644 --- a/File-Formats/DocIO/word-to-pdf.md +++ b/File-Formats/DocIO/word-to-pdf.md @@ -1852,6 +1852,7 @@ Partially supported. At present, the text in a line is scaled uniformly to match Images + 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). From a426258ae657011e4e6ef1ef9aa457ec867f8715 Mon Sep 17 00:00:00 2001 From: AkashArul26 <95226047+AkashArul26@users.noreply.github.com> Date: Wed, 18 Oct 2023 18:22:10 +0530 Subject: [PATCH 7/9] Update FAQ.md for RedX image --- File-Formats/DocIO/FAQ.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/File-Formats/DocIO/FAQ.md b/File-Formats/DocIO/FAQ.md index ec64c004e..e210eec45 100644 --- a/File-Formats/DocIO/FAQ.md +++ b/File-Formats/DocIO/FAQ.md @@ -2759,7 +2759,7 @@ 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, *.emf and *.tiff) have some limitations. In .NET Core (DocIORenderer), we have used SkiaSharp graphics library to render the text and images in PDF. And SkiaSharp doesn’t support the metafile images (“*.emf”, “*.wmf” and *.tiff), so, it doesn’t preserve the images in ASP.NET Core platform. If the Word document contains metafile images (*.wmf" or *.emf" or "*.tiff") internally, 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. +**In .NET Core targeting applications**, metafile images (*.wmf and *.emf) and TIFF images (*.tiff) have some limitations. In .NET Core (DocIORenderer), we have used SkiaSharp graphics library to render the text and images in PDF. And SkiaSharp doesn’t support the metafile images (“*.emf”, “*.wmf”) and TIFF images (*.tiff), so, it doesn’t preserve the images in ASP.NET Core platform. If the Word document contains metafile images (*.wmf" or *.emf") or TIFF images (*.tiff) internally, 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. 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. From f92cb277e3eead9f0d3d9516d6853ebeb53759db Mon Sep 17 00:00:00 2001 From: AkashArul26 <95226047+AkashArul26@users.noreply.github.com> Date: Wed, 18 Oct 2023 19:13:11 +0530 Subject: [PATCH 8/9] Addressed the feedbacks for RedX image --- File-Formats/DocIO/FAQ.md | 13 ++++++++----- 1 file changed, 8 insertions(+), 5 deletions(-) diff --git a/File-Formats/DocIO/FAQ.md b/File-Formats/DocIO/FAQ.md index e210eec45..66f9622b8 100644 --- a/File-Formats/DocIO/FAQ.md +++ b/File-Formats/DocIO/FAQ.md @@ -2758,14 +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) and TIFF images (*.tiff) have some limitations. In .NET Core (DocIORenderer), we have used SkiaSharp graphics library to render the text and images in PDF. And SkiaSharp doesn’t support the metafile images (“*.emf”, “*.wmf”) and TIFF images (*.tiff), so, it doesn’t preserve the images in ASP.NET Core platform. If the Word document contains metafile images (*.wmf" or *.emf") or TIFF images (*.tiff) internally, 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. -N> For more information on performing the conversion of metafile image format to bitmap image format 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) +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. -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. +**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. From e584b19565aa8dd274d7b184bdfcc596d958d597 Mon Sep 17 00:00:00 2001 From: AkashArul26 <95226047+AkashArul26@users.noreply.github.com> Date: Wed, 18 Oct 2023 19:14:52 +0530 Subject: [PATCH 9/9] Added the GitHub sample for Sending to a client browser --- File-Formats/DocIO/Loading-and-Saving-document.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/File-Formats/DocIO/Loading-and-Saving-document.md b/File-Formats/DocIO/Loading-and-Saving-document.md index 362ddff76..4a9b4b56a 100644 --- a/File-Formats/DocIO/Loading-and-Saving-document.md +++ b/File-Formats/DocIO/Loading-and-Saving-document.md @@ -632,7 +632,7 @@ 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. +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