> ## 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.

# XMLExportParams Object (IXMLExportParams Interface)

This object provides functionality for tuning parameters of recognized text export in XML format. A pointer to this object is passed into the export methods as an input parameter, and thus affects the results of export. All properties of a newly created object of this type are set to reasonable defaults. For more information about the default value of this or that property, see the description of the corresponding property.

You can find the XML schema in the ABBYY\_Scheme\_XML.xsd file.

This file is located in the [Headers](/fine-reader/engine/distribution/distribution-macos/distribution-kit-macos) folder for macOS or the Inc folder for [Linux](/fine-reader/engine/distribution/distribution-linux/distribution-kit-linux#inc) and [Windows](/fine-reader/engine/distribution/distribution-windows/distribution-kit#inc) (Start > Programs > ABBYY FineReader Engine 12 > Installation Folders > Include Files Folder). For the description of XML tags see the [XML Schema Description](/fine-reader/engine/specifications/export-formats/xml-schema-description).

The XMLExportParams object is a persistent object. This means that the object's current state can be written to persistent storage. Later, the object can be re-created by reading the object's state from the persistent storage. The following methods provide persistence of the object:

Linux: [SaveToFile](/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetofile-method), and [LoadFromFile](/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfromfile-method)

Windows [SaveToFile](/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetofile-method), [LoadFromFile](/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfromfile-method), [SaveToMemory](/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetomemory-method), and [LoadFromMemory](/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfrommemory-method).

## Properties

| Name                              | Type                                                                                                                                                                                                          | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Application                       | [Engine](/fine-reader/engine/api-reference/engine-object-iengine-interface), [read-only](/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties#readonly_properties) | Returns the Engine object.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| WriteCharacterRecognitionVariants | [VARIANT\_BOOL](/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties)                                                                                              | Specifies if collections of variants of characters recognition are to be written in a file in XML format. This property is not taken into account if the WriteCharAttributes property is XCA\\\_None. <Note> The collections may contain more than one element only if the [IRecognizerParams::SaveCharacterRecognitionVariants](/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/recognizerparams#savecharacterrecognitionvariants) property was set to TRUE during recognition. See [Using Voting API](/fine-reader/engine/guided-tour/advanced-techniques/using-voting-api) for details. </Note> This property is FALSE by default. |
| WriteCharAttributes               | [XMLCharAttributesEnum](/fine-reader/engine/api-reference/enumerations/xmlcharattributesenum)                                                                                                                 | Specifies which [character attributes](/fine-reader/engine/api-reference/text-related-objects/charparams) are to be saved in a file in XML format. This property is XCA\\\_None by default.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| WriteCharFormatting               | [VARIANT\_BOOL](/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties)                                                                                              | Specifies if character formatting is to be saved in a file in XML format. This property is FALSE by default.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| WriteNondeskewedCoordinates       | [VARIANT\_BOOL](/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties)                                                                                              | Specifies if character coordinates saved in a file in XML format are on a non-deskewed image plane. This property is TRUE by default.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| WriteParagraphStyles              | [VARIANT\_BOOL](/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties)                                                                                              | Specifies whether parameters of paragraph and font styles should be written in a file in XML format. This parameter may be useful, if you want to retrieve information on paragraph roles from XML. This property is FALSE by default.                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| WriteWordRecognitionVariants      | [VARIANT\_BOOL](/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties)                                                                                              | Specifies if collections of variants of words recognition are to be written in a file in XML format. <Note> The collections may contain more than one element only if the [IRecognizerParams::SaveWordRecognitionVariants](/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/recognizerparams#savewordrecognitionvariants) property was set to TRUE during recognition. See [Using Voting API](/fine-reader/engine/guided-tour/advanced-techniques/using-voting-api) for details. </Note> This property is FALSE by default.                                                                                                            |

## Methods

| Name                                                                                                                                               | Description                                                                                       |
| -------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
| [CopyFrom](/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/copyfrom-method)                              | Initializes properties of the current object with values of similar properties of another object. |
| [LoadFromFile](/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfromfile-method)                                            | Restores the object contents from a file on disk.                                                 |
| [LoadFromMemory](/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfrommemory-method) <br /><br /> **Note:** *Windows only.* | Restores the object contents from the global memory.                                              |
| [SaveToFile](/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetofile-method)                                                | Saves the object contents into a file on disk.                                                    |
| [SaveToMemory](/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetomemory-method) <br /><br /> **Note:** *Windows only.*     | Saves the object contents into the global memory.                                                 |

## Output parameter

This object is the output parameter of the [CreateXMLExportParams](/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.

## Input parameter

This object is passed as the input parameter to the following methods:

* [Export](/fine-reader/engine/api-reference/document-related-objects/frdocument/export-method), [ExportPages](/fine-reader/engine/api-reference/document-related-objects/frdocument/exportpages-method), [ExportToMemory](/fine-reader/engine/api-reference/document-related-objects/frdocument/exporttomemory-method) methods of the [FRDocument](/fine-reader/engine/api-reference/document-related-objects/frdocument) object

* [Export](/fine-reader/engine/api-reference/document-related-objects/frpage/export-method) method of the [FRPage](/fine-reader/engine/api-reference/document-related-objects/frpage) object

* [RecognizeImageFile](/fine-reader/engine/api-reference/engine-object-iengine-interface/processing-methods/recognizeimagefile-method) method of the [Engine](/fine-reader/engine/api-reference/engine-object-iengine-interface) object

* [OnExportPages](/fine-reader/engine/visual-components-reference/idocumentviewerevents/onexportpages-method) method of the [IDocumentViewerEvents](/fine-reader/engine/visual-components-reference/idocumentviewerevents) interface for Windows Visual Components

* [OnSendToPages](/fine-reader/engine/visual-components-reference/idocumentviewerevents/onsendtopages-method) method of the [IDocumentViewerEvents](/fine-reader/engine/visual-components-reference/idocumentviewerevents) interface for Windows Visual Components

## Samples

The object is used in the following code samples: [CommandLineInterface](/fine-reader/engine/guided-tour/samples#commandlineinterface) (Windows and Linux)

## See also

[Tuning Export Parameters](/fine-reader/engine/guided-tour/advanced-techniques/tuning-export-parameters)

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

[Working with Properties](/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties)
