set_grayvalset_grayvalSetGrayvalSetGrayvalset_grayval (算子)

名称

set_grayvalset_grayvalSetGrayvalSetGrayvalset_grayval — 在图像中设置单个灰度值。

签名

描述

set_grayvalset_grayvalSetGrayvalSetGrayvalSetGrayvalset_grayval 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.

注意

算子 set_grayvalset_grayvalSetGrayvalSetGrayvalSetGrayvalset_grayval 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_pointer1GetImagePointer1GetImagePointer1GetImagePointer1get_image_pointer1 and to directly use the C or C++ interface for integrating own procedures.

Note also that set_grayvalset_grayvalSetGrayvalSetGrayvalSetGrayvalset_grayval 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_objCopyObjCopyObjCopyObjcopy_obj from another image object, set_grayvalset_grayvalSetGrayvalSetGrayvalSetGrayvalset_grayval will also modify the image matrix of this other image object. Therefore, set_grayvalset_grayvalSetGrayvalSetGrayvalSetGrayvalset_grayval should only be used to overpaint newly created image objects.

执行信息

• 多线程类型：可重入（与非独占算子并行运行）。
• 多线程作用域：全局（可从任何线程调用）。
• 未采用并行化处理。

此算子修改后续输入参数的状态：

• ImageImageImageImageimageimage

在执行此算子时，若该参数值需在多个线程间使用，则必须对其访问进行同步。

参数

结果

set_grayvalset_grayvalSetGrayvalSetGrayvalSetGrayvalset_grayval 在所有参数正确时返回 2 ( H_MSG_TRUE )。 如果输入为空则可设置行为通过 set_system(::'no_object_result',<Result>:)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)set_system("no_object_result",<Result>)。如有必要，则抛出异常。

可能的前趋

read_imageread_imageReadImageReadImageReadImageread_image, get_image_pointer1get_image_pointer1GetImagePointer1GetImagePointer1GetImagePointer1get_image_pointer1, gen_image_protogen_image_protoGenImageProtoGenImageProtoGenImageProtogen_image_proto, gen_image1gen_image1GenImage1GenImage1GenImage1gen_image1

替代

get_image_pointer1get_image_pointer1GetImagePointer1GetImagePointer1GetImagePointer1get_image_pointer1, paint_graypaint_grayPaintGrayPaintGrayPaintGraypaint_gray, paint_regionpaint_regionPaintRegionPaintRegionPaintRegionpaint_region

另见

get_grayvalget_grayvalGetGrayvalGetGrayvalGetGrayvalget_grayval, gen_image_constgen_image_constGenImageConstGenImageConstGenImageConstgen_image_const, gen_image1gen_image1GenImage1GenImage1GenImage1gen_image1, gen_image_protogen_image_protoGenImageProtoGenImageProtoGenImageProtogen_image_proto

模块

基础