c_pxe255 - Performs a scaled exponentiation on each element of a byte array. The formula used is 255 raised to the (i/255).

SYNTAX

#include "worgen.h"

FUNCTION c_pxe255 (in, out, ns, dtype)

     unsigned char         *in;
     double                *out;
     long                  *ns;
     long                  *dtype;

PARAMETERS

in (input, unsigned char('ns'))

Input array.

out (output, double('ns'))

Output array to hold result.

ns (input, integer)

Number of elements in the input array.

dtype (input, integer)

An integer value that represents the type of data of the input array. Legal values include:

     = EBYTE(1):     unsigned byte data
     = EWORD(2):     signed two byte data
     = ELONG(3):     signed four byte data
     = EREAL(4):     four byte floating point data

DESCRIPTION

c_pxe255() returns a scaled exponentiation of each element of an input array. The input array must be of type unsigned char, and the output array will be of type double.

RETURN VALUE

c_pxe255() returns

     E_SUCC --> successful completion
     TYPERR --> invalid type specified