gen_image3gen_image3GenImage3GenImage3gen_image3 (算子名称)

名称

gen_image3gen_image3GenImage3GenImage3gen_image3 — Create an image from three pointers to the pixels (red/green/blue).

参数签名

描述

该算子 gen_image3gen_image3GenImage3GenImage3GenImage3gen_image3 creates a three-channel image of the size WidthWidthWidthWidthwidthwidth * HeightHeightHeightHeightheightheight. The pixels in PixelPointerRedPixelPointerRedPixelPointerRedPixelPointerRedpixelPointerRedpixel_pointer_red, PixelPointerGreenPixelPointerGreenPixelPointerGreenPixelPointerGreenpixelPointerGreenpixel_pointer_green and PixelPointerBluePixelPointerBluePixelPointerBluePixelPointerBluepixelPointerBluepixel_pointer_blue are stored line-sequentially. The type of the given pixels (PixelPointerRedPixelPointerRedPixelPointerRedPixelPointerRedpixelPointerRedpixel_pointer_red etc.) must correspond to TypeTypeTypeTypetypetype (see gen_image_constgen_image_constGenImageConstGenImageConstGenImageConstgen_image_const for a more detailed description of the pixel types). The storage for the new image is newly created by HALCON. Thus, it can be released after the call. Note that how to pass a pointer value depends on the used operator signature and programming environment. Make sure to pass the actual memory address where the image data is stored, not the address of a pointer variable. Care must be taken not to truncate 64-bit pointers on 64-bit architectures.

注意

gen_image3gen_image3GenImage3GenImage3GenImage3gen_image3 does not check whether the pixels in PixelPointerRedPixelPointerRedPixelPointerRedPixelPointerRedpixelPointerRedpixel_pointer_red,PixelPointerGreenPixelPointerGreenPixelPointerGreenPixelPointerGreenpixelPointerGreenpixel_pointer_green, and PixelPointerBluePixelPointerBluePixelPointerBluePixelPointerBluepixelPointerBluepixel_pointer_blue are valid or not. Thus, it must be ensured by the user that they are valid. Otherwise, the program may crash!

运行信息

• 多线程类型:可重入(与非独占操作符并行运行)。
• 多线程作用域:全局(可以从任何线程调用)。
• 未经并行化处理。

参数表

例程 (C)

void NewRGBImage(Hobject *new)
{
  unsigned char  red[768*525];
  unsigned char  green[768*525];
  unsigned char  blue[768*525];
  int            r,c;
  for (r=0; r<525; r++)
    for (c=0; c<768; c++)
    {
      red[r*768+c]   = c % 255;
      green[r*768+c] = (767 - c) % 255;
      blue[r*768+c]  = r % 255;
    }
    gen_image3(new,"byte",768,525,(Hlong)red,(long)green,(long)blue);
}

main()
{
  Hobject  rgb;
  open_window(0,0,768,525,0,"","",&WindowHandle);
  NewRGBImage(&rgb);
  disp_color(rgb,WindowHandle);
}

结果

If the parameter values are correct, 该算子 gen_image3gen_image3GenImage3GenImage3GenImage3gen_image3 返回值 2 ( H_MSG_TRUE) . Otherwise an exception is raised.

可能的前置算子

gen_image_constgen_image_constGenImageConstGenImageConstGenImageConstgen_image_const, get_image_pointer1get_image_pointer1GetImagePointer1GetImagePointer1GetImagePointer1get_image_pointer1

可能的后置算子

disp_colordisp_colorDispColorDispColorDispColordisp_color

可替代算子

gen_image1gen_image1GenImage1GenImage1GenImage1gen_image1, compose3compose3Compose3Compose3Compose3compose3, gen_image_constgen_image_constGenImageConstGenImageConstGenImageConstgen_image_const

参考其它

reduce_domainreduce_domainReduceDomainReduceDomainReduceDomainreduce_domain, paint_graypaint_grayPaintGrayPaintGrayPaintGraypaint_gray, paint_regionpaint_regionPaintRegionPaintRegionPaintRegionpaint_region, set_grayvalset_grayvalSetGrayvalSetGrayvalSetGrayvalset_grayval, get_image_pointer1get_image_pointer1GetImagePointer1GetImagePointer1GetImagePointer1get_image_pointer1, decompose3decompose3Decompose3Decompose3Decompose3decompose3

模块

Foundation

---