opensolaris man page for mlib_imagezoomblend

mlib_ImageZoomBlend(3MLIB)				    mediaLib Library Functions					mlib_ImageZoomBlend(3MLIB)

NAME
       mlib_ImageZoomBlend - image scaling with alpha blending

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

       mlib_status mlib_ImageZoomBlend(mlib_image *dst, const mlib_image *src,
	    mlib_d64 zoomx, mlib_d64 zoomy, mlib_filter filter, mlib_edge edge,
	    mlib_blend blend, mlib_s32 alpha, mlib_s32 cmask);

DESCRIPTION
       The  mlib_ImageZoomBlend()  function  will enlarge or minify the source image by the X and Y zoom factors and blend it with the destination
       image.

       This function is a special case of mlib_ImageZoomTranslateBlend() with the center of the source image being mapped to  the  center  of  the
       destination image.

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

       Both src and dst must be of type MLIB_BYTE. They can have either 3 or 4 channels.

       The src image cannot have width or height larger than 32767.

PARAMETERS
       The function takes the following arguments:

       dst	 Pointer to destination image.

       src	 Pointer to first source image.

       zoomx	 X zoom factor. zoomx > 0.0.

       zoomy	 Y zoom factor. zoomy > 0.0.

       filter	 Type of resampling filter. It can be one of the following:

		   MLIB_NEAREST
		   MLIB_BILINEAR
		   MLIB_BICUBIC
		   MLIB_BICUBIC2

       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_EXTEND_INDEF
		   MLIB_EDGE_SRC_PADDED

       blend	 Type of alpha blending. It can be one of the following:

		   MLIB_BLEND_GTK_SRC
		   MLIB_BLEND_GTK_SRC_OVER
		   MLIB_BLEND_GTK_SRC_OVER2

       alpha	 Overall alpha for blending.

       cmask	 Channel mask to indicate the alpha channel.

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	     |Committed 		   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO
       mlib_ImageZoomTranslateBlend(3MLIB), mlib_ImageZoomTranslateTableBlend(3MLIB), attributes(5)

SunOS 5.11							    2 Mar 2007						mlib_ImageZoomBlend(3MLIB)