Herror ::set_grayval (
    Hobject Image,
    const HTuple &Row,
    const HTuple &Column,
    const HTuple &Grayval
)
void HImage::SetGrayval (
    const HTuple &Row,
    const HTuple &Column,
    const HTuple &Grayval
) const

Set single gray values in an image.

::set_grayval sets the gray values of the input image Image at the positions (Row,Column) to the values specified by Grayval. The number of values in Grayval must match the number of points passed to the operator.


Parameters

Image (input_object)
image -> Hobject: HImage
Image to be modified.

Row (input_control)
point.y(-array) -> HTuple.long
Row coordinates of the pixels to be modified.
Default value: 0
Suggested values: 0, 10, 50, 127, 255, 511
Typical range of values: 0 <= Row
Restriction: (0 <= Row) && (Row < height(Image))

Column (input_control)
point.x(-array) -> HTuple.long
Column coordinates of the pixels to be modified.
Default value: 0
Suggested values: 0, 10, 50, 127, 255, 511
Typical range of values: 0 <= Column
Restriction: (0 <= Column) && (Column < width(Image))

Grayval (input_control)
grayval(-array) -> HTuple.double / long
Gray values to be used.
Default value: 255.0
Suggested values: 0.0, 1.0, 10.0, 128.0, 255.0


Result

::set_grayval returns H_MSG_TRUE if all parameters are correct. If the input is empty the behavior can be set via ::set_system('no_object_result',<Result>). If necessary, an exception is raised.


Possible Predecessors

::read_image, ::get_image_pointer1, ::gen_image_proto, ::gen_image1


Alternatives

::get_image_pointer1, ::paint_gray, ::paint_region


See also

::get_grayval, ::gen_image_const, ::gen_image1, ::gen_image_proto


Module

Basic operators



Copyright © 1996-2002 MVTec Software GmbH