Merge pull request #422 from telerik/yoan/spreadprocessing-export-wor…

…ksheet-to-image

Export Worksheet to Image KB

knowledge-base/spreadprocessing-export-worksheet-to-image-netstandard.md

@@ -0,0 +1,129 @@
+---
+title: How to export a Worksheet to image with RadSpreadProcessing in .NET Standard
+description: This article shows how to export a Worksheet to image with RadSpreadProcessing in .NET Standard.
+type: how-to
+page_title: How to export a Worksheet to image with RadSpreadProcessing in .NET Standard
+slug: spreadprocessing-export-worksheet-to-image-netstandard
+tags: spreadprocessing, export, worksheet, image, netstandard, xlsx, spread
+res_type: kb
+---
+# Environment
+| Version | Product | Author | 
+| --- | --- | ---- | 
+| 2024.1.305 | RadSpreadProcessing |[Yoan Karamanov](https://www.telerik.com/blogs/author/yoan-karamanov)| 
+---
+# Description
+This article shows how to export a [Worksheet]({%slug radspreadprocessing-working-with-worksheets-what-is-worksheet%}) to image in .NET Standard using the [RadSpreadProcessing]({%slug radspreadprocessing-overview%}) library. Currently the [Document Processing libraries]({%slug introduction%}) provide image export only for PDF files. This is why the document must first be converted to PDF.
+
+# Solution
+
+1. [Import the file as __Workbook__](https://docs.telerik.com/devtools/document-processing/libraries/radspreadprocessing/formats-and-conversion/import-and-export-to-excel-file-formats/xlsx/xlsxformatprovider#import).
+2. Set the desired [Worksheet Page Setup]({%slug radspreadprocessing-features-worksheetpagesetup%}) and [PDF Export Settings]({%slug radspreadprocessing-format-and-conversion-pdf-settings%}).
+3. [Export the __Workbook__ to __PDF__](https://docs.telerik.com/devtools/document-processing/libraries/radspreadprocessing/formats-and-conversion/pdf/pdfformatprovider#export).
+4. [Import the __PDF__ file](https://docs.telerik.com/devtools/document-processing/libraries/radpdfprocessing/formats-and-conversion/pdf/pdfformatprovider/pdfformatprovider#import).
+5. Calculate the size of the used range in the __Worksheet__.
+6. Make the PDF page the same size.
+7. Export the __PDF__ file to image using the [SkiaImageFormatProvider]({%slug radpdfprocessing-formats-and-conversion-image-using-skiaimageformatprovider%}).
+
+# Additional Requirements
+
+### .NET Standard requirements
+* [SpreadFixedTextMeasurer]({%slug radspreadprocessing-cross-platform-text-measure%})
+### General requirements
+* [SkiaSharp Nuget package](https://www.nuget.org/packages/SkiaSharp/)
+
+```csharp
+    using Telerik.Windows.Documents.Spreadsheet.FormatProviders.OpenXml.Xlsx;
+    using Telerik.Windows.Documents.Spreadsheet.FormatProviders;
+    using Telerik.Windows.Documents.Spreadsheet.Model;
+    using Telerik.Windows.Documents.Fixed.Model;
+    using Telerik.Documents.Fixed.FormatProviders.Image.Skia;
+    using Telerik.Windows.Documents.Extensibility;
+    using Telerik.Windows.Documents.Spreadsheet.Extensibility;
+    using Telerik.Windows.Documents.Model;
+    using Telerik.Windows.Documents.Spreadsheet.Model.Printing;
+    using Telerik.Documents.Primitives;
+
+    //.NET Standard Requirements
+    SpreadTextMeasurerBase fixedTextMeasurer = new SpreadFixedTextMeasurer();
+    SpreadExtensibilityManager.TextMeasurer = fixedTextMeasurer;
+
+    //Import Workbook
+    Workbook workbook;
+    IWorkbookFormatProvider xlsxFormatProvider = new XlsxFormatProvider();
+
+    using (Stream input = new FileStream("input.xlsx", FileMode.Open))
+    {
+        workbook = xlsxFormatProvider.Import(input);
+    }
+
+    //Set PDF export settings to your preference
+    WorksheetPageSetup pageSetup = workbook.ActiveWorksheet.WorksheetPageSetup;
+    pageSetup.PageOrientation = PageOrientation.Landscape;
+    pageSetup.Margins = new PageMargins(0,0,0,0);
+    pageSetup.PaperType = PaperTypes.A1; /*make sure the size of the PaperType is bigger than the dimentions of worksheetTableSizetableSize*/
+
+    Telerik.Windows.Documents.Spreadsheet.FormatProviders.Pdf.PdfFormatProvider spreadPdfFormatProvider = new Telerik.Windows.Documents.Spreadsheet.FormatProviders.Pdf.PdfFormatProvider();
+    spreadPdfFormatProvider.ExportSettings = new Telerik.Windows.Documents.Spreadsheet.FormatProviders.Pdf.Export.PdfExportSettings(ExportWhat.ActiveSheet, true);
+
+    //Export as PDF
+    using (Stream output = File.OpenWrite("output.pdf"))
+    {
+        spreadPdfFormatProvider.Export(workbook, output);
+    }
+
+    //Import PDF 
+    RadFixedDocument pdfDocument;
+    Telerik.Windows.Documents.Fixed.FormatProviders.Pdf.PdfFormatProvider fixedPdfFormatProvider = new Telerik.Windows.Documents.Fixed.FormatProviders.Pdf.PdfFormatProvider();
+
+    using (Stream input = File.OpenRead("output.pdf"))
+    {
+        pdfDocument = fixedPdfFormatProvider.Import(input);
+    }
+
+    //Set new PDF page size
+    var worksheetTableSize = CalculateRangeSize(workbook.ActiveWorksheet, workbook.ActiveWorksheet.UsedCellRange);
+    pdfDocument.Pages.FirstOrDefault().Size = new Size(worksheetTableSize.Width, worksheetTableSize.Height);
+
+    //Export to image
+    SkiaImageFormatProvider imageProvider = new SkiaImageFormatProvider();
+
+    int count = 1;
+    foreach (RadFixedPage page in pdfDocument.Pages)
+    {
+        byte[] resultImage = imageProvider.Export(page);
+        File.WriteAllBytes("image " + count++ + ".jpg", resultImage);
+    }
+
+    Size CalculateRangeSize(Worksheet worksheet, CellRange range)
+    {
+        double totalHeight = 0;
+        double totalWidth = 0;
+
+        for (int row = range.FromIndex.RowIndex; row <= range.ToIndex.RowIndex; row++)
+        {
+            double rowHeight = worksheet.Rows[row].GetHeight().Value.Value;
+            totalHeight += rowHeight;
+        }
+
+        for (int column = range.FromIndex.ColumnIndex; column <= range.ToIndex.ColumnIndex; column++)
+        {
+            double columnWidth = worksheet.Columns[column].GetWidth().Value.Value;
+            totalWidth += columnWidth;
+        }
+
+        return new Size(totalWidth, totalHeight);
+    }
+
+```
+__Before:__
+
+  ![Worksheet](images/worksheet-to-image-netstandard-before.png)
+
+__After:__
+
+  ![Worksheet as image](images/worksheet-to-image-netstandard-after.png)
+
+# See Also
+* [SpreadProcessing .NET Standard limitations]({%slug radspreadprocessing-cross-platform%}) 
+* [PdfProcessing .NET Standard limitations]({%slug radpdfprocessing-cross-platform%}) 

libraries/radpdfprocessing/formats-and-conversion/convert-to-image/using-image-format-provider.md

@@ -106,5 +106,6 @@ The __SkiaImageFormatProvider__ exposes the following settings:
 {{endregion}}
 
 # See Also
-* [Converting XLSX Content to DOCX Document]({%slug convert-excel-content-to-word-document%})
+* [Converting XLSX Content to DOCX Document]({%slug convert-excel-content-to-word-document%}) 
+* [Export Worksheet to image]({%slug spreadprocessing-export-worksheet-to-image-netstandard%})
 * [Cropping PDF Pages and Saving as Images Using RadPdfProcessing]({%slug crop-save-pdf-pages-as-images-radpdfprocessing%})

libraries/radspreadprocessing/formats-and-conversion/pdf/pdfformatprovider.md

@@ -71,4 +71,5 @@ The result from the export method is a document that can be opened in any applic
 ## See Also
 - [How to Eliminate Formatting Issues when Exporting XLSX to PDF Format]({%slug exporting-xlsx-to-pdf-formatting-issues%})
 - [Import/Load and Export/Save RadSpreadProcessing Workbook]({%slug import-export-save-load-workbook%})
+- [Export Worksheet to image]({%slug spreadprocessing-export-worksheet-to-image-netstandard%})