mlib_ImageScale man page on SunOS

mlib_ImageScale man page on SunOS

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

mlib_ImageScale(3MLIB)	  mediaLib Library Functions	mlib_ImageScale(3MLIB)

NAME
       mlib_ImageScale - linear scaling

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

       mlib_status mlib_ImageScale(mlib_image *dst,
	   const mlib_image *src, const mlib_s32 *alpha, const mlib_s32 *beta,
	   mlib_s32 shift);

DESCRIPTION
       The  mlib_ImageScale() function performs a linear scaling on the pixels
       of the source image by multiplying the data by a scale  factor,	shift‐
       ing, and then adding an offset.

       The following equation is used:

	 dst[x][y][i] = src[x][y][i] * alpha[i] * 2**(-shift) +
		       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.

       shift	Right shifting factor.

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

SunOS 5.10			  2 Mar 2007		mlib_ImageScale(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