HistogramEqualization

Equalize the histogram of a grayscale or color image, which normalizes the brightness and improves the contrast. The channel index that should be equalized has to be specified (-1 expects a RGB image, converts it to YCbCr, equalizes the Y channel and converts the image back to RGB).
Can use available TwinCAT Job Tasks for executing parallel code regions.

Syntax

Definition:

HRESULT HistogramEqualization(
    HRESULT      hrPrev,
    ITcVnImage*  ipSrcImage,
    ITcVnImage*& ipDestImage,
    SHORT        nChannelIdx = -1
)

Parameters

Name	Type	Default	Description
hrPrev	HRESULT		HRESULT indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.)
ipSrcImage	ITcVnImage*		Source image
ipDestImage	ITcVnImage*&		Destination image (An appropriate destination image will be created if required.)
nChannelIdx	SHORT	-1	Index of the image channel that should be equalized (-1 expects a RGB image, converts it to YCbCr, equalizes the Y channel and converts the image back to RGB)

Return value

HRESULT

Required License

TC3 Vision Base

System Requirements

Development environment	Target platform	PLC libraries to include
TwinCAT V3.1. 4024.44 or later	PC or CX (x64) with PL50, e.g. Intel 4-core Atom CPU	Tc3_Vision