opensolaris man page for mlib_imagethresh4_fp_inp

mlib_ImageThresh4_Fp_Inp(3MLIB) 			    mediaLib Library Functions				   mlib_ImageThresh4_Fp_Inp(3MLIB)

NAME
       mlib_ImageThresh4_Fp_Inp - image thresholding

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

       mlib_status mlib_ImageThresh4_Fp_Inp(mlib_image *srcdst,
	    const mlib_d64 *thigh, const mlib_d64 *tlow, const mlib_d64 *ghigh,
	    const mlib_d64 *glow);

DESCRIPTION
       The  mlib_ImageThresh4_Fp_Inp()	function  compares each pixel in the source image to two threshold values, tlow and thigh. If the pixel is
       less than the lower threshold value, tlow, then the destination pixel is set to the lower output level, glow. If the pixel is greater  than
       the higher threshold value, thigh, then the destination pixel is set to the higher output level, ghigh. Otherwise, the destination pixel is
       set to the value of the source pixel.

       It uses the following equation:

	 srcdst[x][y][i] = glow[i]   if srcdst[x][y][i] < tlow[i]
	 srcdst[x][y][i] = ghigh[i]  if srcdst[x][y][i] > thigh[i]

PARAMETERS
       The function takes the following arguments:

       srcdst	 Pointer to source and destination image.

       thigh	 High threshold value. thigh[i] holds the high threshold for channel i.

       tlow	 Low threshold value. tlow[i] holds the low threshold for channel i.

       ghigh	 High output grayscale level. ghigh[i] holds the high output grayscale level for channel i.

       glow	 Low output grayscale level. glow[i] holds the low output grayscale level 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_ImageThresh1(3MLIB),   mlib_ImageThresh1_Fp(3MLIB),   mlib_ImageThresh1_Fp_Inp(3MLIB),   mlib_ImageThresh1_Inp(3MLIB),   mlib_ImageTh-
       resh2(3MLIB),   mlib_ImageThresh2_Fp(3MLIB),   mlib_ImageThresh2_Fp_Inp(3MLIB),	 mlib_ImageThresh2_Inp(3MLIB),	 mlib_ImageThresh3(3MLIB),
       mlib_ImageThresh3_Fp(3MLIB),   mlib_ImageThresh3_Fp_Inp(3MLIB),	 mlib_ImageThresh3_Inp(3MLIB),	 mlib_ImageThresh4(3MLIB),   mlib_ImageTh-
       resh4_Fp(3MLIB),   mlib_ImageThresh4_Inp(3MLIB),  mlib_ImageThresh5(3MLIB),  mlib_ImageThresh5_Fp(3MLIB),  mlib_ImageThresh5_Fp_Inp(3MLIB),
       mlib_ImageThresh5_Inp(3MLIB), attributes(5)

SunOS 5.11							    2 Mar 2007					   mlib_ImageThresh4_Fp_Inp(3MLIB)