DDDD III SSSS PPPP LL AAAA YY YY DDDDD III SSSSSS PPPPPP LL AAAAAAAA YY YY DD DD III SSS PP PP LL AA AA YY YY DD DD III SSSSS PPPPPP LL AA AA YYYY DD DD III SSSSS PPPP LL AAAAAAAA YY DD DD III SSS PP LL AA AA YY DDDDD III SSSSSS PP LL AA AA YY DDDD III SSSS PP LLLLLLLL AA AA YY Program written by Jih-Shin Ho (u7711501@bicmos.ee.nctu.edu.tw) Document written by Jih-Shin Ho (u7711501@bicmos.ee.nctu.edu.tw) Oliver Weyand (chbrin3@nyx.uni-konstanz.de) Bernhard Maerz (F58394@rio.ngate.uni-regensburg.de) Document modified by Ben Jos Walbeehm (abruzzis@cas.usf.edu) Copyright (C) 1993-1996 by Jih-Shin Ho. All rights reserved. !!! Permission to use and distribute DISPLAY(Executable format) !!! !!! for any purpose and without fee is hereby granted, provied !!! !!! that you don't make profit from DISPLAY directly. That is, you !!! !!! can use DISPLAY to create things you like and sell them, but !!! !!! !!! !!! you CAN'T sell DISPLAY. !!! !!! !!! !!! For BBS and software distribution sites, some handling charge !!! !!! is allowed. !!! !!! This software is provided "as is" without express or implied !!! !!! warranty. The author is not responsible for any damage caused by !!! !!! this program. !!! Table of Contents: ------------------ (1) Introduction (2) General Notes (3) Supported Formats (4) Command Line Switches (5) Function Keys (6) Mouse Buttons (7) Screen saver (8) Preview (9) Initialization steps (10) Menu (11) Special Effects (12) Tech. information (13) About the author (14) Final (1) Introduction ================ This program lets you READ, WRITE and DISPLAY images/movies with different formats. It lets you do some special effects (rotation, dithering, ...) on images as well. Features: Includes simple file management system. Supports 'slide show', 'batch conversion', 'contact sheet making', 'image preview'. There is NO LIMIT on image size. This program supports 8, 15, 16, 24 bits display. + Supports movie files (DL, FLI/FLC, RAW, MPEG, AVI, GL, IFF/ANIM, QT). Supports FLC making. Tiny screen saver. CD player (including Volume control for Sound Blaster). + Supports sound for AVI, QT; MPEG, FLI/FLC, DL, RAW with WAV file. + Simple WAV, AU player. Supports mouse. This Program is MEMORY-GREEDY. If you do not have enough memory, its performance is poor. The official site is NCTUCCCA.edu.tw:/PC/graphics/disp. The IP address is 140.111.1.10 or 192.83.166.10 The beta test version of next release is in the beta directory. I often upload DISPLAY to SimTel. So if NCTUCCCA is too slow, you can try: oak.oakland.edu:/SimTel/msdos/graphics. Filenames are : disp???a.zip, disp???b.zip. ??? is version number. (2) General Notes ================= Line begins with '+' is newly added/modified after last version. Resources/parameters are in config file, config.dis. This file is read when DISPLAY starts up. You can use text editor to edit config.dis. If you encounter something unknown, please read display.faq and config.dis. (3) Supported Formats ===================== Read: GIF(.gif)*, Japan MAG(.mag), Japan PIC(.jpc), Sun Raster(.ras), Jpeg in Jfif(.jpg)*, XBM(.xbm), Utah RLE(.rle), PBM(.pbm), PGM(.pgm), PPM(.ppm), PM(.pm), PCX(.pcx), Japan MKI(.mki), Tiff(.tif), Targa(.tga), XPM(.xpm), Mac Paint(.mac), GEM/IMG(.img), IFF/ILBM/PBM(.iff,.lbm), Windows BMP(.bmp), QRT ray tracing(.qrt), Mac PICT(.pct), VIS(.vis), PDS(.pds), VIKING(.vik), VICAR(.vic), FITS(.fit), Usenix FACE(.fac), IRIS/SGI(.sgi), YUV(.yuv), RAW RGB(.rgb), PCPAINT/Pictor(.pic,.clp), RAW GREY(.gry), Photo-CD(.pcd), VORT output(.pix), WordPerfect Graphics(.wpg), Windows ICON(.ico), ANSI screen file(.ans), Image INDEX(.idx), VIVID output(.img,.viv), Thumbnail(.tnl), Dr. Halo(.cut), Japan PI(.pi), PNG(.png)*. DL(.dl), FLI(.fli), FLC(.flc), RAW(.raw, produced by DMPEG), + MPEG(.mpg), AVI(.avi), GL(.gl), IFF/ANIM(.anm), QuickTime (.mov). + RIFF/WAVE(.wav), Sun au(.au). the extensions in () are standard extensions. Write: GIF*, Sun Raster, Jpeg*, XBM, PBM, PGM, PPM, PM, Tiff, Targa, XPM, Mac Paint, Ascii, Laser Jet, IFF/ILBM, Windows BMP, Mac PICT, VIS, FITS, FACE, PCX, GEM/IMG, IRIS/SGI, YUV, RAW RGB, Postscript, RAW GREY, Wordperfect Graphics, Windows ICON, Image INDEX(.idx), ANSI screen file, Thumbnail, Dr. Halo, PNG*. Preview: GIF, Jpeg, Windows BMP, PBM, PGM, PPM, Targa, PCX, Mac Paint, Photo-CD, PNG, XBM, Sun Raster, Thumbnail, GEM/IMG, Windows ICON, WPG, FACE, IFF/ILBM, XPM, IRIS/SGI. '*' means 'support image comment'. All Read/Write formats support full color(8 bits), grey scale, b/w dither, and 24 bits image, if allowed for that format. (4) Command Line Switches ========================= DISPLAY understands several command-line parameters. Some of them are useful for setting up your preferred configuration or overwriting config.dis options. Others are for command-line processing. Symbol : aaa | bbb : You can use aaa or bbb. They are equivalent. [ aaa ] : aaa is optional. < aaa > : Use other value or string to replace aaa. (a) For normal use : display [-d|--display <initial_display_type>] [-s|--sort <sort_method>] [-f <config_file>] [-c <config_file] [-a] [-n l|g] [--help|-?] [--target|-t <working_directory>] [--mask|-m 'filename_mask'] [--report|-r <report_file>] initial_display_type: 8 (SVGA, default), 15, 16 (HiColor), 24 (TrueColor) sort_method: 'name', 'ext'. -f: Read user specified config file only. -c: Read Local, Global and user specified config file. -a: Always set to highest display type -n: Do not read Local or Global config file. Global: where DISPLAY.EXE resides. Local: where you start DISPLAY. -t: change to the specified directory when DISPLAY starts up. filename_mask: separated by ';'. quotation marks are needed before and after + filename_mask. Mask length should be less than 128. report_file: Contains useful information generated by DISPLAY. Please don't use relative path(e.g.: ../qqq/report). (b) For command-line single image/movie viewing : display [--width|-w <image_width>] [--height|-h <image_height>] + [--noask|-k] [--stay] [--type <standard extension>] image/movie_file -w & -h: For image format without information header(YUV,RGB,GREY). -k: Don't ask any question, start movie playing immediately. + --stay: Don't exit DISPLAY after viewing. + --type: Specify the input image type. (c) For command-line batch conversion : display --batch | -b <output_format> [--bw|--grey|--color|--true|--same] [--stay] [--dialog | -g] [--report|-r <report_file>] [--effect] [--width|-w <image_width>] [--height|-h <image_height>] [--skip <bytes>] [-i] input_file | input_file output_directory | input_file output_file | input_files output_directory output_format: Standard extensions. Like gif, bmp ... (see section (6)) bw,grey,color,true: B/W dither, Grey scale, 8bit full color, 24bit true color. same: The same color format as input image. If input is 24-bit image, output is saved as true color image (if possible). Otherwise output is saved as 8bit full color image. The default color type for batch conversion is 8bit full color. -g: DISPLAY will let you change the setting of output_format if there is any. + --stay: Don't exit DISPLAY after viewing. + --effect: Perform default special effects (in config.dis) on images. + --skip: Number of bytes to skip before reading .GRY and .RGB images. + -w & -h: For images format without information header(YUV,RGB,GREY). + -i : Don't initialize screen. (d) For command-line slide show : display [--slide|-l] [--noask|-k] [--report|-r <report_file>] [--stay] image_files | @response_file -l: Tell DISPLAY you want slide show (even for single file). -k: Don't ask any question, start slide show immediately. response_file: please refer to display.faq. + --stay: Don't exit DISPLAY after viewing. (e) For command-line contact sheet generation : display --sheet|-e <batch_contact_sheet_script> [--report|-r <report_file>] for the batch_contact_sheet_script format, read display.faq. (f) For command-line movies (more than 1) playing : display --mov...
Janusz40