名称
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图像的各种方法