gen_image3_externgen_image3_externgen_image3_externGenImage3ExternGenImage3Extern (Operator)

Name

gen_image3_externgen_image3_externgen_image3_externGenImage3ExternGenImage3Extern — Create a three-channel image from three pointers on the pixels with storage management.

Signature

Description

The operator gen_image3_externgen_image3_externgen_image3_externGenImage3ExternGenImage3Extern creates a three-channel image of the size WidthWidthWidthWidthwidth * HeightHeightHeightHeightheight. The pixels in PointerRedPointerRedPointerRedPointerRedpointerRed, PointerGreenPointerGreenPointerGreenPointerGreenpointerGreen, and PointerBluePointerBluePointerBluePointerBluepointerBlue are stored line-sequentially. The type of the given pixels must correspond to TypeTypeTypeTypetype. Since the type of the parameters PointerRedPointerRedPointerRedPointerRedpointerRed, PointerGreenPointerGreenPointerGreenPointerGreenpointerGreen, and PointerBluePointerBluePointerBluePointerBluepointerBlue is generic (long) a cast must be used for the call.

The memory for the new image is not newly allocated by HALCON, contrary to gen_image3gen_image3gen_image3GenImage3GenImage3, and thus is not copied either. This means that the memory space that PointerRedPointerRedPointerRedPointerRedpointerRed, PointerGreenPointerGreenPointerGreenPointerGreenpointerGreen, and PointerBluePointerBluePointerBluePointerBluepointerBlue point to must be released by deleting the object ImageImageImageImageimage. This is done by the procedure ClearProcClearProcClearProcClearProcclearProc provided by the caller. This procedure must have the following signature

void ClearProc(void* ptr);

and will be called using __cdecl calling convention when deleting ImageImageImageImageimage. If the memory shall not be released (in the case of frame grabbers or static memory) a procedure “without trunk” or the NULL-Pointer can be passed. Analogous to the parameters PointerRedPointerRedPointerRedPointerRedpointerRed, PointerGreenPointerGreenPointerGreenPointerGreenpointerGreen, and PointerBluePointerBluePointerBluePointerBluepointerBlue the pointer has to be passed to the procedure by casting it to long.

Attention

gen_image3_externgen_image3_externgen_image3_externGenImage3ExternGenImage3Extern does not check if enough memory for an image of WidthWidthWidthWidthwidth * HeightHeightHeightHeightheight is allocated in PointerRedPointerRedPointerRedPointerRedpointerRed, PointerGreenPointerGreenPointerGreenPointerGreenpointerGreen, and PointerBluePointerBluePointerBluePointerBluepointerBlue.

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 NewImage(Hobject *new)
{
  unsigned char  *image_red;
  unsigned char  *image_green;
  unsigned char  *image_blue;
  int            r,c;
  image_red = malloc(640*480);
  image_green = malloc(640*480);
  image_blue = malloc(640*480);
  for (r=0; r<480; r++)
    for (c=0; c<640; c++)
    {
      image_red[r*640+c] = c % 255;
      image_green[r*640+c] = (c+64) % 255;
      image_blue[r*640+c] = (c+128) % 255;
    }
  gen_image3_extern(new,"byte",640,480,(long)image_red,(long)image_green,(long)image_blue,(long)free);
}

Result

The operator gen_image3_externgen_image3_externgen_image3_externGenImage3ExternGenImage3Extern returns the value 2 (H_MSG_TRUE) if the parameter values are correct. Otherwise an exception is raised.

Alternatives

gen_image3gen_image3gen_image3GenImage3GenImage3, gen_image_constgen_image_constgen_image_constGenImageConstGenImageConst, get_image_pointer3get_image_pointer3get_image_pointer3GetImagePointer3GetImagePointer3, gen_image1_externgen_image1_externgen_image1_externGenImage1ExternGenImage1Extern

See also

reduce_domainreduce_domainreduce_domainReduceDomainReduceDomain, paint_graypaint_graypaint_grayPaintGrayPaintGray, paint_regionpaint_regionpaint_regionPaintRegionPaintRegion, set_grayvalset_grayvalset_grayvalSetGrayvalSetGrayval

Module

Foundation