robinson_amprobinson_ampRobinsonAmpRobinsonAmp (Operator)

Name

robinson_amprobinson_ampRobinsonAmpRobinsonAmp — Detect edges (amplitude) using the Robinson operator.

Signature

robinson_amp(Image : ImageEdgeAmp : : )

Herror robinson_amp(const Hobject Image, Hobject* ImageEdgeAmp)

Herror T_robinson_amp(const Hobject Image, Hobject* ImageEdgeAmp)

void RobinsonAmp(const HObject& Image, HObject* ImageEdgeAmp)

HImage HImage::RobinsonAmp() const

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

HImage HImage.RobinsonAmp()

Description

robinson_amprobinson_ampRobinsonAmpRobinsonAmpRobinsonAmp calculates an approximation of the first derivative of the image data and is used as an edge detector. In robinson_amprobinson_ampRobinsonAmpRobinsonAmpRobinsonAmp the following four of the originally proposed eight 3x3 filter masks are convolved with the image. The other four masks are obtained by a multiplication by -1. All masks contain only the values 0,1,-1,2,-2. -1 0 1 2 1 0 -2 0 2 1 0 -1 -1 0 1 0 -1 -2 0 1 2 1 2 1 -1 0 1 0 0 0 -2 -1 0 -1 -2 -1 The result image contains the maximum response of all masks.

Attention

Note that filter operators may return unexpected results if an image with a reduced domain is used as input. Please refer to the chapter Filters.

Execution Information

Parameters

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

Input image.

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

Edge amplitude (gradient magnitude) image.

Example (HDevelop)

read_image(Image,'fabrik')
robinson_amp(Image,Robinson_amp)
threshold(Robinson_amp,Edges,128,255)

Example (C)

read_image(&Image,"fabrik");
robinson_amp(Image,&Robinson_amp);
threshold(Robinson_amp,&Edges,128,255);

Example (HDevelop)

read_image(Image,'fabrik')
robinson_amp(Image,Robinson_amp)
threshold(Robinson_amp,Edges,128,255)

Example (HDevelop)

read_image(Image,'fabrik')
robinson_amp(Image,Robinson_amp)
threshold(Robinson_amp,Edges,128,255)

Example (HDevelop)

read_image(Image,'fabrik')
robinson_amp(Image,Robinson_amp)
threshold(Robinson_amp,Edges,128,255)

Result

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

Possible Predecessors

binomial_filterbinomial_filterBinomialFilterBinomialFilterBinomialFilter, gauss_filtergauss_filterGaussFilterGaussFilterGaussFilter, sigma_imagesigma_imageSigmaImageSigmaImageSigmaImage, median_imagemedian_imageMedianImageMedianImageMedianImage, smooth_imagesmooth_imageSmoothImageSmoothImageSmoothImage

Alternatives

sobel_ampsobel_ampSobelAmpSobelAmpSobelAmp, frei_ampfrei_ampFreiAmpFreiAmpFreiAmp, prewitt_ampprewitt_ampPrewittAmpPrewittAmpPrewittAmp, robertsrobertsRobertsRobertsRoberts

See also

bandpass_imagebandpass_imageBandpassImageBandpassImageBandpassImage, laplace_of_gausslaplace_of_gaussLaplaceOfGaussLaplaceOfGaussLaplaceOfGauss

Module

Foundation