F_VN_AdjustActiveContour

Adjust active contour (snake) in order to minimize its cummulative (internal and external) energy.

Syntax

Definition:

FUNCTION F_VN_AdjustActiveContour : HRESULT
VAR_INPUT
    ipImage         : ITcVnImage;
    ipActiveContour : ITcVnContainer;
    fAlpha          : REAL;
    fBeta           : REAL;
    fGamma          : REAL;
    nWindowWidth    : UDINT;
    nWindowHeight   : UDINT;
    nMaxIterations  : UDINT;
    bUseGradient    : BOOL;
    hrPrev          : HRESULT;
END_VAR

Inputs

Name	Type	Description
ipImage	ITcVnImage	Source image (1 channel, USINT elements)
ipActiveContour	ITcVnContainer	Initial contour, which will be adjusted
fAlpha	REAL	Continuity energy coefficient
fBeta	REAL	Curvature energy coefficient
fGamma	REAL	Image energy coefficient
nWindowWidth	UDINT	Window width (3, 5, 7, ...)
nWindowHeight	UDINT	Window height (3, 5, 7, ...)
nMaxIterations	UDINT	Maximum iterations
bUseGradient	BOOL	If true, the gradient magnitude is used as image energy (otherwise: pixel intensity)
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