mlib_ImageColorTrue2Index(3MLIB)

Name

mlib_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 also

mlib_ImageColorErrorDiffusion3x3(3MLIB), mlib_ImageColorOrderedDither8x8(3MLIB), mlib_ImageColorTrue2IndexFree(3MLIB), mlib_ImageColorTrue2IndexInit(3MLIB), attributes(5)