> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Tuning Export Parameters

> Tune ABBYY FineReader Engine export parameter objects (RTFExportParams, TextExportParams, XLExportParams, PDFExportParams) to control output for RTF/DOCX/ODT, TXT/CSV, XLS/XLSX, PDF, and more.

<Note>
  C# samples are applicable only to FRE for Windows.
</Note>

During export, recognized documents are saved in files in suitable formats. ABBYY FineReader Engine has a group of objects which provide tools for tuning different export parameters. Pointers to these objects can be passed to the export methods as input parameters and thus affect the results of the export. The following FineReader Engine objects provide export methods: [FRDocument](/fine-reader/engine/api-reference/document-related-objects/frdocument) and [FRPage](/fine-reader/engine/api-reference/document-related-objects/frpage).

For supported external formats, there are corresponding export parameter objects. These are:

* [RTFExportParams](/fine-reader/engine/api-reference/parameter-objects/export-parameters/rtfexportparams) for RTF, DOCX, and ODT formats
* [TextExportParams](/fine-reader/engine/api-reference/parameter-objects/export-parameters/textexportparams) for TXT and CSV formats
* [XLExportParams](/fine-reader/engine/api-reference/parameter-objects/export-parameters/xlexportparams) for XLS and XLSX formats
* [HTMLExportParams](/fine-reader/engine/api-reference/parameter-objects/export-parameters/htmlexportparams) for HTML format
* [PDFExportParams](/fine-reader/engine/api-reference/parameter-objects/export-parameters/pdfexportparams) for PDF and PDF/A format
* [XMLExportParams](/fine-reader/engine/api-reference/parameter-objects/export-parameters/xmlexportparams) for XML format
* [PPTExportParams](/fine-reader/engine/api-reference/parameter-objects/export-parameters/pptexportparams) for PPTX format
* [AltoExportParams](/fine-reader/engine/api-reference/parameter-objects/export-parameters/altoexportparams) for ALTO format
* [JsonExportParams](/fine-reader/engine/api-reference/parameter-objects/export-parameters/jsonexportparams) for JSON format
* [EBookExportParams](/fine-reader/engine/api-reference/parameter-objects/export-parameters/ebookexportparams) for EPUB and FB2 formats
* [XPSExportParams](/fine-reader/engine/api-reference/parameter-objects/export-parameters/xpsexportparams) for XPS format
* [MrzJsonExportParams](/fine-reader/engine/api-reference/parameter-objects/export-parameters/mrzjsonexportparams) for JSON format (only for the machine-readable zone export)
* [MrzXmlExportParams](/fine-reader/engine/api-reference/parameter-objects/export-parameters/mrzxmlexportparams) for XML format (only for the machine-readable zone export)

Export processes can also be tuned using profiles. See [Working with Profiles](/fine-reader/engine/guided-tour/advanced-techniques/working-with-profiles) for details.

Export of business cards to vCard format is available via the [IBusinessCard::ExportToVCard](/fine-reader/engine/api-reference/document-related-objects/businesscard/exporttovcard-method) method.

## The export procedure

A step-by-step procedure that uses objects of this group should look like this:

1. Create an export parameter object that corresponds to the external format in which you are going to save your text. Use the corresponding [creation method](/fine-reader/engine/api-reference/engine-object-iengine-interface/creation-methods) of the Engine object.
2. Set up the necessary properties of the object you created. You do not need to set up all the properties of the export parameter object, as on creation, they are initialized with reasonable defaults. You only have to tune up those of the properties that you want to have values other than default ones.
3. Pass it to one of the export methods of the [FRDocument](/fine-reader/engine/api-reference/document-related-objects/frdocument) or [FRPage](/fine-reader/engine/api-reference/document-related-objects/frpage) objects together with a suitable [FileExportFormatEnum](/fine-reader/engine/api-reference/enumerations/fileexportformatenum) constant.

Sample code that uses the [RTFExportParams](/fine-reader/engine/api-reference/parameter-objects/export-parameters/rtfexportparams) object:

<Accordion title="C# code">
  ```csharp theme={null}
  FREngine.IEngine Engine;
  FREngine.IFRDocument frDocument;
  // We presume that the document has been recognized and synthesized
  // Tune parameters of export
  FREngine.IRTFExportParams exportParams = Engine.CreateRTFExportParams();
  exportParams.KeepLines = true;
  // Save results using specified parameters
  frDocument.Export( "D:\\Demo.rtf", FREngine.FileExportFormatEnum.FEF_RTF, exportParams );
  ```
</Accordion>

## Export to PDF and PDF/A formats

ABBYY FineReader Engine allows you to tune export to PDF and PDF/A formats in an even more convenient way. It provides the [PDFExportParams](/fine-reader/engine/api-reference/parameter-objects/export-parameters/pdfexportparams) object, which allows you to tune export with only a few parameters. For example, using only one IPDFExportParams::Scenario property, you can optimize your PDF for quality and size.

The procedure which uses the PDFExportParams object is as follows:

1. Create a PDFExportParams object using the [CreatePDFExportParams](/fine-reader/engine/api-reference/engine-object-iengine-interface/creation-methods/createlessobjectgreater-methods) method of the [Engine](/fine-reader/engine/api-reference/engine-object-iengine-interface) object.
2. Set the necessary parameters of the PDFExportParams object:
   * the scenario of export, which optimizes export for some parameters: quality, size of the file, or/and speed of export (the Scenario property)
   * the format of export: PDF, PDF/A-1a, PDF/A-1b, PDF/A-2a, PDF/A-2b, PDF/A-2u, PDF/A-3a, PDF/A-3b, or PDF/A-3u (the PDFAComplianceMode property)
   * the mode of recognized text export: text and pictures only, text over the page image, text under the page image, page image only (the TextExportMode property)
   * set other parameters, if necessary
3. Pass the [FEF\_PDF](/fine-reader/engine/api-reference/enumerations/fileexportformatenum) constant and the object of export parameters to one of the export methods of the [FRDocument](/fine-reader/engine/api-reference/document-related-objects/frdocument) or [FRPage](/fine-reader/engine/api-reference/document-related-objects/frpage) objects.

Sample code that uses the PDFExportParams object:

<Accordion title="C# code">
  ```csharp theme={null}
  FREngine.IEngine Engine;
  FREngine.IFRDocument frDocument;
  // We presume that the document has been recognized and synthesized
  // Tune parameters of export
  FREngine.IPDFExportParams pdfParams = Engine.CreatePDFExportParams();
  pdfParams.Scenario = FREngine.PDFExportScenarioEnum.PES_Balanced;
  // Save results using specified parameters
  frDocument.Export( "D:\\Demo.pdf", FREngine.FileExportFormatEnum.FEF_PDF, pdfParams );
  ```
</Accordion>

A similar procedure is used in the following code samples:

* Linux: [Hello](/fine-reader/engine/guided-tour/samples#hello), [CommandLineInterface](/fine-reader/engine/guided-tour/samples#commandlineinterface)

* macOS: [TiffToRtf](/fine-reader/engine/guided-tour/samples#tifftortf)

* Windows: [Hello](/fine-reader/engine/guided-tour/samples#hello), [CommandLineInterface](/fine-reader/engine/guided-tour/samples#commandlineinterface); and demo tools: [BatchProcessingRecognition](/fine-reader/engine/guided-tour/samples#batchprocessingrecognition), [MultiProcessingRecognition](/fine-reader/engine/guided-tour/samples#multiprocessingrecognition), [PDFExportProfiles](/fine-reader/engine/guided-tour/samples#pdfexportprofiles).

## See also

[Export Formats](/fine-reader/engine/specifications/export-formats)

[Working with Profiles](/fine-reader/engine/guided-tour/advanced-techniques/working-with-profiles)

[Tuning Parameters of Preprocessing, Analysis, Recognition, and Synthesis](/fine-reader/engine/guided-tour/advanced-techniques/tuning-parameters-of-preprocessing-analysis-recognition-and-synthesis)
