lvexp(3)

LIBRARY ROUTINE
lvexp - Compute the base 10 antilogarithm of an image with an operation gating image.

LIBRARY CALL
#include "vinclude.h"
int
lvexp(img1,img2,tflg,mflg)
struct xvimage *img1, *img2;
int  tflg,mflg;

INPUT

    1. img1 -- first xvimage structure
    2. img2 -- mask xvimage structure
    3. tflg -- if set to non zero, compute exp10(x) - 1,
               if set to zero compute exp10(x)
    4. mflg -- if set, then the mask image is available
               and will be used.

    The inputs must be of the same data type and size.

OUTPUT

    1. img1 -- output xvimage structure img1 is used for both the input xvimage structure and the output result xvimage structure. This is done to save space, but you must be careful not to overwrite important data.

    lvexp returns a zero upon failure.

MODIFICATIONS
Marcelo Teran, John Rasure, Tom Sauer 27-Feb-91 Jeremy Worley added processing for double precision images.

DESCRIPTION
lvexp computes the base 10 antilogarithm of an image pixel by pixel with an operation gating image. The base 10 antilogarithm is the same as computing 10 raised to the power of the pixel, exp10(x).

img1 is the input image, img2 is the gating image, and mflg should be set to one if gating image is to be used.

img1 is used for both the input xvimage structure and the output result xvimage structure. This is done to save space, but you must be careful not to overwrite important data.

The mask image must be the same size as the input image. The output image data type is the same as the input data type.

lvexp returns a value of one upon success and a zero on failure.

SEE ALSO
vexp(1), intro(3), vipl(3), verror(3), vutils(3)

RESTRICTIONS
lvexp will not operate on:
    Complex, and Bit
data storage types.

AUTHOR
Scott Wilson

COPYRIGHT
Copyright 1991, University of New Mexico. All rights reserved.