此方法向 ImageModification 对象的“替换白色像素”区域内部数组中添加一个新的“替换白色像素”区域。要移除之前添加的所有“替换白色像素”区域,请调用 IImageModification::ClearReplaceWhitePixelsRegions 方法。如果该修改需要应用于图像的单个 彩色 (或 灰度) 平面,则区域坐标应在该彩色 (灰度) 平面上指定。如果该修改需要应用于整个 ImageModification,则坐标应在已纠偏的 黑白 图像平面上指定。
HRESULT AddReplaceWhitePixelsRegion(
IRegion* Region,
int Color,
int StrokesExpansion
);
void AddReplaceWhitePixelsRegion(
IRegion Region,
int Color,
int StrokesExpansion
);
Sub AddReplaceWhitePixelsRegion( _
Region As IRegion, _
Color As Integer, _
[StrokesExpansion As Integer = 0] _
)
Region
[in] 此 Parameter 的类型为 Region,用于指定要添加的“replace white pixels”区域。
Color
[in] 此变量指定用于替换白色像素的颜色。此 Parameter 的值可以为 -1,表示该颜色为透明色。
int 值根据 RGB 三元组按以下公式计算:( 红色值 ) + (256 x 绿色值 ) + (65536 x 蓝色值 ),其中红色值是三元组的第一个分量,绿色值是第二个分量,蓝色值是第三个分量。例如,白色的 int 值等于 16777215。
StrokesExpansion
[in] 此变量指定在替换前图像中黑色区域的扩展量 (以像素为单位) 。此 Parameter 必须为非负值。
此方法没有特定的返回值,返回 ABBYY FineReader Engine 函数的标准返回值。
当应用 IImageDocument::Modify 方法时,“替换白色像素”区域内的图像上的白色像素将被替换为指定颜色的像素。此操作在 black-and-white 图像平面上执行,但结果也会应用到 gray 和 color 图像平面。
ImageModification
ClearReplaceWhitePixelsRegions