ClassesClassesClassesClasses | | | | Operators

gray_range_rectgray_range_rectGrayRangeRectgray_range_rectGrayRangeRectGrayRangeRect (Operator)

Name

gray_range_rectgray_range_rectGrayRangeRectgray_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 GrayRangeRect(const HObject& Image, HObject* ImageResult, const HTuple& MaskHeight, const HTuple& MaskWidth)

HImage HImage::GrayRangeRect(Hlong MaskHeight, Hlong 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_rectGrayRangeRectgray_range_rectGrayRangeRectGrayRangeRect calculates the gray value range, i.e., the difference (max - min) of the maximum and minimum gray values, of the input image ImageImageImageImageImageimage within a rectangular mask of size (MaskHeightMaskHeightMaskHeightMaskHeightMaskHeightmaskHeight, MaskWidthMaskWidthMaskWidthMaskWidthMaskWidthmaskWidth) for each image point. The resulting image is returned in ImageResultImageResultImageResultImageResultImageResultimageResult. If the parameters MaskHeightMaskHeightMaskHeightMaskHeightMaskHeightmaskHeight or MaskWidthMaskWidthMaskWidthMaskWidthMaskWidthmaskWidth are even, they are changed to the next smaller odd value. At the border of the image the gray values are mirrored.

Parallelization

Parameters

ImageImageImageImageImageimage (input_object)  (multichannel-)image(-array) objectHImageHImageHImageHImageXHobject (byte / cyclic / uint2 / int2 / int4 / real)

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

ImageResultImageResultImageResultImageResultImageResultimageResult (output_object)  (multichannel-)image(-array) objectHImageHImageHImageHImageXHobject * (byte / cyclic / uint2 / int2 / int4 / real)

Image containing the gray value range.

MaskHeightMaskHeightMaskHeightMaskHeightMaskHeightmaskHeight (input_control)  extent.y HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (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 maskHeight ≤ 511 (lin)

Minimum increment: 2

Recommended increment: 2

Restriction: odd(MaskHeight)

MaskWidthMaskWidthMaskWidthMaskWidthMaskWidthmaskWidth (input_control)  extent.x HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (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 maskWidth ≤ 511 (lin)

Minimum increment: 2

Recommended increment: 2

Restriction: odd(MaskWidth)

Result

gray_range_rectgray_range_rectGrayRangeRectgray_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>)SetSystem("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_rectGrayDilationRectgray_dilation_rectGrayDilationRectGrayDilationRect, gray_erosion_rectgray_erosion_rectGrayErosionRectgray_erosion_rectGrayErosionRectGrayErosionRect, sub_imagesub_imageSubImagesub_imageSubImageSubImage

Module

Foundation


ClassesClassesClassesClasses | | | | Operators