gen_image_protogen_image_protoGenImageProtoGenImageProtogen_image_proto (Operator)
Name
gen_image_protogen_image_protoGenImageProtoGenImageProtogen_image_proto
— Create an image with a specified constant gray value.
Signature
def gen_image_proto(image: HObject, grayval: Union[int, float]) -> HObject
Description
gen_image_protogen_image_protoGenImageProtoGenImageProtoGenImageProtogen_image_proto
creates an output image
ImageClearedImageClearedImageClearedImageClearedimageClearedimage_cleared
with the constant gray value GrayvalGrayvalGrayvalGrayvalgrayvalgrayval
.
If the input image is of type direction
, gray values in result
image that are not in the value range that is valid for direction
images are set to the value 255 to mark them as invalid.
ImageClearedImageClearedImageClearedImageClearedimageClearedimage_cleared
has the same dimensions and pixel type as the
input image ImageImageImageImageimageimage
.
Execution Information
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
Parameters
ImageImageImageImageimageimage
(input_object) singlechannelimage →
objectHImageHObjectHImageHobject (byte / direction / cyclic / int1 / int2 / uint2 / int4 / int8 / real / complex / vector_field)
Input image.
ImageClearedImageClearedImageClearedImageClearedimageClearedimage_cleared
(output_object) image →
objectHImageHObjectHImageHobject * (byte / direction / cyclic / int1 / int2 / uint2 / int4 / int8 / real / complex / vector_field)
Image with constant gray value.
GrayvalGrayvalGrayvalGrayvalgrayvalgrayval
(input_control) number →
HTupleUnion[int, float]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
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_protogen_image_protoGenImageProtoGenImageProtoGenImageProtogen_image_proto
returns TRUE if all parameters are correct.
If necessary, an exception is raised.
Alternatives
set_grayvalset_grayvalSetGrayvalSetGrayvalSetGrayvalset_grayval
,
paint_graypaint_grayPaintGrayPaintGrayPaintGraypaint_gray
,
gen_image_constgen_image_constGenImageConstGenImageConstGenImageConstgen_image_const
,
copy_imagecopy_imageCopyImageCopyImageCopyImagecopy_image
See also
get_image_pointer1get_image_pointer1GetImagePointer1GetImagePointer1GetImagePointer1get_image_pointer1
Module
Foundation