F_VN_CopyImageRegion
Deep copy the specified region of interest into a new image.
Syntax
Definition:
FUNCTION F_VN_CopyImageRegion : HRESULT
VAR_INPUT
ipSrcImage : ITcVnImage;
nX : UDINT;
nY : UDINT;
nWidth : UDINT;
nHeight : UDINT;
ipDestImage : Reference To ITcVnImage;
hrPrev : HRESULT;
END_VAR
Inputs
Name |
Type |
Description |
---|---|---|
ipSrcImage |
Source image | |
nX |
UDINT |
Left boundary (inclusive 0-based index) |
nY |
UDINT |
Upper boundary (inclusive 0-based index) |
nWidth |
UDINT |
ROI width |
nHeight |
UDINT |
ROI height |
ipDestImage |
Reference To ITcVnImage |
Destination image (An appropriate destination image will be created if required.) |
hrPrev |
HRESULT indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.) |
Weiterführende Informationen
Die Funktion F_VN_CopyImageRegion
erstellt eine tiefe Kopie eines Bildausschnitts des Eingangsbilds ipSrcImage
. Der Bildausschnitt wird wie bei einer ROI durch ein Rechteck mit Position und Größe angegeben.
Rechenzeitoptimierung Prüfen Sie in Bezug auf Rechenzeitoptimierung jede Bildkopie auf ihre Notwendigkeit. |
Wenn keine Kopie benötigt wird, sondern nur der Bildausschnitt verkleinert werden soll, kann stattdessen eine Region of Interest gesetzt werden.
Anwendung
Das Kopieren eines Bildbereichs der Größe [240, 120]
mit oberer linker Ecke an Position [50, 50]
sieht z. B. so aus:
hr := F_VN_CopyImageRegion(
ipSrcImage := ipImageIn,
nX := 50,
nY := 50,
nWidth := 240,
nHeight := 120,
ipDestImage := ipImageWork,
hrPrev := hr,
);
Verwandte Funktionen
- F_VN_CopyImage zum Kopieren des gesamten Bildes
- F_VN_CopyImageRegion zum Kopieren eines Bildbereichs
- F_VN_CopyImageRegionToRegion zum Kopieren eines Bildbereichs an eine bestimmte Position
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 |