/* #ident "@(#)x11:contrib/clients/xloadimage/README 6.7 91/12/19 Labtam" */
XLI - X11 Image Loading Utility
WHAT IS IT?
xli is a version of xloadimage.
This utility will view several types of images under X11, or load
images onto the root window. The current version (1.00) supports:
CMU Window Manager raster files
Faces Project images
Fuzzy Bitmap (FBM) images
GEM bit images
GIF images
G3 FAX images
JFIF style jpeg Image
McIDAS areafiles
MacPaint images
C Paintbrush (PCX) images
Portable Bitmap (PBM, PGM, PPM) images
Sun monochrome rasterfiles
Sun color RGB rasterfiles
Utah Raster Toolkit (RLE) files
X pixmap files
X10 bitmap files
X11 bitmap files
X Window Dump (except TrueColor and DirectColor)
A variety of options are available to modify images prior to viewing.
These options include clipping, dithering, depth reduction, zoom
(either X or Y axis independently or both at once), brightening or
darkening, gamma correction, and image merging. When applicable, these
options are done automatically (eg a color image to be displayed on a
monochrome screen will be dithered automatically). A utility (xlito) is
provided that allows these viewing options to be appended to the image files.
HOW IS XLI RELATED TO XLOADIMAGE ?
xli version 1.00 is a based on xloadimage version 3.01.
xli is intended to be something to be going on with until xloadimage 4.0
is available.
xloadimage is maintained by Jim Frost - jimf@saber.com
xli was created by Graeme Gill - graeme@labtam.oz.au
Please read the README.orig file, which is the original xloadimage README
file for xloadimage info and acknowledgments.
CHANGES FROM XLOADIMAGE 3.01
Noticeably faster image loading and image type recognition.
Better handling of gamma correction. Gamma of individual images is handled
separately from that of the screen. Allows better compositing of images.
Improved private color map allocation to reduce screen flashing.
Cleaned up memory allocation and de-allocation a fair bit.
fbm now supports full range of depths.
Reduced false image recognition (especially g3 fax images !)
pbm generated g3 images are recognized properly.
Have replaced color quantizer with variance cut color quantiser with
optional color dithering.
Removed a lot of unused code from rlelib.c Fixed bug in seeking through a
file.
Fix padding calculation for sun raster format. Add 32 bit format support.
Add RGB and BGR support.
Fix SYSV timeout stuff.
Add faster rejection of non xbitmap files, so scanning for format
recognition goes faster.
Add faster rejection of non xpixmap files, so scanning for format
recognition goes faster.
X window dumps now work with all endian combinations. Gives a more
comprehensive description of the file format.
zio.c has been modified to add more facilities, speed up character and
string reading, and fix bug in znocache().
xlito support built in. (XLoadImage Trailing Options)
JFIF type JPEG format support.
An attempt has been made to get all the loaders to be more consistent about
error reporting, and more forgiving of corrupted images.
New options:
DISPLAYGAMMA (sets target screen gamma)
COLORDITHER (or CDITHER) (option on variance cut colour reduction)
Changed options:
GAMMA (now applies to individual image)
Please read the manual entry for details on new features.