pow_imagepow_imagePowImagePowImagepow_image (Operator)

Name

pow_imagepow_imagePowImagePowImagepow_image — Raise an image to a power.

Signature

pow_image(Image : PowImage : Exponent : )

Description

pow_imagepow_imagePowImagePowImagePowImagepow_image raises the gray values of the input image ImageImageImageImageimageimage to the power ExponentExponentExponentExponentexponentexponent and stores the result in the image PowImagePowImagePowImagePowImagepowImagepow_image. If ImageImageImageImageimageimage contains gray values that would overflow the range of PowImagePowImagePowImagePowImagepowImagepow_image, e.g., > 7131.55017 for ExponentExponentExponentExponentexponentexponent = 10, the corresponding gray values in PowImagePowImagePowImagePowImagepowImagepow_image are set to the largest value representable in PowImagePowImagePowImagePowImagepowImagepow_image (i.e., ). If ImageImageImageImageimageimage contains gray values that cannot be raised to the power ExponentExponentExponentExponentexponentexponent, i.e., if the gray values are negative and ExponentExponentExponentExponentexponentexponent is not an integer, the corresponding gray values in PowImagePowImagePowImagePowImagepowImagepow_image are set to 0.

Attention

pow_imagepow_imagePowImagePowImagePowImagepow_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

ImageImageImageImageimageimage (input_object) (multichannel-)image(-array) → object (byte* / int1* / uint2* / int2* / int4* / int8 / real*) *allowed for compute devices

Input image.

PowImagePowImagePowImagePowImagepowImagepow_image (output_object) (multichannel-)image(-array) → object (real)

Output image.

ExponentExponentExponentExponentexponentexponent (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

Alternatives

gamma_imagegamma_imageGammaImageGammaImageGammaImagegamma_image

Module

Foundation

Operators