F_VN_CopyImageRegion

F_VN_CopyImageRegion 1:

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

F_VN_CopyImageRegion 2: 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.)

F_VN_CopyImageRegion 3: 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.

F_VN_CopyImageRegion 4:

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

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