Halcon算子翻译——get_image_pointer3

名称

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