F_VN_SauvolaThreshold

F_VN_SauvolaThreshold 1:

Apply Sauvola local threshold to source image.

Syntax

Definition:

FUNCTION F_VN_SauvolaThreshold : HRESULT
VAR_INPUT
    ipSrcImage     : ITcVnImage;
    pipDestImage   : Reference To ITcVnImage;
    nBlockSize     : UDINT;
    fParamK        : LREAL;
    fMaxSigma      : LREAL;
    eThresholdType : ETcVnThresholdType;
    hrPrev         : HRESULT;
END_VAR

 Inputs

Name

Type

Description

ipSrcImage

ITcVnImage

Source image (USINT, UINT, INT, REAL, or LREAL, 1 channel)

pipDestImage

Reference To ITcVnImage

Destination image (An appropriate single channel destination image will be created if required.))

nBlockSize

UDINT

Size of the pixel neighborhood to calculate the local threshold (3, 5, 7, ...)

fParamK

LREAL

parameter K which takes positive values in range (0,1). Recommended are K in range [0.2, 0.5]

fMaxSigma

LREAL

Maximum value of the standard deviation, required to be strictly positive. (fMaxSigma = 128 for a grayscale document).

eThresholdType

ETcVnThresholdType

Threshold type to be applied. Supported are TCVN_TT_BINARY and TCVN_TT_BINARY_INV.

hrPrev

HRESULT

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

 Return value

HRESULT

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 PL50, e.g. Intel 4-core Atom CPU

Tc3_Vision