mediaLib Library Functions               mlibImageLookUp2(3MLIB)



NAME
     mlibImageLookUp2 - table lookup

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

     mlibstatus mlibImageLookUp2(mlibimage *dst, const mlibimage *src,
          const void **table, const mlibs32 *offsets, mlibs32 channels);


DESCRIPTION
     The mlibImageLookUp2() function maps the  source  image  to
     the  destination  image  by  using the user-specified lookup
     table and an offset.


     The source and destination images must have the  same  width
     and height.


     The source and destination images can  have  different  data
     types.  See  the following table for available variations of
     the table lookup function on image types:



        Type [*]      BYTE   SHORT       USHORT            INT        FLOAT       DOUBLE
     
     MLIBIT         Y
     MLIBYTE        Y      Y       Y                Y               Y       Y
     
     MLIBSHORT       Y      Y       Y                Y               Y       Y
     
     MLIBUSHORT      Y      Y       Y                Y               Y       Y
     
     MLIBINT         Y      Y       Y                Y               Y       Y



     [*] Each row represents a  source  data  type.  Each  column
     represents a destination data type.


     The source and destination images also can have a  different
     number of channels. The source image can be a single-channel
     image or can have the same number of channels as the  desti-
     nation  image. The lookup table can have one channel or have
     the same channels as the destination image. See the  follow-
     ing  table for possible variations on the number of channels
     in the images and the lookup table:




SunOS 5.11           Last change: 2 Mar 2007                    1






mediaLib Library Functions               mlibImageLookUp2(3MLIB)



      # of channels in     # of channels in      # of channels in
      the input image      the lookup table      the output image
     
             1                     n                    n
             n                     1                    n
             n                     n                    n



     where, n = 1, 2, 3, 4.


     Each of the following equations is used in the corresponding
     case shown in the table above.

       dst[x][y][i] = table[i][src[x][y][0] - offsets[i]
       dst[x][y][i] = table[0][src[x][y][i] - offsets[0]
       dst[x][y][i] = table[i][src[x][y][i] - offsets[i]


PARAMETERS
     The function takes the following arguments:

     dst         Pointer to destination image.


     src         Pointer to source image.


     table       Pointer to lookup table. The data  type  of  the
                 lookup table is the same as that of the destina-
                 tion image.. The format of the lookup table is:

                 table[channel][index]

                 The entries are indexed from 0 to 1, 2, ..., and
                 so  on.  It is the user's responsibility to pro-
                 vide a lookup table that has enough  entries  to
                 cover  all  possible  values  of  the pixel com-
                 ponents deducted by the offset in  each  channel
                 of the source image.


     offsets      Offset values subtracted  from  the  src  pixel
                 before table lookup.


     channels     Number of channels in the lookup table. If  the
                 number of channels equals 1, then the same table
                 is  applied  to  all  channels.  Otherwise,  the
                 number  of  channels  must  be  no less than the
                 number of channels in the destination image.



SunOS 5.11           Last change: 2 Mar 2007                    2






mediaLib Library Functions               mlibImageLookUp2(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
     mlibImageLookUp(3MLIB),        mlibImageLookUpInp(3MLIB),
     mlibImageLookUpMask(3MLIB), attributes(5)

































SunOS 5.11           Last change: 2 Mar 2007                    3