F_VN_BilateralFilterExp

F_VN_BilateralFilterExp 1:

Apply a Bilateral filter to smooth the image but preserve edges. (expert function)
Can use available TwinCAT Job Tasks for executing parallel code regions.

Syntax

Definition:

FUNCTION F_VN_BilateralFilterExp : HRESULT
VAR_INPUT
    ipSrcImage  : ITcVnImage;
    ipDestImage : Reference To ITcVnImage;
    nDiameter   : DINT;
    fSigmaColor : LREAL;
    fSigmaSpace : LREAL;
    eBorderType : ETcVnBorderInterpolationMethod;
    hrPrev      : HRESULT;
END_VAR

F_VN_BilateralFilterExp 2: Inputs

Name

Type

Description

ipSrcImage

ITcVnImage

Source image

ipDestImage

Reference To ITcVnImage

Destination image (Must be different from ipSrcImage! An appropriate destination image will be created if required.)

nDiameter

DINT

Diameter of the pixel neighborhood used for filtering (e.g. 5, 7, 9). If <= 0, it is automatically chosen dependend on fSigmaSpace.

fSigmaColor

LREAL

Sigma used for color space filtering (> 0). A larger value means that farther colors are mixed together.

fSigmaSpace

LREAL

Sigma used for coordinate space filtering (> 0). A larger value means that farther pixels can influence each other.

eBorderType

ETcVnBorderInterpolationMethod

Image border handling

hrPrev

HRESULT

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

F_VN_BilateralFilterExp 3: Return value

HRESULT

Weiterführende Informationen

Die Funktion F_VN_BilateralFilterExp ist die Expert-Variante von F_VN_BilateralFilter. Sie enthält zusätzliche Parameter.

Parameter

Originalbild

Das Originalbild ipSrcImage muss vom Element-Typ TCVN_ET_USINT oder einem Fließkomma-Typ sein und 1 oder 3 Kanäle besitzen.

Ergebnisbild

Das Ergebnisbild ipDestImage muss ein anderer Interface Pointer als das Originalbild ipSrcImage sein!

Filter-Durchmesser

Der Filter-Durchmesser nDiameter bestimmt die Größe eines Filterbereichs. Es wird ein ungerader Wert erwartet. Wenn nDiameter = 0 ist, dann wird der Filter-Durchmesser automatisch auf Basis von fSigmaSpace berechnet.

Farb-Bereich

Dieser Wert darf nicht 0 sein.

Raum-Bereich

Dieser Wert darf nicht 0 sein.

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

Eine Anwendung dieser Funktion kann z. B. wie folgt aussehen:

hr := F_VN_BilateralFilterExp(
    ipSrcImage      :=  ipImage,
    ipDestImage     :=  ipImageRes,
    nDiameter       :=  nDiameter,
    fSigmaColor     :=  fSigmaColor,
    fSigmaSpace     :=  fSigmaSpace,
    eBorderType     :=  eBorderType,
    hrPrev          :=  hr
);

Beispiele

Required License

TC3 Vision Base

System Requirements

Development environment

Target platform

PLC libraries to include

TwinCAT V3.1.4024.54 or later

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

Tc3_Vision