Class RtfConversionOptions

Configuration options for RTF to PDF conversion

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

PDF generation in IronPDF is handled through RtfConversionOptions. It represents configuration options for RTF to PDF conversion.

RtfConversionOptions matters when an application needs to configure or invoke PDF generation from C# code. The class encapsulates the related options and behavior in a single object that is set up once and reused across render or processing calls. Typical scenarios include batch generation pipelines, templated document workflows, and integration with existing C# document services.

To use RtfConversionOptions, instantiate or obtain it from the relevant entry point in the IronPDF C# API. Key properties include ColumnGapPercent, FontFamily, FontSizePt, MarginBottomTwips. Assign options or invoke methods on the instance to configure or perform the operation. The RTF to PDF covers typical usage in C# end to end.

using IronPdf;

var instance = new RtfConversionOptions();
var current = instance.ColumnGapPercent;
// Read or assign other properties such as FontFamily, FontSizePt
instance.ForA4();

For the broader workflow, see the IronPDF C# documentation for related how-to guides and examples. For broader context, the PDF generation portion of the IronPDF C# API contains related types that work with RtfConversionOptions directly. RtfConversionOptions exposes additional members beyond those highlighted above; the reference tables on this page list the full set. In application code, treat RtfConversionOptions as a configured object that is constructed once and reused across operations rather than instantiated per call. Configuration is generally idempotent: assigning the same property value twice has the same effect as assigning it once. For diagnostic purposes, inspect the relevant RtfConversionOptions property after each operation to confirm the configured state. See the constructors, properties, and methods tables below for the complete API surface of RtfConversionOptions. Application code typically obtains or instantiates a single RtfConversionOptions and shares it across multiple IronPDF operations rather than recreating it per call.

Constructors

RtfConversionOptions()

Declaration
public RtfConversionOptions()

Properties

ColumnGapPercent

Gets or sets the percentage-based gap between columns in the generated HTML layout.

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

Unit: Percentage of page width

Default: 1.0 (%)

Column width is calculated as:
(100% - (GapPercent × (ColumnCount - 1))) / ColumnCount

Increasing this value increases visual separation between columns.

FontFamily

Gets or sets the default font family applied to wrapper elements when the RTF does not specify a font.

Declaration
public string FontFamily { get; set; }
Property Value
Type Description
System.String
Remarks

Default: "Times New Roman", serif

This value acts as a fallback and does not override inline font definitions preserved from the RTF.

FontSizePt

Gets or sets the default font size (in points) applied to wrapper elements when the RTF does not specify a font size.

Declaration
public int FontSizePt { get; set; }
Property Value
Type Description
System.Int32
Remarks

Unit: Points (pt)

Default: 12

Inline font sizes defined in the RTF are preserved and take precedence.

MarginBottomTwips

Gets or sets the default bottom margin used when the RTF document does not specify a bottom margin (\margb).

Declaration
public int MarginBottomTwips { get; set; }
Property Value
Type Description
System.Int32
Remarks

Unit: Twips (1 inch = 1440 twips)

Default: 1440 (1 inch)

Influences footer spacing and page break positioning.

MarginLeftTwips

Gets or sets the default left margin used when the RTF document does not specify a left margin (\margl).

Declaration
public int MarginLeftTwips { get; set; }
Property Value
Type Description
System.Int32
Remarks

Unit: Twips (1 inch = 1440 twips)

Default: 1440 (1 inch)

Applied via the generated @page CSS rule and affects usable content width.

MarginRightTwips

Gets or sets the default right margin used when the RTF document does not specify a right margin (\margr).

Declaration
public int MarginRightTwips { get; set; }
Property Value
Type Description
System.Int32
Remarks

Unit: Twips (1 inch = 1440 twips)

Default: 1440 (1 inch)

MarginTopTwips

Gets or sets the default top margin used when the RTF document does not specify a top margin (\margt).

Declaration
public int MarginTopTwips { get; set; }
Property Value
Type Description
System.Int32
Remarks

Unit: Twips (1 inch = 1440 twips)

Default: 1440 (1 inch)

Influences header spacing and the vertical start position of content.

PaperHeightTwips

Gets or sets the default paper height used when the RTF document does not specify a paper height (\paperh).

Declaration
public int PaperHeightTwips { get; set; }
Property Value
Type Description
System.Int32
Remarks

Unit: Twips (1 inch = 1440 twips)

Default: 15840 (11 inches, US Letter)

This value influences page breaks and vertical content flow.

PaperWidthTwips

Gets or sets the default paper width used when the RTF document does not specify a paper width (\paperw).

Declaration
public int PaperWidthTwips { get; set; }
Property Value
Type Description
System.Int32
Remarks

Unit: Twips (1 inch = 1440 twips)

Default: 12240 (8.5 inches, US Letter)

This value affects page width, line wrapping, and the generated @page CSS size.

Methods

ForA4()

Creates a RtfConversionOptions instance configured for standard A4 paper size.

Declaration
public static RtfConversionOptions ForA4()
Returns
Type Description
RtfConversionOptions

A RtfConversionOptions configured for A4 layout.
Remarks

Uses A4 dimensions (210 × 297 mm) with ~20 mm margins on all sides. These values are applied only when the source RTF does not specify paper size or margins.