F_VN_ScharrFilter

F_VN_ScharrFilter 1:

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

F_VN_ScharrFilter 2: Inputs

Name

Type

Description

ipSrcImage

ITcVnImage

Source image

ipDestImage

Reference To ITcVnImage

Destination image (An appropriate destination image will be created if required.)

eDestDepth

ETcVnElementType

Destination image depth

eFilterDirection

ETcVnFilterDirection

Filter direction

hrPrev

HRESULT

HRESULT indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.)

F_VN_ScharrFilter 3: Return value

HRESULT

Weiterfü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.

F_VN_ScharrFilter 4:

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

F_VN_ScharrFilter 5:

F_VN_ScharrFilter 6:

Beispiele

Required License

TC3 Vision Base

System Requirements

Development environment

Target platform

PLC libraries to include

TwinCAT V3.1.4024.59 or later

PC or CX (x64) with PL50, e.g. Intel 4-core Atom CPU

Tc3_Vision