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