# NAME

matrix_to_max_contrast_8bit_bw_image - Convert matrix to an image, linearly scaling image from black to white
# 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 matrix_to_max_contrast_8bit_bw_image
(
const Matrix *mp,
KJB_image **out_ipp
);

# DESCRIPTION

This routine accepts a matrix and turns it into a grayscale image, with
the lowest-value matrix entry generating a pixel with R=G=B=0, and the
highest-value matrix entry generating a pixel with R=G=B=255, scaling all
other values linearly within that range. This assumes the matrix is not
constant-valued.
If the input matrix is a constant, the output image will have constant
value R=G=B=128, since that seems reasonable (albeit hacky).
I think this also might occur if the input contains NaN -- not sure.
# 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

Andrew Predoehl
# DOCUMENTER

Andrew Predoehl
# SEE ALSO

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