1mlib_ImageCopyMask_Fp(3MLIBm)ediaLib Library Functionmslib_ImageCopyMask_Fp(3MLIB)
2
3
4

NAME

6       mlib_ImageCopyMask_Fp - copy with mask, floating-point
7

SYNOPSIS

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

DESCRIPTION

17       The  mlib_ImageCopyMask_Fp() function copies one image to another image
18       via a mask image by using it as a yes/no indicator. The  data  type  of
19       the images can be MLIB_FLOAT or MLIB_DOUBLE.
20
21
22       It uses the following equation:
23
24         dst[x][y][i] = src[x][y][i]  if mask[x][y][i] ≤ thresh[i]
25         dst[x][y][i] = dst[x][y][i]  if mask[x][y][i] > thresh[i]
26
27

PARAMETERS

29       The function takes the following arguments:
30
31       dst       Pointer to destination image.
32
33
34       src       Pointer to source image.
35
36
37       mask      Pointer to mask image.
38
39
40       thresh    Threshold  for the mask image. thresh[i] contains the thresh‐
41                 old for channel i.
42
43

RETURN VALUES

45       The function returns MLIB_SUCCESS if successful. Otherwise  it  returns
46       MLIB_FAILURE.
47

ATTRIBUTES

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

SEE ALSO

63       mlib_ImageCopy(3MLIB),    mlib_ImageCopyArea(3MLIB),    mlib_ImageCopy‐
64       Mask(3MLIB), mlib_ImageCopySubimage(3MLIB), attributes(5)
65
66
67
68SunOS 5.11                        2 Mar 2007      mlib_ImageCopyMask_Fp(3MLIB)
Impressum