BilateralFilter

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

Syntax

Definition:

HRESULT BilateralFilter(
    HRESULT                        hrPrev,
    ITcVnImage*                    ipSrcImage,
    ITcVnImage*&                   ipDestImage,
    LONG                           nDiameter,
    double                         fSigmaColor,
    double                         fSigmaSpace,
    ETcVnBorderInterpolationMethod eBorderType = BIM_DEFAULT
)

Parameters

Name

Type

Default

Description

hrPrev

HRESULT

 

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

ipSrcImage

ITcVnImage*

 

Source image

ipDestImage

ITcVnImage*&

 

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

nDiameter

LONG

 

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

fSigmaColor

double

 

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

fSigmaSpace

double

 

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

eBorderType

ETcVnBorderInterpolationMethod

BIM_DEFAULT

Image border handling

BilateralFilter 1: Return value

HRESULT

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