F_VN_ScharrFilterExp

Syntax

Definition:

FUNCTION F_VN_ScharrFilterExp : HRESULT
VAR_INPUT
    ipSrcImage       : ITcVnImage;
    ipDestImage      : Reference To  ITcVnImage;
    eDestDepth       : ETcVnElementType;
    eFilterDirection : ETcVnFilterDirection;
    fScale           : LREAL;
    fDelta           : LREAL;
    eBorderType      : ETcVnBorderInterpolationMethod;
    hrPrev           : HRESULT;
END_VAR

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
fScale	LREAL	Scale factor for the computed derivative values
fDelta	LREAL	Delta value that is added to the results prior to storing them in dest
eBorderType	ETcVnBorderInterpolationMethod	Image border handling
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_ScharrFilterExp ist die Expert-Variante von F_VN_ScharrFilter. Sie enthält zusätzliche Parameter.

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.

Skalierung

Das Ergebnis der Scharr-Operation wird mit dem Skalierungsfaktor fScale multipliziert.

Delta

Das konstante Delta fDelta wird auf das Ergebnis der Scharr-Operation nach Skalierung mit fScale dazuaddiert.

Rand-Extrapolation

Die Art der Rand-Extrapolation eBorderType definiert, wie nichtexistente Pixel über die Bildgrenze hinaus extrapoliert werden, um die Filterwerte an den Bildgrenzen auszurechnen. Für weitere Details siehe ETcVnBorderInterpolationMethod.

Anwendung

hr := F_VN_ScharrFilterExp(
    ipSrcImage      :=  ipImageIn,
    ipDestImage     :=  ipImageRes,
    eDestDepth      :=  TCVN_ET_USINT,
    eFilterDirection:=  TCVN_FD_X,
    fScale          :=  1,
    fDelta          :=  0,
    eBorderType     :=  TCVN_BIM_DEFAULT,
    hrPrev          :=  hr,
);

Beispiele

Kantendetektionsfilter

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