# NAME

image_to_matrix_vector - Converts an image to a matrix vector of length 3.
# SYNOPSIS

#include "i/i_matrix.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 image_to_matrix_vector
(
const KJB_image *ip,
Matrix_vector **mvpp
);

# DESCRIPTION

This routine converts an image to a matrix vector of length 3. If any the
matrices vector is NULL, then they it is created. If it is not of length 3,
it is resized. Similarly, if any of the matrices in the matrix vector are
NULL, they are created. Also, if any are the wrong size, they are resized.
Otherwise, 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

Kobus Barnard
# SEE ALSO

matrix_vector_to_image
,
rgb_matrix_array_to_image
,
image_to_rgb_matrix_array
,
matrix_to_bw_image
,
matrix_to_max_contrast_8bit_bw_image
,
rgb_matrices_to_image
,
image_to_matrix
,
image_to_matrix_2
,
bw_image_to_matrix
,
image_to_rgb_matrices