scale_imagescale_imageScaleImageScaleImagescale_image (算子)

名称

scale_imagescale_imageScaleImageScaleImagescale_image — 缩放图像的灰度值。

签名

描述

The operator scale_imagescale_imageScaleImageScaleImageScaleImagescale_image scales the input images (ImageImageImageImageimageimage) by the following transformation: g' := g * Mult + Add 若发生溢出或下溢，数值将被截断。 请注意，循环和方向图像不存在此情况。

This operator can be applied, e.g., to map the gray values of an image, i.e., the interval [GMin,GMax], to the maximum range [0:255]. For this, the parameters are chosen as follows: The values for GMin and GMax can be determined, e.g., with the operator min_max_graymin_max_grayMinMaxGrayMinMaxGrayMinMaxGraymin_max_gray.

请注意，算子的运行时间会因不同的控制参数而变化。对于常用组合，会采用特殊的优化方案。此外，还实现了使用定点运算（针对 int2 和 uint2 图像）的特殊优化，以及利用 SIMD 技术（针对 byte、int2 和 uint2 图像）的进一步优化。 The actual application of these special optimizations is controlled by the system parameters 'int_zooming'"int_zooming""int_zooming""int_zooming""int_zooming""int_zooming" and 'mmx_enable'"mmx_enable""mmx_enable""mmx_enable""mmx_enable""mmx_enable" (see set_systemset_systemSetSystemSetSystemSetSystemset_system). If 'int_zooming'"int_zooming""int_zooming""int_zooming""int_zooming""int_zooming" is set to 'true'"true""true""true""true""true", the internal calculation is performed using fixed point arithmetic, leading to much shorter execution times. However, the accuracy of the transformed gray values is slightly lower in this mode. The difference to the more accurate calculation (using 'int_zooming'"int_zooming""int_zooming""int_zooming""int_zooming""int_zooming" = 'false'"false""false""false""false""false") is typically less than two gray levels. If 'mmx_enable'"mmx_enable""mmx_enable""mmx_enable""mmx_enable""mmx_enable" is set to 'true'"true""true""true""true""true"(and the SIMD instruction set is available), the internal calculations are performed using fixed point arithmetic and SIMD technology. In this case the setting of 'int_zooming'"int_zooming""int_zooming""int_zooming""int_zooming""int_zooming" is ignored.

scale_imagescale_imageScaleImageScaleImageScaleImagescale_image 可在 OpenCL 设备上执行，适用于 byte、int1、int2、 uint2、int4、real、direction、cyclic 和 complex 图像。然而，由于 OpenCL 1.0 仅支持所有设备使用单精度浮点运算，且并非所有舍入模式均被支持，因此 OpenCL 实现可能会产生与标量或 SIMD 实现略有差异的结果。

注意

请注意，SIMD 技术获得的加速效果在大型、紧凑输入区域上最为显著。然而，在极少数情况下，根据输入区域和硬件性能的不同，使用 SIMD 技术执行 scale_imagescale_imageScaleImageScaleImageScaleImagescale_image 可能比不使用时耗时显著增加。在这些情况下，可通过 set_system(::'mmx_enable','false':)set_system("mmx_enable","false")SetSystem("mmx_enable","false")SetSystem("mmx_enable","false")SetSystem("mmx_enable","false")set_system("mmx_enable","false") 来避免使用 SIMD 技术。

执行信息

• 支持 OpenCL 计算设备。
• 多线程类型：可重入（与非独占算子并行运行）。
• 多线程作用域：全局（可从任何线程调用）。
• 在元组级别上自动并行化。
• 在通道级别上自动并行化。
• 在域级别上自动并行化。

参数

* Complement of the gray values:
scale_image(Image,Invert,-1.0,255.0)

/* simulation of invert for type 'byte' */
byte_invert(Hobject In, Hobject *out)
{
  scale_image(In,Out,-1.0,255.0);
}

* Complement of the gray values:
scale_image(Image,Invert,-1.0,255.0)

* Complement of the gray values:
scale_image(Image,Invert,-1.0,255.0)

* Complement of the gray values:
scale_image(Image,Invert,-1.0,255.0)

结果

如果参数正确，算子 scale_imagescale_imageScaleImageScaleImageScaleImagescale_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>) 进行设置。否则将执行异常处理。

可能的前趋

min_max_graymin_max_grayMinMaxGrayMinMaxGrayMinMaxGraymin_max_gray

替代

mult_imagemult_imageMultImageMultImageMultImagemult_image, add_imageadd_imageAddImageAddImageAddImageadd_image, sub_imagesub_imageSubImageSubImageSubImagesub_image

另见

min_max_graymin_max_grayMinMaxGrayMinMaxGrayMinMaxGraymin_max_gray

模块

基础