Name
gen_image1gen_image1GenImage1gen_image1GenImage1GenImage1 — Create an image from a pointer to the pixels.
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::GenImage1(const HString& Type, Hlong Width, Hlong Height, void* PixelPointer)
void HImage::GenImage1(const char* Type, Hlong Width, Hlong Height, void* 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)
The operator gen_image1gen_image1GenImage1gen_image1GenImage1GenImage1 creates an image of the size
WidthWidthWidthWidthWidthwidth * HeightHeightHeightHeightHeightheight.
The pixels in PixelPointerPixelPointerPixelPointerPixelPointerPixelPointerpixelPointer are stored line-sequentially.
The type of the given pixels (PixelPointerPixelPointerPixelPointerPixelPointerPixelPointerpixelPointer) must correspond
to TypeTypeTypeTypeTypetype (see gen_image_constgen_image_constGenImageConstgen_image_constGenImageConstGenImageConst 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 PixelPointerPixelPointerPixelPointerPixelPointerPixelPointerpixelPointer 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.
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
Created image with new image matrix.
Pixel type.
Default value:
'byte'
"byte"
"byte"
"byte"
"byte"
"byte"
List of values: 'byte'"byte""byte""byte""byte""byte", '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", 'real'"real""real""real""real""real", 'uint2'"uint2""uint2""uint2""uint2""uint2"
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
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
Pointer to first gray value.
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);
}
If the parameter values are correct, the operator gen_image1gen_image1GenImage1gen_image1GenImage1GenImage1
returns the value 2 (H_MSG_TRUE).
Otherwise an exception is raised.
gen_image_constgen_image_constGenImageConstgen_image_constGenImageConstGenImageConst,
get_image_pointer1get_image_pointer1GetImagePointer1get_image_pointer1GetImagePointer1GetImagePointer1
gen_image3gen_image3GenImage3gen_image3GenImage3GenImage3,
gen_image1_externgen_image1_externGenImage1Externgen_image1_externGenImage1ExternGenImage1Extern,
gen_image_constgen_image_constGenImageConstgen_image_constGenImageConstGenImageConst,
get_image_pointer1get_image_pointer1GetImagePointer1get_image_pointer1GetImagePointer1GetImagePointer1
reduce_domainreduce_domainReduceDomainreduce_domainReduceDomainReduceDomain,
paint_graypaint_grayPaintGraypaint_grayPaintGrayPaintGray,
paint_regionpaint_regionPaintRegionpaint_regionPaintRegionPaintRegion,
set_grayvalset_grayvalSetGrayvalset_grayvalSetGrayvalSetGrayval
Foundation