HALCON Reference Manual 10.0.2
Table of Contents / Filters / Edges ClassesClassesClasses | | | Operators

frei_ampfrei_ampfrei_ampFreiAmpFreiAmp (Operator)

Name

frei_ampfrei_ampfrei_ampFreiAmpFreiAmp — Detect edges (amplitude) using the Frei-Chen operator.

Signature

frei_amp(Image : ImageEdgeAmp : : )

Herror frei_amp(const Hobject Image, Hobject* ImageEdgeAmp)

Herror T_frei_amp(const Hobject Image, Hobject* ImageEdgeAmp)

Herror frei_amp(Hobject Image, Hobject* ImageEdgeAmp)

HImage HImage::FreiAmp() const

HImageArray HImageArray::FreiAmp() const

void HOperatorSetX.FreiAmp(
[in] IHUntypedObjectX* Image, [out] IHUntypedObjectX*ImageEdgeAmp)

IHImageX* HImageX.FreiAmp()

static void HOperatorSet.FreiAmp(HObject image, out HObject imageEdgeAmp)

HImage HImage.FreiAmp()

Description

frei_ampfrei_ampfrei_ampFreiAmpFreiAmp calculates an approximation of the first derivative of the image data and is used as an edge detector. The filter is based on the following filter masks:

  A =
         1       sqrt(2)        1
         0          0           0
        -1      -sqrt(2)       -1

  B =
         1          0          -1
       sqrt(2)      0       -sqrt(2)
         1          0          -1

The result image contains the maximum response of the masks A and B.

Parallelization

Parameters

ImageImageImageImageimage (input_object)  (multichannel-)image(-array) objectHImageHImageHImageXHobject (byte / int2 / uint2)

Input image.

ImageEdgeAmpImageEdgeAmpImageEdgeAmpImageEdgeAmpimageEdgeAmp (output_object)  (multichannel-)image(-array) objectHImageHImageHImageXHobject * (byte / int2 / uint2)

Edge amplitude (gradient magnitude) image.

Example (HDevelop)

read_image(Image,'fabrik')
frei_amp(Image,Frei_amp)
threshold(Frei_amp,Edges,128,255)

Example (C)

read_image(&Image,"fabrik");
frei_amp(Image,&Frei_amp);
threshold(Frei_amp,&Edges,128,255);

Example (HDevelop)

read_image(Image,'fabrik')
frei_amp(Image,Frei_amp)
threshold(Frei_amp,Edges,128,255)

Example (HDevelop)

read_image(Image,'fabrik')
frei_amp(Image,Frei_amp)
threshold(Frei_amp,Edges,128,255)

Example (HDevelop)

read_image(Image,'fabrik')
frei_amp(Image,Frei_amp)
threshold(Frei_amp,Edges,128,255)

Result

frei_ampfrei_ampfrei_ampFreiAmpFreiAmp always returns 2 (H_MSG_TRUE). If the input is empty the behaviour can be set via set_system('no_object_result',<Result>)set_system("no_object_result",<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>). If necessary, an exception is raised.

Possible Predecessors

binomial_filterbinomial_filterbinomial_filterBinomialFilterBinomialFilter, gauss_imagegauss_imagegauss_imageGaussImageGaussImage, sigma_imagesigma_imagesigma_imageSigmaImageSigmaImage, median_imagemedian_imagemedian_imageMedianImageMedianImage, smooth_imagesmooth_imagesmooth_imageSmoothImageSmoothImage

Alternatives

sobel_ampsobel_ampsobel_ampSobelAmpSobelAmp, kirsch_ampkirsch_ampkirsch_ampKirschAmpKirschAmp, prewitt_ampprewitt_ampprewitt_ampPrewittAmpPrewittAmp, robinson_amprobinson_amprobinson_ampRobinsonAmpRobinsonAmp, robertsrobertsrobertsRobertsRoberts

See also

bandpass_imagebandpass_imagebandpass_imageBandpassImageBandpassImage, laplace_of_gausslaplace_of_gausslaplace_of_gaussLaplaceOfGaussLaplaceOfGauss

Module

Foundation


Table of Contents / Filters / Edges ClassesClassesClasses | | | Operators
HALCON Reference Manual 10.0.2 Copyright © 1996-2011 MVTec Software GmbH