gray_range_rectgray_range_rectGrayRangeRectGrayRangeRectgray_range_rect (算子)

名称

gray_range_rectgray_range_rectGrayRangeRectGrayRangeRectgray_range_rect — 确定矩形内的灰度值范围。

签名

gray_range_rect(Image : ImageResult : MaskHeight, MaskWidth : )

描述

gray_range_rectgray_range_rectGrayRangeRectGrayRangeRectGrayRangeRectgray_range_rect 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 (MaskHeightMaskHeightMaskHeightMaskHeightmaskHeightmask_height, MaskWidthMaskWidthMaskWidthMaskWidthmaskWidthmask_width) for each image point. The resulting image is returned in ImageResultImageResultImageResultImageResultimageResultimage_result. If the parameters MaskHeightMaskHeightMaskHeightMaskHeightmaskHeightmask_height or MaskWidthMaskWidthMaskWidthMaskWidthmaskWidthmask_width are even, they are changed to the next smaller odd value. At the border of the image the gray values are mirrored.

注意

请注意，若使用域缩减后的图像作为输入，滤波器算子可能会返回意外结果。请参阅滤波器一章

执行信息

支持 OpenCL 计算设备。
多线程类型：可重入（与非独占算子并行运行）。
多线程作用域：全局（可从任何线程调用）。
在元组级别上自动并行化。
在通道级别上自动并行化。
在域级别上自动并行化。

参数

ImageImageImageImageimageimage (输入对象) (multichannel-)image(-array) → object (byte / cyclic / uint2 / int2 / int4 / real)

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

ImageResultImageResultImageResultImageResultimageResultimage_result (输出对象) (multichannel-)image(-array) → object (byte / cyclic / uint2 / int2 / int4 / real)

Image containing the gray value range.

MaskHeightMaskHeightMaskHeightMaskHeightmaskHeightmask_height (输入控制) extent.y → (integer)

Height of the filter mask.

默认值： 11

建议值： 3, 5, 7, 9, 11, 13, 15

值范围： 3 ≤ MaskHeight MaskHeight MaskHeight MaskHeight maskHeight mask_height ≤ 511 (lin)

最小增量： 2

建议增量： 2

限制： odd(MaskHeight) && MaskHeight < height(Image) * 2

MaskWidthMaskWidthMaskWidthMaskWidthmaskWidthmask_width (输入控制) extent.x → (integer)

Width of the filter mask.

默认值： 11

建议值： 3, 5, 7, 9, 11, 13, 15

值范围： 3 ≤ MaskWidth MaskWidth MaskWidth MaskWidth maskWidth mask_width ≤ 511 (lin)

最小增量： 2

建议增量： 2

限制： odd(MaskWidth) && MaskWidth < width(Image) * 2

结果

gray_range_rectgray_range_rectGrayRangeRectGrayRangeRectGrayRangeRectgray_range_rect 在所有参数正确时返回 2 ( H_MSG_TRUE )。如果输入为空则可设置行为通过 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>)set_system("no_object_result",<Result>)。如有必要，则抛出异常。

替代

gray_dilation_rectgray_dilation_rectGrayDilationRectGrayDilationRectGrayDilationRectgray_dilation_rect, gray_erosion_rectgray_erosion_rectGrayErosionRectGrayErosionRectGrayErosionRectgray_erosion_rect, sub_imagesub_imageSubImageSubImageSubImagesub_image

模块

基础

算子