ImageSaveOptions Class
Represents a class which stores saving options for image files.
public sealed class ImageSaveOptions : SaveOptions
Public NotInheritable Class ImageSaveOptions
Inherits SaveOptions
- Inheritance:
- System.ObjectImageSaveOptions
Constructors
ImageSaveOptions()
Initializes a new instance of the ImageSaveOptions class.
ImageSaveOptions(ImageSaveFormat)
Initializes a new instance of the ImageSaveOptions class for a specific image format.
public ImageSaveOptions(ImageSaveFormat imageFormat)
Public Sub New(imageFormat As ImageSaveFormat)
Parameters
imageFormat
- ImageSaveFormat
The image format.
Properties
ContentType
Gets the content-type for image file format:
public override string ContentType { get; }
Public Overrides ReadOnly Property ContentType As String
Property Value
- System.String
The content-type for image file format.
Overrides
CropToContent
Gets or sets a value indicating whether the image should be cropped to fit the content of the sheet.
If this property is set to true, only the content of the sheet is rendered, without headers or footers.
Property Value
- System.Boolean
Dither
Gets or sets the value that indicated whether dithering should be applied when converting to pixel formats BlackWhite, Gray2, and Gray4.
Default value: true.
This property is currently ignored when RenderingMode is resolved to Skia.
Property Value
- System.Boolean
true if dithering should be applied when converting to pixel formats BlackWhite, Gray2, and Gray4; otherwise, false.
DpiX
Gets or sets the horizontal dots per inch (dpi) of the image.
Default value is System.Double.NaN, which means that component specific default value will be used (currently 300).
Property Value
- System.Double
The horizontal dots per inch (dpi) of the image; that is, the dots per inch (dpi) along the x-axis.
Exceptions
- System.ArgumentOutOfRangeException
Value is not greater than 0.
DpiY
Gets or sets the vertical dots per inch (dpi) of the image.
Default value is System.Double.NaN, which means that component specific default value will be used (currently 300).
Property Value
- System.Double
The vertical dots per inch (dpi) of the image; that is, the dots per inch (dpi) along the y-axis.
Exceptions
- System.ArgumentOutOfRangeException
Value is not greater than 0.
ExtendedOptions
Gets the extended save options that are not natively supported by spreadsheet formats.
public ExtendedSaveOptions ExtendedOptions { get; }
Public ReadOnly Property ExtendedOptions As ExtendedSaveOptions
Property Value
Extended save options that are not natively supported by spreadsheet formats.
Format
Gets or sets the image format.
Property Value
The image format.
Height
Gets or sets the image height in pixels.
Property Value
- System.Double
The image height in pixels.
Remarks
If both Width and Height are not specified, then image size will be equal to the page size.
If only one of the Width or Height is specified, then the specified dimension will be respected and other dimension will be calculated so that original aspect ratio is maintained.
If both Width and Height are specified, then both specified dimensions will be respected (which may result in non-uniformly scaled image, if aspect ratio is not equal to the original one.
Limitations
Gets limitations for saving to image file formats.
public override FileFormatLimitations Limitations { get; }
Public Overrides ReadOnly Property Limitations As FileFormatLimitations
Property Value
Overrides
Remarks
These are the limits:
- MaxRows: System.Int32.MaxValue
- MaxColumns: System.Int32.MaxValue
- MaxColors: System.Int32.MaxValue
- MaxCellStyles: System.Int32.MaxValue
MetafileScaleFactor
Gets or sets the scaling factor for rendering metafile (WMF and EMF) images. Greater scaling factor improves quality but also increases file size. Default value is 1.
public double MetafileScaleFactor { get; set; }
Public Property MetafileScaleFactor As Double
Property Value
- System.Double
The metafile scale factor for rendering metafile (WMF and EMF) images.
Remarks
Windows Metafile Format (WMF) and Enhanced Metafile Format (EMF) are vector image formats which contain a series of graphics drawing commands usually executed in Windows GDI layer.
Metafile drawing commands could also be executed in PDF (or XPS) file which is also vector format, but for that Metafile drawing commands would have to be converted to PDF drawing commands.
GemBox.Document currently doesn't perform this conversion of drawing commands, instead it uses Windows GDI to execute Metafile drawing commands into bitmap which is then encoded to PNG format and embedded into PDF file.
MetafileScaleFactor specifies the size of the bitmap surface, based from the original Metafile surface size, into which Metafile should be drawn / rasterized.
PDF viewer will still scale the bitmap to the original Metafile size, but if the page is zoomed or viewed on a larger surface, quality of the image will be better since it contains more pixels / dots which will become visible while PDF viewer scales down the image.
MetafileScaleFactor increases the quality of the Metafile image in PDF file, but it also increases the size of the PDF file because greater MetafileScaleFactor means greater bitmap surface and more space to store bitmap pixel / color data. PNG encoding / compression helps in reducing the space requirement and for complex Metafiles (with a lot of drawing instructions), MetafileScaleFactor of 5 or even greater, might not incur any space overhead relative to the original (complex) Metafile.
Default value for MetafileScaleFactor is 1.
PageCount
Gets or sets the number of pages which should be saved to a multi-frame image.
If image format doesn't support multiple frames, this property is ignored.
Default value is 1.
To save all pages, set value to System.Int32.MaxValue.
Only Tagged Image File Format (TIFF) and Graphics Interchange Format (GIF) format images support multiple frames.
Property Value
- System.Int32
The number of pages which should be saved to a multi-frame image.
PageNumber
Gets or sets the zero-based page number of the document's page which should be saved to an image.
Property Value
- System.Int32
The zero-based page number of the document's page which should be saved to an image.
PixelFormat
Gets or sets a pixel format, which will be used for the image.
Property Value
The pixel format, which will be used for the image.
RenderingMode
Gets or sets the rendering mode used when saving the content to an image.
public RenderingMode RenderingMode { get; set; }
Public Property RenderingMode As RenderingMode
Property Value
The rendering mode used when saving the content to an image.
Exceptions
- System.NotSupportedException
The rendering mode is not supported because of the reasons explained in the exception's System.Exception.Message.
SelectionType
Gets or sets a value indicating whether to save a page from the whole ExcelFile or just ActiveWorksheet.
public SelectionType SelectionType { get; set; }
Public Property SelectionType As SelectionType
Property Value
Remarks
Default value is ActiveSheet to optimize export since only active worksheet will be paginated.
If you want to render a specific page from an un-active worksheet, set that worksheet as ActiveWorksheet or change this property to EntireFile.
TiffCompression
Gets or sets compression schema, which will be used when exporting to Tagged Image File Format (TIFF).
public TiffCompression TiffCompression { get; set; }
Public Property TiffCompression As TiffCompression
Property Value
The compression schema, which will be used when exporting to Tagged Image File Format (TIFF).
Width
Gets or sets the image width in pixels.
Property Value
- System.Double
The image width in pixels.
Remarks
If both Width and Height are not specified, then image size will be equal to the page size.
If only one of the Width or Height is specified, then the specified dimension will be respected and other dimension will be calculated so that original aspect ratio is maintained.
If both Width and Height are specified, then both specified dimensions will be respected (which may result in non-uniformly scaled image, if aspect ratio is not equal to the original one.
Events
ProgressChanged
Occurs when saving progress of a file has changed.
public event EventHandler<OperationProgressChangedEventArgs> ProgressChanged
Public Event ProgressChanged As EventHandler(Of OperationProgressChangedEventArgs)
Event Type
- System.EventHandler<OperationProgressChangedEventArgs>
Inherited Properties
CsvDefault | Gets the default options for saving to Character Separated Values file format. (Inherited from SaveOptions) |
HtmlDefault | Gets the default options for saving to HyperText Markup Language File format. (Inherited from SaveOptions) |
ImageDefault | Gets the default options for saving to image formats. (Inherited from SaveOptions) |
OdsDefault | Gets the default options for saving to OpenDocument Spreadsheet file format. (Inherited from SaveOptions) |
PdfDefault | Gets the default options for saving to Portable Document Format file. (Inherited from SaveOptions) |
TxtDefault | Gets the default options for saving to Tab delimited file format. (Inherited from SaveOptions) |
XlsDefault | Gets the default options for saving to, XLS file format (Microsoft Excel Spreadsheet format; Excel 2003 and prior versions) . (Inherited from SaveOptions) |
XlsbDefault | Gets the default options for saving to XLSB file format (Microsoft Excel Binary File Format). (Inherited from SaveOptions) |
XlsxDefault | Gets the default options for saving to XLSX file format (Microsoft Excel Open XML Spreadsheet; Excel 2007 and later). (Inherited from SaveOptions) |
XpsDefault | Gets the default options for saving to XML Paper Specification file format. (Inherited from SaveOptions) |