NAME

project_vector - Projects RGB vector into a 2-D space

SYNOPSIS

#include "c/c_projection.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 project_vector
(
	Vector **output_vpp,
	const Vector *input_vp,
	Projection_method projection_method
);

DESCRIPTION

This routine projects RGB data into a 2-D space, normally a chromaticity space. The projection method used is specified by the argument "projection_method". This argument should be one of DIVIDE_BY_RED, DIVIDE_BY_GREEN, DIVIDE_BY_BLUE, DIVIDE_BY_SUM, ONTO_RG_PLANE, ONTO_GB_PLANE, and ONTO_RB_PLANE.

RETURNS

NO_ERROR on success and ERROR on failure. The usuall reason for failure is that the denominator is less than DBL_EPSILON.

NOTE

This routine offers simpler semantics to similar (but not identical) operation as get_projection_vector(). The semantics differ if the componants are non-positive.

WARNING

I am still working on this library. Be prepared for change!

DISCLAIMER

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

AUTHOR

Kobus Barnard

DOCUMENTER