PDFMRCParams Object (IPDFMRCParams Interface)

This object allows you to tune Mixed Raster Content (MRC) parameters for PDF (PDF/A) files. These parameters are set in the MRCParams property of the PDFPictureCompressionParams object.

The MRC imaging model represents a document as three different layers: a foreground plane which contains pictures, a mask plane which contains the text and its coloring, and a background plane which contains background pictures or texture. Each layer is compressed separately using the best type of compression for that data type. The MRC technology for PDF (PDF/A) allows you to achieve significantly better file compression without visible degradation of document representation.

The PDFMRCParams object allows you to do the following:

  • set the parameters of compression for background and color mask;
  • change background and text color;
  • manage the availability of PDF layers corresponding to MRC image planes.

All the properties of the PDFMRCParams object are set to reasonable defaults. For more information about the default value of this or that property, see the description of the corresponding property.

Properties

Name Type Description
Common properties
Application Engine, read-only Returns the Engine object.
AssignPdfLayersToMrcPlanes VARIANT_BOOL

This property manages the availability of PDF layers in the output PDF file. If you set it to TRUE, PDF layers are assigned to MRC image planes, so that in some PDF viewers such as Adobe Acrobat you can choose which layers to view.

This property is only taken into account for image-only and image-on-text PDF files.

The default value of this property is FALSE.

Color mask and text mask settings
ColorMaskDownSampling int

Specifies the downsampling rate of the color mask. This property can take a value from 1 to 20.

The default value is 4.

MonochromeText VARIANT_BOOL

Specifies if the recognized text is monochrome. If you set the value of this property to TRUE, you can specify the text color in the TextColor property.

This property affects the whole MRC text mask, which includes not only text, but, for example, table separators as well.

The default value of this property is FALSE.

TextColor int

Specifies the text color in monochrome mode. This property is used only when the MonochromeText property is set to TRUE.

Note: The int value is calculated from the RGB triplet using the formula: (red value) + (256 x green value) + (65536 x blue value), where red value is the first triplet component, green value is the second triplet component, blue value is the third triplet component. For example, the int value of the color white equals 16777215.

By default, this property is 0, which means black text color.

This property affects the whole MRC text mask, which includes not only text, but, for example, table separators as well.

UseBwImageAsTextMask VARIANT_BOOL

When you set this property to TRUE, the binarized image is used as MRC text mask. This setting is recommended for originally black-and-white printed documents with handwritten notes, stamps etc.

The default value of this property is FALSE, and the recognized text area is used as MRC text mask. This setting works better for photos and images with complex background.

UseMultipleMasks VARIANT_BOOL

When you set this property to TRUE, several monochrome masks are used instead of one multicolor background plane and one mask. This increases the printing speed.

Notes:

  • This property is available only for color images.
  • Color grade inside one character is not supported in this mode. The entire character will be of the same color.

The default value is FALSE.

Background settings
KeepBackground VARIANT_BOOL

Specifies if the original background is retained during export to a PDF (PDF/A) file with Mixed Raster Content.

This property is TRUE by default.

BackgroundColor int

Specifies the background color.

Important! This property can be set to any value only if the KeepBackground property is set to FALSE. Otherwise, the original background will be retained.

By default, the value of this property is -1, which means that the background color should be detected automatically based on the original background.

Note: The int value is calculated from the RGB triplet using the formula: (red value) + (256 x green value) + (65536 x blue value), where red value is the first triplet component, green value is the second triplet component, blue value is the third triplet component. For example, the int value of the color white equals 16777215.

BackgroundDownSampling int

Specifies the background downsampling rate. This property can take a value from 1 to 20.

The default value is 2.

ProcessPicturesAsBackground ThreeStatePropertyValueEnum

Specifies whether pictures should be considered a part of background and the background compression options used for the pictures.

The default value of this property is TSPV_Auto. If all the other properties have their default values, the automatic mode will not consider pictures to be part of the background.

Related objects

Object Diagram

See also

Tuning Export Parameters

Working with Profiles

Working with Properties

24.03.2023 8:51:52

Usage of Cookies. In order to optimize the website functionality and improve your online experience ABBYY uses cookies. You agree to the usage of cookies when you continue using this site. Further details can be found in our Privacy Notice.