이 메서드는 이미지에서 지정한 색조의 모든 색상 객체를 제거하고, 이를 지정한 색으로 바꿉니다. 또한 추출된 객체만 포함된 별도의 이미지를 저장할 수도 있습니다.
이 메서드는 컬러 이미지에만 사용할 수 있습니다.
HRESULT RemoveColorObjectsEx(
IIntsCollection* ColorHues,
int BackgroundColor,
IImage** ColorLayer
);
Image RemoveColorObjectsEx(
IIntsCollection ColorHues,
int BackgroundColor
);
Function RemoveColorObjectsEx( _
ColorHues As IIntsCollection, _
BackgroundColor As Integer _
) As Image
ColorHues
[in] 필터링해야 하는 객체의 색조 값 모음을 HSL 표현으로 포함하는 IntsCollection 객체를 나타냅니다. 이 매개변수에 null을 전달할 수 있으며, 이 경우 모든 색상 객체가 제거되고 회색조 이미지만 남습니다.
색조를 지정하는 숫자는 0~255 범위여야 합니다. 값 0은 빨간색, 43은 노란색, 85는 초록색, 171은 파란색, 213은 보라색에 해당합니다.
BackgroundColor
[in] 제거된 색상 객체를 대체할 색상을 지정합니다. 이 매개변수에 -1을 전달하면 배경색이 자동으로 결정됩니다.
ColorLayer
[out, retval] 추출된 색상 객체를 포함하는 출력 Image 객체의 인터페이스 포인터를 받는 IImage* 포인터 변수를 가리키는 포인터입니다.
이 메서드에는 별도의 반환 값이 없습니다. ABBYY FineReader 엔진 함수의 표준 반환 값을 반환합니다.
이 메서드는 ImageDocument의 색상 이미지 평면에 색상 필터링을 적용합니다. 나머지 모든 페이지는 ImageDocument에서 삭제되며, 필요할 때 다시 생성됩니다.
이미지를 인식하기 전에 동일한 방식의 색상 객체 필터링을 수행하고, 내보내기 전에 이를 자동으로 복원할 수 있는 특수한 전처리 모드도 있습니다: IPageProcessingParams::ProhibitColorObjectsAtProcessing. 사용 시나리오에 가장 적합한 설정을 선택하십시오.
ImageDocument