Manual Pages for UNIX Operating System command usage for man mlib_ImageZoomTranslateToGray

mediaLib Library Functions   mlib_ImageZoomTranslateToGray(3MLIB)



NAME
     mlib_ImageZoomTranslateToGray - zoom, with translation,  and
     convert to grayscale

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

     mlib_status mlib_ImageZoomTranslateToGray(mlib_image *dst,
          const mlib_image *src, mlib_d64 zoomx, mlib_d64 zoomy,
          mlib_d64 tx, mlib_d64 ty, mlib_filter filter, mlib_edge edge,
          const mlib_s32 *ghigh, const mlib_s32 *glow);


DESCRIPTION
     The mlib_ImageZoomTranslateToGray() function will enlarge or
     minify  the source binary image by the X and Y zoom factors,
     with translation, and convert the  resulting  image  into  a
     grayscale image.


     It uses the following equation for coordinate mapping:

       xd = zoomx*xs + tx
       yd = zoomy*ys + ty



     where a point with coordinates (xs, ys) in the source  image
     is mapped to a point with coordinates (xd, yd) in the desti-
     nation image.


     The width and height of the destination image  can  be  dif-
     ferent from the width and height of the source image.


     The center of the upper-left corner pixel  of  an  image  is
     located at (0.5, 0.5).

PARAMETERS
     The function takes the following arguments:

     dst       Pointer to destination image. It must be  of  type
               MLIB_BYTE and have just one channel.


     src       Pointer to  source  image.  It  must  be  of  type
               MLIB_BIT and have just one channel.






SunOS 5.11           Last change: 2 Mar 2007                    1






mediaLib Library Functions   mlib_ImageZoomTranslateToGray(3MLIB)



     zoomx     X zoom factor. zoomx > 0.


     zoomy     Y zoom factor. zoomy > 0.


     tx        X translation.


     ty        Y translation.


     filter    Type   of   resampling   filter.   It   must    be
               MLIB_NEAREST.


     edge      Type of edge condition. It can be one of the  fol-
               lowing:

                 MLIB_EDGE_DST_NO_WRITE
                 MLIB_EDGE_DST_FILL_ZERO
                 MLIB_EDGE_OP_NEAREST
                 MLIB_EDGE_SRC_EXTEND
                 MLIB_EDGE_SRC_PADDED



     ghigh     Pointer to value for '1' pixels in source image.


     glow      Pointer to value for '0' pixels in source image.


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:















SunOS 5.11           Last change: 2 Mar 2007                    2






mediaLib Library Functions   mlib_ImageZoomTranslateToGray(3MLIB)



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


SEE ALSO
     mlib_ImageSubsampleBinaryToGray(3MLIB), attributes(5)












































SunOS 5.11           Last change: 2 Mar 2007                    3