HALCON Reference Manual 10.0.2
Table of Contents / Image / Creation ClassesClassesClasses | | | Operators

gen_image1gen_image1gen_image1GenImage1GenImage1 (Operator)

Name

gen_image1gen_image1gen_image1GenImage1GenImage1 — 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)

Herror gen_image1(Hobject* Image, const HTuple& Type, const HTuple& Width, const HTuple& Height, const HTuple& PixelPointer)

HImage HImage::GenImage1(const HTuple& Type, const HTuple& Width, const HTuple& Height, const HTuple& PixelPointer)

void HOperatorSetX.GenImage1(
[out] IHUntypedObjectX** Image, [in] VARIANT Type, [in] VARIANT Width, [in] VARIANT Height, [in] VARIANT PixelPointer)

void HImageX.GenImage1(
[in] BSTR Type, [in] Hlong Width, [in] Hlong Height, [in] Hlong PixelPointer)

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)

Description

The operator gen_image1gen_image1gen_image1GenImage1GenImage1 creates an image of the size WidthWidthWidthWidthwidth * HeightHeightHeightHeightheight. The pixels in PixelPointerPixelPointerPixelPointerPixelPointerpixelPointer are stored line-sequentially. The type of the given pixels (PixelPointerPixelPointerPixelPointerPixelPointerpixelPointer) must correspond to TypeTypeTypeTypetype. The storage for the new image is newly created by HALCON. Thus, the storage on the PixelPointerPixelPointerPixelPointerPixelPointerpixelPointer can be released after the call. Since the type of the parameter PixelPointerPixelPointerPixelPointerPixelPointerpixelPointer is generic (long) a cast has to be used for the call.

Parallelization

Parameters

ImageImageImageImageimage (output_object)  image → objectHImageHImageHImageXHobject * (byte / direction / cyclic / int1 / int2 / uint2 / int4 / real)

Created image with new image matrix.

TypeTypeTypeTypetype (input_control)  string → HTupleHTupleVARIANTHtuple (string) (string) (char*) (BSTR) (char*)

Pixel type.

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

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

WidthWidthWidthWidthwidth (input_control)  extent.x → HTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong)

Width of image.

Default value: 512

Suggested values: 128, 256, 512, 1024

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

Minimum increment: 1

Recommended increment: 10

Restriction: Width >= 1

HeightHeightHeightHeightheight (input_control)  extent.y → HTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong)

Height of image.

Default value: 512

Suggested values: 128, 256, 512, 1024

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

Minimum increment: 1

Recommended increment: 10

Restriction: Height >= 1

PixelPointerPixelPointerPixelPointerPixelPointerpixelPointer (input_control)  pointer → HTupleHTupleVARIANTHtuple (integer) (IntPtr) (Hlong) (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,(long)image);
}

Result

If the parameter values are correct, the operator gen_image1gen_image1gen_image1GenImage1GenImage1 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

Alternatives

gen_image3gen_image3gen_image3GenImage3GenImage3, gen_image1_externgen_image1_externgen_image1_externGenImage1ExternGenImage1Extern, gen_image_constgen_image_constgen_image_constGenImageConstGenImageConst, get_image_pointer1get_image_pointer1get_image_pointer1GetImagePointer1GetImagePointer1

See also

reduce_domainreduce_domainreduce_domainReduceDomainReduceDomain, paint_graypaint_graypaint_grayPaintGrayPaintGray, paint_regionpaint_regionpaint_regionPaintRegionPaintRegion, set_grayvalset_grayvalset_grayvalSetGrayvalSetGrayval

Module

Foundation

Table of Contents / Image / Creation ClassesClassesClasses | | | Operators
HALCON Reference Manual 10.0.2 Copyright © 1996-2011 MVTec Software GmbH