Manual Pages for UNIX Operating System command usage for man mlib_ImageScale_Fp

mediaLib Library Functions              mlib_ImageScale_Fp(3MLIB)



NAME
     mlib_ImageScale_Fp - linear scaling

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

     mlib_status mlib_ImageScale_Fp(mlib_image *dst, const mlib_image *src,
          const mlib_d64 *alpha, const mlib_d64 *beta);


DESCRIPTION
     The mlib_ImageScale_Fp() 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
     _______________________________________________________________________________________
     MLIB_FLOAT       Y      Y       Y                Y               Y       Y
     _______________________________________________________________________________________
     MLIB_DOUBLE      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              mlib_ImageScale_Fp(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 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_ImageScale(3MLIB),       mlib_ImageScale_Fp_Inp(3MLIB),
     mlib_ImageScale_Inp(3MLIB),         mlib_ImageScale2(3MLIB),
     mlib_ImageScale2_Inp(3MLIB), attributes(5)





















SunOS 5.11           Last change: 2 Mar 2007                    2