sunos man page for mlib_imagezoomtranslatetogray

mlib_ImageZoomTranslateToGray(3MLIB)			    mediaLib Library Functions			      mlib_ImageZoomTranslateToGray(3MLIB)

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

SYNOPSIS
       cc [ flag... ] file... -lmlib [ library... ]
       #include <mlib.h>

       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 destination image.

       The width and height of the destination image can be different 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.

       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 following:

		       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 attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Evolving			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+

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

SunOS 5.10							    10 Nov 2004 			      mlib_ImageZoomTranslateToGray(3MLIB)