Operator Reference

HALCON Operator Reference / Image / Creation

• HDevelop
• .NET
• Python
• C++
• C

ClassesClasses | | Operators

gen_image1gen_image1GenImage1GenImage1gen_image1 (Operator)

gen_image1gen_image1GenImage1GenImage1gen_image1 — Create an image from a pointer to the pixels.

Signature

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

Herror gen_image1(Hobject* Image, const char* Type, const Hlong Width, const Hlong Height, const Hlong PixelPointer)

Herror T_gen_image1(Hobject* Image, const Htuple Type, const Htuple Width, const Htuple Height, const Htuple PixelPointer)

void GenImage1(HObject* Image, const HTuple& Type, const HTuple& Width, const HTuple& Height, const HTuple& PixelPointer)

void HImage::HImage(const HString& Type, Hlong Width, Hlong Height, void* PixelPointer)

void HImage::HImage(const char* Type, Hlong Width, Hlong Height, void* PixelPointer)

void HImage::HImage(const wchar_t* Type, Hlong Width, Hlong Height, void* PixelPointer)   ( Windows only)

void HImage::GenImage1(const HString& Type, Hlong Width, Hlong Height, void* PixelPointer)

void HImage::GenImage1(const char* Type, Hlong Width, Hlong Height, void* PixelPointer)

void HImage::GenImage1(const wchar_t* Type, Hlong Width, Hlong Height, void* PixelPointer)   ( Windows only)

static void HOperatorSet.GenImage1(out HObject image, HTuple type, HTuple width, HTuple height, HTuple pixelPointer)

public HImage(string type, int width, int height, IntPtr pixelPointer)

void HImage.GenImage1(string type, int width, int height, IntPtr pixelPointer)

def gen_image1(type: str, width: int, height: int, pixel_pointer: int) -> HObject

Description

The operator gen_image1gen_image1GenImage1GenImage1gen_image1 creates an image of the size WidthWidthWidthwidthwidth * HeightHeightHeightheightheight. The pixels in PixelPointerPixelPointerPixelPointerpixelPointerpixel_pointer are stored line-sequentially. The type of the given pixels (PixelPointerPixelPointerPixelPointerpixelPointerpixel_pointer) must correspond to TypeTypeTypetypetype (see gen_image_constgen_image_constGenImageConstGenImageConstgen_image_const for a more detailed description of the pixel types). The storage for the new image is newly created by HALCON. Thus, the storage on the PixelPointerPixelPointerPixelPointerpixelPointerpixel_pointer 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.

Attention

gen_image1gen_image1GenImage1GenImage1gen_image1 does not check whether the PixelPointerPixelPointerPixelPointerpixelPointerpixel_pointer is valid or not. Thus, it must be ensured by the user that it is valid. Otherwise, the program may crash!

Execution Information

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

Parameters

ImageImageImageimageimage (output_object)  image → objectHImageHObjectHObjectHobject * (byte / direction / cyclic / int1 / int2 / uint2 / int4 / real)

Created image with new image matrix.

TypeTypeTypetypetype (input_control)  string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)

Pixel type.

Default: 'byte' "byte" "byte" "byte" "byte"

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

WidthWidthWidthwidthwidth (input_control)  extent.x → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Width of image.

Default: 512

Suggested values: 128, 256, 512, 1024

Value range: 1 ≤ Width Width Width width width (lin)

Minimum increment: 1

Recommended increment: 10

HeightHeightHeightheightheight (input_control)  extent.y → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Height of image.

Default: 512

Suggested values: 128, 256, 512, 1024

Value range: 1 ≤ Height Height Height height height (lin)

Minimum increment: 1

Recommended increment: 10

PixelPointerPixelPointerPixelPointerpixelPointerpixel_pointer (input_control)  pointer → HTupleintHTupleHtuple (integer) (IntPtr) (Hlong) (Hlong)

Pointer to first gray value.

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);
}

Result

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

Possible Predecessors

gen_image_constgen_image_constGenImageConstGenImageConstgen_image_const, get_image_pointer1get_image_pointer1GetImagePointer1GetImagePointer1get_image_pointer1

Alternatives

gen_image3gen_image3GenImage3GenImage3gen_image3, gen_image1_externgen_image1_externGenImage1ExternGenImage1Externgen_image1_extern, gen_image_constgen_image_constGenImageConstGenImageConstgen_image_const, get_image_pointer1get_image_pointer1GetImagePointer1GetImagePointer1get_image_pointer1

See also

reduce_domainreduce_domainReduceDomainReduceDomainreduce_domain, paint_graypaint_grayPaintGrayPaintGraypaint_gray, paint_regionpaint_regionPaintRegionPaintRegionpaint_region, set_grayvalset_grayvalSetGrayvalSetGrayvalset_grayval

Module

Foundation

---

ClassesClasses | | Operators