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

# PictureExportParams Object (IPictureExportParams Interface)

This object provides functionality for tuning the parameters of writing images to output files of various formats. The object allows you to select an image format for color and gray images. Black-and-white images are always saved in PNG format.

## Properties

<table><thead><tr><th><p><strong>Name</strong></p></th><th><p><strong>Type</strong></p></th><th><p><strong>Description</strong></p></th></tr></thead><tbody><tr><td><p><strong>Application</strong></p></td><td><p><strong><a href="/fine-reader/engine/api-reference/engine-object-iengine-interface">Engine</a></strong>, <a href="/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties#readonly_properties">read-only</a></p></td><td><p>Returns the <strong>Engine</strong> object.</p></td></tr><tr><td><p><a name="colority" /><strong>Colority</strong></p></td><td><p><strong><a href="/fine-reader/engine/api-reference/enumerations/picturecoloritymodeenum">PictureColorityModeEnum</a></strong></p></td><td><p>Allows you to keep color of the pictures embedded into the file or save it in gray or black-and-white. It may be useful to set this property to PCM\_ForceToGray for color pictures, if you do not need to save their colors and want to reduce the size of output files.</p><Note>If the CorrectColorDepth property is set to TRUE, ABBYY FineReader Engine can additionally correct color depth of embedded pictures. For example, if you set Colority to PCM\_ForceToGray and CorrectColorDepth is TRUE, FineReader Engine will change the color images to gray, then will detect color depth of gray images and, if necessary, will change some images to black-and-white.</Note><p>The default value for this property is PCM\_KeepColority.</p></td></tr><tr><td><p><a name="colorpictureformats" /><strong>ColorPictureFormats</strong></p></td><td><p><strong><a href="/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">int</a></strong></p></td><td><p>Specifies the image format to be used when saving a file with embedded color pictures. The value of this property is an OR superposition of the <strong><a href="/fine-reader/engine/api-reference/enumerations/colorpictureformatsenum">ColorPictureFormatsEnum</a></strong> enumeration constants.</p><p>The property can be set to CPF\_Jpeg, CPF\_Png, or CPF\_Auto.</p><p>The default value for this property is CPF\_Auto.</p></td></tr><tr><td><p><a name="correctcolordepth" /><strong>CorrectColorDepth</strong></p></td><td><p><strong><a href="/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">VARIANT\_BOOL</a></strong></p></td><td><p>This property set to TRUE enables ABBYY FineReader Engine to correct color depth of embedded pictures. If you set this property to FALSE, ABBYY FineReader Engine will save colors of the pictures as defined in the <strong>Colority </strong>property.</p><p>By default, the value of this property is TRUE.</p></td></tr><tr><td><p><a name="graypictureformats" /><strong>GrayPictureFormats</strong></p></td><td><p><strong><a href="/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">int</a></strong></p></td><td><p>Specifies the image format to be used when saving a file with embedded gray pictures. The value of this property is an OR superposition of the <strong><a href="/fine-reader/engine/api-reference/enumerations/graypictureformatsenum">GrayPictureFormatsEnum</a></strong> enumeration constants.</p><p>The property can be set to GPF\_Jpeg, GPF\_Png, or GPF\_Auto.</p><p>The default value for this property is GPF\_Auto.</p></td></tr><tr><td><p><a name="jpegquality" /><strong>JpegQuality</strong></p></td><td><p><strong><a href="/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">int</a></strong></p></td><td><p>Stores the value of the JPEG quality for pictures embedded in a file in percent. This value is used with color and gray JPEG image formats.</p><p>The default value of this property is 50%.</p></td></tr><tr><td><p><a name="resolution" /><strong>Resolution</strong></p></td><td><p><strong><a href="/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">int</a></strong></p></td><td><p>Stores the value of picture resolution in dpi. This property may be set to -1, which means that the original resolution must be preserved.</p><p>The default value of this property depends on the export format:</p><ul><li>for RTF, XLSX and PPTX it is 150 dpi;</li><li>for HTML, FB2 and EPUB it is 72 dpi;</li><li>for XPS it is 300 dpi.</li></ul></td></tr></tbody></table>

## Related objects

<img src="https://mintcdn.com/abbyy/i-EfCQVmseNiPQcp/images/fine-reader/engine/pictureexportparams.gif?s=f4d18a18163fdc4e29ec063eb128a00e" alt="PictureExportParams" width="254" height="112" data-path="images/fine-reader/engine/pictureexportparams.gif" />[](/fine-reader/engine/api-reference/parameter-objects/export-parameters/xlexportparams)[](/fine-reader/engine/api-reference/parameter-objects/export-parameters/ebookexportparams)[](/fine-reader/engine/api-reference/parameter-objects/export-parameters/pptexportparams)[](/fine-reader/engine/api-reference/parameter-objects/export-parameters/xpsexportparams)[](/fine-reader/engine/api-reference/parameter-objects/export-parameters/rtfexportparams)[](/fine-reader/engine/api-reference/parameter-objects/export-parameters/htmlexportparams)

[Object Diagram](/fine-reader/engine/api-reference/object-diagram)

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