F_VN_UprightInnerRectangleExp
Computes the maximum area upright inner rectangle inside an area. (expert function)
Can use available TwinCAT Job Tasks for executing parallel code regions.
Can return partial results when canceled by Watchdog.
Syntax
Definition:
FUNCTION F_VN_UprightInnerRectangleExp : HRESULT
VAR_INPUT
ipSrcImage : ITcVnImage;
END_VAR
VAR_IN_OUT
stRectangle : TcVnRectangle_DINT;
END_VAR
VAR_INPUT
nDownScaleFactor : DINT;
hrPrev : HRESULT;
END_VARInputs
|
Name |
Type |
Description |
|---|---|---|
|
ipSrcImage |
Source image (USINT, 1 channel, binary, values > 0 mark valid area) | |
|
nDownScaleFactor |
DINT |
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). |
|
hrPrev |
HRESULT indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.) |
In/Outputs
|
Name |
Type |
Description |
|---|---|---|
|
stRectangle |
Returns the maximum area upright inner rectangle |
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 |