Class Image

Inheritance
System.Object
Image
Namespace: PdfToSvg
Assembly: IronPdf.dll
Syntax
public abstract class Image : Object

Embedded raster images extracted during PDF-to-SVG conversion are surfaced through Image, the base record that carries both the raw bytes and the metadata needed to identify, size, and embed each graphic. When IronPDF converts a PDF page to SVG, every image resource on that page becomes a concrete Image subclass, giving you a uniform handle regardless of the underlying encoding.

Four properties describe the image without loading its content: ContentType returns the MIME type (for example image/png or image/jpeg), Extension gives the matching file extension without a leading dot, and Width and Height report pixel dimensions. These are available immediately after extraction, so you can filter or route images before paying the cost of decoding the bytes.

To retrieve the actual content, call GetContent for a synchronous byte[] or GetContentAsync for the awaitable form, both accepting an optional CancellationToken. For scenarios where the bytes must be embedded in HTML or SVG markup directly, ToDataUrl and ToDataUrlAsync produce a complete data: URI string, combining the MIME type and Base64-encoded content in one step. This is particularly useful when writing SVG output that must be self-contained, with no external file references.

The constructor Image(string contentType, string extension, int width, int height) is protected, so you do not instantiate Image directly. Concrete subclasses returned by the IronPDF conversion pipeline populate those fields. Your code consumes the object through the public surface.

using IronPdf;
using PdfToSvg;
using System.IO;

var renderer = new SvgRenderer();
SvgDocument svg = renderer.RenderPdfPageAsSvg("report.pdf", pageIndex: 0);

foreach (Image img in svg.Images)
{
    if (img.ContentType == "image/png" && img.Width >= 300)
    {
        byte[] raw = await img.GetContentAsync();
        await File.WriteAllBytesAsync($"extracted_{img.Width}x{img.Height}.{img.Extension}", raw);
    }
}

The PDF to SVG how-to explains the full conversion pipeline. The image extraction example shows common patterns for working with extracted graphics. For embedding images in generated output, see the data URL guide and the IronPDF get-started page.

Constructors

Image(String, String, Int32, Int32)

Declaration
protected Image(string contentType, string extension, int width, int height)
Parameters
Type Name Description
System.String contentType
System.String extension
System.Int32 width
System.Int32 height

Properties

ContentType

Declaration
public string ContentType { get; }
Property Value
Type Description
System.String

Extension

Declaration
public string Extension { get; }
Property Value
Type Description
System.String

Height

Declaration
public int Height { get; }
Property Value
Type Description
System.Int32

Width

Declaration
public int Width { get; }
Property Value
Type Description
System.Int32

Methods

GetContent(CancellationToken)

Declaration
public abstract byte[] GetContent(CancellationToken cancellationToken = null)
Parameters
Type Name Description
System.Threading.CancellationToken cancellationToken
Returns
Type Description
System.Byte[]

GetContentAsync(CancellationToken)

Declaration
public abstract Task<byte[]> GetContentAsync(CancellationToken cancellationToken = null)
Parameters
Type Name Description
System.Threading.CancellationToken cancellationToken
Returns
Type Description
System.Threading.Tasks.Task<System.Byte[]>

ToDataUrl(CancellationToken)

Declaration
public string ToDataUrl(CancellationToken cancellationToken = null)
Parameters
Type Name Description
System.Threading.CancellationToken cancellationToken
Returns
Type Description
System.String

ToDataUrlAsync(CancellationToken)

Declaration
public Task<string> ToDataUrlAsync(CancellationToken cancellationToken = null)
Parameters
Type Name Description
System.Threading.CancellationToken cancellationToken
Returns
Type Description
System.Threading.Tasks.Task<System.String>