mult_imagemult_imageMultImageMultImagemult_image (算子)

名称

mult_imagemult_imageMultImageMultImagemult_image — 将两幅图像相乘。

签名

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 若发生溢出或下溢，数值将被截断。请注意，循环和方向图像不存在此情况。

单次调用可处理多张图像。此时两个输入参数包含相同数量的图像，这些图像将成对进行处理。每处理一对图像，系统将生成一张输出图像。

mult_imagemult_imageMultImageMultImageMultImagemult_image 可在 OpenCL 设备上执行，适用于 byte、int1、int2、uint2、int4、real、direction、cyclic 和 complex 图像。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 计算设备。
多线程类型：可重入（与非独占算子并行运行）。
多线程作用域：全局（可从任何线程调用）。
在元组级别上自动并行化。
在通道级别上自动并行化。
在域级别上自动并行化。

参数

Image1Image1Image1Image1image1image_1 (输入对象) (multichannel-)image(-array) → object (byte* / int1* / int2* / uint2* / int4* / int8 / real* / direction* / cyclic* / complex*) *允许用于计算设备

图像 1。

Image2Image2Image2Image2image2image_2 (输入对象) (multichannel-)image(-array) → object (byte* / int1* / int2* / uint2* / int4* / int8 / real* / direction* / cyclic* / complex*) *允许用于计算设备

图像 2。

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

Result image(s) by the product.

MultMultMultMultmultmult (输入控制) number → (real / integer)

Factor for gray range adaption.

默认值： 0.005

建议值： 0.001, 0.01, 0.5, 1.0, 2.0, 3.0, 5.0, 10.0

值范围： -255.0 ≤ Mult Mult Mult Mult mult mult ≤ 255.0

最小增量： 0.001

建议增量： 0.1

AddAddAddAddaddadd (输入控制) number → (real / integer)

Value for gray range adaption.

默认值： 0

建议值： 0.0, 128.0, 256.0

值范围： -512.0 ≤ Add Add Add Add add add ≤ 512.0

最小增量： 0.01

建议增量： 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 )。当输入为空（无可用输入图像）时可设置行为通过算子 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>)。如有必要，则抛出异常。

替代

add_imageadd_imageAddImageAddImageAddImageadd_image, sub_imagesub_imageSubImageSubImageSubImagesub_image, div_imagediv_imageDivImageDivImageDivImagediv_image

另见

add_imageadd_imageAddImageAddImageAddImageadd_image, sub_imagesub_imageSubImageSubImageSubImagesub_image, div_imagediv_imageDivImageDivImageDivImagediv_image

模块

基础

算子