gen_image_proto ( Image : ImageCleared : Grayval : )

Set the gray values of an image to a specified value.

gen_image_proto sets the gray values of the image ImageCleared to the value Grayval. The input image is not modified. It is merely used to determine the size of the output image.


Parameters

Image (input_object)
image -> object : byte / direction / cyclic / int1 / int2 / uint2 / int4 / real / complex / dvf
Image, whose gray values are to be cleared.

ImageCleared (output_object)
image -> object : byte / direction / cyclic / int1 / int2 / uint2 / int4 / real / complex / dvf
Image with constant gray value.

Grayval (input_control)
number -> real / integer
Gray value to be used for the output image.
Default value: 0
Suggested values: 0, 1, 2, 5, 10, 16, 32, 64, 128, 253, 254, 255


Result

gen_image_proto returns 2 (H_MSG_TRUE) if all parameters are correct. If necessary, an exception is raised.


Parallelization Information

gen_image_proto is reentrant and processed without parallelization.


Possible Predecessors

test_obj_def


Alternatives

set_grayval, paint_gray, gen_image_const, copy_image


See also

get_image_pointer1


Module

Basic operators



Copyright © 1996-2005 MVTec Software GmbH