Flags

Flags that determine the behavior of the inverted text removal process. Flags may be combined using a bitwise OR (|). Possible values are:

Value

Meaning

INVERTEDTEXT_SINGLE_REGION:

For each inverted text segment found by the InvertedText method, if the DocCleanSuccess property is set to SUCCESS_REMOVE, the inverted text is added to an internal single region. If the DocCleanSuccess property is set to SUCCESS_NOREMOVE, the inverted text is not added to the single region. When the InvertedText method returns, either

 

1. LEADRasterView.Raster will contain a region that contains all corrected Inverted text. This is the case if the INVERTEDTEXT_LEAD_REGION has also been set. This region can be destroyed using the DeleteRgnHandle method of LEADRasterView.Raster or

 

2. the hDocCleanRgn property will reference a Windows region that contains all the corrected Inverted text. This is the case if the INVERTEDTEXT_LEAD_REGION has NOT been set. When hDocCleanRgn is no longer needed, it must be destroyed.

 

When the region (either LEAD or Windows) is no longer needed, it must be destroyed.

INVERTEDTEXT_LEAD_REGION

This flag must be used in conjunction with INVERTEDTEXT_LEAD_SINGLE_REGION. If this flag is set, the LEADRasterView.Raster will contain a region that contains all corrected Inverted text when the InvertedText method returns. This region can be destroyed using the DeleteRgnHandle method of LEADRasterView.Raster.

INVERTEDTEXT_IMAGE_UNCHANGED

The original image is unchanged.

INVERTEDTEXT_USE_DPI

The unit of measure for all parameters of this method is thousandths of an inch. Use the image's DPI to convert to pixels. This allows the processing of many images with different DPI. If this flag is not set, the unit of measure is pixels.

INVERTEDTEXT_CALLBACK_REGION

The InvertedText event receives a Windows region that contains the current inverted text to be inverted. Setting this flag lets the user create his or her own composite of inverted text by combining the regions received by the InvertedText event, if the event returns SUCCESS_REMOVE. The regions can be combined using a logical OR operator. Combining all regions received by the event, that are removed, results in a region identical to the region created when INVERTEDTEXT_SINGLE_REGION is set in uFlags. When the region received by the event is no longer needed, it must be destroyed.

INVERTEDTEXT_USE_DIAGONALS

Considers pixels that are diagonal to the inverted text as part of the inverted text.