ClassesClassesClassesClasses | | | | Operators

pow_imagepow_imagePowImagepow_imagePowImagePowImage (Operator)

Name

pow_imagepow_imagePowImagepow_imagePowImagePowImage — Raise an image to a power.

Signature

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)

Description

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.

Attention

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.

Parallelization

Parameters

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

Alternatives

gamma_imagegamma_imageGammaImagegamma_imageGammaImageGammaImage

See also

sqrt_imagesqrt_imageSqrtImagesqrt_imageSqrtImageSqrtImage, exp_imageexp_imageExpImageexp_imageExpImageExpImage, log_imagelog_imageLogImagelog_imageLogImageLogImage

Module

Foundation


ClassesClassesClassesClasses | | | | Operators