mlib_ImageScale2 man page on SunOS

mlib_ImageScale2 man page on SunOS

Man page or keyword search:
man Server 20652 pages
apropos Keyword Search (all sections)
Output format

mlib_ImageScale2(3MLIB)	  mediaLib Library Functions   mlib_ImageScale2(3MLIB)

NAME
       mlib_ImageScale2 - linear scaling

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

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

DESCRIPTION
       The mlib_ImageScale2() function performs a linear scaling on the pixels
       of the source image by multiplying the data by a scale factor and  then
       adding  an  offset. Images must have the same size, and number of chan‐
       nels. They can have 1, 2, 3, or 4 channels.

       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 respectively.

       See the following table for available variations of this linear scaling
       function.

	  Type [*]	BYTE   SHORT	   USHORT	     INT	FLOAT	    DOUBLE
       ────────────────────────────────────────────────────────────────────────────────────────
       MLIB_BYTE	Y      Y       Y		Y		Y	Y
       ────────────────────────────────────────────────────────────────────────────────────────
       MLIB_SHORT	Y      Y       Y		Y		Y	Y
       ────────────────────────────────────────────────────────────────────────────────────────
       MLIB_USHORT	Y      Y       Y		Y		Y	Y
       ────────────────────────────────────────────────────────────────────────────────────────
       MLIB_INT		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.

       src	Pointer to source image.

       alpha	Scaling factor. alpha[i] contains the scaling factor for chan‐
		nel i.

       beta	Offset value. beta[i] contains the offset for channel i.

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_ImageScale(3MLIB),			    mlib_ImageScale_Fp(3MLIB),
       mlib_ImageScale_Fp_Inp(3MLIB),		   mlib_ImageScale_Inp(3MLIB),
       mlib_ImageScale2_Inp(3MLIB), attributes(5)

SunOS 5.10			  2 Mar 2007	       mlib_ImageScale2(3MLIB)

[top]

List of man pages available for SunOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]

Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................

Vote for polarhome