Herror ::gen_image_proto (
    Hobject Image,
    Hobject *ImageCleared,
    const HTuple &Grayval
)
HImage HImage::GenImageProto (
    const HTuple &Grayval
) const

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 -> Hobject: HImage
Image, whose gray values are to be cleared.

ImageCleared (output_object)
image -> Hobject * : HImage
Image with constant gray value.

Grayval (input_control)
number -> HTuple.double / long
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 H_MSG_TRUE if all parameters are correct. If necessary, an exception is raised.


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-2002 MVTec Software GmbH