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

bandpass_imagebandpass_imagebandpass_imageBandpassImageBandpassImage (Operator)

Name

bandpass_imagebandpass_imagebandpass_imageBandpassImageBandpassImage — Edge extraction using bandpass filters.

Signature

bandpass_image(Image : ImageBandpass : FilterType : )

Herror bandpass_image(const Hobject Image, Hobject* ImageBandpass, const char* FilterType)

Herror T_bandpass_image(const Hobject Image, Hobject* ImageBandpass, const Htuple FilterType)

Herror bandpass_image(Hobject Image, Hobject* ImageBandpass, const HTuple& FilterType)

HImage HImage::BandpassImage(const HTuple& FilterType) const

HImageArray HImageArray::BandpassImage(const HTuple& FilterType) const

void HOperatorSetX.BandpassImage(
[in] IHUntypedObjectX* Image, [out] IHUntypedObjectX*ImageBandpass, [in] VARIANT FilterType)

IHImageX* HImageX.BandpassImage([in] BSTR FilterType)

static void HOperatorSet.BandpassImage(HObject image, out HObject imageBandpass, HTuple filterType)

HImage HImage.BandpassImage(string filterType)

Description

bandpass_imagebandpass_imagebandpass_imageBandpassImageBandpassImage serves as an edge filter. It applies a linear filter with the following convolution mask to ImageImageImageImageimage:

FilterTypeFilterTypeFilterTypeFilterTypefilterType: 'lines' In contrast to the edge operator sobel_ampsobel_ampsobel_ampSobelAmpSobelAmp this filter detects lines instead of edges, i.e., two closely adjacent edges.

             0      -2      -2      -2       0
            -2       0       3       0      -2
            -2       3      12       3      -2
            -2       0       3       0      -2
             0      -2      -2      -2       0

At the border of the image the gray values are mirrored. Over- and underflows of gray values are clipped. The resulting images are returned in ImageBandpassImageBandpassImageBandpassImageBandpassimageBandpass.

Parallelization

Parameters

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

Input images.

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

Bandpass-filtered images.

FilterTypeFilterTypeFilterTypeFilterTypefilterType (input_control)  string HTupleHTupleVARIANTHtuple (string) (string) (char*) (BSTR) (char*)

Filter type: currently only 'lines' is supported.

Default value: 'lines' "lines" "lines" "lines" "lines"

List of values: 'lines'"lines""lines""lines""lines"

Example (C)

bandpass_image(Image,&LineImage,"lines");
threshold(LineImage,&Lines,60.0,255.0);
skeleton(Lines,&ThinLines);

Result

bandpass_imagebandpass_imagebandpass_imageBandpassImageBandpassImage returns 2 (H_MSG_TRUE) if all parameters are correct. 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 Successors

thresholdthresholdthresholdThresholdThreshold, skeletonskeletonskeletonSkeletonSkeleton

Alternatives

convol_imageconvol_imageconvol_imageConvolImageConvolImage, topographic_sketchtopographic_sketchtopographic_sketchTopographicSketchTopographicSketch, texture_lawstexture_lawstexture_lawsTextureLawsTextureLaws

See also

highpass_imagehighpass_imagehighpass_imageHighpassImageHighpassImage, gray_skeletongray_skeletongray_skeletonGraySkeletonGraySkeleton

Module

Foundation


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