get_image_pointer3

Herror ::get_image_pointer3 ( Hobject ImageRGB, long *PointerRed, long *PointerGreen, long *PointerBlue, char *Type, long *Width, long *Height ) HTuple HImage::GetImagePointer3 ( HTuple *PointerGreen, HTuple *PointerBlue, HTuple *Type, HTuple *Width, HTuple *Height ) const

Access the pointers of a colored image.

The operator ::get_image_pointer3 returns a C pointer to the three channels of a colored image (ImageRGB). Additionally the image type (Type = 'byte', 'int2','float' etc.) and the image size (Width and Height) are returned. Consequently a direct access to the image data in the HALCON databank from the HALCON host language via the pointer is possible. An image is stored in HALCON as a vector of image lines. The three channels must have the same pixel type and the same size. The operator ::get_image_pointer3 is only of interest for HALCON/C.

Attention

Only one image can be passed. The operator ::get_image_pointer3 should only be used for entry into newly created images, since otherwise the gray values of other images might be overwritten (see relational structure).

Parameters

`ImageRGB` (input_object)	image `->` Hobject: HImage
Input image.

`PointerRed` (output_control)	pointer `->` long *
Pointer to the pixels of the first channel.

`PointerGreen` (output_control)	pointer `->` long *
Pointer to the pixels of the second channel.

`PointerBlue` (output_control)	pointer `->` long *
Pointer to the pixels of the third channel.

`Type` (output_control)	string `->` char *
Type of image.
List of values: 'int1', 'int2', 'int4', 'byte', 'real', 'direction', 'cyclic', 'complex', 'dvf', 'lut'

`Width` (output_control)	extent.x `->` long *
Width of image.

`Height` (output_control)	extent.y `->` long *
Height of image.

Result

The operator ::get_image_pointer3 returns the value H_MSG_TRUE if exactly one image is passed. The behavior in case of empty input (no input images available) is set via the operator ::set_system('no_object_result',<Result>). If necessary an exception handling is raised.

Possible Predecessors

::read_image

Alternatives

::set_grayval, ::get_grayval, ::get_image_pointer1

See also

::paint_region, ::paint_gray

Module

Image / region / XLD management