opensolaris man page for mlib_imagethresh5_inp

mlib_ImageThresh5_Inp(3MLIB)				    mediaLib Library Functions				      mlib_ImageThresh5_Inp(3MLIB)

NAME
       mlib_ImageThresh5_Inp - image thresholding

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

       mlib_status mlib_ImageThresh5_Inp(mlib_image *srcdst,
	    const mlib_s32 *thigh, const mlib_s32 *tlow, const mlib_s32 *gray);

DESCRIPTION
       The  mlib_ImageThresh5_Inp()  function  compares each pixel in the source image to two threshold values, tlow and thigh. If the pixel is in
       between the lower threshold value, tlow, and the higher threshold value, thigh, (inclusive on both sides), then the  destination  pixel	is
       set to the value gray. Otherwise, the destination pixel is set to the value of the source pixel.

       It uses the following equation:

	 srcdst[x][y][i] = gray[i]  if tlow[i] <= 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.

       gray	 Output grayscale level. gray[i] holds the 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_Fp_Inp(3MLIB),  mlib_ImageThresh4_Inp(3MLIB),  mlib_ImageThresh5(3MLIB),   mlib_ImageThresh5_Fp(3MLIB),
       mlib_ImageThresh5_Fp_Inp(3MLIB), attributes(5)

SunOS 5.11							    2 Mar 2007					      mlib_ImageThresh5_Inp(3MLIB)