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