F_VN_NormalizeImageExp

Normalize an image regarding its value range (e.g. stretch pixel values [50..150] to full range [0..255]) or scale the values regarding a specific normalization (e.g. L2-norm). (expert function)

Syntax

Definition:

FUNCTION F_VN_NormalizeImageExp : HRESULT
VAR_INPUT
    ipSrcImage  : ITcVnImage;
    ipDestImage : Reference To  ITcVnImage;
    fAlpha      : LREAL;
    fBeta       : LREAL;
    eNormType   : ETcVnNormalizationType;
    eDestType   : ETcVnElementType;
    ipMask      : ITcVnImage;
    hrPrev      : HRESULT;
END_VAR

Inputs

Name	Type	Description
ipSrcImage	ITcVnImage	Source image
ipDestImage	Reference To ITcVnImage	Destination image (An appropriate destination image will be created if required.)
fAlpha	LREAL	Lower range boundary (in case of normalizing the value range) or value to normalize to (\|\|ipDestImage\|\| = fAlpha)
fBeta	LREAL	Upper range boundary (in case of normalizing the value range)
eNormType	ETcVnNormalizationType	Normalization type (only INF, L1, L2 or MINMAX)
eDestType	ETcVnElementType	Destination image depth (usually SAME_AS_SOURCE)
ipMask	ITcVnImage	Mask to restrict the normalization to specific pixel positions (set 0 to normalize the whole image)
hrPrev	HRESULT	HRESULT indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.)

Return value

HRESULT

Required License

TC3 Vision Base

System Requirements

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