kjb_display_image - Displays an image
Example compile flags (system dependent):
-DLINUX_X86_64 -DLINUX_X86_64_OPTERON -DGNU_COMPILER
-lKJB -lfftw3 -lgsl -lgslcblas -ljpeg -lSVM -lstdc++ -lpthread -lSLATEC -lg2c -lacml -lacml_mv -lblas -lg2c -lncursesw
const KJB_image *ip,
const char *title
This routine is used to display an image. It uses an external program to
actually do the displaying. The program used is the first program in a hard
coded list found in PATH. The list is subject to change, but on 17/08/01 it
An image title can be specified using the parameter "title". If you don't
care to title the displayed image, then the title paramter can be NULL.
Currently, all double quotes in the title string are converted to single
quotes, since double quotes are used down stream to delimit the title.
Images are displayed either with (default) or without the recomended gamma
correction. This is controlled through the "gamma" option which is normally
exposed to the user.
Images may also be corrected by a matrix before display (not by default).
This is controlled throught the "display-matrix-file" option which is also
normally exposed to the user.
Images may be scaled so that their maximum value is 255 (not by default).
This is controlled by the "scale-by-max-rgb" option which is normally exposed
to the user.
Images may be scaled so that their minimum value is 0 and their maximum value
is 255 (not by default). This is controlled by the "adust-image-range"
option which is normally exposed to the user.
On success, the image number is returned. This number can be used as a
handle to manipulate the image from the program (actually, not much has
been implemented here, but you can close the image). On failure, ERROR is
returned on failure, with and appropriate error message being set .
This software is not adequatedly tested. It is recomended that
results are checked independantly where appropriate.