F_VN_ScharrFilter
Calculates the first order derivative in x or y direction using a Scharr filter.
Syntax
Definition:
FUNCTION F_VN_ScharrFilter : HRESULT
VAR_INPUT
ipSrcImage : ITcVnImage;
ipDestImage : Reference To ITcVnImage;
eDestDepth : ETcVnElementType;
eFilterDirection : ETcVnFilterDirection;
hrPrev : HRESULT;
END_VAR
Inputs
|
Name |
Type |
Description |
|---|---|---|
|
ipSrcImage |
Source image | |
|
ipDestImage |
Reference To ITcVnImage |
Destination image (An appropriate destination image will be created if required.) |
|
eDestDepth |
Destination image depth | |
|
eFilterDirection |
Filter direction | |
|
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_ScharrFilter wendet einen Scharr-Filter auf das Eingangsbild an. Der Scharr-Filter funktioniert analog zum Sobel-Filter und unterscheidet sich von diesem nur durch den Kernel.
Algorithmus
Der Scharr-Filter ist eng mit dem Sobel-Filter verwandt. Er liefert jedoch genauere Ergebnisse als ein 3 x 3 Sobel-Filter.
Parameter
Originalbild
Das Originalbild ipSrcImage kann jedes verfügbare Format haben.
Ergebnisbild
Das Ergebnisbild ipDestImage liefert das Filter-Ergebnis zurück und besitzt das gleiche Format wie das Originalbild ipSrcImage.
Ergebnistiefe
Die Ergebnistiefe eDestDepth definiert, welchen Element-Typ das Ergebnisbild ipDestImage hat. Ein größerer Element-Typ kann mehr Informationen darstellen.
Filter-Richtung
Die Filter-Richtung eFilterDirection definiert, ob der Scharr-Filter in X-Richtung (TCVN_FD_X) oder in Y-Richtung (TCVN_FD_Y) auf das Bild angewandt wird.
Expert-Parameter
Weitere Parameter finden Sie in der Expert-Variante F_VN_ScharrFilterExp.
Anwendung
hr := F_VN_ScharrFilter(
ipSrcImage := ipImageIn,
ipDestImage := ipImageRes,
eDestDepth := TCVN_ET_USINT,
eFilterDirection:= TCVN_FD_X,
hrPrev := hr,
);
Originalbild | Ergebnisbild |
|
|
Beispiele
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 |