mediaLib Library Functions      mlibVolumeRayCastGeneral(3MLIB)



NAME
     mlibVolumeRayCastGeneral,
     mlibVolumeRayCastGeneralParallelNearestU8Bit,
     mlibVolumeRayCastGeneralParallelNearestU8U8,
     mlibVolumeRayCastGeneralParallelNearestS16S16,
     mlibVolumeRayCastGeneralParallelTrilinearU8U8,
     mlibVolumeRayCastGeneralParallelTrilinearS16S16,
     mlibVolumeRayCastGeneralDivergentNearestU8Bit,
     mlibVolumeRayCastGeneralDivergentNearestU8U8,
     mlibVolumeRayCastGeneralDivergentNearestS16S16,
     mlibVolumeRayCastGeneralDivergentTrilinearU8U8,
     mlibVolumeRayCastGeneralDivergentTrilinearS16S16     -
     cast a ray (or rays) through a 3D data set

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

     mlibstatus mlibVolumeRayCastGeneralParallelNearestU8Bit(
          mlibrays *rays, const mlibgenvolume *vol, void *buffer);


     mlibstatus mlibVolumeRayCastGeneralParallelNearestU8U8(
          mlibrays *rays, const mlibgenvolume *vol, void *buffer);


     mlibstatus mlibVolumeRayCastGeneralParallelNearestS16S16(
          mlibrays *rays, const mlibgenvolume *vol, void *buffer);


     mlibstatus mlibVolumeRayCastGeneralParallelTrilinearU8U8(
          mlibrays *rays, const mlibgenvolume *vol, void *buffer);


     mlibstatus mlibVolumeRayCastGeneralParallelTrilinearS16S16(
          mlibrays *rays, const mlibgenvolume *vol, void *buffer);


     mlibstatus mlibVolumeRayCastGeneralDivergentNearestU8Bit(
          mlibrays *rays, const mlibgenvolume *vol, void *buffer);


     mlibstatus mlibVolumeRayCastGeneralDivergentNearestU8U8(
          mlibrays *rays, const mlibgenvolume *vol, void *buffer);


     mlibstatus mlibVolumeRayCastGeneralDivergentNearestS16S16(
          mlibrays *rays, const mlibgenvolume *vol, void *buffer);


     mlibstatus mlibVolumeRayCastGeneralDivergentTrilinearU8U8(
          mlibrays *rays, const mlibgenvolume *vol, void *buffer);



SunOS 5.11           Last change: 2 Mar 2007                    1






mediaLib Library Functions      mlibVolumeRayCastGeneral(3MLIB)



     mlibstatus mlibVolumeRayCastGeneralDivergentTrilinearS16S16(
          mlibrays *rays, const mlibgenvolume *vol, void *buffer);


DESCRIPTION
     Each of these functions casts a  ray  (or  rays)  through  a
     three-dimensional  (3D)  data set, then computes and returns
     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.


     vol       Volume data that consists of slices.


     buffer    Working buffer.


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





SunOS 5.11           Last change: 2 Mar 2007                    2






mediaLib Library Functions      mlibVolumeRayCastGeneral(3MLIB)



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



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


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






































SunOS 5.11           Last change: 2 Mar 2007                    3