NAME
make_int_matrix_image - Makes an image from an integer matrix.
SYNOPSIS
#include "i/i_int_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 make_int_matrix_image
(
KJB_image **ipp,
const Int_matrix *mp,
int color_width,
int bw_width,
int bw_brightness_factor
);
DESCRIPTION
This routine makes an image from an integer matrix, mostly for
debuging/visualization purposes. The image created has blocks for each
element of the matrix. There are two different kinds of encodings: color and
black and white. To specify which are wanted, there are two corresponding
width arguments, color_width and bw_width. If either is zero or less, than
the corresponding encoding is ignored. However, at least one has to be
positive. The width of the blocks corresponding to an element in the integer
array is the maximum of the two widths.
If both widths are none zero, the smaller of the two widths becoms a block
inside the larger. It does not make sense to have the sizes the same (the
black and white encoding overwrites the color one). Further, if both widths
are non zero, it is recomended that they are
both odd or even.
The color encoding is adjusted so that their is at least on color with one of
R,G,B at roughly 255.
The black and white encoding is the value scaled by bw_brightness_factor. If
bw_brightness_factor is 1 or less, then 1 is used.
A typical use of this is to have a small black and white square whose RGB
value can be used to look up the value in the array inside a larger color
squares which are coded to easily visualize where values are different.
DISCLAIMER
This software is not adequatedly tested. It is recomended that
results are checked independantly where appropriate.
AUTHOR
Kobus Barnard
DOCUMENTER
Kobus Barnard