mult_imagemult_imageMultImageMultImagemult_image (算子名称)

名称

mult_imagemult_imageMultImageMultImagemult_image — Multiply two images.

参数签名

mult_image(Image1, Image2 : ImageResult : Mult, Add : )

描述

mult_imagemult_imageMultImageMultImageMultImagemult_image multiplies two images. The gray values (g1,g2) of the input images (Image1Image1Image1Image1image1image_1) are transformed as follows: g' := g1 * g2 * Mult + Add If an overflow or an underflow occurs the values are clipped. Note that this is not the case with cyclic and direction images.

Several images can be processed in one call. In this case both input parameters contain the same number of images which are then processed in pairs. An output image is generated for every pair.

mult_imagemult_imageMultImageMultImageMultImagemult_image can be executed on an OpenCL device for byte, int1, int2, uint2, int4, real, direction, cyclic, and complex images. However, since for OpenCL 1.0 only single precision floating point is supported for all devices, and not all rounding modes are supported, the OpenCL implementation can produce slightly different results from the scalar implementation.

运行信息

支持OpenCL计算设备。
多线程类型:可重入(与非独占操作符并行运行)。
多线程作用域:全局(可以从任何线程调用)。
在元组级别自动并行化。
在图像通道级别自动并行化。
Automatically parallelized on domain level.

参数表

Image1Image1Image1Image1image1image_1 (input_object) (multichannel-)image(-array) → object (byte* / int1* / int2* / uint2* / int4* / int8 / real* / direction* / cyclic* / complex*) *allowed for compute devices

Image(s) 1.

Image2Image2Image2Image2image2image_2 (input_object) (multichannel-)image(-array) → object (byte* / int1* / int2* / uint2* / int4* / int8 / real* / direction* / cyclic* / complex*) *allowed for compute devices

Image(s) 2.

ImageResultImageResultImageResultImageResultimageResultimage_result (output_object) (multichannel-)image(-array) → object (byte / int1 / int2 / uint2 / int4 / int8 / real / direction / cyclic / complex)

Result image(s) by the product.

MultMultMultMultmultmult (input_control) number → (real / integer)

Factor for gray range adaption.

Default: 0.005

Suggested values: 0.001, 0.01, 0.5, 1.0, 2.0, 3.0, 5.0, 10.0

Value range: -255.0 ≤ Mult Mult Mult Mult mult mult ≤ 255.0

Minimum increment: 0.001

Recommended increment: 0.1

AddAddAddAddaddadd (input_control) number → (real / integer)

Value for gray range adaption.

Default: 0

Suggested values: 0.0, 128.0, 256.0

Value range: -512.0 ≤ Add Add Add Add add add ≤ 512.0

Minimum increment: 0.01

Recommended increment: 1.0

例程 (HDevelop)

read_image(Image1,'fabrik')
dev_display (Image1)
read_image(Image2,'monkey')
dev_display (Image2)
mult_image (Image1, Image2, Result, 0.01, 10)
dev_display (Result)

例程 (C)

read_image(&Image1,"fabrik");
disp_image(Image1,WindowHandle);
read_image(&Image2,"monkey");
disp_image(Image2,WindowHandle);
mult_image(Image1,Image2,&Result,0.01,10.0);
disp_image(Result,WindowHandle);

例程 (HDevelop)

read_image(Image1,'fabrik')
dev_display (Image1)
read_image(Image2,'monkey')
dev_display (Image2)
mult_image (Image1, Image2, Result, 0.01, 10)
dev_display (Result)

例程 (HDevelop)

read_image(Image1,'fabrik')
dev_display (Image1)
read_image(Image2,'monkey')
dev_display (Image2)
mult_image (Image1, Image2, Result, 0.01, 10)
dev_display (Result)

例程 (HDevelop)

read_image(Image1,'fabrik')
dev_display (Image1)
read_image(Image2,'monkey')
dev_display (Image2)
mult_image (Image1, Image2, Result, 0.01, 10)
dev_display (Result)

结果

该算子 mult_imagemult_imageMultImageMultImageMultImagemult_image 返回值 2 ( H_MSG_TRUE) if the parameters are correct. The behavior in case of empty input (no input images available) is set via 该算子 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>) If necessary an exception is raised.

可替代算子

add_imageadd_imageAddImageAddImageAddImageadd_image, sub_imagesub_imageSubImageSubImageSubImagesub_image, div_imagediv_imageDivImageDivImageDivImagediv_image

参考其它

add_imageadd_imageAddImageAddImageAddImageadd_image, sub_imagesub_imageSubImageSubImageSubImagesub_image, div_imagediv_imageDivImageDivImageDivImagediv_image

模块

Foundation

算子列表