halcon算子翻译——gen_image1

名称

gen_image1 - 从指向像素的指针创建一个图像。

用法

gen_image1( : Image : Type, Width, Height, PixelPointer : )

描述

算子gen_image1创建一个Width*Height大小的图像。 PixelPointer中的像素按线顺序存储。 给定像素的类型（PixelPointer）必须对应于Type（请参阅gen_image_const以获取更详细的像素类型描述）。 新图像的存储是由HALCON新创建的。 因此，在PixelPointer上的存储可以在调用之后被释放。 请注意，如何传递一个指针值取决于所使用的算子和编程环境。 确保传递存储图像数据的实际内存地址，而不是指针变量的地址。 必须注意不要在64位体系结构上截断64位指针。

并行

● 多线程类型：可重入（与非独占算子并行运行）。

● 多线程范围：全局（可以从任何线程调用）。

● 不并行化处理。

参数

Image (output_object) image → object (byte / direction / cyclic / int1 / int2 / uint2 / int4 / real)

新创建的图像矩阵。

Type (input_control) string → (string)

像素类型。

Default value: 'byte'

List of values: 'byte', 'cyclic', 'direction', 'int1', 'int2', 'int4', 'real', 'uint2'

Width (input_control) extent.x → (integer)

图像宽度。

Default value: 512

Suggested values: 128, 256, 512, 1024

Typical range of values: 1 ≤ Width ≤ 512 (lin)

Minimum increment: 1

Recommended increment: 10

Restriction: Width >= 1

Height (input_control) extent.y → (integer)

图像高度。

Default value: 512

Suggested values: 128, 256, 512, 1024

Typical range of values: 1 ≤ Height ≤ 512 (lin)

Minimum increment: 1

Recommended increment: 10

Restriction: Height >= 1

PixelPointer (input_control) pointer → (integer)

指向第一个灰度值的指针。

Example (C)

void NewImage(Hobject *new)
{
  unsigned char  image[768*525];
  int            r,c;
  for (r=0; r<525; r++)
    for (c=0; c<768; c++)
      image[r*768+c] = c % 255;
  gen_image1(new,"byte",768,525,(Hlong)image);
}

结果

如果参数值正确，则算子gen_image1返回值2（H_MSG_TRUE）。 否则会引发异常。

Possible Predecessors

gen_image_const, get_image_pointer1

Alternatives

gen_image3, gen_image1_extern, gen_image_const, get_image_pointer1

See also

reduce_domain, paint_gray, paint_region, set_grayval

模块

Foundation
原文链接: https://www.cnblogs.com/xhiong/p/gen_image1.html

欢迎关注

微信关注下方公众号，第一时间获取干货硬货；公众号内回复【pdf】免费获取数百本计算机经典书籍