UprightInnerRectangle

Computes the maximum area upright inner rectangle inside an area.
Can use available TwinCAT Job Tasks for executing parallel code regions.
Can return partial results when canceled by Watchdog.

Syntax

Definition:

HRESULT UprightInnerRectangle(
    HRESULT             hrPrev,
    ITcVnImage*         ipSrcImage,
    TcVnRectangle_DINT& stRectangle,
    LONG                nDownScaleFactor = -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 (USINT, 1 channel, binary, values > 0 mark valid area)
stRectangle	TcVnRectangle_DINT&		Returns the maximum area upright inner rectangle
nDownScaleFactor	LONG	-1	To tradeoff performance vs. accuracy, a factor can be provided, to reduce the internally used image resolution. As long as invalid areas enclosed in the valid area are larger than nDownScaleFactor, the result usually still is the optimal one. Use -1 to auto select depending on ipSrcImage resolution, 0 to always use full resolution (slower but always optimal result).

Return value

HRESULT

Required License

TC3 Vision Base

System Requirements

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