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

prewitt_ampprewitt_ampprewitt_ampPrewittAmpPrewittAmp (Operator)

Name

prewitt_ampprewitt_ampprewitt_ampPrewittAmpPrewittAmp — Detect edges (amplitude) using the Prewitt operator.

Signature

prewitt_amp(Image : ImageEdgeAmp : : )

Herror prewitt_amp(const Hobject Image, Hobject* ImageEdgeAmp)

Herror T_prewitt_amp(const Hobject Image, Hobject* ImageEdgeAmp)

Herror prewitt_amp(Hobject Image, Hobject* ImageEdgeAmp)

HImage HImage::PrewittAmp() const

HImageArray HImageArray::PrewittAmp() const

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

IHImageX* HImageX.PrewittAmp()

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

HImage HImage.PrewittAmp()

Description

prewitt_ampprewitt_ampprewitt_ampPrewittAmpPrewittAmp 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       1       1
        0       0       0
       -1      -1      -1

  B =
        1       0      -1
        1       0      -1
        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')
prewitt_amp(Image,Prewitt)
threshold(Prewitt,Edges,128,255)

Example (C)

read_image(&Image,"fabrik");
prewitt_amp(Image,&Prewitt);
threshold(Prewitt,&Edges,128,255);

Example (HDevelop)

read_image(Image,'fabrik')
prewitt_amp(Image,Prewitt)
threshold(Prewitt,Edges,128,255)

Example (HDevelop)

read_image(Image,'fabrik')
prewitt_amp(Image,Prewitt)
threshold(Prewitt,Edges,128,255)

Example (HDevelop)

read_image(Image,'fabrik')
prewitt_amp(Image,Prewitt)
threshold(Prewitt,Edges,128,255)

Result

prewitt_ampprewitt_ampprewitt_ampPrewittAmpPrewittAmp 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

Possible Successors

thresholdthresholdthresholdThresholdThreshold, gray_skeletongray_skeletongray_skeletonGraySkeletonGraySkeleton, nonmax_suppression_ampnonmax_suppression_ampnonmax_suppression_ampNonmaxSuppressionAmpNonmaxSuppressionAmp, close_edgesclose_edgesclose_edgesCloseEdgesCloseEdges, close_edges_lengthclose_edges_lengthclose_edges_lengthCloseEdgesLengthCloseEdgesLength

Alternatives

sobel_ampsobel_ampsobel_ampSobelAmpSobelAmp, kirsch_ampkirsch_ampkirsch_ampKirschAmpKirschAmp, frei_ampfrei_ampfrei_ampFreiAmpFreiAmp, 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