mlib_ImageThresh5(3MLIB) mediaLib Library Functions mlib_ImageThresh5(3MLIB)NAMEmlib_ImageThresh5 - image thresholding
SYNOPSIS
cc [ flag... ] file... -lmlib [ library... ]
#include <mlib.h>
mlib_status mlib_ImageThresh5(mlib_image *dst, const mlib_image *src,
const mlib_s32 *thigh, const mlib_s32 *tlow, const mlib_s32 *gray);
DESCRIPTION
The mlib_ImageThresh5() 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 ALSOmlib_ImageThresh1(3MLIB), mlib_ImageThresh1_Fp(3MLIB), mlib_ImageTh‐
resh1_Fp_Inp(3MLIB), mlib_ImageThresh1_Inp(3MLIB), mlib_ImageTh‐
resh2(3MLIB), mlib_ImageThresh2_Fp(3MLIB), mlib_ImageTh‐
resh2_Fp_Inp(3MLIB), mlib_ImageThresh2_Inp(3MLIB), mlib_ImageTh‐
resh3(3MLIB), mlib_ImageThresh3_Fp(3MLIB), mlib_ImageTh‐
resh3_Fp_Inp(3MLIB), mlib_ImageThresh3_Inp(3MLIB), mlib_ImageTh‐
resh4(3MLIB), mlib_ImageThresh4_Fp(3MLIB), mlib_ImageTh‐
resh4_Fp_Inp(3MLIB), mlib_ImageThresh4_Inp(3MLIB), mlib_ImageTh‐
resh5_Fp(3MLIB), mlib_ImageThresh5_Fp_Inp(3MLIB), mlib_ImageTh‐
resh5_Inp(3MLIB), attributes(5)SunOS 5.10 2 Mar 2007 mlib_ImageThresh5(3MLIB)
