ClassesClassesClassesClasses | | | | Operators

gen_image_constgen_image_constGenImageConstgen_image_constGenImageConstGenImageConst (Operator)

Name

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

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

HImage HImage::GenImageConst(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::GenImageConst(const HString& Type, Hlong Width, Hlong Height)

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

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

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

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)

Description

The operator gen_image_constgen_image_constGenImageConstgen_image_constGenImageConstGenImageConst creates an image of the indicated size. The width and height of the image are determined by WidthWidthWidthWidthWidthwidth and HeightHeightHeightHeightHeightheight. HALCON supports the following image types:

'byte'

1 byte per pixel, unsigned

Value range: (0..255)

'int1'

1 byte per pixel, signed

Value range: (-128..127)

'uint2'

2 bytes per pixel, unsigned

Value range: (0..65535)

'int2'

2 bytes per pixel, signed

Value range: (-32768..32767)

'int4'

4 bytes per pixel, signed

Value range: (-2147483648..2147483647)

'int8'

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

Value range: (-9223372036854775808..9223372036854775807)

'real'

4 bytes per pixel, floating point

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

Precision: 6 significant decimal digits

'complex'

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

'vector_field_relative'

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

Interpretation: Vectors

'vector_field_absolute'

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

Interpretation: Absolute coordinates

'direction'

1 byte per pixel, unsigned

Value range: (0..179)

Interpretation: Angle divided by two

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

'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">)set_system("init_new_image",<"true"/"false">)SetSystem("init_new_image",<"true"/"false">)SetSystem("init_new_image",<"true"/"false">), it can be controlled whether the created image is initialized with 0 or not.

Parallelization

Parameters

ImageImageImageImageImageimage (output_object)  image objectHImageHImageHImageHImageXHobject * (byte / direction / cyclic / int1 / int2 / uint2 / int4 / int8 / real / complex / vector_field)

Created image with new image matrix.

TypeTypeTypeTypeTypetype (input_control)  string HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Pixel type.

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

List of values: 'byte'"byte""byte""byte""byte""byte", 'complex'"complex""complex""complex""complex""complex", 'cyclic'"cyclic""cyclic""cyclic""cyclic""cyclic", 'direction'"direction""direction""direction""direction""direction", 'int1'"int1""int1""int1""int1""int1", 'int2'"int2""int2""int2""int2""int2", 'int4'"int4""int4""int4""int4""int4", 'int8'"int8""int8""int8""int8""int8", 'real'"real""real""real""real""real", 'uint2'"uint2""uint2""uint2""uint2""uint2", 'vector_field_absolute'"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""vector_field_relative"

WidthWidthWidthWidthWidthwidth (input_control)  extent.x HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (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 width ≤ 512 (lin)

Minimum increment: 1

Recommended increment: 10

Restriction: Width >= 1

HeightHeightHeightHeightHeightheight (input_control)  extent.y HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (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 height ≤ 512 (lin)

Minimum increment: 1

Recommended increment: 10

Restriction: Height >= 1

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_constGenImageConstgen_image_constGenImageConstGenImageConst returns the value 2 (H_MSG_TRUE). Otherwise an exception is raised.

Possible Successors

paint_regionpaint_regionPaintRegionpaint_regionPaintRegionPaintRegion, reduce_domainreduce_domainReduceDomainreduce_domainReduceDomainReduceDomain, get_image_pointer1get_image_pointer1GetImagePointer1get_image_pointer1GetImagePointer1GetImagePointer1, copy_objcopy_objCopyObjcopy_objCopyObjCopyObj

Alternatives

gen_image1gen_image1GenImage1gen_image1GenImage1GenImage1, gen_image3gen_image3GenImage3gen_image3GenImage3GenImage3

See also

reduce_domainreduce_domainReduceDomainreduce_domainReduceDomainReduceDomain, paint_graypaint_grayPaintGraypaint_grayPaintGrayPaintGray, paint_regionpaint_regionPaintRegionpaint_regionPaintRegionPaintRegion, set_grayvalset_grayvalSetGrayvalset_grayvalSetGrayvalSetGrayval, get_image_pointer1get_image_pointer1GetImagePointer1get_image_pointer1GetImagePointer1GetImagePointer1

Module

Foundation


ClassesClassesClassesClasses | | | | Operators