名称
get_image_pointer3 - 获取彩色图像的指针。
用法
get_image_pointer3(ImageRGB : : : PointerRed, PointerGreen, PointerBlue, Type, Width, Height)
描述
算子get_image_pointer3返回一个C指针指向彩色图像的三个通道（ImageRGB）。 此外还返回图像类型（Type ='byte'，'int2'，'float'等）和图像大小（Width和Height）。 因此，可以通过指针从HALCON主语言直接访问HALCON数据库中的图像数据。 图像被存储在HALCON的一个图像行向量。 图像类型'complex'和'vector_type'以特定方式处理。 特别是，'complex'图像是交错的，即实部和虚部是交替的，而'vector_type'图像由两个矩阵组成，一个用于行，另一个用于列，这些矩阵一个接着一个存储在HALCON数据库中。 三个通道必须具有相同的像素类型和相同的尺寸。
注意
只能传递一个图像。 算子get_image_pointer3只能用于输入新创建的图像，否则其他图像的灰度值可能会被覆盖（请参阅关系结构）。
并行
● 多线程类型：可重入（与非独占算子并行运行）。
● 多线程范围：全局（可以从任何线程调用）。
● 不并行处理。
参数
ImageRGB (input_object) 多通道图像(-array) → object (byte / direction / cyclic / int1 / int2 / uint2 / int4 / int8 / real / complex / vector_field)
输入图像
PointerRed (output_control) pointer(-array) → (integer)
指向第一个通道的像素的指针。
PointerGreen (output_control) pointer(-array) → (integer)
指向第二个通道的像素的指针。
PointerBlue (output_control) pointer(-array) → (integer)
指向第三个通道的像素的指针。
Type (output_control) string(-array) → (string)
图像类型
List of values: 'byte', 'complex', 'cyclic', 'direction', 'int1', 'int2', 'int4', 'int8', 'real', 'uint2', 'vector_field_absolute', 'vector_field_relative'
Width (output_control) extent.x(-array) → (integer)
图像宽度
Height (output_control) extent.y(-array) → (integer)
图像高度
结果
算子get_image_pointer3返回值2（H_MSG_TRUE），如果只有一个图像被传递。 空输入（无可用输入图像）时的行为通过算子set_system（'no_object_result'，<Result>）设置。 如有必要，会引发异常。
Possible Predecessors
read_image
Alternatives
set_grayval, get_grayval, get_image_pointer1
See also
paint_region, paint_gray
模块
Foundation
HDevelop例程
ocrcolort.hdev 使用颜色信息分离数字并训练OCR
ocrcolor.hdev 使用颜色信息读取数字
multicam_quickpack.hdev 与Euresys QUICKPACK板一起使用MultiCam接口
gen_image_interleaved.hdev 演示从交错像素的输入矩阵创建三通道HALCON图像的各种方法