API Reference

Class

HtmlImageExportExtensions

Namespace OfficeIMO.Html
Assembly OfficeIMO.Html
Modifiers static

Direct HTML image-export helpers backed by the shared HTML render scene.

Inheritance

  • Object
  • HtmlImageExportExtensions

Methods

public static OfficeImageExportResult ExportImage(HtmlConversionDocument document, OfficeImageExportFormat format, HtmlRenderOptions options = null, Int32 pageIndex = 0) #
Returns: OfficeImageExportResult

Renders one selected surface to the requested image format with dimensions and diagnostics.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
format OfficeIMO.Drawing.OfficeImageExportFormat requiredposition: 1
options OfficeIMO.Html.HtmlRenderOptions = null optionalposition: 2
pageIndex System.Int32 = 0 optionalposition: 3
public static async Task<OfficeImageExportResult> ExportImageAsync(HtmlConversionDocument document, OfficeImageExportFormat format, HtmlRenderOptions options = null, Int32 pageIndex = 0, CancellationToken cancellationToken = null) #
Returns: Task<OfficeImageExportResult>

Asynchronously renders one selected surface to the requested image format.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
format OfficeIMO.Drawing.OfficeImageExportFormat requiredposition: 1
options OfficeIMO.Html.HtmlRenderOptions = null optionalposition: 2
pageIndex System.Int32 = 0 optionalposition: 3
cancellationToken System.Threading.CancellationToken = null optionalposition: 4
ExportImages 2 overloads
public static IReadOnlyList<OfficeImageExportResult> ExportImages(HtmlConversionDocument document, OfficeImageExportFormat format, HtmlRenderOptions options = null) #
Returns: IReadOnlyList<OfficeImageExportResult>

Renders all surfaces to the requested image format.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
format OfficeIMO.Drawing.OfficeImageExportFormat requiredposition: 1
options OfficeIMO.Html.HtmlRenderOptions = null optionalposition: 2
public static Void ExportImages(HtmlConversionDocument document, OfficeImageExportFormat format, OfficeImageExportConsumer consumer, HtmlRenderOptions options = null, CancellationToken cancellationToken = null) #
Returns: Void

Streams rendered surfaces without retaining earlier encoded payloads.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
format OfficeIMO.Drawing.OfficeImageExportFormat requiredposition: 1
consumer OfficeIMO.Drawing.OfficeImageExportConsumer requiredposition: 2
options OfficeIMO.Html.HtmlRenderOptions = null optionalposition: 3
cancellationToken System.Threading.CancellationToken = null optionalposition: 4
ExportImagesAsync 2 overloads
public static async Task<IReadOnlyList<OfficeImageExportResult>> ExportImagesAsync(HtmlConversionDocument document, OfficeImageExportFormat format, HtmlRenderOptions options = null, CancellationToken cancellationToken = null) #
Returns: Task<IReadOnlyList<OfficeImageExportResult>>

Asynchronously renders all surfaces to the requested image format.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
format OfficeIMO.Drawing.OfficeImageExportFormat requiredposition: 1
options OfficeIMO.Html.HtmlRenderOptions = null optionalposition: 2
cancellationToken System.Threading.CancellationToken = null optionalposition: 3
public static async Task ExportImagesAsync(HtmlConversionDocument document, OfficeImageExportFormat format, OfficeImageExportAsyncConsumer consumer, HtmlRenderOptions options = null, CancellationToken cancellationToken = null) #
Returns: Task

Asynchronously streams rendered surfaces without retaining earlier encoded payloads.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
format OfficeIMO.Drawing.OfficeImageExportFormat requiredposition: 1
consumer OfficeIMO.Drawing.OfficeImageExportAsyncConsumer requiredposition: 2
options OfficeIMO.Html.HtmlRenderOptions = null optionalposition: 3
cancellationToken System.Threading.CancellationToken = null optionalposition: 4
SaveAsJpeg 2 overloads
public static OfficeImageExportResult SaveAsJpeg(HtmlConversionDocument document, String path, HtmlRenderOptions options = null, Int32 pageIndex = 0) #
Returns: OfficeImageExportResult

Saves a shared HTML conversion document as a JPEG file.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
path System.String requiredposition: 1
options OfficeIMO.Html.HtmlRenderOptions = null optionalposition: 2
pageIndex System.Int32 = 0 optionalposition: 3
public static OfficeImageExportResult SaveAsJpeg(HtmlConversionDocument document, Stream stream, HtmlRenderOptions options = null, Int32 pageIndex = 0) #
Returns: OfficeImageExportResult

Writes a shared HTML conversion document as JPEG to a caller-owned stream.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
stream System.IO.Stream requiredposition: 1
options OfficeIMO.Html.HtmlRenderOptions = null optionalposition: 2
pageIndex System.Int32 = 0 optionalposition: 3
SaveAsJpegAsync 2 overloads
public static Task<OfficeImageExportResult> SaveAsJpegAsync(HtmlConversionDocument document, String path, HtmlRenderOptions options = null, Int32 pageIndex = 0, CancellationToken cancellationToken = null) #
Returns: Task<OfficeImageExportResult>

Asynchronously resolves resources and saves a shared HTML conversion document as a JPEG file.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
path System.String requiredposition: 1
options OfficeIMO.Html.HtmlRenderOptions = null optionalposition: 2
pageIndex System.Int32 = 0 optionalposition: 3
cancellationToken System.Threading.CancellationToken = null optionalposition: 4
public static Task<OfficeImageExportResult> SaveAsJpegAsync(HtmlConversionDocument document, Stream stream, HtmlRenderOptions options = null, Int32 pageIndex = 0, CancellationToken cancellationToken = null) #
Returns: Task<OfficeImageExportResult>

Asynchronously resolves resources and writes JPEG to a caller-owned stream.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
stream System.IO.Stream requiredposition: 1
options OfficeIMO.Html.HtmlRenderOptions = null optionalposition: 2
pageIndex System.Int32 = 0 optionalposition: 3
cancellationToken System.Threading.CancellationToken = null optionalposition: 4
SaveAsPng 2 overloads
public static OfficeImageExportResult SaveAsPng(HtmlConversionDocument document, String path, HtmlRenderOptions options = null, Int32 pageIndex = 0) #
Returns: OfficeImageExportResult

Saves a shared HTML conversion document as a PNG file.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
path System.String requiredposition: 1
options OfficeIMO.Html.HtmlRenderOptions = null optionalposition: 2
pageIndex System.Int32 = 0 optionalposition: 3
public static OfficeImageExportResult SaveAsPng(HtmlConversionDocument document, Stream stream, HtmlRenderOptions options = null, Int32 pageIndex = 0) #
Returns: OfficeImageExportResult

Writes a shared HTML conversion document as PNG to a caller-owned stream.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
stream System.IO.Stream requiredposition: 1
options OfficeIMO.Html.HtmlRenderOptions = null optionalposition: 2
pageIndex System.Int32 = 0 optionalposition: 3
SaveAsPngAsync 2 overloads
public static Task<OfficeImageExportResult> SaveAsPngAsync(HtmlConversionDocument document, String path, HtmlRenderOptions options = null, Int32 pageIndex = 0, CancellationToken cancellationToken = null) #
Returns: Task<OfficeImageExportResult>

Asynchronously resolves resources and saves a shared HTML conversion document as a PNG file.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
path System.String requiredposition: 1
options OfficeIMO.Html.HtmlRenderOptions = null optionalposition: 2
pageIndex System.Int32 = 0 optionalposition: 3
cancellationToken System.Threading.CancellationToken = null optionalposition: 4
public static Task<OfficeImageExportResult> SaveAsPngAsync(HtmlConversionDocument document, Stream stream, HtmlRenderOptions options = null, Int32 pageIndex = 0, CancellationToken cancellationToken = null) #
Returns: Task<OfficeImageExportResult>

Asynchronously resolves resources and writes PNG to a caller-owned stream.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
stream System.IO.Stream requiredposition: 1
options OfficeIMO.Html.HtmlRenderOptions = null optionalposition: 2
pageIndex System.Int32 = 0 optionalposition: 3
cancellationToken System.Threading.CancellationToken = null optionalposition: 4
SaveAsSvg 2 overloads
public static OfficeImageExportResult SaveAsSvg(HtmlConversionDocument document, String path, HtmlRenderOptions options = null, Int32 pageIndex = 0) #
Returns: OfficeImageExportResult

Saves a shared HTML conversion document as an SVG file.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
path System.String requiredposition: 1
options OfficeIMO.Html.HtmlRenderOptions = null optionalposition: 2
pageIndex System.Int32 = 0 optionalposition: 3
public static OfficeImageExportResult SaveAsSvg(HtmlConversionDocument document, Stream stream, HtmlRenderOptions options = null, Int32 pageIndex = 0) #
Returns: OfficeImageExportResult

Writes a shared HTML conversion document as SVG to a caller-owned stream.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
stream System.IO.Stream requiredposition: 1
options OfficeIMO.Html.HtmlRenderOptions = null optionalposition: 2
pageIndex System.Int32 = 0 optionalposition: 3
SaveAsSvgAsync 2 overloads
public static Task<OfficeImageExportResult> SaveAsSvgAsync(HtmlConversionDocument document, String path, HtmlRenderOptions options = null, Int32 pageIndex = 0, CancellationToken cancellationToken = null) #
Returns: Task<OfficeImageExportResult>

Asynchronously resolves resources and saves a shared HTML conversion document as an SVG file.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
path System.String requiredposition: 1
options OfficeIMO.Html.HtmlRenderOptions = null optionalposition: 2
pageIndex System.Int32 = 0 optionalposition: 3
cancellationToken System.Threading.CancellationToken = null optionalposition: 4
public static Task<OfficeImageExportResult> SaveAsSvgAsync(HtmlConversionDocument document, Stream stream, HtmlRenderOptions options = null, Int32 pageIndex = 0, CancellationToken cancellationToken = null) #
Returns: Task<OfficeImageExportResult>

Asynchronously resolves resources and writes SVG to a caller-owned stream.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
stream System.IO.Stream requiredposition: 1
options OfficeIMO.Html.HtmlRenderOptions = null optionalposition: 2
pageIndex System.Int32 = 0 optionalposition: 3
cancellationToken System.Threading.CancellationToken = null optionalposition: 4
SaveAsTiff 2 overloads
public static OfficeImageExportResult SaveAsTiff(HtmlConversionDocument document, String path, HtmlRenderOptions options = null, Int32 pageIndex = 0) #
Returns: OfficeImageExportResult

Saves a shared HTML conversion document as a TIFF file.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
path System.String requiredposition: 1
options OfficeIMO.Html.HtmlRenderOptions = null optionalposition: 2
pageIndex System.Int32 = 0 optionalposition: 3
public static OfficeImageExportResult SaveAsTiff(HtmlConversionDocument document, Stream stream, HtmlRenderOptions options = null, Int32 pageIndex = 0) #
Returns: OfficeImageExportResult

Writes a shared HTML conversion document as TIFF to a caller-owned stream.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
stream System.IO.Stream requiredposition: 1
options OfficeIMO.Html.HtmlRenderOptions = null optionalposition: 2
pageIndex System.Int32 = 0 optionalposition: 3
SaveAsTiffAsync 2 overloads
public static Task<OfficeImageExportResult> SaveAsTiffAsync(HtmlConversionDocument document, String path, HtmlRenderOptions options = null, Int32 pageIndex = 0, CancellationToken cancellationToken = null) #
Returns: Task<OfficeImageExportResult>

Asynchronously resolves resources and saves a shared HTML conversion document as a TIFF file.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
path System.String requiredposition: 1
options OfficeIMO.Html.HtmlRenderOptions = null optionalposition: 2
pageIndex System.Int32 = 0 optionalposition: 3
cancellationToken System.Threading.CancellationToken = null optionalposition: 4
public static Task<OfficeImageExportResult> SaveAsTiffAsync(HtmlConversionDocument document, Stream stream, HtmlRenderOptions options = null, Int32 pageIndex = 0, CancellationToken cancellationToken = null) #
Returns: Task<OfficeImageExportResult>

Asynchronously resolves resources and writes TIFF to a caller-owned stream.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
stream System.IO.Stream requiredposition: 1
options OfficeIMO.Html.HtmlRenderOptions = null optionalposition: 2
pageIndex System.Int32 = 0 optionalposition: 3
cancellationToken System.Threading.CancellationToken = null optionalposition: 4
SaveAsWebp 2 overloads
public static OfficeImageExportResult SaveAsWebp(HtmlConversionDocument document, String path, HtmlRenderOptions options = null, Int32 pageIndex = 0) #
Returns: OfficeImageExportResult

Saves a shared HTML conversion document as a lossless WebP file.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
path System.String requiredposition: 1
options OfficeIMO.Html.HtmlRenderOptions = null optionalposition: 2
pageIndex System.Int32 = 0 optionalposition: 3
public static OfficeImageExportResult SaveAsWebp(HtmlConversionDocument document, Stream stream, HtmlRenderOptions options = null, Int32 pageIndex = 0) #
Returns: OfficeImageExportResult

Writes a shared HTML conversion document as lossless WebP to a caller-owned stream.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
stream System.IO.Stream requiredposition: 1
options OfficeIMO.Html.HtmlRenderOptions = null optionalposition: 2
pageIndex System.Int32 = 0 optionalposition: 3
SaveAsWebpAsync 2 overloads
public static Task<OfficeImageExportResult> SaveAsWebpAsync(HtmlConversionDocument document, String path, HtmlRenderOptions options = null, Int32 pageIndex = 0, CancellationToken cancellationToken = null) #
Returns: Task<OfficeImageExportResult>

Asynchronously resolves resources and saves a shared HTML conversion document as a lossless WebP file.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
path System.String requiredposition: 1
options OfficeIMO.Html.HtmlRenderOptions = null optionalposition: 2
pageIndex System.Int32 = 0 optionalposition: 3
cancellationToken System.Threading.CancellationToken = null optionalposition: 4
public static Task<OfficeImageExportResult> SaveAsWebpAsync(HtmlConversionDocument document, Stream stream, HtmlRenderOptions options = null, Int32 pageIndex = 0, CancellationToken cancellationToken = null) #
Returns: Task<OfficeImageExportResult>

Asynchronously resolves resources and writes lossless WebP to a caller-owned stream.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
stream System.IO.Stream requiredposition: 1
options OfficeIMO.Html.HtmlRenderOptions = null optionalposition: 2
pageIndex System.Int32 = 0 optionalposition: 3
cancellationToken System.Threading.CancellationToken = null optionalposition: 4
ToImage 2 overloads
public static HtmlPageImageExportBuilder ToImage(HtmlConversionDocument document) #
Returns: HtmlPageImageExportBuilder

Starts fluent image export for one rendered HTML surface.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
public static HtmlPageImageExportBuilder ToImage(HtmlConversionDocument document, HtmlRenderOptions options) #
Returns: HtmlPageImageExportBuilder

Starts fluent image export for one rendered HTML surface using a cloned options snapshot.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
options OfficeIMO.Html.HtmlRenderOptions requiredposition: 1
ToImages 2 overloads
public static HtmlPageImageBatchExportBuilder ToImages(HtmlConversionDocument document) #
Returns: HtmlPageImageBatchExportBuilder

Starts fluent image export for all rendered HTML pages.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
public static HtmlPageImageBatchExportBuilder ToImages(HtmlConversionDocument document, HtmlRenderOptions options) #
Returns: HtmlPageImageBatchExportBuilder

Starts fluent image export for all rendered HTML pages using a cloned options snapshot.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
options OfficeIMO.Html.HtmlRenderOptions requiredposition: 1
public static Byte[] ToJpeg(HtmlConversionDocument document, HtmlRenderOptions options = null, Int32 pageIndex = 0) #
Returns: Byte[]

Renders a shared HTML conversion document to JPEG bytes.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
options OfficeIMO.Html.HtmlRenderOptions = null optionalposition: 1
pageIndex System.Int32 = 0 optionalposition: 2
public static async Task<Byte[]> ToJpegAsync(HtmlConversionDocument document, HtmlRenderOptions options = null, Int32 pageIndex = 0, CancellationToken cancellationToken = null) #
Returns: Task<Byte[]>

Asynchronously resolves resources and renders a shared HTML conversion document to JPEG bytes.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
options OfficeIMO.Html.HtmlRenderOptions = null optionalposition: 1
pageIndex System.Int32 = 0 optionalposition: 2
cancellationToken System.Threading.CancellationToken = null optionalposition: 3
public static Byte[] ToPng(HtmlConversionDocument document, HtmlRenderOptions options = null, Int32 pageIndex = 0) #
Returns: Byte[]

Renders a shared HTML conversion document to PNG bytes.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
options OfficeIMO.Html.HtmlRenderOptions = null optionalposition: 1
pageIndex System.Int32 = 0 optionalposition: 2
public static async Task<Byte[]> ToPngAsync(HtmlConversionDocument document, HtmlRenderOptions options = null, Int32 pageIndex = 0, CancellationToken cancellationToken = null) #
Returns: Task<Byte[]>

Asynchronously resolves resources and renders a shared HTML conversion document to PNG bytes.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
options OfficeIMO.Html.HtmlRenderOptions = null optionalposition: 1
pageIndex System.Int32 = 0 optionalposition: 2
cancellationToken System.Threading.CancellationToken = null optionalposition: 3
public static String ToSvg(HtmlConversionDocument document, HtmlRenderOptions options = null, Int32 pageIndex = 0) #
Returns: String

Renders a shared HTML conversion document to SVG text.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
options OfficeIMO.Html.HtmlRenderOptions = null optionalposition: 1
pageIndex System.Int32 = 0 optionalposition: 2
public static async Task<String> ToSvgAsync(HtmlConversionDocument document, HtmlRenderOptions options = null, Int32 pageIndex = 0, CancellationToken cancellationToken = null) #
Returns: Task<String>

Asynchronously resolves resources and renders a shared HTML conversion document to SVG text.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
options OfficeIMO.Html.HtmlRenderOptions = null optionalposition: 1
pageIndex System.Int32 = 0 optionalposition: 2
cancellationToken System.Threading.CancellationToken = null optionalposition: 3
public static Byte[] ToTiff(HtmlConversionDocument document, HtmlRenderOptions options = null, Int32 pageIndex = 0) #
Returns: Byte[]

Renders a shared HTML conversion document to TIFF bytes.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
options OfficeIMO.Html.HtmlRenderOptions = null optionalposition: 1
pageIndex System.Int32 = 0 optionalposition: 2
public static async Task<Byte[]> ToTiffAsync(HtmlConversionDocument document, HtmlRenderOptions options = null, Int32 pageIndex = 0, CancellationToken cancellationToken = null) #
Returns: Task<Byte[]>

Asynchronously resolves resources and renders a shared HTML conversion document to TIFF bytes.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
options OfficeIMO.Html.HtmlRenderOptions = null optionalposition: 1
pageIndex System.Int32 = 0 optionalposition: 2
cancellationToken System.Threading.CancellationToken = null optionalposition: 3
public static Byte[] ToWebp(HtmlConversionDocument document, HtmlRenderOptions options = null, Int32 pageIndex = 0) #
Returns: Byte[]

Renders a shared HTML conversion document to lossless WebP bytes.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
options OfficeIMO.Html.HtmlRenderOptions = null optionalposition: 1
pageIndex System.Int32 = 0 optionalposition: 2
public static async Task<Byte[]> ToWebpAsync(HtmlConversionDocument document, HtmlRenderOptions options = null, Int32 pageIndex = 0, CancellationToken cancellationToken = null) #
Returns: Task<Byte[]>

Asynchronously resolves resources and renders a shared HTML conversion document to lossless WebP bytes.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
options OfficeIMO.Html.HtmlRenderOptions = null optionalposition: 1
pageIndex System.Int32 = 0 optionalposition: 2
cancellationToken System.Threading.CancellationToken = null optionalposition: 3