opensolaris man page for mlib_imagethresh5_fp

mlib_ImageThresh5_Fp(3MLIB)				    mediaLib Library Functions				       mlib_ImageThresh5_Fp(3MLIB)

NAME
       mlib_ImageThresh5_Fp - image thresholding

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

       mlib_status mlib_ImageThresh5_Fp(mlib_image *dst, const mlib_image *src,
	    const mlib_d64 *thigh, const mlib_d64 *tlow, const mlib_d64 *gray);

DESCRIPTION
       The  mlib_ImageThresh5_Fp()  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:

	 dst[x][y][i] = src[x][y][i]  if src[x][y][i] < tlow[i]
	 dst[x][y][i] = gray[i]       if tlow[i] <= src[x][y][i] <= thigh[i]
	 dst[x][y][i] = src[x][y][i]  if src[x][y][i] > thigh[i]

PARAMETERS
       The function takes the following arguments:

       dst	Pointer to destination image.

       src	Pointer to source 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_Inp(3MLIB),
       mlib_ImageThresh5_Inp(3MLIB), attributes(5)

SunOS 5.11							    2 Mar 2007					       mlib_ImageThresh5_Fp(3MLIB)