NAME

get_image_pixels - Puts all valid pixels into an Nx3 array.

SYNOPSIS

#include "i/i_data.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 get_image_pixels
(
	const KJB_image *ip,
	Matrix **mpp
);

DESCRIPTION

This routine puts all valid image pixels into an Nx3 array (one row for each pixel). If the target matrix *mpp is NULL, then it is created. If it is the wrong size, it is resized. Finally, if it is the right size, then the storage is recycled as is.

RETURNS

NO_ERROR on success, and ERROR on failure, with an appropriate 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