This function automatically detects areas of white text on black backgrounds in 1-bit images, and inverts them so that they become black text on white backgrounds.
Declaration:
 Copy Code |
|
|---|---|
AT_ERRCOUNT IG_IC_invert_white_text (
HIGEAR hIGear,
INT MinX,
INT MinY,
INT MinT
);
|
|
Arguments:
| hIGear | HIGEAR handle of image. |
| MinX | Minimal width of the region to be considered. |
| MinY | Minimum height of the region to be considered. |
| MinT | Minimum "thickness" of spaces that fall in between sections of text that will be inverted. |
Return Value:
Returns the number of ImageGear errors that occurred during this function call.
Supported Raster Image Formats:
Indexed RGB – 1 bpp.
Sample:
ImageClean
Remarks:
This function scans your entire image and makes adjustments to all areas of white text on black that fall within the scope of your settings.
The arguments MinX and MinY tell ImageGear the minimum width and height (respectively) for areas that you would like to invert. For example, if you set MinX = 60 and MinY = 20, ImageGear will only invert sections of white text on black background that have a minimum width of 60 pixels and a minimum height of 20 pixels. The third argument of this function, MinT, sets the minimum "thickness" of spaces that fall in-between sections of text that will be inverted. This minimum value tells ImageGear what sections of text should be treated as all one section based on how close they are to one another. As an example: let's say you have three adjacent sections of white text on black backgrounds that contain the words: "There" "is" "hope." If "There" and "hope" meet your minimum size requirements they will be inverted. If "is" is below your minimum size requirements and you have not set MinT, "is" will note be inverted and your final result will be that "There" and "hope" look normal, while "is" remains as white text on black background. To keep this from happening (if you so desire), you would need to set MinT to a value small enough to include the spaces before and after the word "is". This way all the words would be treated as one section and inverted together.
Refer to the Component Manager API section.
See also IG_IC_invert_white_text_ex() function.