Halcon算子翻译——get_grayval_interpolated

名称

get_grayval_interpolated - 在由行和列的元组给出的位置返回图像的灰度值。

用法

get_grayval_interpolated(Image : : Row, Column, Interpolation : Grayval)

描述

　　算子get_grayval_interpolated返回图像若干个亚像素位置处的插值灰度值。 行位置的坐标在元组Row中给出，列位置的坐标在元组Column中给出。 Grayval返回灰度值的浮点数元组。

插值方法可以通过Interpolation参数来选择。 支持以下插值方法：

'bilinear':

参数Grayval是使用所选坐标的四个相邻灰度值的双线性插值计算的。 注意：方向和循环图像被视为像字节图像。

'bicubic':

使用所选坐标的十六个相邻灰度值的双三次插值来计算参数Grayval。 方向和循环图像被视为像字节图像。 在此模式下，灰度值结果可能包含位于输入图像类型可以表示的数字范围之外的值。

'bicubic_clipped':

使用所选坐标的十六个相邻灰度值的双三次插值来计算参数Grayval。 方向和循环图像被视为像字节图像。 在这种模式下，在输入图像类型表示的数字范围之外的结果灰度值被剪切到该范围。

　　注意，get_grayval_interpolated不考虑图像的ROI，即如果ROI已经减小，例如使用reduce_domain，则即使对于位于ROI之外的点，也返回灰度值。

并行

●　　多线程类型：可重入（与非独占算子并行运行）。

●　　多线程范围：全局（可以从任何线程调用）。

●　　不并行处理。

参数

Image (input_object) 　　单通道图像 → object (byte / direction / cyclic / int1 / int2 / uint2 / int4 / real / complex)
　　要获取灰度值的图像。

Row (input_control) 　　 point.y(-array) → (real / integer)
　　行位置的坐标。
　　Default value: 0
　　Suggested values: 0, 64, 128, 256, 512, 1024
　　Typical range of values: -0.5 ≤ Row
　　Restriction: (-0.5 <= Row) && (Row < (height(Image) - 0.5))

Column (input_control) 　　 point.x(-array) → (real / integer)
　　列位置的坐标。
　　Number of elements: Column == Row
　　Default value: 0
　　Suggested values: 0, 64, 128, 256, 512, 1024
　　Typical range of values: -0.5 ≤ Column
　　Restriction: (-0.5 <= Column) && (Column < (width(Image) - 0.5))

Interpolation (input_control) 　　 string → (string)
　　插值方法。
　　Default value: 'bilinear'
　　List of values: 'bicubic', 'bicubic_clipped', 'bilinear'

Grayval (output_control) grayval(-array) → (real)
　　所选图像坐标的灰度值。

结果

如果参数有效，则算子get_grayval_interpolated将返回值2（H_MSG_TRUE）。 如有必要，会引发异常。

Possible Predecessors

read_image

Alternatives

get_grayval_contour_xld, get_grayval

模块

Foundation

HDevelop例程

inspect_bottle_label_360_degree.hdev 　　将一个瓶子的四个图像组合成拼接图像，显示瓶子的展开标签
get_grayval_interpolated.hdev 　　　　　   在特定的行和列位置获取灰度值
find_local_deformable_model.hdev 　　　   使用局部变形匹配来找到局部变形的对象。
adjust_circle_matrix.hdev　　　　　　　　  演示如何使用矩阵