get_image_pointer3 ( ImageRGB : : : PointerRed, PointerGreen, PointerBlue, Type, Width, Height )

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 HORUS data bank from the HORUS host language via the pointer is possible. An image is stored in HORUS 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 HORUS/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 -> object
Input image.

PointerRed (output_control)
pointer -> integer
Pointer to the pixels of the first channel.

PointerGreen (output_control)
pointer -> integer
Pointer to the pixels of the second channel.

PointerBlue (output_control)
pointer -> integer
Pointer to the pixels of the third channel.

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

Width (output_control)
extent.x -> integer
Width of image.

Height (output_control)
extent.y -> integer
Height of image.


Result

The operator get_image_pointer3 returns the value 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 is raised.


Possible Predecessors

read_image, read_picture


Alternatives

set_greyval__, get_greyval__, get_image_pointer__


See also

paint_region__, paint_grey__



Copyright © 1996-1997 MVTec Software GmbH