Skip to content

RtfConverter

RtfConverter is the BaseConverter subclass selected by ConverterFactory for .rtf source files. Unlike the Office converters, it does not use a dedicated Syncfusion RTF-to-PDF engine — it renders the RTF as a metafile via PdfImage.FromRtf and draws that metafile onto PDF pages, allowing text content to flow across multiple pages.

Purpose

  • Convert an RTF document stream to PDF by rendering it as a metafile (BR-SFC-003).
  • Allow RTF text content to flow across multiple output pages rather than being clipped to one page (BR-SFC-013).
  • Identify itself to ConverterFactory and downstream consumers as the RTF conversion type.

Context

  • Namespace: PdfAPI.SyncFusionCore
  • Assembly/package: PdfAPI.SyncFusionCore (Pdf.Local.Client NuGet package)

Public members

Member Signature Purpose
RtfConverter RtfConverter() Creates a ready-to-use RtfConverter instance for ConverterFactory to invoke against RTF source documents (.rtf); the constructor body is empty*, so no state is established beyond the base type's fields.
ConversionType override SourceConversionType ConversionType { get; } Returns SourceConversionType.RTF, identifying this converter's source format to ConverterFactory and to the assembled PdfResult.

Inherited public members

Members in this section are inherited from BaseConverter in PdfAPI.SyncFusionCore. They are available on this type through inheritance.

Member Signature Purpose Origin
Convert PdfResult Convert(Stream stream, ConvertRequest request) Executes the full conversion: times the operation, invokes ConfigureConverter and ConvertItem, and assembles a PdfResult with Status, Elapsed, and PdfProcessorType = Syncfusion; captures rather than propagates conversion exceptions (BR-SFC-006, BR-SFC-010). PdfAPI.SyncFusionCore — BaseConverter

Behavioral notes

  • Rendering is done via PdfImage.FromRtf producing a PdfMetafile, which is then drawn onto one or more PdfGraphics pages — a fundamentally different approach from the Office converters, which call a dedicated Syncfusion document-to-PDF engine.
  • A conversion failure is captured by the inherited Convert method and reported through the result rather than thrown (BR-SFC-010).

Constraints and usage notes

  • Not intended to be constructed directly by application code; ConverterFactory constructs and invokes it based on the source file extension.

Note: Statements marked with * were inferred from code structure, naming conventions, or contextual evidence where direct confirmation was not available in source artifacts.

Sources

  • PdfApi.SyncFusionCore\Convert\RtfConverter.cs