F_VN_SobelFilterExp
Calculates the first, second, third, or mixed image derivatives using an extended Sobel filter. (expert function)
Syntax
Definition:
FUNCTION F_VN_SobelFilterExp : HRESULT
VAR_INPUT
ipSrcImage : ITcVnImage;
ipDestImage : Reference To ITcVnImage;
eDestDepth : ETcVnElementType;
nXOrder : UDINT;
nYOrder : UDINT;
nKernelSize : UDINT;
fScale : LREAL;
fDelta : LREAL;
eBorderType : ETcVnBorderInterpolationMethod;
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 | |
|
nXOrder |
UDINT |
Order of the x-derivative (must be < nKernelSize) |
|
nYOrder |
UDINT |
Order of the y-derivative (must be < nKernelSize) |
|
nKernelSize |
UDINT |
Size of the extended Sobel kernel (3, 5, 7, ..., 31) |
|
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 |
Image border handling | |
|
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_SobelFilterExp ist die Expert-Variante von F_VN_SobelFilter. 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.
Ableitungsordnung
Die Ableitungsordnungen nXOrder und nYOrder definieren, die wievielte Ableitung in X- und Y-Richtung verwendet werden soll, um den Filter zu erstellen.
Kernel-Größe
Die Größe nKernelSize des Sobel-Kernels bestimmt, wie groß der Bereich ist, der den Ergebniswert eines Pixels beeinflusst.
Skalierung
Das Ergebnis der Sobel-Operation wird mit dem Skalierungsfaktor fScale multipliziert.
Delta
Das konstante Delta fDelta wird auf das Ergebnis der Sobel-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_SobelFilterExp(
ipSrcImage := ipImageIn,
ipDestImage := ipImageRes,
eDestDepth := TCVN_ET_USINT,
nXOrder := 1,
nYOrder := 1,
nKernelSize := 3,
fScale := 1,
fDelta := 0,
eBorderType := TCVN_BIM_DEFAULT,
hrPrev := hr,
);
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 |