mediaLib Library Functions              mlibImageScaleFp(3MLIB)



NAME
     mlibImageScaleFp - linear scaling

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

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


DESCRIPTION
     The mlibImageScaleFp() function performs a  floating-point
     linear  scaling  on the pixels of the source image by multi-
     plying the data by a scale factor, shifting, and then adding
     an offset.


     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
     
     MLIBFLOAT       Y      Y       Y                Y               Y       Y
     
     MLIBDOUBLE      Y      Y       Y                Y               Y       Y



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

PARAMETERS
     The function takes the following arguments:

     dst      Pointer to destination image.





SunOS 5.11           Last change: 2 Mar 2007                    1






mediaLib Library Functions              mlibImageScaleFp(3MLIB)



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





















SunOS 5.11           Last change: 2 Mar 2007                    2