/* #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.