1mlib_ImageColorTrue2IndexInmietd(i3aMLLiIbB)LibrarymFluinbc_tIimoangseColorTrue2IndexInit(3MLIB)
2
3
4

NAME

6       mlib_ImageColorTrue2IndexInit   -  initialization  for  true  color  to
7       indexed color conversion
8

SYNOPSIS

10       cc [ flag... ] file... -lmlib [ library... ]
11       #include <mlib.h>
12
13       mlib_status mlib_ImageColorTrue2IndexInit(void **colormap, mlib_s32 bits,
14            mlib_type intype, mlib_type outtype, mlib_s32 channels,
15            mlib_s32 entries, mlib_s32 offset, const void **table);
16
17

DESCRIPTION

19       The mlib_ImageColorTrue2IndexInit() function creates and initializes an
20       internal  data  structure  based  on  the  input lookup table and other
21       parameters for inverse color mapping.
22
23
24       The lookup table can have either three or four channels. The number  of
25       channels of the lookup table should match that of the source image pro‐
26       vided to the function that will use the colormap structure  created  by
27       this function.
28
29
30       The type of the lookup table can be one of the following:
31
32         MLIB_BYTE in, MLIB_BYTE out (i.e., BYTE-to-BYTE)
33         MLIB_SHORT in, MLIB_SHORT out (i.e., SHORT-to-SHORT)
34         MLIB_SHORT in, MLIB_BYTE out (i.e., SHORT-to-BYTE)
35
36
37
38       The  input type of the lookup table should match the type of the desti‐
39       nation image; the output type of the  lookup  table  should  match  the
40       source  image  type.  The  source and destination images are the images
41       provided to the function that is going to use  the  colormap  structure
42       created by mlib_ImageColorTrue2IndexInit() to do inverse color mapping.
43

PARAMETERS

45       The function takes the following arguments:
46
47       colormap    Internal data structure for inverse color mapping.
48
49
50       bits        Number of bits per color component used in the colorcube of
51                   the colormap structure. (If bits = 0, then no colorcube  is
52                   created.  But  the  inverse  color mapping might be done by
53                   using the original lookup table.)
54
55
56       intype      Data type of the source image and lookup table.
57
58
59       outtype     Data type of the destination indexed image.
60
61
62       channels    Number of channels of the lookup table.
63
64
65       entries     Number of entries of the lookup table.
66
67
68       offset      The first entry offset of the lookup table.
69
70
71       table       The lookup table (LUT).
72
73

RETURN VALUES

75       The function returns MLIB_SUCCESS if successful. Otherwise  it  returns
76       MLIB_FAILURE.
77

ATTRIBUTES

79       See attributes(5) for descriptions of the following attributes:
80
81
82
83
84       ┌─────────────────────────────┬─────────────────────────────┐
85       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
86       ├─────────────────────────────┼─────────────────────────────┤
87       │Interface Stability          │Committed                    │
88       ├─────────────────────────────┼─────────────────────────────┤
89       │MT-Level                     │MT-Safe                      │
90       └─────────────────────────────┴─────────────────────────────┘
91

SEE ALSO

93       mlib_ImageColorErrorDiffusion3x3(3MLIB),        mlib_ImageColorOrdered‐
94       Dither8x8(3MLIB),   mlib_ImageColorTrue2Index(3MLIB),    mlib_ImageCol‐
95       orTrue2IndexFree(3MLIB), attributes(5)
96
97
98
99SunOS 5.11                        2 Mar 200m7lib_ImageColorTrue2IndexInit(3MLIB)
Impressum