Operator Reference
pow_image (Operator)
pow_image — Raise an image to a power.
Signature
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 Exponent = 10, the corresponding
gray values in PowImage are set to the largest value
representable in PowImage (i.e., ). 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
- 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
Alternatives
See also
sqrt_image,
exp_image,
log_image
Module
Foundation