F_VN_CopyImageRegion

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	ITcVnImage	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	HRESULT indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.)

Return value

HRESULT

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,
);

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