Operator Reference

HALCON Operator Reference / Image / Creation
ClassesClasses | | Operators

gen_image_constgen_image_constGenImageConstGenImageConstgen_image_const (Operator)

gen_image_constgen_image_constGenImageConstGenImageConstgen_image_const — Create an image with constant gray value.

Signature

gen_image_const( : Image : Type, Width, Height : )

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

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

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

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

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

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

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

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

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

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

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

void HImage.GenImageConst(string type, int width, int height)

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

Description

The operator gen_image_constgen_image_constGenImageConstGenImageConstgen_image_const creates an image of the indicated size. The width and height of the image are determined by WidthWidthWidthwidthwidth and HeightHeightHeightheightheight. HALCON supports the following image types:

'byte'"byte""byte""byte""byte"

1 byte per pixel, unsigned

Value range: (0..255)

'int1'"int1""int1""int1""int1"

1 byte per pixel, signed

Value range: (-128..127)

'uint2'"uint2""uint2""uint2""uint2"

2 bytes per pixel, unsigned

Value range: (0..65535)

'int2'"int2""int2""int2""int2"

2 bytes per pixel, signed

Value range: (-32768..32767)

'int4'"int4""int4""int4""int4"

4 bytes per pixel, signed

Value range: (-2147483648..2147483647)

'int8'"int8""int8""int8""int8"

8 bytes per pixel, signed (only available on 64 bit systems)

Value range: (-9223372036854775808..9223372036854775807)

'real'"real""real""real""real"

4 bytes per pixel, floating point

Precision: 6 significant decimal digits

Value range: (-3.4e38..3.4e38)

'complex'"complex""complex""complex""complex"

Two matrices of type 'real'"real""real""real""real"

'vector_field_relative'"vector_field_relative""vector_field_relative""vector_field_relative""vector_field_relative"

Two matrices of type 'real'"real""real""real""real"

Interpretation: Vectors

'vector_field_absolute'"vector_field_absolute""vector_field_absolute""vector_field_absolute""vector_field_absolute"

Two matrices of type 'real'"real""real""real""real"

Interpretation: Absolute coordinates

'direction'"direction""direction""direction""direction"

1 byte per pixel, unsigned

Interpretation: Angle divided by two

Value range: (0..179)

Attention: The values 180..254 are automatically set to the value 255, which is interpreted as undefined angle.

'cyclic'"cyclic""cyclic""cyclic""cyclic"

1 byte per pixel, unsigned, cyclic arithmetics

Value range: (0..255)

With the operator set_system('init_new_image',<'true'/'false'>)set_system("init_new_image",<"true"/"false">)SetSystem("init_new_image",<"true"/"false">)SetSystem("init_new_image",<"true"/"false">)set_system("init_new_image",<"true"/"false">), it can be controlled whether the created image is initialized with 0 or not.

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 / int8 / real / complex / vector_field)

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", 'complex'"complex""complex""complex""complex", '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", 'int8'"int8""int8""int8""int8", 'real'"real""real""real""real", 'uint2'"uint2""uint2""uint2""uint2", 'vector_field_absolute'"vector_field_absolute""vector_field_absolute""vector_field_absolute""vector_field_absolute", 'vector_field_relative'"vector_field_relative""vector_field_relative""vector_field_relative""vector_field_relative"

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

Example (C)

gen_image_const(&New,"byte",width,height);
get_image_pointer1(New,(Hlong*)&pointer,type,&width,&height);
for (row=0; row<height-1; row++)
{
  for (col=0; col<width-1; col++)
  {
    pointer[row*width+col] = (row + col) % 256;
  }
}

Result

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

Possible Successors

paint_regionpaint_regionPaintRegionPaintRegionpaint_region, reduce_domainreduce_domainReduceDomainReduceDomainreduce_domain, get_image_pointer1get_image_pointer1GetImagePointer1GetImagePointer1get_image_pointer1, copy_objcopy_objCopyObjCopyObjcopy_obj

Alternatives

gen_image1gen_image1GenImage1GenImage1gen_image1, gen_image3gen_image3GenImage3GenImage3gen_image3

See also

reduce_domainreduce_domainReduceDomainReduceDomainreduce_domain, paint_graypaint_grayPaintGrayPaintGraypaint_gray, paint_regionpaint_regionPaintRegionPaintRegionpaint_region, set_grayvalset_grayvalSetGrayvalSetGrayvalset_grayval, get_image_pointer1get_image_pointer1GetImagePointer1GetImagePointer1get_image_pointer1

Module

Foundation

ClassesClasses | | Operators