Content-type: text/html Man page of mlib_ImageThresh1

mlib_ImageThresh1

Section: mediaLib Library Functions (3MLIB)
Updated: 2 Mar 2007
Index Return to Main Contents
 

NAME

mlib_ImageThresh1 - image thresholding  

SYNOPSIS

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

mlib_status mlib_ImageThresh1(mlib_image *dst, const mlib_image *src,
    const mlib_s32 *thresh, const mlib_s32 *ghigh, const mlib_s32 *glow);

 

DESCRIPTION

The mlib_ImageThresh1() function compares each pixel in the source image to a threshold value. If the pixel is less than or equal to the threshold value, then the destination pixel is set to the low output level. If the pixel is greater than the threshold value, then the destination pixel is set to the high output level.

The data type of the destination image can be MLIB_BIT or can be the same as the data type of the source image.

It uses the following equation:

dst[x][y][i] = glow[i]   if src[x][y][i] ≤ thresh[i]
dst[x][y][i] = ghigh[i]  if src[x][y][i] > thresh[i]

 

PARAMETERS

The function takes the following arguments:

dst

Pointer to destination image.

src

Pointer to source image.

thresh

Threshold value. thresh[i] contains the threshold for channel i.

ghigh

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

glow

Low output level. glow[i] contains the low output 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 TYPEATTRIBUTE VALUE

Interface StabilityCommitted

MT-Level

 

SEE ALSO

mlib_ImageThresh1_Fp(3MLIB), mlib_ImageThresh1_Fp_Inp(3MLIB), mlib_ImageThresh1_Inp(3MLIB), mlib_ImageThresh2(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_ImageThresh4_Fp(3MLIB), mlib_ImageThresh4_Fp_Inp(3MLIB), mlib_ImageThresh4_Inp(3MLIB), mlib_ImageThresh5(3MLIB), mlib_ImageThresh5_Fp(3MLIB), mlib_ImageThresh5_Fp_Inp(3MLIB), mlib_ImageThresh5_Inp(3MLIB), attributes(5)


 

Index

NAME
SYNOPSIS
DESCRIPTION
PARAMETERS
RETURN VALUES
ATTRIBUTES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 02:38:12 GMT, October 02, 2010