名称
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 计算立体图像对中的点的世界坐标