mediaLib Library Functions
                           mlibImageColorOrderedDitherMxN(3MLIB)



NAME
     mlibImageColorOrderedDitherMxN  -  true-color  to  indexed-
     color  or grayscale to black-white conversion, using ordered
     dithering

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

     mlibstatus mlibImageColorOrderedDitherMxN(mlibimage *dst,
          const mlibimage *src, const mlibs32 **dmask, mlibs32 m,
          mlibs32 n, mlibs32 scale, const void *colormap);


DESCRIPTION
     The mlibImageColorOrderedDitherMxN()  function  converts  a
     3-channel  image to a 1-channel indexed image, or converts a
     1-channel grayscale image to  a  1-channel  MLIBIT  image,
     with the method of ordered dithering.


     The src can be an MLIBYTE image with 1 or 3 channels.  The
     dst must be a 1-channel MLIBIT or MLIBYTE image.


     The colormap must be created by mlibImageColorDitherInit(),
     and it must have a colorcube included.


     The dither masks are required to  have  the  following  pro-
     perty:

       0 < dmask[i][j] < 2**scale; scale > 0


PARAMETERS
     The function takes the following arguments:

     dst         Pointer to destination image.


     src         Pointer to source image.


     dmask       Pointer to the dither masks, one per channel, in
                 row major order.


     m           Mask width. m > 1.





SunOS 5.11           Last change: 2 Mar 2007                    1






mediaLib Library Functions
                           mlibImageColorOrderedDitherMxN(3MLIB)



     n           Mask height. n > 1.


     scale       Scaling factor for dmask to  convert  the  input
                 integer coefficients into floating-point coeffi-
                 cients:

                   floating-point coefficient = integer coefficient * \
                   2**(-scale)



     colormap    Internal data structure for image dithering.


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
     mlibImageColorDitherInit(3MLIB),
     mlibImageColorDitherFree(3MLIB),
     mlibImageColorErrorDiffusion3x3(3MLIB),
     mlibImageColorErrorDiffusionMxN(3MLIB),
     mlibImageColorOrderedDither8x8(3MLIB), attributes(5)














SunOS 5.11           Last change: 2 Mar 2007                    2






mediaLib Library Functions
                           mlibImageColorOrderedDitherMxN(3MLIB)






















































SunOS 5.11           Last change: 2 Mar 2007                    3