mediaLib Library Functions   mlibImageColorTrue2IndexInit(3MLIB)



NAME
     mlibImageColorTrue2IndexInit  -  initialization  for   true
     color to indexed color conversion

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

     mlibstatus mlibImageColorTrue2IndexInit(void **colormap, mlibs32 bits,
          mlibtype intype, mlibtype outtype, mlibs32 channels,
          mlibs32 entries, mlibs32 offset, const void **table);


DESCRIPTION
     The  mlibImageColorTrue2IndexInit()  function  creates  and
     initializes  an  internal  data structure based on the input
     lookup table and other parameters for inverse color mapping.


     The lookup table can have either three or four channels. The
     number  of channels of the lookup table should match that of
     the source image provided to the function that will use  the
     colormap structure created by this function.


     The type of the lookup table can be one of the following:

       MLIBYTE in, MLIBYTE out (i.e., BYTE-to-BYTE)
       MLIBSHORT in, MLIBSHORT out (i.e., SHORT-to-SHORT)
       MLIBSHORT in, MLIBYTE out (i.e., SHORT-to-BYTE)



     The input type of the lookup table should match the type  of
     the  destination  image; the output type of the lookup table
     should match the source image type. The source and  destina-
     tion  images are the images provided to the function that is
     going   to   use   the   colormap   structure   created   by
     mlibImageColorTrue2IndexInit() to do inverse color mapping.

PARAMETERS
     The function takes the following arguments:

     colormap    Internal data structure for inverse  color  map-
                 ping.


     bits        Number of bits per color component used  in  the
                 colorcube  of the colormap structure. (If bits =
                 0, then no colorcube is created. But the inverse
                 color  mapping might be done by using the origi-
                 nal lookup table.)



SunOS 5.11           Last change: 2 Mar 2007                    1






mediaLib Library Functions   mlibImageColorTrue2IndexInit(3MLIB)



     intype      Data type of the source image and lookup table.


     outtype     Data type of the destination indexed image.


     channels    Number of channels of the lookup table.


     entries     Number of entries of the lookup table.


     offset      The first entry offset of the lookup table.


     table       The lookup table (LUT).


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
     mlibImageColorErrorDiffusion3x3(3MLIB),
     mlibImageColorOrderedDither8x8(3MLIB),
     mlibImageColorTrue2Index(3MLIB),
     mlibImageColorTrue2IndexFree(3MLIB), attributes(5)













SunOS 5.11           Last change: 2 Mar 2007                    2