mediaLib Library Functions      mlibVolumeRayCastBlocked(3MLIB)



NAME
     mlibVolumeRayCastBlocked,
     mlibVolumeRayCastBlockedParallelNearestU8U8,
     mlibVolumeRayCastBlockedParallelNearestS16S16,
     mlibVolumeRayCastBlockedParallelTrilinearU8U8,
     mlibVolumeRayCastBlockedParallelTrilinearS16S16,
     mlibVolumeRayCastBlockedDivergentNearestU8U8,
     mlibVolumeRayCastBlockedDivergentNearestS16S16,
     mlibVolumeRayCastBlockedDivergentTrilinearU8U8,
     mlibVolumeRayCastBlockedDivergentTrilinearS16S16     -
     cast a ray (or rays) through a 3D data set

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


     mlibstatus mlibVolumeRayCastBlockedParallelNearestU8U8
          (mlibrays *rays, const mlibblkvolume *blk, void *buffer);


     mlibstatus mlibVolumeRayCastBlockedParallelNearestS16S16
          (mlibrays *rays, const mlibblkvolume *blk, void *buffer);


     mlibstatus mlibVolumeRayCastBlockedParallelTrilinearU8U8
          (mlibrays *rays, const mlibblkvolume *blk, void *buffer);


     mlibstatus mlibVolumeRayCastBlockedParallelTrilinearS16S16
          (mlibrays *rays  const mlibblkvolume *blk, void *buffer);


     mlibstatus mlibVolumeRayCastBlockedDivergentNearestU8U8
          (mlibrays *rays, const mlibblkvolume *blk, void *buffer);


     mlibstatus mlibVolumeRayCastBlockedDivergentNearestS16S16
          (mlibrays *rays, const mlibblkvolume *blk, void *buffer);


     mlibstatus mlibVolumeRayCastBlockedDivergentTrilinearU8U8
          (mlibrays *rays, const mlibblkvolume *blk, void *buffer);


     mlibstatus mlibVolumeRayCastBlockedDivergentTrilinearS16S16
          (mlibrays *rays, const mlibblkvolume *blk, void *buffer);


DESCRIPTION
     Each of these functions casts a  ray  (or  rays)  through  a
     three-dimensional  (3D)  data set, then computes and returns



SunOS 5.11           Last change: 2 Mar 2007                    1






mediaLib Library Functions      mlibVolumeRayCastBlocked(3MLIB)



     the interpolated samples at each step along the way.


     In trilinear interpolation, the value at point P is computed
     from  its  eight surrounding neighbors based on the equation
     below.

       P = (1-a)*(1-b)*(1-c)*P0 ]
           a*(1-b)*(1-c)*Px ] (1-a)*b*(1-c)*Py ] (1-a)*(1-b)*c*Pz ]
           a*b*(1-c)*Pxy ] a*(1-b)*c*Pxz ] (1-a)*b*c*Pyz ]
           a*b*c*Pxyz



     where a, b, and c are the fractional parts  of  the  coordi-
     nates of point P.


     The trilinear interpolation is represented by the  following
     figure:

     Printed  copy  or  docs.sun.com  displays  a   figure   that
     represents the trilinear interpolation.


     In nearest neighbor operation, the sample value at  point  P
     is replaced by the value of the nearest neighbor voxel.

PARAMETERS
     Each of the functions takes the following arguments:

     rays      Casting rays.


     blk       Volume data in the blocked format.


     buffer    Working buffer.


RETURN VALUES
     Each of the functions returns  MLIBSUCES  if  successful.
     Otherwise it returns MLIBFAILURE.

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








SunOS 5.11           Last change: 2 Mar 2007                    2






mediaLib Library Functions      mlibVolumeRayCastBlocked(3MLIB)



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


SEE ALSO
     mlibVolumeRayCastGeneral(3MLIB), attributes(5)












































SunOS 5.11           Last change: 2 Mar 2007                    3