F_VN_SetRoi_TcVnRectangle_UDINT
Sets a region of interest (ROI) within an image.
Syntax
Definition:
FUNCTION F_VN_SetRoi_TcVnRectangle_UDINT : HRESULT
VAR_IN_OUT
stRoi : TcVnRectangle_UDINT;
END_VAR
VAR_INPUT
ipDestImage : ITcVnImage;
hrPrev : HRESULT;
END_VAR
Inputs
|
Name |
Type |
Description |
|---|---|---|
|
ipDestImage |
Destination image | |
|
hrPrev |
HRESULT indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.) |
Return valueWeiterführende Informationen
Die Funktion F_VN_SetRoi_TcVnRectangle_UDINT setzt wie die Funktion F_VN_SetRoi, eine Region of Interest. Sie nimmt die Rechteck-Parameter allerdings nicht einzeln, sondern als Struktur vom Typ TcVnRectangle_UDINT entgegen.
Dies ermöglicht es zum Beispiel, mit dem Ergebnis der Funktion F_VN_UprightBoundingRectangle direkt die ROI zu setzen.
Anwendung
Das Setzen einer ROI um eine gefundene Kontur sieht z. B.: so aus:
hr := F_VN_UprightBoundingRectangle(ipContour, stRoi, hr);
hr := F_VN_SetRoi_TcVnRectangle_UDINT(stRoi, ipImageWork, hr);
Verwandte Funktionen
- F_VN_SetRoi zum Setzen einer Region of Interest
- F_VN_GetRoi zum Abrufen der gesetzten Region of Interest
- F_VN_ResetRoi zum Zurücksetzen der Region of Interest auf das gesamte Bild
- F_VN_CopyImageRegion zum Kopieren eines Bildausschnitts
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 |