F_VN_CustomFilterExp
Apply a custom filter to the image. (expert function)
Syntax
Definition:
FUNCTION F_VN_CustomFilterExp : HRESULT
VAR_INPUT
ipSrcImage : ITcVnImage;
ipDestImage : Reference To ITcVnImage;
eDestDepth : ETcVnElementType;
END_VAR
VAR_IN_OUT
stKernel : TcVnMatrix;
aAnchor : TcVnPoint;
END_VAR
VAR_INPUT
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 | |
|
fDelta |
LREAL |
Value added to each pixel after filtering |
|
eBorderType |
Image border handling | |
|
hrPrev |
HRESULT indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.) |
In/Outputs
|
Name |
Type |
Description |
|---|---|---|
|
stKernel |
Custom filter kernel with values of type REAL or LREAL | |
|
aAnchor |
Anchor point of the kernel |
Return valueWeiterführende Informationen
Die Funktion F_VN_CustomFilterExp ist die Expert-Variante von F_VN_CustomFilter. Sie enthält zusätzliche Parameter.
Parameter
Eingangsbild
Das Eingangsbild ipSrcImage darf jedes verfügbare Format haben.
Ergebnisbild
Das Ergebnisbild ipDestImage hat das gleiche Format wie das Eingangsbild ipSrcImage.
Ergebnistiefe
Die Ergebnistiefe eDestDepth definiert, welchen Element-Typ das Ergebnisbild ipDestImage hat. Ein größerer Element-Typ kann mehr Informationen darstellen.
Filter-Kernel
Der benutzerdefinierte Filter-Kernel stKernel wird als Matrix übergeben. Erlaubte Element-Typen der Matrix sind TCVN_ET_REAL und TCVN_ET_LREAL. Eine entsprechende Matrix vom Typ TcVnMatrix kann mit Hilfe der Funktion F_VN_InitMatrixStruct erstellt werden.
Ankerpunkt
Der Ankerpunkt aAnchor definiert, welcher Punkt des Filter-Kernels über jedes Pixel des Eingangsbildes ipSrcImage bewegt wird.
Delta
Das konstante Delta fDelta wird auf das Ergebnis der Filter-Operation addiert.
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_CustomFilterExp(
ipSrcImage := ipImageIn,
ipDestImage := ipImageRes,
eDestDepth := TCVN_ET_USINT,
stKernel := stKernelMatrix,
aAnchor := aAnchorPoint,
fDelta := 0,
eBorderType := TCVN_BIM_DEFAULT,
hrPrev := hr
);Beispiele
- Benutzerdefinierte Filter
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 min. PL50, e.g. Intel 4-core Atom CPU | Tc3_Vision |