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

NAME

6       mlib_ImageExtrema2, mlib_ImageExtrema2_Fp - image extrema
7

SYNOPSIS

9       cc [ flag... ] file... -lmlib [ library... ]
10       #include <mlib.h>
11
12       mlib_status mlib_ImageExtrema2(mlib_s32 *min, mlib_s32 *max,
13            const mlib_image *img, mlib_s32 xStart, mlib_s32 yStart,
14            mlib_s32 xPeriod, mlib_s32 yPeriod);
15
16
17       mlib_status mlib_ImageExtrema2_Fp(mlib_d64 *min, mlib_d64 *max,
18            const mlib_image *img, mlib_s32 xStart, mlib_s32 yStart,
19            mlib_s32 xPeriod, mlib_s32 yPeriod);
20
21

DESCRIPTION

23       Each of the functions determines the extrema values for each channel in
24       an image, possibly with subsampling.
25
26
27       It uses the following equation:
28
29         min[i] = MIN{ img[x][y][i] }
30         max[i] = MAX{ img[x][y][i] }
31
32
33
34       where
35
36         x = xStart + p*xPeriod;  0 ≤ p < (w - xStart)/xPeriod
37         y = yStart + q*yPeriod;  0 ≤ q < (h - yStart)/yPeriod
38
39

PARAMETERS

41       Each of the functions takes the following arguments:
42
43       min        Pointer to minimum vector, where length  is  the  number  of
44                  channels  in the image. min[i] contains the minimum of chan‐
45                  nel i.
46
47
48       max        Pointer to maximum vector, where length  is  the  number  of
49                  channels  in the image. max[i] contains the maximum of chan‐
50                  nel i.
51
52
53       img        Pointer to a source image.
54
55
56       xStart     Initial X sample coordinate.
57
58
59       yStart     Initial Y sample coordinate.
60
61
62       xPeriod     X sample rate. xPeriod ≥ 1.
63
64
65       yPeriod     Y sample rate. yPeriod ≥ 1.
66
67

RETURN VALUES

69       The function returns MLIB_SUCCESS if successful. Otherwise  it  returns
70       MLIB_FAILURE.
71

ATTRIBUTES

73       See attributes(5) for descriptions of the following attributes:
74
75
76
77
78       ┌─────────────────────────────┬─────────────────────────────┐
79       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
80       ├─────────────────────────────┼─────────────────────────────┤
81       │Interface Stability          │Committed                    │
82       ├─────────────────────────────┼─────────────────────────────┤
83       │MT-Level                     │MT-Safe                      │
84       └─────────────────────────────┴─────────────────────────────┘
85

SEE ALSO

87       mlib_ImageExtremaLocations(3MLIB),            mlib_ImageMaximum(3MLIB),
88       mlib_ImageMaximum_Fp(3MLIB), mlib_ImageMinimum(3MLIB),  mlib_ImageMini‐
89       mum_Fp(3MLIB), attributes(5)
90
91
92
93SunOS 5.11                        2 Mar 2007         mlib_ImageExtrema2(3MLIB)
Impressum