NAME

convert_matrix_rgb_to_lab - Converts matrix RGB to L*a*b.

SYNOPSIS

#include "c/c_colour_space.h"

Example compile flags (system dependent):
  -DLINUX_X86_64 -DLINUX_X86_64_OPTERON  -DGNU_COMPILER 
   -I/home/kobus/include
   -L/home/kobus/misc/load/linux_x86_64_opteron -L/usr/lib/x86_64-linux-gnu
  -lKJB                               -lfftw3  -lgsl -lgslcblas -ljpeg  -lSVM -lstdc++                    -lpthread -lSLATEC -lg2c    -lacml -lacml_mv -lblas -lg2c      -lncursesw 


int convert_matrix_rgb_to_lab
(
	Matrix **out_mpp,
	const Matrix *in_mp,
	const Vector *white_rgb_vp
);

DESCRIPTION

This routine converts matrix RGB to L*a*b. This conversion uses an RGB to XYZ matrix. If KJB library options are being made available to the user, then this matrix can be set using the option "rgb-to-xyz-file". If no conversion file has been set, than a default one is used. If no default is available, then sRGB is used. The contents of the third argument, white_rgb_vp, is used as the RGB of the white point. If it is NULL, then RGB=(255,255,255) is used. The output is put into *out_mpp. If *out_mpp is NULL, then it is created. If it is the wrong size, then it is resized. If it is the right size, the storage is recycled as is.

RETURNS

NO_ERROR on success and ERROR on failure, with an error message being set.

DISCLAIMER

This software is not adequatedly tested. It is recomended that results are checked independantly where appropriate.

AUTHOR

Kobus Barnard

DOCUMENTER