ClassesClassesClassesClasses | | | | Operators

pow_imagepow_imagePowImagepow_imagePowImagePowImage (Operator)


pow_imagepow_imagePowImagepow_imagePowImagePowImage — Raise an image to a power.


pow_image(Image : PowImage : Exponent : )

Herror pow_image(const Hobject Image, Hobject* PowImage, double Exponent)

Herror T_pow_image(const Hobject Image, Hobject* PowImage, const Htuple Exponent)

Herror pow_image(Hobject Image, Hobject* PowImage, const HTuple& Exponent)

HImage HImage::PowImage(const HTuple& Exponent) const

HImageArray HImageArray::PowImage(const HTuple& Exponent) const

void PowImage(const HObject& Image, HObject* PowImage, const HTuple& Exponent)

HImage HImage::PowImage(const HTuple& Exponent) const

HImage HImage::PowImage(double Exponent) const

void HOperatorSetX.PowImage(
[in] IHUntypedObjectX* Image, [out] IHUntypedObjectX*PowImage, [in] VARIANT Exponent)

IHImageX* HImageX.PowImage([in] VARIANT Exponent)

static void HOperatorSet.PowImage(HObject image, out HObject powImage, HTuple exponent)

HImage HImage.PowImage(HTuple exponent)

HImage HImage.PowImage(double exponent)


pow_imagepow_imagePowImagepow_imagePowImagePowImage raises the gray values of the input image ImageImageImageImageImageimage to the power ExponentExponentExponentExponentExponentexponent and stores the result in the image PowImagePowImagePowImagePowImagePowImagepowImage. If ImageImageImageImageImageimage contains gray values that would overflow the range of PowImagePowImagePowImagePowImagePowImagepowImage, e.g., > 7131.55017 for ExponentExponentExponentExponentExponentexponent = 10, the corresponding gray values in PowImagePowImagePowImagePowImagePowImagepowImage are set to the largest value representable in PowImagePowImagePowImagePowImagePowImagepowImage (i.e., 3.4028235*10^38). 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 PowImagePowImagePowImagePowImagePowImagepowImage are set to 0.


pow_imagepow_imagePowImagepow_imagePowImagePowImage 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.



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

Input image.

PowImagePowImagePowImagePowImagePowImagepowImage (output_object)  (multichannel-)image(-array) objectHImageHImageHImageHImageXHobject * (real)

Output image.

ExponentExponentExponentExponentExponentexponent (input_control)  number HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)

Power to which the gray values are raised.

Default value: 2

Suggested values: 0.25, 0.5, 2, 3, 4



See also

sqrt_imagesqrt_imageSqrtImagesqrt_imageSqrtImageSqrtImage, exp_imageexp_imageExpImageexp_imageExpImageExpImage, log_imagelog_imageLogImagelog_imageLogImageLogImage



ClassesClassesClassesClasses | | | | Operators