NAME

invert_image_gamma - Inverts image gamma

SYNOPSIS

#include "i/i_gamma.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 invert_image_gamma
(
	KJB_image **out_ipp,
	const KJB_image *in_ip,
	Vector *gamma_vp
);

DESCRIPTION

This routine puts a linear version of a gamma corected image (in_ip) in the output location (out_ipp). The output image is created or resized as necessary with the usual KJB library semantics. The third argument is a vector of three gamma values one for each channel. If it is NULL, then default gamma is used, either from lookup tables in standard placess (usually not available), or, if that fails, using standard gamma correction.

RETURNS

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

NOTE

This is a separate facility to the linearization mechanism developed in the context of cameras (see i_offset.c). These two facilities have converged to be very similar. This suite of routines is meant to be inverses of the corresponding gamma ones, and were developed in the context of corercting images from random sources, rather than a calibrated camera where we generally have very specific lookup tables.

DISCLAIMER

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

AUTHOR

Kobus Barnard

DOCUMENTER