mlib_ImageColorTrue2Index(mediaLib Library Funmlib_ImageColorTrue2Index(3MLIB)NAMEmlib_ImageColorTrue2Index - true color to indexed color using nearest
matched LUT entries
SYNOPSIS
cc [ flag... ] file... -lmlib [ library... ]
#include <mlib.h>
mlib_status mlib_ImageColorTrue2Index(mlib_image *dst,
const mlib_image *src, const void *colormap);
DESCRIPTION
The mlib_ImageColorTrue2Index() function converts a true color image to
a pseudo color image with the method of finding the nearest matched
lookup table entry for each pixel. The source image can be an MLIB_BYTE
or MLIB_SHORT image with three or four channels. The destination must
be a single-channel MLIB_BYTE or MLIB_SHORT image.
The last parameter, colormap, is an internal data structure (which
includes the lookup table) for inverse color mapping. Create it by
calling the mlib_ImageColorTrue2IndexInit() function.
PARAMETERS
The function takes the following arguments:
dst Pointer to destination or destination image.
src Pointer to source or source image.
colormap Internal data structure for inverse color mapping.
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 TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Interface Stability │Committed │
├─────────────────────────────┼─────────────────────────────┤
│MT-Level │MT-Safe │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOmlib_ImageColorErrorDiffusion3x3(3MLIB), mlib_ImageColorOrdered‐
Dither8x8(3MLIB), mlib_ImageColorTrue2IndexFree(3MLIB), mlib_ImageCol‐
orTrue2IndexInit(3MLIB), attributes(5)SunOS 5.10 2 Mar 2007 mlib_ImageColorTrue2Index(3MLIB)