pow_image🔗
Short description🔗
pow_image — Raise an image to a power.
Signature🔗
pow_image( image Image, out image PowImage, number Exponent )
Description🔗
pow_image raises the gray values of the input image
Image to the power Exponent and stores the result
in the image PowImage. If Image contains gray
values that would overflow the range of PowImage, e.g., \(>
7131.55017\) for \(\textrm{Exponent} = \textit{10}\), the corresponding
gray values in PowImage are set to the largest value
representable in PowImage (i.e., \(3.4028235 \times 10^{38}\)). If Image contains gray
values that cannot be raised to the power Exponent, i.e.,
if the gray values are negative and Exponent is not an
integer, the corresponding gray values in PowImage are set
to 0.
Attention🔗
pow_image can be executed on an OpenCL device for byte,
int1, int2, uint2, int4, and real images. Note that the results of
the OpenCL code may vary from the results produced by the CPU.
Execution information🔗
Execution information
-
Supports OpenCL compute devices.
-
Multithreading type: reentrant (runs in parallel with non-exclusive operators).
-
Multithreading scope: global (may be called from any thread).
-
Automatically parallelized on tuple level.
-
Automatically parallelized on channel level.
-
Automatically parallelized on domain level.
Parameters🔗
Image (input_object) (multichannel-)image(-array) → object (byte* / int1* / uint2* / int2* / int4* / int8 / real*) *allowed for compute devices
Input image.
PowImage (output_object) (multichannel-)image(-array) → object (real)
Output image.
Exponent (input_control) number → (real / integer)
Power to which the gray values are raised.
Default: 2
Suggested values: 0.25, 0.5, 2, 3, 4
Combinations with other operators🔗
Module🔗
Foundation