ClassesClassesClassesClasses | | | | Operators

info_smoothT_info_smoothInfoSmoothinfo_smoothInfoSmoothInfoSmooth (Operator)

Name

info_smoothT_info_smoothInfoSmoothinfo_smoothInfoSmoothInfoSmooth — Information on smoothing filter smooth_imagesmooth_imageSmoothImagesmooth_imageSmoothImageSmoothImage.

Signature

info_smooth( : : Filter, Alpha : Size, Coeffs)

Herror T_info_smooth(const Htuple Filter, const Htuple Alpha, Htuple* Size, Htuple* Coeffs)

Herror info_smooth(const HTuple& Filter, const HTuple& Alpha, HTuple* Size, HTuple* Coeffs)

void InfoSmooth(const HTuple& Filter, const HTuple& Alpha, HTuple* Size, HTuple* Coeffs)

static Hlong HMisc::InfoSmooth(const HString& Filter, double Alpha, HTuple* Coeffs)

static Hlong HMisc::InfoSmooth(const char* Filter, double Alpha, HTuple* Coeffs)

void HOperatorSetX.InfoSmooth(
[in] VARIANT Filter, [in] VARIANT Alpha, [out] VARIANT* Size, [out] VARIANT* Coeffs)

Hlong HMiscX.InfoSmooth(
[in] BSTR Filter, [in] double Alpha, [out] VARIANT* Coeffs)

static void HOperatorSet.InfoSmooth(HTuple filter, HTuple alpha, out HTuple size, out HTuple coeffs)

static int HMisc.InfoSmooth(string filter, double alpha, out HTuple coeffs)

Description

The operator info_smoothinfo_smoothInfoSmoothinfo_smoothInfoSmoothInfoSmooth returns an estimation of the width of the smoothing filters used in routine smooth_imagesmooth_imageSmoothImagesmooth_imageSmoothImageSmoothImage. For this purpose the underlying continuous impulse answers of FilterFilterFilterFilterFilterfilter are scanned until a filter coefficient is smaller than five percent of the maximum coefficient (at the origin). AlphaAlphaAlphaAlphaAlphaalpha is the filter parameter (see smooth_imagesmooth_imageSmoothImagesmooth_imageSmoothImageSmoothImage). Currently four filters are supported (parameter FilterFilterFilterFilterFilterfilter):

            'deriche1', 'deriche2', 'shen' and 'gauss'.
The gauss filter was conventionally implemented with filter masks (the other three are recursive filters). In the case of the gauss filter the filter coefficients (of the one-dimensional impulse answer ) are returned in CoeffsCoeffsCoeffsCoeffsCoeffscoeffs in addition to the filter size.

Parallelization

Parameters

FilterFilterFilterFilterFilterfilter (input_control)  string HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Name of required filter.

Default value: 'deriche2' "deriche2" "deriche2" "deriche2" "deriche2" "deriche2"

List of values: 'deriche1'"deriche1""deriche1""deriche1""deriche1""deriche1", 'deriche2'"deriche2""deriche2""deriche2""deriche2""deriche2", 'gauss'"gauss""gauss""gauss""gauss""gauss", 'shen'"shen""shen""shen""shen""shen"

AlphaAlphaAlphaAlphaAlphaalpha (input_control)  real HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Filter parameter: small values effect strong smoothing (reversed in case of 'gauss').

Default value: 0.5

Suggested values: 0.5, 1.0, 1.5, 2.0, 2.5, 3.0, 4.0, 5.0, 7.0, 10.0

Typical range of values: 0.01 ≤ Alpha Alpha Alpha Alpha Alpha alpha ≤ 50.0

Minimum increment: 0.01

Recommended increment: 0.1

Restriction: Alpha > 0.0

SizeSizeSizeSizeSizesize (output_control)  integer HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Width of filter is approx. size x size pixels.

CoeffsCoeffsCoeffsCoeffsCoeffscoeffs (output_control)  integer-array HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

In case of gauss filter: coefficients of the “positive” half of the 1D impulse answer.

Example (HDevelop)

info_smooth('deriche2',0.5,Size,Coeffs)
smooth_image(Input,Smooth,'deriche2',7)

Example (C)

info_smooth('deriche2',0.5,Size,Coeffs);
smooth_image(Input,&Smooth,'deriche2',7);

Example (HDevelop)

info_smooth('deriche2',0.5,Size,Coeffs)
smooth_image(Input,Smooth,'deriche2',7)

Example (HDevelop)

info_smooth('deriche2',0.5,Size,Coeffs)
smooth_image(Input,Smooth,'deriche2',7)

Example (HDevelop)

info_smooth('deriche2',0.5,Size,Coeffs)
smooth_image(Input,Smooth,'deriche2',7)

Example (HDevelop)

info_smooth('deriche2',0.5,Size,Coeffs)
smooth_image(Input,Smooth,'deriche2',7)

Result

If the parameter values are correct the operator info_smoothinfo_smoothInfoSmoothinfo_smoothInfoSmoothInfoSmooth returns the value 2 (H_MSG_TRUE). Otherwise an exception is raised.

Possible Predecessors

read_imageread_imageReadImageread_imageReadImageReadImage

Possible Successors

smooth_imagesmooth_imageSmoothImagesmooth_imageSmoothImageSmoothImage

See also

smooth_imagesmooth_imageSmoothImagesmooth_imageSmoothImageSmoothImage

Module

Foundation


ClassesClassesClassesClasses | | | | Operators