NAME
kjb_display_image - Displays an image
SYNOPSIS
#include "i/i_float_io.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 kjb_display_image
(
const KJB_image *ip,
const char *title
);
DESCRIPTION
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
was:
| kjb_display
display
xv
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.
RETURNS
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 .
RELATED
close_displayed_image
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
kjb_read_image
,
kjb_read_image_2
,
kjb_write_image
,
display_matrix