ClassesClassesClassesClasses | | | | Operators

set_grayvalset_grayvalSetGrayvalset_grayvalSetGrayvalSetGrayval (Operator)


set_grayvalset_grayvalSetGrayvalset_grayvalSetGrayvalSetGrayval — Set single gray values in an image.


set_grayval(Image : : Row, Column, Grayval : )

Herror set_grayval(const Hobject Image, const Hlong Row, const Hlong Column, double Grayval)

Herror T_set_grayval(const Hobject Image, const Htuple Row, const Htuple Column, const Htuple Grayval)

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

void SetGrayval(const HObject& Image, const HTuple& Row, const HTuple& Column, const HTuple& Grayval)

void HImage::SetGrayval(const HTuple& Row, const HTuple& Column, const HTuple& Grayval) const

void HImage::SetGrayval(Hlong Row, Hlong Column, double Grayval) const

void HOperatorSetX.SetGrayval(
[in] IHUntypedObjectX* Image, [in] VARIANT Row, [in] VARIANT Column, [in] VARIANT Grayval)

void HImageX.SetGrayval(
[in] VARIANT Row, [in] VARIANT Column, [in] VARIANT Grayval)

static void HOperatorSet.SetGrayval(HObject image, HTuple row, HTuple column, HTuple grayval)

void HImage.SetGrayval(HTuple row, HTuple column, HTuple grayval)

void HImage.SetGrayval(int row, int column, double grayval)


set_grayvalset_grayvalSetGrayvalset_grayvalSetGrayvalSetGrayval sets the gray values of the input image ImageImageImageImageImageimage at the positions (RowRowRowRowRowrow,ColumnColumnColumnColumnColumncolumn) to the values specified by GrayvalGrayvalGrayvalGrayvalGrayvalgrayval. If ImageImageImageImageImageimage is a multi-channel image, you can either set a single gray value for a pixel and thus set it for all available channels, or you can set the gray values g for all channels individually by concatenating them within GrayvalGrayvalGrayvalGrayvalGrayvalgrayval. For example, for a three-channel image three gray values (according to the order of the channels) are specified for each pixel:

  [g(channel0,pixel0), g(channel1,pixel0), g(channel2,pixel0), g(channel0,pixel1), ... ].
Please note that for complex or vector field images, two gray values per pixel must be specified (per channel).

If the image is of type 'direction', gray values that are not in the value range that is valid for 'direction' images are set to the value 255 to mark them as invalid.


The operator set_grayvalset_grayvalSetGrayvalset_grayvalSetGrayvalSetGrayval produces quite some overhead. Typically, it is used to set single gray values of an image. It is not suitable for programming image processing operations such as filters. In this case it is more useful to use the operator get_image_pointer1get_image_pointer1GetImagePointer1get_image_pointer1GetImagePointer1GetImagePointer1 and to directly use the C or C++ interface for integrating own procedures.

Note also that set_grayvalset_grayvalSetGrayvalset_grayvalSetGrayvalSetGrayval modifies the content of an already existing image (ImageImageImageImageImageimage). Besides, even other image objects may be affected: For example, if you created ImageImageImageImageImageimage via copy_objcopy_objCopyObjcopy_objCopyObjCopyObj from another image object, set_grayvalset_grayvalSetGrayvalset_grayvalSetGrayvalSetGrayval will also modify the image matrix of this other image object. Therefore, set_grayvalset_grayvalSetGrayvalset_grayvalSetGrayvalSetGrayval should only be used to overpaint newly created image objects.


This operator modifies the state of the following input parameter:

The value of this parameter may not be shared across multiple threads without external synchronization.


ImageImageImageImageImageimage (input_object, state is modified)  (multichannel-)image objectHImageHImageHImageHImageXHobject (byte / direction / cyclic / int1 / int2 / uint2 / int4 / int8 / real / complex / vector_field)

Image to be modified.

RowRowRowRowRowrow (input_control)  point.y(-array) HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

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 Row Row Row Row row

Restriction: 0 <= Row && Row < height(Image)

ColumnColumnColumnColumnColumncolumn (input_control)  point.x(-array) HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

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 Column Column Column Column column

Restriction: 0 <= Column && Column < width(Image)

GrayvalGrayvalGrayvalGrayvalGrayvalgrayval (input_control)  grayval(-array) HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)

Gray values to be used.

Default value: 255.0

Suggested values: 0.0, 1.0, 10.0, 128.0, 255.0


set_grayvalset_grayvalSetGrayvalset_grayvalSetGrayvalSetGrayval returns 2 (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>:)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>). If necessary, an exception is raised.

Possible Predecessors

read_imageread_imageReadImageread_imageReadImageReadImage, get_image_pointer1get_image_pointer1GetImagePointer1get_image_pointer1GetImagePointer1GetImagePointer1, gen_image_protogen_image_protoGenImageProtogen_image_protoGenImageProtoGenImageProto, gen_image1gen_image1GenImage1gen_image1GenImage1GenImage1


get_image_pointer1get_image_pointer1GetImagePointer1get_image_pointer1GetImagePointer1GetImagePointer1, paint_graypaint_grayPaintGraypaint_grayPaintGrayPaintGray, paint_regionpaint_regionPaintRegionpaint_regionPaintRegionPaintRegion

See also

get_grayvalget_grayvalGetGrayvalget_grayvalGetGrayvalGetGrayval, gen_image_constgen_image_constGenImageConstgen_image_constGenImageConstGenImageConst, gen_image1gen_image1GenImage1gen_image1GenImage1GenImage1, gen_image_protogen_image_protoGenImageProtogen_image_protoGenImageProtoGenImageProto



ClassesClassesClassesClasses | | | | Operators