Class SvgConversionOptions

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

Fine-grained control over every PDF-to-SVG conversion in C# lives in SvgConversionOptions. Construct one with new SvgConversionOptions(), set the properties that matter for the job, and pass the object to IronPDF's SVG export call to govern fonts, images, annotations, links, hidden text, stroke rendering, and whitespace collapsing in a single, reusable configuration record.

**Font and whitespace control**

Two properties manage how adjacent glyphs are merged into text runs. CollapseSpaceEmbeddedFont sets the threshold (as a fraction of the font size) below which gaps between characters rendered with an embedded font are collapsed into a single run rather than emitted as separate SVG text elements. CollapseSpaceLocalFont applies the same logic when the page uses a locally resolved font. Tighter values preserve more spacing fidelity; looser values produce smaller, cleaner SVG files. The FontResolver property accepts a FontResolver delegate or object that maps font references in the PDF to local font resources, which is essential when the source document references fonts that are not embedded.

**Image and link handling**

ImageResolver accepts an ImageResolver that determines how raster images embedded in the PDF are encoded or referenced in the output SVG. Keeping images inline produces a self-contained file; resolving them to external paths keeps the SVG compact. Set IncludeLinks to true to carry PDF hyperlink annotations through to the SVG as <a> elements, so the exported graphic remains navigable in a browser.

**Annotation, hidden text, and stroke options**

IncludeAnnotations controls whether PDF annotation layers appear in the SVG output. IncludeHiddenText surfaces text that is present in the PDF content stream but not visible to the reader, which is useful for accessibility tooling or text-extraction pipelines that consume the SVG. MinStrokeWidth sets a floor (in SVG user units) for rendered strokes, preventing hairline paths from disappearing at normal viewing scales.

using PdfToSvg;
using IronPdf;

var options = new SvgConversionOptions
{
    CollapseSpaceEmbeddedFont = 0.3,
    CollapseSpaceLocalFont    = 0.4,
    IncludeAnnotations        = true,
    IncludeLinks              = true,
    IncludeHiddenText         = false,
    MinStrokeWidth            = 0.5
};

var pdf = PdfDocument.FromFile("report.pdf");
// Pass options to the SVG conversion method on your chosen export API.

Explore more in the IronPDF documentation, the PDF conversion how-to guides, and the SVG export examples. For setup, see the getting-started page.

Constructors

SvgConversionOptions()

Declaration
public SvgConversionOptions()

Properties

CollapseSpaceEmbeddedFont

Declaration
public double CollapseSpaceEmbeddedFont { get; set; }
Property Value
Type Description
System.Double

CollapseSpaceLocalFont

Declaration
public double CollapseSpaceLocalFont { get; set; }
Property Value
Type Description
System.Double

FontResolver

Declaration
public FontResolver FontResolver { get; set; }
Property Value
Type Description
FontResolver

ImageResolver

Declaration
public ImageResolver ImageResolver { get; set; }
Property Value
Type Description
ImageResolver

IncludeAnnotations

Declaration
public bool IncludeAnnotations { get; set; }
Property Value
Type Description
System.Boolean

IncludeHiddenText

Declaration
public bool IncludeHiddenText { get; set; }
Property Value
Type Description
System.Boolean
Declaration
public bool IncludeLinks { get; set; }
Property Value
Type Description
System.Boolean

MinStrokeWidth

Declaration
public double MinStrokeWidth { get; set; }
Property Value
Type Description
System.Double