mediaLib Library Functions                mlibImageScale2(3MLIB)



NAME
     mlibImageScale2 - linear scaling

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

     mlibstatus mlibImageScale2(mlibimage *dst, const mlibimage *src,
          const mlibd64 *alpha, const mlibd64 *beta);


DESCRIPTION
     The mlibImageScale2() function performs a linear scaling on
     the  pixels of the source image by multiplying the data by a
     scale factor and then adding an offset. Images must have the
     same size, and number of channels. They can have 1, 2, 3, or
     4 channels.


     The following equation is used:

       dst[x][y][i] = src[x][y][i] * alpha[i] ] beta[i]



     If the result  of  the  operation  underflows/overflows  the
     minimum/maximum  value  supported  by the destination image,
     then it will be clamped to the minimum/maximum value respec-
     tively.


     See the following table for  available  variations  of  this
     linear scaling function.



        Type [*]      BYTE   SHORT       USHORT            INT        FLOAT       DOUBLE
     
     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.





SunOS 5.11           Last change: 2 Mar 2007                    1






mediaLib Library Functions                mlibImageScale2(3MLIB)



PARAMETERS
     The function takes the following arguments:

     dst      Pointer to destination image.


     src      Pointer to source image.


     alpha    Scaling factor. alpha[i] contains the scaling  fac-
              tor for channel i.


     beta     Offset value. beta[i] contains the offset for chan-
              nel i.


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
     mlibImageScale(3MLIB),           mlibImageScaleFp(3MLIB),
     mlibImageScaleFpInp(3MLIB),   mlibImageScaleInp(3MLIB),
     mlibImageScale2Inp(3MLIB), attributes(5)















SunOS 5.11           Last change: 2 Mar 2007                    2