HALCON Reference Manual 10.0.2
Table of Contents / Morphology / Gray Values ClassesClassesClasses | | | Operators

gray_range_rectgray_range_rectgray_range_rectGrayRangeRectGrayRangeRect (Operator)

Name

gray_range_rectgray_range_rectgray_range_rectGrayRangeRectGrayRangeRect — Determine the gray value range within a rectangle.

Signature

gray_range_rect(Image : ImageResult : MaskHeight, MaskWidth : )

Herror gray_range_rect(const Hobject Image, Hobject* ImageResult, const Hlong MaskHeight, const Hlong MaskWidth)

Herror T_gray_range_rect(const Hobject Image, Hobject* ImageResult, const Htuple MaskHeight, const Htuple MaskWidth)

Herror gray_range_rect(Hobject Image, Hobject* ImageResult, const HTuple& MaskHeight, const HTuple& MaskWidth)

HImage HImage::GrayRangeRect(const HTuple& MaskHeight, const HTuple& MaskWidth) const

HImageArray HImageArray::GrayRangeRect(const HTuple& MaskHeight, const HTuple& MaskWidth) const

void HOperatorSetX.GrayRangeRect(
[in] IHUntypedObjectX* Image, [out] IHUntypedObjectX** ImageResult, [in] VARIANT MaskHeight, [in] VARIANT MaskWidth)

IHImageX* HImageX.GrayRangeRect(
[in] Hlong MaskHeight, [in] Hlong MaskWidth)

static void HOperatorSet.GrayRangeRect(HObject image, out HObject imageResult, HTuple maskHeight, HTuple maskWidth)

HImage HImage.GrayRangeRect(int maskHeight, int maskWidth)

Description

gray_range_rectgray_range_rectgray_range_rectGrayRangeRectGrayRangeRect calculates the gray value range, i.e., the difference (max - min) of the maximum and minimum gray values, of the input image ImageImageImageImageimage within a rectangular mask of size (MaskHeightMaskHeightMaskHeightMaskHeightmaskHeight, MaskWidthMaskWidthMaskWidthMaskWidthmaskWidth) for each image point. The resulting image is returned in ImageResultImageResultImageResultImageResultimageResult. If the parameters MaskHeightMaskHeightMaskHeightMaskHeightmaskHeight or MaskWidthMaskWidthMaskWidthMaskWidthmaskWidth are even, they are changed to the next smaller odd value. At the border of the image the gray values are mirrored.

Parallelization

Parameters

ImageImageImageImageimage (input_object)  (multichannel-)image(-array) → objectHImageHImageHImageXHobject (byte / direction / cyclic / uint2 / int2 / int4 / real)

Image for which the gray value range is to be calculated.

ImageResultImageResultImageResultImageResultimageResult (output_object)  (multichannel-)image(-array) → objectHImageHImageHImageXHobject * (byte / direction / cyclic / uint2 / int2 / int4 / real)

Image containing the gray value range.

MaskHeightMaskHeightMaskHeightMaskHeightmaskHeight (input_control)  extent.y → HTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong)

Height of the filter mask.

Default value: 11

Suggested values: 3, 5, 7, 9, 11, 13, 15

Typical range of values: 3 ≤ MaskHeight MaskHeight MaskHeight MaskHeight maskHeight ≤ 511 (lin)

Minimum increment: 2

Recommended increment: 2

Restriction: odd(MaskHeight)

MaskWidthMaskWidthMaskWidthMaskWidthmaskWidth (input_control)  extent.x → HTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong)

Width of the filter mask.

Default value: 11

Suggested values: 3, 5, 7, 9, 11, 13, 15

Typical range of values: 3 ≤ MaskWidth MaskWidth MaskWidth MaskWidth maskWidth ≤ 511 (lin)

Minimum increment: 2

Recommended increment: 2

Restriction: odd(MaskWidth)

Result

gray_range_rectgray_range_rectgray_range_rectGrayRangeRectGrayRangeRect returns 2 (H_MSG_TRUE) if all parameters are correct. If the input is empty the behavior 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.

Alternatives

gray_dilation_rectgray_dilation_rectgray_dilation_rectGrayDilationRectGrayDilationRect, gray_erosion_rectgray_erosion_rectgray_erosion_rectGrayErosionRectGrayErosionRect, sub_imagesub_imagesub_imageSubImageSubImage

Module

Foundation

Table of Contents / Morphology / Gray Values ClassesClassesClasses | | | Operators
HALCON Reference Manual 10.0.2 Copyright © 1996-2011 MVTec Software GmbH