gen_image3gen_image3gen_image3GenImage3GenImage3 (Operator)

Name

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

Signature

Description

The operator gen_image3gen_image3gen_image3GenImage3GenImage3 creates a three-channel image of the size WidthWidthWidthWidthwidth * HeightHeightHeightHeightheight. The pixels in PixelPointerRedPixelPointerRedPixelPointerRedPixelPointerRedpixelPointerRed, PixelPointerGreenPixelPointerGreenPixelPointerGreenPixelPointerGreenpixelPointerGreen and PixelPointerBluePixelPointerBluePixelPointerBluePixelPointerBluepixelPointerBlue are stored line-sequentially. The type of the given pixels (PixelPointerRedPixelPointerRedPixelPointerRedPixelPointerRedpixelPointerRed etc.) must correspond to the name of the pixels (TypeTypeTypeTypetype). The storage for the new image is newly created by HALCON. Thus, it can be released after the call. Since the type of the parameters (PixelPointerRedPixelPointerRedPixelPointerRedPixelPointerRedpixelPointerRed etc.) is generic (long) a “cast” must be used for the call.

Parallelization

• Multithreading type: reentrant (runs in parallel with non-exclusive operators).
• Multithreading scope: global (may be called from any thread).
• Processed without parallelization.

Parameters

Example (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,(long)red,(long)green,(long)blue);
}

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

Result

If the parameter values are correct, the operator gen_image3gen_image3gen_image3GenImage3GenImage3 returns the value 2 (H_MSG_TRUE). Otherwise an exception is raised.

Possible Predecessors

gen_image_constgen_image_constgen_image_constGenImageConstGenImageConst, get_image_pointer1get_image_pointer1get_image_pointer1GetImagePointer1GetImagePointer1

Possible Successors

disp_colordisp_colordisp_colorDispColorDispColor

Alternatives

gen_image1gen_image1gen_image1GenImage1GenImage1, compose3compose3compose3Compose3Compose3, gen_image_constgen_image_constgen_image_constGenImageConstGenImageConst

See also

reduce_domainreduce_domainreduce_domainReduceDomainReduceDomain, paint_graypaint_graypaint_grayPaintGrayPaintGray, paint_regionpaint_regionpaint_regionPaintRegionPaintRegion, set_grayvalset_grayvalset_grayvalSetGrayvalSetGrayval, get_image_pointer1get_image_pointer1get_image_pointer1GetImagePointer1GetImagePointer1, decompose3decompose3decompose3Decompose3Decompose3

Module

Foundation