pow_image
— Raise an image to a power.
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.
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.
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 value: 2
Suggested values: 0.25, 0.5, 2, 3, 4
sqrt_image
,
exp_image
,
log_image
Foundation