1mlib_ImageThresh3(3MLIB)  mediaLib Library Functions  mlib_ImageThresh3(3MLIB)
2
3
4

NAME

6       mlib_ImageThresh3 - image thresholding
7

SYNOPSIS

9       cc [ flag... ] file... -lmlib [ library... ]
10       #include <mlib.h>
11
12       mlib_status mlib_ImageThresh3(mlib_image *dst, const mlib_image *src,
13            const mlib_s32 *thresh, const mlib_s32 *ghigh);
14
15

DESCRIPTION

17       The  mlib_ImageThresh3()  function  compares  each  pixel in the source
18       image to a threshold value. If the pixel is less than or equal  to  the
19       threshold  value, then the destination pixel is set to the value of the
20       source pixel. If the pixel is greater than the  threshold  value,  then
21       the destination pixel is set to the high output level.
22
23
24       It uses the following equation:
25
26         dst[x][y][i] = src[x][y][i]  if src[x][y][i] ≤ thresh[i]
27         dst[x][y][i] = ghigh[i]      if src[x][y][i] > thresh[i]
28
29

PARAMETERS

31       The function takes the following arguments:
32
33       dst       Pointer to destination image.
34
35
36       src       Pointer to source image.
37
38
39       thresh    Threshold value. thresh[i] contains the threshold for channel
40                 i.
41
42
43       ghigh     High output level. ghigh[i] contains the  high  output  level
44                 for channel i.
45
46

RETURN VALUES

48       The  function  returns MLIB_SUCCESS if successful. Otherwise it returns
49       MLIB_FAILURE.
50

ATTRIBUTES

52       See attributes(5) for descriptions of the following attributes:
53
54
55
56
57       ┌─────────────────────────────┬─────────────────────────────┐
58       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
59       ├─────────────────────────────┼─────────────────────────────┤
60       │Interface Stability          │Committed                    │
61       ├─────────────────────────────┼─────────────────────────────┤
62       │MT-Level                     │MT-Safe                      │
63       └─────────────────────────────┴─────────────────────────────┘
64

SEE ALSO

66       mlib_ImageThresh1(3MLIB),  mlib_ImageThresh1_Fp(3MLIB),   mlib_ImageTh‐
67       resh1_Fp_Inp(3MLIB),     mlib_ImageThresh1_Inp(3MLIB),    mlib_ImageTh‐
68       resh2(3MLIB),        mlib_ImageThresh2_Fp(3MLIB),         mlib_ImageTh‐
69       resh2_Fp_Inp(3MLIB),     mlib_ImageThresh2_Inp(3MLIB),    mlib_ImageTh‐
70       resh3_Fp(3MLIB),     mlib_ImageThresh3_Fp_Inp(3MLIB),     mlib_ImageTh‐
71       resh3_Inp(3MLIB),        mlib_ImageThresh4(3MLIB),        mlib_ImageTh‐
72       resh4_Fp(3MLIB),     mlib_ImageThresh4_Fp_Inp(3MLIB),     mlib_ImageTh‐
73       resh4_Inp(3MLIB),        mlib_ImageThresh5(3MLIB),        mlib_ImageTh‐
74       resh5_Fp(3MLIB),     mlib_ImageThresh5_Fp_Inp(3MLIB),     mlib_ImageTh‐
75       resh5_Inp(3MLIB), attributes(5)
76
77
78
79SunOS 5.11                        2 Mar 2007          mlib_ImageThresh3(3MLIB)
Impressum