Manual Pages for UNIX Operating System command usage for man mlib_ImageColorTrue2IndexInit

mediaLib Library Functions   mlib_ImageColorTrue2IndexInit(3MLIB)



NAME
     mlib_ImageColorTrue2IndexInit  -  initialization  for   true
     color to indexed color conversion

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

     mlib_status mlib_ImageColorTrue2IndexInit(void **colormap, mlib_s32 bits,
          mlib_type intype, mlib_type outtype, mlib_s32 channels,
          mlib_s32 entries, mlib_s32 offset, const void **table);


DESCRIPTION
     The  mlib_ImageColorTrue2IndexInit()  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:

       MLIB_BYTE in, MLIB_BYTE out (i.e., BYTE-to-BYTE)
       MLIB_SHORT in, MLIB_SHORT out (i.e., SHORT-to-SHORT)
       MLIB_SHORT in, MLIB_BYTE 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
     mlib_ImageColorTrue2IndexInit() 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   mlib_ImageColorTrue2IndexInit(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 MLIB_SUCCESS if  successful.  Otherwise
     it returns MLIB_FAILURE.

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



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe                     |
    |_____________________________|_____________________________|


SEE ALSO
     mlib_ImageColorErrorDiffusion3x3(3MLIB),
     mlib_ImageColorOrderedDither8x8(3MLIB),
     mlib_ImageColorTrue2Index(3MLIB),
     mlib_ImageColorTrue2IndexFree(3MLIB), attributes(5)













SunOS 5.11           Last change: 2 Mar 2007                    2