Name
gen_image3gen_image3GenImage3gen_image3GenImage3GenImage3 — Create an image from three pointers to the pixels (red/green/blue).
Herror gen_image3(Hobject* ImageRGB, const char* Type, const Hlong Width, const Hlong Height, const Hlong PixelPointerRed, const Hlong PixelPointerGreen, const Hlong PixelPointerBlue)
Herror T_gen_image3(Hobject* ImageRGB, const Htuple Type, const Htuple Width, const Htuple Height, const Htuple PixelPointerRed, const Htuple PixelPointerGreen, const Htuple PixelPointerBlue)
Herror gen_image3(Hobject* ImageRGB, const HTuple& Type, const HTuple& Width, const HTuple& Height, const HTuple& PixelPointerRed, const HTuple& PixelPointerGreen, const HTuple& PixelPointerBlue)
HImage HImage::GenImage3(const HTuple& Type, const HTuple& Width, const HTuple& Height, const HTuple& PixelPointerRed, const HTuple& PixelPointerGreen, const HTuple& PixelPointerBlue)
void GenImage3(HObject* ImageRGB, const HTuple& Type, const HTuple& Width, const HTuple& Height, const HTuple& PixelPointerRed, const HTuple& PixelPointerGreen, const HTuple& PixelPointerBlue)
void HImage::GenImage3(const HString& Type, Hlong Width, Hlong Height, void* PixelPointerRed, void* PixelPointerGreen, void* PixelPointerBlue)
void HImage::GenImage3(const char* Type, Hlong Width, Hlong Height, void* PixelPointerRed, void* PixelPointerGreen, void* PixelPointerBlue)
void HOperatorSetX.GenImage3(
[out] IHUntypedObjectX** ImageRGB, [in] VARIANT Type, [in] VARIANT Width, [in] VARIANT Height, [in] VARIANT PixelPointerRed, [in] VARIANT PixelPointerGreen, [in] VARIANT PixelPointerBlue)
void HImageX.GenImage3(
[in] BSTR Type, [in] Hlong Width, [in] Hlong Height, [in] Hlong PixelPointerRed, [in] Hlong PixelPointerGreen, [in] Hlong PixelPointerBlue)
static void HOperatorSet.GenImage3(out HObject imageRGB, HTuple type, HTuple width, HTuple height, HTuple pixelPointerRed, HTuple pixelPointerGreen, HTuple pixelPointerBlue)
void HImage.GenImage3(string type, int width, int height, IntPtr pixelPointerRed, IntPtr pixelPointerGreen, IntPtr pixelPointerBlue)
The operator gen_image3gen_image3GenImage3gen_image3GenImage3GenImage3 creates a three-channel image of the
size WidthWidthWidthWidthWidthwidth * HeightHeightHeightHeightHeightheight.
The pixels in PixelPointerRedPixelPointerRedPixelPointerRedPixelPointerRedPixelPointerRedpixelPointerRed, PixelPointerGreenPixelPointerGreenPixelPointerGreenPixelPointerGreenPixelPointerGreenpixelPointerGreen and
PixelPointerBluePixelPointerBluePixelPointerBluePixelPointerBluePixelPointerBluepixelPointerBlue are stored line-sequentially.
The type of the given pixels
(PixelPointerRedPixelPointerRedPixelPointerRedPixelPointerRedPixelPointerRedpixelPointerRed etc.) 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, it 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
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
Pointer to first red value (channel 1).
Pointer to first green value (channel 2).
Pointer to first blue value (channel 3).
void NewRGBImage(Hobject *new)
{
unsigned char red[768*525];
unsigned char green[768*525];
unsigned char blue[768*525];
int r,c;
for (r=0; r<525; r++)
for (c=0; c<768; c++)
{
red[r*768+c] = c % 255;
green[r*768+c] = (767 - c) % 255;
blue[r*768+c] = r % 255;
}
gen_image3(new,"byte",768,525,(Hlong)red,(long)green,(long)blue);
}
main()
{
Hobject rgb;
open_window(0,0,768,525,0,"","",&WindowHandle);
NewRGBImage(&rgb);
disp_color(rgb,WindowHandle);
clear_obj(rgb);
}
If the parameter values are correct, the operator gen_image3gen_image3GenImage3gen_image3GenImage3GenImage3
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
disp_colordisp_colorDispColordisp_colorDispColorDispColor
gen_image1gen_image1GenImage1gen_image1GenImage1GenImage1,
compose3compose3Compose3compose3Compose3Compose3,
gen_image_constgen_image_constGenImageConstgen_image_constGenImageConstGenImageConst
reduce_domainreduce_domainReduceDomainreduce_domainReduceDomainReduceDomain,
paint_graypaint_grayPaintGraypaint_grayPaintGrayPaintGray,
paint_regionpaint_regionPaintRegionpaint_regionPaintRegionPaintRegion,
set_grayvalset_grayvalSetGrayvalset_grayvalSetGrayvalSetGrayval,
get_image_pointer1get_image_pointer1GetImagePointer1get_image_pointer1GetImagePointer1GetImagePointer1,
decompose3decompose3Decompose3decompose3Decompose3Decompose3
Foundation