get_image_pointer1（算子）

get_image_pointer1 - 访问单通道图像的指针。

get_image_pointer1(Image : : : Pointer, Type, Width, Height)

描述

运算符get_image_pointer1返回指向图像Image的第一个通道的指针。此外，返回图像类型（Type =‘byte’，‘int2’，'uint2’等）和图像大小（宽度和高度）。因此，可以从使用HALCON的编程语言直接访问HALCON数据库中的图像数据。图像存储在以行主要顺序线性化的HALCON中，即逐行。请注意，图像类型“complex”和“vector_type”以特定方式处理。特别地，“复杂”图像是交错的，即，实部和虚部是交替的。相反，'vector_field’图像由两个矩阵组成，一个用于行，一个用于列，它们一个接一个地存储在HALCON数据库中。

注意

只有在HALCON数据库中存在相应的图像对象时，才可以使用get_image_pointer1返回的指针。只要使用HALCON的编程语言中的相应变量有效，就是这种情况。如果未遵守此规定，可能会导致意外行为或程序崩溃。

如果通过指针将数据写入现有图像，则修改引用该图像的所有图像对象。例如，如果通过reduce_domain限制图像的域，则具有完整域的原始图像对象和具有缩小域的图像对象共享相同的图像矩阵（即，get_image_pointer1为两个图像返回相同的指针）。因此，如果修改了该示例中的两个图像之一，则两个图像对象都受到影响。因此，如果指针用于以使用HALCON的编程语言写入图像数据，则应该将图像数据写入仅为此目的而创建的图像对象，例如使用gen_image1。对于多通道输入图像，返回第一通道的类型和指针。

并行

多线程类型：可重入（与非独占运算符并行运行）。
多线程范围：全局（可以从任何线程调用）。
没有并行化处理。

参数

Image（input_object）singlechannelimage（-array）→object（byte / direction / cyclic / int1 / int2 / uint2 / int4 / int8 / real / complex / vector_field）
输入图像。

Pointer（output_control）指针（-array）→（整数）
指向HALCON数据库中的图像数据的指针。

Type（output_control）string（-array）→（string）
图像类型。
值列表：‘byte’，‘complex’，‘cyclic’，‘direction’，‘int1’，‘int2’，‘int4’，‘int8’，‘real’，‘uint2’，‘vector_field_absolute’，'vector_field_relative “

Width（output_control）extent.x（-array）→（整数）
图像宽度。

Height（output_control）extent.y（-array）→（整数）
图像的高度。