Halcon算子翻译——get_grayval

名称

get_grayval - 获取图像对象的灰度值。

用法

get_grayval(Image : : Row, Column : Grayval)

描述

　　参数Grayval是浮点数或整数的元组，它返回Image的几个像素的灰度值。 对于多通道图像，对每个像素返回一组元素，一般是每个通道一个值（或者针对复数或矢量场图像则每个通道的两个值）。 像素的行坐标在元组Row中指定，列坐标在元组Column中指定。

　　请注意，get_grayval不考虑图像的ROI，即，如果设定了ROI，例如使用reduce_domain，即使位于域外的点也返回灰度值。

注意

　　Grayval的值的类型取决于图像Image的通道的灰度值的类型。 算子get_grayval产生相当多的开销。 通常用于获取图像的单个灰度值（例如，get_mposition后跟get_grayval）。 这是不适合图像处理操作如filter的编程。 在这种情况下，使用算子get_image_pointer1并直接使用C或C ++接口来封装自己的函数会更有用。

并行

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

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

●　　不并行处理。

参数

Image (input_object) 　　(multichannel-)image → object (byte / direction / cyclic / int1 / int2 / uint2 / int4 / int8 / real / complex / vector_field)
　　要获取灰度值的图像。

Row (input_control) 　　 point.y(-array) → (integer)
　　要查看的像素的行坐标。
　　Default value: 0
　　Suggested values: 0, 64, 128, 256, 512, 1024
　　Typical range of values: 0 ≤ Row ≤ 32768 (lin)
　　Minimum increment: 1
　　Recommended increment: 1
　　Restriction: (0 <= Row) && (Row < height(Image))

Column (input_control) 　　 point.x(-array) → (integer)
　　要查看的像素的列坐标。
　　Number of elements: Column == Row
　　Default value: 0
　　Suggested values: 0, 64, 128, 256, 512, 1024
　　Typical range of values: 0 ≤ Column ≤ 32768 (lin)
　　Minimum increment: 1
　　Recommended increment: 1
　　Restriction: (0 <= Column) && (Column < width(Image))

Grayval (output_control) 　　 grayval(-array) → (real / integer)
　　像素的灰度值。

结果

　　如果参数状态正确，则算子get_grayval返回值2（H_MSG_TRUE）。 空输入（无可用输入图像）时的行为通过算子set_system（'no_object_result'，<Result>）设置。 如有必要，会引发异常。

Possible Predecessors

read_image

Alternatives

get_image_pointer1, get_grayval_interpolated, get_grayval_contour_xld

See also

set_grayval

模块

Foundation

HDevelop例程

inspect_bottle_label_360_degree.hdev 　　　　将一个瓶子的四个图像组合成合成图像，显示瓶子的展开标签
get_mposition.hdev 　　　　　　　　　　   　　查询鼠标位置和按钮状态
determine_tilt_slant_photometric_stereo.hdev     确定光度立体法系统的光源的方向
3d_information_for_selected_points.hdev 　　　计算立体图像对中的点的世界坐标