mediaLib Library Functions      mlibVolumeFindMaxCMaskU8(3MLIB)



NAME
     mlibVolumeFindMaxCMaskU8,  mlibVolumeFindMaxCMaskS16   -
     maximum intensity searching

SYNOPSIS
     cc [ flag... ] file... -lmlib [ library... ]
     #include 

     mlibstatus mlibVolumeFindMaxCMaskU8(mlibu8 *max,
          const mlibrays *rays, const mlibu8 *cmask, mlibs32 thresh);


     mlibstatus mlibVolumeFindMaxCMaskS16(mlibs16 *max,
          const mlibrays *rays, const mlibu8 *cmask, mlibs32 thresh);


DESCRIPTION
     Each function performs maximum intensity searching.


     It uses the following equation:

       max[i] = MAX{ rays->results[j][i]
                     j = 0, 1, ..., rays->nsteps[i]; cmask[j] > thresh }



     where i = 0, 1, ..., rays->nrays - 1.

PARAMETERS
     The function takes the following arguments:

     max       Pointer to an array of rays->nrays maximum  values
               of the samples in each ray.


     rays      Pointer to an mlibrays structure. The data  rays-
               >results  are  organized  with  ray number (rather
               than ray step) varying fastest. Ray number and ray
               step  are the output of the ray casting functions.
               The data might have values beyond the maximum step
               on   a   ray.   For  example,  rays->results[rays-
               >nsteps[i][i] on ray i might not equal 0.


     cmask     Pointer  to  an  unsigned  8-bit  mask  array.  If
               cmask[j]  >  thresh,  then  data  in step j, rays-
               >results[j], are considered.


     thresh    Threshold.




SunOS 5.11           Last change: 2 Mar 2007                    1






mediaLib Library Functions      mlibVolumeFindMaxCMaskU8(3MLIB)



RETURN VALUES
     The function returns MLIBSUCES if  successful.  Otherwise
     it returns MLIBFAILURE.

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Committed                   
    
     MT-Level                     MT-Safe                     
    


SEE ALSO
     mlibVolumeFindMaxU8(3MLIB),
     mlibVolumeFindMaxBMaskU8(3MLIB), attributes(5)

































SunOS 5.11           Last change: 2 Mar 2007                    2