F_VN_FuseImages
Fuse 2 images vertically (intended for line scan cameras).
Syntax
Definition:
FUNCTION F_VN_FuseImages : HRESULT
VAR_INPUT
ipSrcImage1 : ITcVnImage;
ipSrcImage2 : ITcVnImage;
ipDestImage : Reference To ITcVnImage;
nFirstLine : UDINT;
nNumLines : UDINT;
hrPrev : HRESULT;
END_VAR
Inputs
|
Name |
Type |
Description |
|---|---|---|
|
ipSrcImage1 |
Source image 1 | |
|
ipSrcImage2 |
Source image 2 | |
|
ipDestImage |
Reference To ITcVnImage |
Destination image |
|
nFirstLine |
UDINT |
Line index in ipSrcImage1, which is the first line in ipDestImage |
|
nNumLines |
UDINT |
The number of lines that should be copied to ipDestImage, starting with nFirstLine in ipSrcImage1. Once the last line of ipSrcImage1 was copied, the remaining lines are copied from ipSrcImage2, starting at line index 0. |
|
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_FuseImages verknüpft zwei Bilder untereinander, sodass ein neues, zusammenhängendes Bild entsteht. Dies ist insbesondere bei Aufnahmen von Zeilenkameras interessant.
Für die Verknüpfung von bis zu 10 Bildern kann die Funktion F_VN_FuseImagesArray genutzt werden.
Anwendung
Zeilenkameras geben meist eine vorgegebene Anzahl nacheinander aufgenommener Zeilen als 2D-Bild zurück. Dieses 2D-Bild kann ein interessantes Objekt (im nachfolgenden Bild grün dargestellt) vollständig enthalten, es kann aber auch nur ein Objektteil (rot dargestellt) im Bild enthalten sein.
Zur vollständigen Analyse des roten Objektes können mit der Funktion F_VN_FuseImages die beiden Bilder mit den Objektteilen zu einem Bild verknüpft werden. Ist bereits bekannt, welche Zeilen das Objekt betreffen, kann die Verknüpfung auch auf die relevanten Zeilen begrenzt werden.
F_VN_FuseImages(ipImage1, ipImage2, ipFusedImage, 6, 7, S_OK);
Beispiele
Verwandte Funktionen
- F_VN_FuseImages zur Verknüpfung von zwei Bildern
- F_VN_FuseImagesArray zur Verknüpfung von bis zu 10 Bildern
Required License
TC3 Vision Base
System Requirements
Development environment | Target platform | PLC libraries to include |
|---|---|---|
TwinCAT V3.1. 4024.44 or later | PC or CX (x64) with PL50, e.g. Intel 4-core Atom CPU | Tc3_Vision |