home *** CD-ROM | disk | FTP | other *** search
/ 1st Canadian Shareware Disc / 1st_Canadian_Shareware_Disc_1991.ISO / graphics / vuimg296 / vuimg.doc < prev    next >
Text File  |  1991-01-30  |  48KB  |  1,091 lines
  1.                   VUIMAGE(tm) (Version 2.96) (Shareware)
  2.                 GIF*/TIFF Format Picture Viewer/Printer
  3.         Copyright (C) 1990 Offe Enterprises. All rights reserved.
  4.  
  5.                                 USERS MANUAL
  6.  
  7.  Offe Enterprises, 1163 E. Ogden Ave.  #705-131, Naperville, IL 60563  USA
  8.                                 708-357-6679
  9.  
  10.    ------------------------------------------------------------------------ 
  11.   | A list of changes in this version is provided at the end of this file. |
  12.   | Some of the sources from where the latest version can usually be       |
  13.   | obtained are listed at the end of this file.                           |
  14.    ------------------------------------------------------------------------ 
  15.  
  16. *  GIF and "Graphics Interchange Format" are trademarks (tm) of Compuserve,
  17.    Inc., an H&R block company.  PostScript is a trademark of Adobe Systems, Inc.
  18.    VUIMAGE, VUIMAGE PLUS, TBG and SCRtoPS are trademarks of Offe Enterprises.
  19.  
  20.  
  21. ==============================================================================
  22.  
  23. FEATURES
  24. --------
  25.  
  26. Offe is proud to bring you our GIF/TIFF display/print software for the 
  27. IBM PC family.  Its main features are:
  28.  
  29.     - super fast display of GIF files and bilevel/grayscale TIFF files
  30.     - print GIF and TIFF files (six dithering options)
  31.     - handles large images while needing only 160K of free memory*
  32.     - Support for the GIF89a standard - plain text, graphics control, comment
  33.       extensions, restore to background, restore to previous etc.
  34.     - print entire image, set your own print size
  35.     - supports a variety of display types - CGA/Hercules/6300/DEB/EGA/MCGA/
  36.       VGA/SuperVGA/VESA SuperVGA
  37.     - 320x400x256, 360x480x256 and 800x600x16 driver for standard IBM VGA
  38.     - VESA SuperVGA driver for all SuperVGA cards that have VESA BIOS support.
  39.       Supports the following VESA standard modes (if available in card):
  40.        800x600x16, 1024x768x26, 1280x1024x16
  41.        640x400x256, 640x480x256, 800x600x256, 1024x768x256, 1280x1024x256
  42.     - excellent color rendition in all video modes
  43.     - six dithering options for two-color video modes
  44.     - handles large images with low memory requirement
  45.     - automatic/manual video mode selection capability
  46.     - auto/manual scaling - automatically scale to full screen or
  47.       manually scale from 1% to 999%
  48.     - zoom in / zoom out using the "+" and "-" keys
  49.     - panning - cursor keys allow moving screen window over different sections
  50.       of picture 
  51.     - adjust brightness and contrast, autoscale etc. while picture is on screen
  52.     - supports other boards/future boards through BIOS mode
  53.     - user-friendly, multiple interfaces
  54.         - menu-selectable options
  55.         - command-line selectable options (useful in batch files and when
  56.           called as a sub-program by other programs)
  57.         - pre-programmed keystroke mode (std. input re-direction)
  58.     - select files using cursor or by file numbers
  59.     - specify a list of files to be displayed, move forward/backward in list
  60.     - continuously repeat list of files (for demos etc.)
  61.     - Sort directory alphabetically, by date or by filesize, or disable sort
  62.     - List directory in short, medium or long format
  63.     - abort single picture or list of pictures in the middle
  64.     - handles corrupt files well
  65.     - returns DOS errorlevel value (useful in batch files and when
  66.       called as a sub-program by other programs)
  67.     - user selectable menu screen colors
  68.     - includes utility to convert interlaced GIF files to non-interlaced
  69.       GIF files 
  70.     - display quick picture info without displaying picture
  71.  
  72. * GIF89a images that use "restore to previous" function need may need more
  73.   memory for complete restoral to previous.
  74.  
  75.  
  76. ==============================================================================
  77.  
  78. FOR REGISTERED USERS
  79. --------------------
  80.  
  81. Registered users get VUIMAGE PLUS(tm) Version 2.96, our non-shareware version
  82. of the program with the following added features:
  83.  
  84. - the program configuration can be saved
  85.  
  86. - menus may be disabled and file (or files) to be shown may be specified from
  87.   the command line (in this mode, the image may be left on the screen when
  88.   the program ends)
  89.  
  90. - print options (printer select, set print size, printer port etc.) can
  91.   be specifed from the command line 
  92.  
  93. - invert images by pressing the "i" key after the picture has been displayed
  94.   on the screen 
  95.  
  96. - PCX files can also be viewed
  97.  
  98. - compressed bilevel TIFF files (compression type - CCITT Group 3-1D or
  99.   compression type PackBits) can be viewed.  Many scanners come with
  100.   software that can produce such files.
  101.  
  102. - most uncompressed TIFF 8-bit palette color images can be viewed.
  103.  
  104. ==============================================================================
  105.  
  106. REGISTRATION
  107. ------------
  108.  
  109. This version of the program is released as shareware. It is not free and is
  110. not in the public domain.  Private, non-commercial users are requested to
  111. register and support its continued development.  Registered users get
  112. VUIMAGE PLUS(tm) Ver 2.96.  To register, please use the order form supplied
  113. with this package, or send your name, address and phone number(s) with the
  114. registration fee of US $30.00** to:
  115.  
  116. Offe Enterprises, 1163 E. Ogden Ave.  #705-131, Naperville, IL 60563  USA
  117.  
  118. (Outside US, please add $5.00**).  Telephone: (708)-357-6679 (USA)
  119.  
  120. Any use of VUIMAGE(tm) in a commercial environment is illegal and is strictly
  121. prohibited.  Commercial users should purchase VUIMAGE PLUS(tm), the
  122. non-shareware version.  Volume discounts and site licenses are available for
  123. VUIMAGE PLUS(tm).  Contact Offe Enterprises for customized versions.
  124.  
  125.  
  126. DISTRIBUTION
  127. ------------
  128.  
  129. You may make copies of the program files for VUIMAGE(tm) and the documentation
  130. VUIMG.DOC (this file) together and distribute them to others, upload to
  131. bulletin boards etc. for non-commercial purposes. The program files should
  132. not be distributed without the documentation file VUIMG.DOC.  None of the
  133. files should be modified in any way.  
  134.  
  135.  
  136.  
  137.  OTHER PROGRAMS AVAILABLE FROM OFFE ENTERPRISES:
  138. -----------------------------------------------
  139.  
  140.    TBG(tm)     - TIFF black&white/grayscale image to GIF/TIFF black&white/
  141.                  grayscale converter (can reduce large b&w images to smaller
  142.                  grayscale ones for easier viewing, convert TIFF to GIF etc.).
  143.                  Commandline options for non-interactive conversion.
  144.  
  145.    SCRtoPS(tm) - Dump text and graphics screens (CGA/EGA/VGA) to PostScript*
  146.                  printer or capture to Encapsulated PostScript file (including
  147.                  line/box characters).  Requires only about 10K of resident
  148.                  memory.
  149.  
  150.    See file PROGRAMS.DOC for more information on these programs.
  151. ==============================================================================
  152.  
  153.  
  154.    *******************************  NOTICE  ********************************
  155.    *                                                                       *
  156.    *    This program, and all supporting programs and documentation are    *
  157.    *    provided "as is" without warranty of any kind, either expressed    *
  158.    *    or implied, including but not limited to the implied warranties    *
  159.    *    of merchantability and fitness for a particular purpose.  In no    *
  160.    *    event will  Offe Enterprises  be liable  to you for any damages    *
  161.    *    arising out of the use or  inability to use this program and/or    *
  162.    *    all supporting programs and documentation.                         *
  163.    *************************************************************************
  164.  
  165. ** All prices and other information are subject to change without notice.
  166.  
  167.  
  168.  
  169. INSTALLATION AND USAGE
  170. ----------------------
  171.  
  172. Note: Requires MS-DOS Version 2.0 or later and at least 160K of free memory.
  173.  
  174. 1.  FLOPPY DISK  Copy all the files from the program disk to another floppy
  175.                  disk.  Use this as your working disk - place this disk into
  176.                  drive A:, type "A:" and press return.  Go to step 2.
  177.  
  178.     HARD DISK    Make a new subdirectory.  For example, if you are using
  179.                  drive C: and the subdirectory name you want is \VUIMAGE, enter
  180.                           c:
  181.                           md \vuimage
  182.                  Now make this subdirectory your current directory.  In our
  183.                  example, enter
  184.                           cd  \vuimage
  185.                  Copy all the files from the program disk to this subdirectory.
  186.                  Go to step 2.
  187.  
  188. 2.  Now all the files are in the current drive/directory.  To start the program,
  189.     type "vuimg"  at the DOS prompt and press return.
  190.  
  191.     You will be placed in the main menu.  Also shown will be a list of files
  192.     in the current directory that have the extension "GIF".  The current display
  193.     mode will be displayed at the bottom left of the screen.  The main menu
  194.     options are displayed at the bottom right of the screen.
  195.  
  196.     Press "Q" to quit back to DOS.  Go to step 3.
  197.  
  198. 3.  You can execute the program any time by changing to the subdirectory that
  199.     has the program files and typing "vuimg"  as in step 2.  However, so that
  200.     you can execute the program from any directory, you should include the
  201.     directory containing the program files as part of your "PATH".  The PATH
  202.     is a list of directories that DOS will search when you type in a command.
  203.     Refer to your DOS manual for information on PATH and how to add a 
  204.     sub-directory to your PATH.
  205.  
  206.  
  207. PROGRAM CONFIGURATION
  208. ---------------------
  209.  
  210.     VUIMAGE PLUS(tm) users can configure the program by making selections
  211.     through the various menus and/or through commandline options, and then
  212.     saving the configuration using the "z" key of the Options menu. 
  213.  
  214.     VUIMAGE(tm) shareware version users can configure the program using 
  215.     "batch" files.  You can create a batch file by typing
  216.  
  217.           copy con: v.bat     <return>
  218.  
  219.     where "v.bat" is the name of the batch file.  Now enter the program
  220.     name along with the drive and directory name.  For example,
  221.  
  222.           c:\vuimage\vuimg    <return>
  223.  
  224.     Then press <ctrl>-Z followed by a <return> to finish creating the batch
  225.     file (you can also use an editor to create this file).  Now you can start
  226.     the program by typing "v" and return.  The batch file need not be kept
  227.     in the same subdirectory as the program files.  However, the sub-directory
  228.     that it is kept in must be part of your "PATH".  The PATH is a list of
  229.     directories that DOS will search when you type in a command.  Refer to
  230.     your DOS manual for information on PATH and how to add a sub-directory to
  231.     your PATH.
  232.  
  233.     After you become familiar with the command line options of the program (see
  234.     later section on command line options), you can re-create the batch file 
  235.     and also specify the command line options that you normally prefer to use.
  236.     This way you can "configure" the program to suit your needs.
  237.  
  238.  
  239. MAIN MENU
  240. ---------
  241.  
  242. From the main menu, at the "File(s)" prompt, you can enter:
  243.  
  244.         - "t" to select the file type - GIF or TIFF
  245.  
  246.         - "m" to change the display mode
  247.  
  248.         - "s" to change the scaling options
  249.  
  250.         - "o" to change other user selectable options
  251.  
  252.         - "d" to select a different directory/different group of files
  253.  
  254.         - "q" or ESC to quit and go back to DOS.
  255.  
  256.         - a list of picture files to be displayed.  For example, enter
  257.  
  258.                 3,1,5-7,17-14  <return>
  259.  
  260.            to display files 3,1,5,6,7,17,16,15,14 from the list (in that order).
  261.  
  262.         - One of the arrow keys to select files using the cursor keys.
  263.  
  264.           To display a single file, move the cursor bar to the file
  265.           and press enter.  To display a list of files, move to each file
  266.           and press the space bar to select (mark) the file.  Press enter to
  267.           display the marked files or "/" to continuously repeat the list of
  268.           files.  If there are too many files to fit on one screen, use the
  269.           PgUp/PgDn keys to see other files.
  270.  
  271.           After moving the cursor to a specific file, you can press the
  272.           "Insert" key to obtain quick information about the file.
  273.  
  274.  
  275. SELECTING THE FILE TYPE
  276. -----------------------
  277.  
  278. The default file type is "GIF".  To select between TIFF and GIF,
  279. press "t" at the main menu prompt.  You can also select the file type from
  280. the command line using the "-T" option (for example, -Ttiff will select TIFF -
  281. see section on command line options).
  282.  
  283.  
  284. SETTING THE DISPLAY MODE
  285. ------------------------
  286.  
  287. The program selects a video display mode appropriate for the video adapter
  288. and the picture being displayed automatically.  The mode is chosen from the
  289. CGA/Hercules/EGA/VGA modes present and any modes supported by any extended
  290. mode driver that has been loaded (extended mode drivers are selected by the
  291. command line option "-v" - see section "Display Boards and Extended
  292. Modes/Drivers" for more details on extended modes).  SuperVGA modes are
  293. extended modes.
  294.  
  295. If the user desires to select a particular video mode to display the picture
  296. instead of the automatically selected mode, this can be done by pressing
  297. "m" at the main menu prompt, going into the display mode menu and changing
  298. the display mode.  An appropriate mode supported by your video display
  299. board may be specified.  If any extended video mode drivers have been
  300. loaded, the extended modes supported by these drivers are also listed.
  301.  
  302. Instead of using the menu, you can also specify the mode to be used from the
  303. command line by using the "-m" option (for example, "-m7" will use the
  304. EGA 640x350 16-color mode - see section on command line options).
  305.  
  306. There is also a "BIOS" mode that you can use for extended modes that are
  307. unsupported.  Your display board will need to provide complete BIOS support.
  308. Usually the BIOS mode is extremely slow. 
  309.  
  310. If you are using a video mode that has only 2 colors, you can use dithering
  311. to improve the displayed picture.  Use the Options menu to select a type
  312. of dithering to be used for 2-color modes.  A suggested dither option for
  313. 2-color displays is 3 (3x3).  To view interlaced files correctly when
  314. dithering is used, convert them to non-interlaced files by using the
  315. utility NINTLACE.EXE.  (See section on interlaced files later).
  316.  
  317.  
  318.  
  319. DISPLAYING PICTURE FILES
  320. ------------------------
  321.  
  322. You can select one file or a list of files to view in one of two ways:
  323.  
  324. Method 1:  From the main menu, enter the number of the file you wish to
  325.            display and press return.  If you wish to display a sequence of
  326.            files, you can enter a set of numbers, separated by commas:
  327.  
  328.            Example:  3,5 <return> will display file 3 followed by file 5. 
  329.  
  330.            You can enter a starting number and an ending number to display
  331.            a list of files:
  332.  
  333.            Example:  2,5-7 <return> will display files 2, 5, 6 and 7.
  334.            Example:  2,7-5 <return> will display files 2, 7, 6 and 5.
  335.  
  336.            After you enter a list of files (or one file) and press return,
  337.            the picture(s) are displayed in sequence.
  338.  
  339. Method 2:  Alternately, you can use the cursor keys to move the cursor bar
  340.            (initially placed on file 1) to the file you wish to view, and
  341.            press enter to view the file.  To select a list of files,
  342.            "mark" each file by moving the cursor bar to it and then
  343.            pressing the space bar.  When you press return, the files
  344.            will be displayed in sequence.
  345.  
  346.  
  347. TIMEOUT
  348. -------
  349.  
  350. Each picture is displayed for a default time of 20 seconds.  Pressing a
  351. return, however, will force the display to end and move on to the next
  352. picture or back to the main menu.  Pressing the backspace key will move back
  353. to the previous picture if a list of pictures is being viewed.
  354.  
  355. The timeout value can be changed from the "Options" menu or from the command
  356. line using the -t option.
  357.  
  358. If the "@" key is pressed after drawing the picture on screen, the timeout
  359. is disabled.  In this case the picture will continue to be displayed
  360. until another key is pressed.
  361.  
  362. If you use a screen grabber program to capture the displayed image and
  363. you are not successful, use of the "@" key may help.
  364.  
  365.  
  366. ABORT PICTURE
  367. -------------
  368.  
  369. Pressing the ESC key while a picture is being drawn aborts that picture.
  370. You can abort a list of pictures by pressing the ESC key twice.
  371.  
  372.  
  373. REPEATING LISTS ( CONTINUOUS SLIDE SHOW MODE )
  374. ----------------------------------------------
  375.  
  376. When you enter a list of pictures in the main menu, if you end the list with
  377. the forward slash ("/") instead of a <return>, the list will be continuously
  378. repeated.  To abort this repeated display, press the ESC key twice in quick
  379. succession.
  380.  
  381.  
  382. SELECTING THE DISPLAY DIRECTORY
  383. -------------------------------
  384.  
  385. From the main menu, press "d" to change the display directory (the directory
  386. containing the picture files).  The files in this directory will be listed
  387. when you return to the main menu.
  388.  
  389. If only a directory name is specified, all files that have an extension of
  390. GIF or TIF (depending on file type selected) in that directory will be
  391. displayed.  If you want to list other files also, enter an appropriate string
  392. to be matched.
  393.  
  394. Examples:
  395.           To list                                       Enter
  396.  
  397. all files in the current directory                      *.*<return>
  398.  
  399. all files with extension GIF in the current directory   *.gif<return>
  400.  
  401. all files with extension GIF or TIF (depending on       pics<return>
  402.   file type) in the subdirectory "pics" of the
  403.   current directory
  404.  
  405. all files with extension GIF or TIF (depending on       \picdir<return>
  406.   file type) in the subdirectory "picdir" of the
  407.   root directory
  408.  
  409. all files in the subdirectory "picdir" of the root      \picdir\*.*<return>
  410.         directory.
  411.  
  412. You can also set the display directory from the command line using the -d
  413. option.
  414.  
  415.  
  416. DIRECTORY SORT
  417. --------------
  418. By default, the directory is sorted alphabetically.  If you press the
  419. "d" key from the main menu, you can choose between an alphabetical sort,
  420. sort by date, sort by file size or no sort.  You can also select between
  421. a short listing with only file names and a long listing with file dates
  422. and sizes in addition.
  423.  
  424. Only the first 1020 files will be sorted in a directory.  All others are
  425. displayed unsorted.
  426.  
  427.  
  428. SCALING OF PICTURES
  429. -------------------
  430.  
  431. There are many scaling options. The default scaling is 1:1 i.e. no scaling.
  432. You can choose to set the scales manually.  You can also have the program
  433. perform auto-scaling.  The "auto-scale full screen" option makes the picture
  434. "fit" the screen horizontally and vertically.  You can also auto-scale
  435. with the constraint that the horizontal and vertical scales should be equal.
  436.  
  437. Use the "Scale" menu to change the scaling options.  You can also select
  438. the scaling method from the command line using the -s option.
  439.  
  440.  
  441. ZOOMING
  442. -------
  443.  
  444. Once a picture is displayed on the screen, you can zoom in using the "+" key
  445. and zoom out using the "-" key.
  446.  
  447.  
  448. PANNING
  449. -------
  450.  
  451. Once a picture is displayed on the screen, you can move the viewing window
  452. around the picture by the use of the cursor keypad:
  453.  
  454.                            (Number lock should be disabled)
  455.  
  456.         down arrow  (or "d")       move down  half screen (1/8 screen for TIFF)
  457.         right arrow (or "r")       move right half screen (1/8 screen for TIFF)
  458.         up   arrow  (or "u")       move up    half screen (1/8 screen for TIFF)
  459.         left arrow  (or "l")       move left  half screen (1/8 screen for TIFF)
  460.         "End"       (or "1")       move to bottom left corner
  461.         "PgDn"      (or "3")       move to bottom right corner
  462.         "PgUp"      (or "9")       move to top right corner
  463.         "Home"      (or "7")       move to top left corner
  464.  
  465.                            (Scroll lock should be disabled)
  466.  
  467.   shift-down  arrow (or "2")       move down  full screen
  468.   shift-right arrow (or "6")       move right full screen
  469.   shift-up    arrow (or "8")       move up    full screen
  470.   shift-left  arrow (or "4")       move left  full screen
  471.  
  472.  
  473.  
  474. BRIGHTNESS
  475. ----------
  476.  
  477. Once a picture is displayed on the screen, you can increase the brightness
  478. by pressing the "b" key and reduce the brightness by pressing the "B" key.
  479. You can also set an overall brightness adjustment from the Options menu.
  480.  
  481.  
  482. CONTRAST
  483. --------
  484.  
  485. Once a picture is displayed on the screen, you can adjust the contrast
  486. by pressing the "g" key and the "G" key.  You can also set an overall
  487. contrast adjustment from the Options menu.
  488.  
  489.  
  490. INVERTING THE IMAGE
  491. -------------------
  492. Once a picture is displayed on the screen, you can invert the image by
  493. pressing the "i" key (available in VUIMAGE PLUS only).  This is useful
  494. for black and white or grayscale images.
  495.  
  496. Image inversion can be selected during startup by using the "-iiy"
  497. commandline option.
  498.  
  499.  
  500. PRINTING
  501. --------
  502.  
  503. Once an image is displayed on the screen, you can print that image by
  504. pressing the "p" key.  Before printing, make sure that you have set up
  505. the printer port and selected the correct printer by going into the
  506. Options menu.
  507.  
  508. The entire image is printed.  Any brightness and contrast adjustments you have
  509. made will affect the print output.  The output to 2-color printers (most
  510. printers) can be dithered so as to obtain a better print-out.  You can choose
  511. between no dithering, 2x2, 3x3, 4x4, 5x5 or 6x6 dithering by going
  512. into the Options menu.  You may wish to experiment with the dithering
  513. options to obtain the best print image.  For fairly high resolution
  514. printers (200x200 dpi or greater), 6x6 or 5x5 is suggested for paint-type
  515. images and scanned images with many shades.  For line art/scanned documents,
  516. eiher no dithering or 2x2 is suggested.
  517.  
  518. From the Options menu, you can also set the desired size of the print-out.
  519.  
  520. You can specify "lpt1:","lpt2:","lpt3:","com1:","com2:" or a filename
  521. for the printer port.
  522.  
  523.  
  524.  
  525. INTERLACED GIF FILES
  526. --------------------
  527.  
  528. Interlaced GIF files are the files that contain images that are not drawn
  529. top to bottom, but are drawn in four passes over the image area.  On each
  530. pass, some lines are skipped that are subsequently filled by a following pass.
  531.  
  532. To display interlaced images using dithering in 2-color modes and also to
  533. print interlaced images, the image must be converted to a non-interlaced image.
  534. This can be done using the utility NINTLACE.EXE by typing:
  535.  
  536.     nintlace input.gif output.gif
  537.  
  538. where input.gif is the interlaced GIF file and output.gif is the non-
  539. interlaced GIF file to be created.
  540.  
  541. (If you use the "-n" option for NINTLACE.EXE as in "nintlace -n x.gif y.gif",
  542.  the program does not do this conversion, but will eliminate all unnencessary
  543.  characters from the end of the file that may have been added as a result of
  544.  using communications protocols like XMODEM or YMODEM to transfer files).
  545.  
  546.  
  547.  
  548. TEXT SCREEN COLORS
  549. ------------------
  550.  
  551. You can change the text screen colors used by going into the "Options"
  552. menu and pressing "C - Screen Colors ".  Use the left/right arrow keys 
  553. to change the foreground color and the up/down arrow keys to change the 
  554. background color. (Alternately, you can use the "f" and "F" keys for
  555. foreground and the "b" and "B" keys for background).
  556.  
  557. Select the colors you like.  Note the numbers shown that corresponds to each
  558. of the colors that you selected - these numbers can be used with the "-cd",
  559. "-co" and the "-cg" command line options to automatically select your
  560. favourite colors when the program is started.
  561.  
  562. ^L
  563.  
  564.  
  565. SUMMARY OF COMMANDS AVAILABLE WHEN A PICTURE IS FULLY ON-SCREEN
  566. ---------------------------------------------------------------
  567. (Disable Scroll-Lock)
  568.  
  569. @            Disable timeout, freeze pic on screen till the enter key is pressed
  570.  
  571. +, -         Zoom In, Zoom Out
  572. a            Auto-scale current pic to fit screen
  573.  
  574. arrow keys, d,r,u,l         Pan down, right, up, left
  575. shift arrow keys, 2,6,8,4   Pan down, right, up, left (larger shift)
  576. End , 1                     Pan to bottom left corner
  577. PgDn, 3                     Pan to bottom right corner
  578. PgUp, 9                     Pan to top right corner
  579. Home, 7                     Pan to top left corner
  580.  
  581. b, B, ctrl-b Increase brightness, decrease brightness, reset brightness
  582. g, G, ctrl-g Decrease contrast, increase contrast, reset contrast
  583. f            cycle through dithers (if being dithered)
  584. i            invert image (VUIMAGE PLUS only)
  585.  
  586. p            Print image
  587. delete       Re-draw picture
  588. insert       Show picture info
  589.  
  590. return       Move to next picture in list
  591. backspace    Move to previous picture in list
  592. escape       Abort the list 
  593.  
  594.  
  595.  
  596. COMMAND LINE OPTIONS
  597. --------------------
  598.  
  599. Many of the options may be set from the command line instead going through
  600. a menu.  For example, to start the program with the mode option set to 9
  601. and the scaling option set to 3, enter:
  602.  
  603.         vuimg  -m9 -s3
  604.  
  605. The available command line options are listed below:
  606.  
  607.   -Tfiletype    where filetype is "gif" or "tiff".
  608.  
  609.                 Example:   -Ttiff       (display tiff files)
  610.  
  611.   -vdrivername  where drivername is the name of the extended mode driver
  612.                 appropriate for your board.  If the program files are not in
  613.                 the current directory, then the drive and subdirectory must
  614.                 also be specified.
  615.  
  616.                 Example (load ATI VGAWonder driver):
  617.  
  618.                            -vdativ            (program files in current dir)
  619.                            -vc:\vuimage\dativ (program files in c:\vuimage)
  620.  
  621.   -mmodeindex   where modeindex is the number you would enter if you were
  622.                 to go into the "Mode" menu and make a selection.
  623.  
  624.                 Example:   -m9          (set 320x200x256 mode)
  625.  
  626.   -mdmodeindex  where modeindex is the mode to be forced disabled for autoselect
  627.   -memodeindex  where modeindex is the mode to be forced enabled for autoselect
  628.   -mamodeindex  where modeindex is the mode to be not forced
  629.  
  630.                 Example:   -md11        (force disable mode 11 for autoselect)
  631.                            -me7         (force enable mode 7 for autoselect)
  632.                            -ma7         (let program decide automatically)
  633.  
  634.   -sscaleindex  where scaleindex is the number you would enter if you were
  635.                 to go into the Scale menu (part of the "Options" menu) and
  636.                 make a selection.
  637.  
  638.                 Example:   -s3          (set autoscale full screen)
  639.  
  640.   -sxhscale     where hscale is the horizontal scale value (1% to 999%).
  641.                 This option should be used only if manual scaling is selected.
  642.  
  643.                 Example:   -sx200       (set horizontal scale to 200%)
  644.  
  645.   -syvscale     where vscale is the vertical scale value (1% to 999%).
  646.                 This option should be used only if manual scaling is selected.
  647.  
  648.                 Example:   -sy50        (set vertical scale to 50%)
  649.  
  650.   -ddirectory   where directory is a directory name (or file matching string)
  651.                 that you would enter when you go into the Dir menu.
  652.  
  653.   -Dssorttype   where "sorttype" is 0 for no sort, 1 for alphabetical sort,
  654.                 2 for sort by date and 3 for sort by file size.
  655.  
  656.                 Example:   -Ds2         (sort by date)
  657.  
  658.   -Dllisttype   where "listtype" is 0 for short, 1 for long directory listing.
  659.  
  660.                 Example:   -Dl1         (show long directory listing)
  661.  
  662.   -Dddateform   where "dateform" is 0 for month-day-year format, 1 for
  663.                 day-month-year format.
  664.  
  665.                 Example:   -Dd1         (DD-MM-YY format)
  666.  
  667.   -ttimeout     where timeout is the number of seconds to display each picture.
  668.  
  669.                 Example:   -t40         (set timeout to 40 seconds)
  670.  
  671.   -by           enables the beep at the end of a picture
  672.   -bn           disables the beep at the end of the picture
  673.  
  674.                 Example:   -bn          (disable beep)
  675.  
  676.   -Bbrightness  where brightness is the brightness value (100 is nominal)
  677.  
  678.                 Example:   -B120                (set brightness to 120%)
  679.  
  680.   -cddircolor   where dircolor is the color number for the filenames 
  681.   -cofncolor          fncolor  is the color number for the file numbers 
  682.   -cmmodcolor         modcolor is the color number for the display mode
  683.   -cggencolor         gencolor is the color number for general text
  684.                 To find the color numbers for the colors of your choice, first
  685.                 go into the "Options" menu and select the colors that you like.
  686.                 The corresponding color numbers are also displayed.
  687.  
  688.                 Example:   -cd78    (filenames in yellow on a red background)
  689.                            -co10    (filenumbers in bright green on black)
  690.                            -cm4     (video mode in red on black)
  691.                            -cg14    (general text in yellow on black)
  692.  
  693.   -iby          show brief info (-iby) as pic is displayed (filename, image
  694.   -ibn          size),  do not show brief info (-ibn)
  695.  
  696.   -idy          show detailed info (-idy) as pic is displayed,
  697.   -idn          do not show detailed info (-idn)
  698.  
  699.   -iiy          invert the image (-iiy), do not invert the image (-iin).
  700.   -iin          (really useful for only black and white/grayscale images)
  701.  
  702. (*** The following options are available only in VUIMAGE PLUS(tm) ***)
  703.  
  704.   -Tpcx         select filetype to be PCX.
  705.  
  706.   -pprinternum  where printernum is the number you would enter if you were
  707.                 to go into the Options menu and choose a printer.
  708.  
  709.                 Example:   -p1      (select EPSON FX80/100 printer)
  710.  
  711.   -pddevicename where devicename is the printer device (lpt1:, lpt2:, lpt3:,
  712.                 com1:, com2: or filename).
  713.  
  714.                 Example:   -pdlpt1:      (send output to lpt1:)
  715.                            -pdvuimg.prn  (send output to file vuimg.prn)
  716.  
  717.   -pxwidth      where width is the width of the printed image in 1/100 inches
  718.  
  719.                 Example:   -px904   (print image width=9.04 inches)
  720.  
  721.   -pyheight     where height is the height of the printed image in 1/100 inches
  722.  
  723.                 Example:   -py1200  (print image height=12.00 inches)
  724.  
  725.   -fddithertype where dithertype is the number you would enter if you were to
  726.                 go into the Options menu and choose the display dither type.
  727.  
  728.                 Example:   -fd3     (dither 2-color displays using 3x3 matrix)
  729.  
  730.   -fpdithertype where dithertype is the number you would enter if you were to
  731.                 go into the Options menu and choose the printer dither type.
  732.  
  733.                 Example:   -fp4     (dither 2-color printers using 4x4 matrix)
  734.  
  735.   -C            disables the menus.  If you use this option, you must also
  736.   -Cp           specify a filename to be displayed including the pathname.
  737.                 This should be the last option entered on the command line.
  738.                 The filename may contain wild card characters ? and * and 
  739.                 should be the last parameter.  Any directory name entered
  740.                 with the -d option will be ignored.  If the "-Cp" option is
  741.                 used instead of the "-C", the image is also printed.
  742.  
  743.                 Examples:   -C somefile.gif
  744.                             -C \pics\*.gif
  745.                             -Cp image.tif
  746.  
  747.   -L            leave the last image on the screen when the program ends.
  748.                 Valid only when the -C option is used.  Useful when called
  749.                 as a sub-program by another program.
  750.  
  751.   -l            do not reset the video mode or clear the screen between images.
  752.                 Valid only when the -C option is used.  This option is useful
  753.                 only if the images being viewed are close enough in size,
  754.                 resolution and colors that the video mode and the palette will
  755.                 be the same for the images.  Not recommnded for use unless
  756.                 this is the case.  It is recommended that an appropriate
  757.                 video mode should be specified instead of using auto-select.
  758.  
  759.  
  760.  
  761.  
  762. PRE-PROGRAMMED MODE
  763. -------------------
  764.  
  765. You can run the program in a PRE-PROGRAMMED mode where it will go through a
  766. display session with no keyboard input.  To do this, go through a manual
  767. session and write down all keystrokes till you quit back to DOS (this is
  768. important).  If you use the ESC key to abort a picture or list,
  769. the return key to move on to the next picture, or the cursor keys to do
  770. panning, do NOT include these keystrokes.  Then create a file containing
  771. these keystrokes (we will use the filename "vuimg.inp" in the following
  772. example).  To do this, type: 
  773.  
  774.         copy con: vuimg.inp <return>
  775.  
  776. Enter the keystrokes you wrote down and then type a <CTRL>Z to create the
  777. file called vuimg.inp.  A text editor (ex. edlin) may also be used to
  778. create such a file (start a new line for every "return" key).  This file
  779. may then be used to run the program in the PRE-PROGRAMMED mode by typing
  780.  
  781.        vuimg  < vuimg.inp
  782.  
  783.  
  784. DOS EXIT CODES (ERRORLEVEL)
  785. ---------------------------
  786.  
  787. The return codes generated by the program that may be tested in a batch
  788. file are:
  789.  
  790. 0 - no error
  791. 1 - command line option error
  792. 2 - the -C option was used without specifying a file
  793. 3 - file not found or invalid filename
  794.  
  795.  
  796.  
  797.  
  798. DISPLAY BOARDS and EXTENDED VIDEO MODES/DRIVERS
  799. -----------------------------------------------
  800.  
  801. If the program does not work with your display board, try loading any software
  802. drivers (BIOS emulators, int 10h drivers, RAM BIOS drivers) that come with it.
  803. Refer to the instructions that come with your graphics board.
  804.  
  805. Some video display boards support even higher resolutions than standard VGA,
  806. for example, 640x480 in 256 colors and 800x600 in 16 colors.  These are
  807. sometimes referred to as SuperVGA modes.  Additional drivers that support
  808. these "extended modes" are included with the program.  These drivers have
  809. filenames with the extension ".VDR" and are listed later in this section.
  810. They can be loaded using the "-v" command line option (see section on command
  811. line options).
  812.  
  813. Typically, extended modes are dependent on your type of graphics card.
  814. Refer to your graphics card manual to see what extended modes are supported.
  815. Only VGA type extended modes with either 16 or 256 colors out of a palette
  816. of 262,144 colors are supported by the extended mode drivers.  Check the
  817. list of extended mode drivers at the end of this section to see which driver
  818. is suitable for use with your card.  Some of the modes listed may not be
  819. available in your specific card.  The unavailable modes can be AND SHOULD BE
  820. disabled by using the "-md" commandline option so that the Auto-select videomode
  821. function does not try to use these modes.  Saving the configuration in
  822. VUIMAGE PLUS(tm) will also save this information.
  823.  
  824. However, there is a SuperVGA standard known as the VESA SuperVGA standard.
  825. Many or most of the SuperVGA cards now support this standard.  If your
  826. card supports this standard, then you can take advantage of the VESA driver
  827. (DVESA.VDR) that comes with the program.  Even if there is a separate driver
  828. that supports your card, WE RECOMMEND that you use the VESA driver instead
  829. if your card supports the VESA standard.  In order for your card to support
  830. the VESA standard, you may need to load a device driver or TSR that comes
  831. with your card (through the CONFIG.SYS or AUTOEXEC.BAT file).  Refer to the
  832. documentation that comes with your card (in printed form or disk file form).
  833.  
  834. If you are not using any extended drivers, you may still be able to display
  835. in an extended mode if your BIOS for the board will support this.  Not all
  836. boards come with BIOS that support the extended modes completely.  Installing
  837. any RAM BIOS drivers that come with your board may help.  Display done
  838. through the BIOS is usually extremely slow.
  839.  
  840. To use the BIOS supported extended modes, you need to know the mode number,
  841. the no. of columns, the no. of rows, and the no. of colors for the mode.
  842. Refer to the manual for your graphics card.
  843.  
  844. If you have a plain VGA card with no SuperVGA modes, you may still be able
  845. to get higher resolutions (320x400x256, 360x480x256, 800x600x16, 400x600x256)
  846. using the DNVGA driver.
  847.  
  848.  
  849. Extended Mode Drivers (SuperVGA drivers) included:
  850.  
  851. Note: Some of the modes listed may not be available in your specific card.
  852.       These should be disabled (see section above).  Additional drivers may be
  853.       available from Offe Enterprises.
  854.  
  855.     If your display board is:                   Try driver
  856.     ------------------------                    ----------
  857.     Any board that suports the VESA standard    DVESA
  858.     and has VESA BIOS installed
  859.     
  860.         ATI VGAWonder                           DATIV
  861.         Paradise VGA cards                      DPVGA
  862.         AST VGA cards                           DPVGA
  863.         AT&T VDC600                             DPVGA
  864.     Cardinal 600 VGA             DCHT
  865.         Everex EV673                            DE673
  866.         Everex EV678                            DE678
  867.         Genoa VGA cards                         DORCH
  868.         Orchid ProDesigner                      DORCH
  869.     Orchid ProDesigner II (Tseng 4000)      DTSNG4
  870.         Sigma VGA cards                         DORCH
  871.         Standard IBM VGA & register compatibles
  872.                 with multisync monitors         DNVGA
  873.         STB VGA cards                           DORCH
  874.         STB PowerGraph (Tseng 4000)             DSTBPG
  875.         Tandy 1000 (320x200x16)                 DTANDY
  876.         Trident Video cards                     DTRID
  877.         Video-7 Fastwrite                       DV7FW
  878.         Video-7 1024i                           DV71024
  879.         Video-7 VRAM                            DV7VRAM
  880.  
  881.     Other Chips&Technolgies chipset cards    DCHT
  882.     Other Tseng 4000 Chipset cards          DTSNG4
  883.  
  884.  
  885.     If your board is not listed, you can try one of the supplied drivers
  886.     to see if any of the extended modes will work (to see what extended modes
  887.     will work, each extended mode will have to be manually selected and then
  888.     an image tried in that mode).
  889.  
  890.     All extended modes available on a board may not be supported by the driver.
  891.  
  892.     All extended modes supported by the driver may not be available on your
  893.     board.  Some may simply be unavailable, some may require more memory.
  894.     All modes that are unavailable should be determined by manually selecting
  895.     each mode.  These modes should be disabled while running the program (see
  896.     section before on how to disable these modes).
  897.  
  898.  
  899. Extended Modes Supported by the Drivers (mode numbers in decimal and hex)
  900.  
  901. DVESA
  902.         Mode 256  (100h)         640 x  400 x 256 colors
  903.         Mode 257  (101h)         640 x  480 x 256 colors
  904.         Mode 258  (102h)         800 x  600 x  16 colors
  905.         Mode 259  (103h)         800 x  600 x 256 colors
  906.         Mode 260  (104h)        1024 x  768 x  16 colors
  907.         Mode 261  (105h)        1024 x  768 x 256 colors
  908.         Mode 262  (106h)        1280 x 1024 x  16 colors
  909.         Mode 263  (107h)        1280 x 1024 x 256 colors
  910.  
  911. DATIV
  912.         Mode  84 (54h)           800 x 600 x  16 colors 
  913.         Mode  97 (61h)           640 x 400 x 256 colors
  914.         Mode  98 (62h)           640 x 480 x 256 colors
  915.         Mode  99 (63h)           800 x 600 x 256 colors
  916.         Mode 101 (65h)          1024 x 768 x  16 colors
  917.  
  918. DCHT
  919.         Mode 112 (70h)           800 x 600 x  16 colors 
  920.         Mode 114 (72h)          1024 x 768 x  16 colors
  921.         Mode 120 (78h)           640 x 400 x 256 colors
  922.         Mode 121 (79h)           640 x 480 x 256 colors
  923.         Mode 128 (7bh)           800 x 600 x 256 colors
  924.  
  925. DE673
  926.         Submode 19 (13h)        640 x 350 x 256 colors
  927.         Submode 20 (14h)        640 x 400 x 256 colors
  928.         Submode 21 (15h)        512 x 480 x 256 colors
  929.  
  930. DE678
  931.         Submode 49 (31h)        640 x 400 x 256 colors
  932.         Submode 50 (32h)        512 x 480 x 256 colors
  933.         Submode 77 (4dh)        640 x 480 x 256 colors
  934.         Submode 78 (4eh)        800 x 600 x 256 colors
  935.  
  936. DNVGA
  937.         -------                  320 x 400 x 256 colors
  938.         -------                  360 x 480 x 256 colors
  939.         -------                  800 x 600 x  16 colors
  940.         -------                  400 x 600 x 256 colors
  941.  
  942. DORCH
  943.         Mode  41 (29h)           800 x 600 x  16 colors
  944.         Mode  45 (2Dh)           640 x 350 x 256 colors
  945.         Mode  46 (2Eh)           640 x 480 x 256 colors
  946.         Mode  47 (2Fh)           720 x 512 x 256 colors
  947.         Mode  48 (30h)           800 x 600 x 256 colors
  948.         Mode  55 (37h)          1024 x 768 x  16 colors
  949.  
  950. DPVGA
  951.         Mode  88 (58h)           800 x 600 x  16 colors
  952.         Mode  94 (5Eh)           640 x 400 x 256 colors
  953.         Mode  95 (5Fh)           640 x 480 x 256 colors
  954.  
  955. DV7FW
  956.         Mode  98 (62h)           800 x 600 x  16 colors
  957.         Mode 102 (66h)           640 x 400 x 256 colors
  958.         Mode 103 (67h)           640 x 480 x 256 colors
  959.  
  960. DTANDY
  961.         Mode  9  (09h)           320 x 200 x  16 colors
  962.  
  963. DTRID
  964.         Mode  91 (5Bh)           800 x 600 x  16 colors
  965.         Mode  92 (5Ch)           640 x 400 x 256 colors
  966.         Mode  93 (5Dh)           640 x 480 x 256 colors
  967.         Mode  94 (5Eh)           800 x 600 x 256 colors
  968.         Mode  95 (5Fh)          1024 x 768 x  16 colors
  969.         Mode  98 (62h)          1024 x 768 x 256 colors
  970.  
  971. DTSNG4, DSTBPG
  972.         Mode  41 (29h)           800 x 600 x  16  colors
  973.         Mode  55 (37h)          1024 x 768 x  16  colors
  974.         Mode  45 (2dh)           640 x 350 x 256  colors
  975.         Mode  47 (2fh)           640 x 400 x 256  colors (DTSNG4)
  976.         Mode 120 (78h)           640 x 400 x 256  colors (DSTBPG)
  977.         Mode  46 (2eh)           640 x 480 x 256  colors
  978.         Mode  48 (30h)           800 x 600 x 256  colors
  979.         Mode  56 (38h)          1024 x 768 x 256  colors
  980.  
  981. DV71024
  982.         Mode  98 (62h)           800 x 600 x  16 colors
  983.         Mode 101 (65h)          1024 x 768 x  16 colors
  984.         Mode 102 (66h)           640 x 400 x 256 colors
  985.         Mode 103 (67h)           640 x 480 x 256 colors
  986.  
  987. DV7VRAM
  988.         Mode  98 (62h)           800 x 600 x  16 colors
  989.         Mode 101 (65h)          1024 x 768 x  16 colors
  990.         Mode 102 (66h)           640 x 400 x 256 colors
  991.         Mode 103 (67h)           640 x 480 x 256 colors
  992.         Mode 105 (69h)           800 x 600 x 256 colors
  993.  
  994. REVISION HISTORY
  995. ----------------
  996.  
  997. Additions/Changes from Version 2.80 to Version 2.96:
  998.   - added scaling options 5 & 6 (autoscale only if image is larger than screen)
  999.   - added IBM Proprinter support
  1000.   - added 400x600x256 mode to DNVGA.VDR
  1001.   - added Tandy 320x200x16, 640x200x16 driver
  1002.   - improved auto videomode select
  1003.   - added the "-Cp" option to print from the commandline in VUIMAGE PLUS(tm)
  1004.   - memory requirement has increased to 160K
  1005.   - added the "ctrl-b" and "ctrl-g" keys to reset brightness, contrast
  1006.   - added the 800x600x256, 1024x768x256 modes to the trident driver
  1007.   - filename/image size can be displayed while image is being drawn using
  1008.     the "-iby" commandline option
  1009.   - specific video modes can be disbaled or enabled for autoselect 
  1010.     using the "-md", "-me" and "-ma" commandline options
  1011.   - Added drivers for Tseng 4000, STB Powergraph
  1012.   - VUIMAGE PLUS(tm) can save the configuration
  1013.   - Sort directory alphabetically, by date or by filesize, or disable sort
  1014.   - List directory in short, medium or long format
  1015.   - Simpler main menu - can select Mode, Options etc while using scroll-bar
  1016.   - Space bar to mark/unmark automatically moves to next file on display
  1017.   - autoscale to fit screen while image is on-screen (use the "a" key)
  1018.   - get quick picture info in main menu without displaying ("insert" key)
  1019.   - get quick picture info while image is on screen (use the "insert" key)
  1020.   - re-draw the image on screen (use the "delete" key)
  1021.   - move backwards through a list of files using the backspace key
  1022.   - When entering file numbers, need to press enter after "/" for repeat
  1023.   - VUIMAGE PLUS(tm) can read most uncompressed TIFF 8-bit palette color images
  1024.   - adjust contrast (use the "g","G" keys when image is on screen)
  1025.   - added the program NINTLACE.EXE to convert interlaced files to
  1026.     non-interlaced files (useful for mono display modes and printing)
  1027.   - edit user responses to queries (use cursor keys)
  1028.   - cycle through dithers when dithering in 2-color modes (use the "f" key)
  1029.   - freeze image on screen i.e. disable timeout (use the "@" key)
  1030.   - added the "-l" option to VUIMAGE PLUS(tm) to avoid clearing the screen
  1031.     between images
  1032.  
  1033. Additions/Changes from Version 2.70 to Version 2.80:
  1034.   - Added 5x5, 6x6 dithering, better dithering
  1035.   - GIF89a - supports "restore-to-previous" feature
  1036.   - improved auto-select video mode, scaling in multi-image pictures
  1037.   - max. timeout increased to 43199 seconds
  1038.   - other minor enhancements
  1039.   - VUIMAGE PLUS(tm) now supports PCX also
  1040.  
  1041. Additions/Changes from the previous version (V2.62):
  1042.   - Support for the GIF89a standard - ASCII plain text extensions,
  1043.     graphics control extensions (delay, transparency, restore to background),
  1044.     comment and application extensions
  1045.   - better print quality
  1046.   - Ability to invert the image (VUIMAGE PLUS(tm))
  1047.  
  1048. Additions/Changes from the previous version (V2.60):
  1049.   - SuperVGA support added for any SuperVGA card that supports the VESA
  1050.     standard.  Most SuperVGA cards now come with VESA BIOS support in the
  1051.     form of a device driver (installed through CONFIG.SYS) or TSR (installed
  1052.     through AUTOEXEC.BAT).  The VESA driver for VUIMAGE(tm)/VUIMAGE PLUS(tm)
  1053.     supports the following VESA standard modes (if available in card):
  1054.        800x600x16, 1024x768x26, 1280x1024x16
  1055.        640x400x256, 640x480x256, 800x600x256, 1024x768x256, 1280x1024x256
  1056.     Use of the VESA extended video driver (dvesa) is strongly recommended.
  1057.   - added Chips & Technologies extended video driver
  1058.   - added HP Thinkjet printer
  1059.   - from main menu and cursorbar menu, can use ctrl-home/ctrl-end to get to
  1060.     top of directory or end of directory
  1061.   - from main menu, any arrow key takes you to cursorbar selection
  1062.   - four digit filenumber display allows upto 9999 files.
  1063.  
  1064. Additions/Changes from the previous version (V2.53):
  1065.   - Now supports printing of images.  To choose printer, use the Options menu.
  1066.        Print entire image, set your own print size.
  1067.   - Now can dither images in 2-color display modes - none, 2x2, 3x3, 4x4,
  1068.        5x5 or 6x6 dithering
  1069.   - Dither print output - none, 2x2, 3x3, 4x4, 5x5 or 6x6 dithering
  1070.   - better Options menu
  1071.   - reads more TIFF files
  1072.   - memory requirement has increased to 150K
  1073.  
  1074. Additions/Changes from the previous version (V2.42):
  1075.   - drivers for Trident, Video-7 1024i and Video-7 VRAM cards added
  1076.   - select files using cursors, mark/unmark for list of files
  1077.   - read more TIFF files - Vuimage Plus(tm) now supports PackBits
  1078.     compressed bilevel TIFF files
  1079.  
  1080. *****************************************************************************
  1081. SOME SOURCES FROM WHERE THE LATEST SHAREWARE VERSION CAN USUALLY BE OBTAINED
  1082.  
  1083.   1. Compuserve  - PICS (GRAPHICS SUPPORT) forum, library 3.
  1084.                  - Enter "browse vuim*.*" in library 3 to list.
  1085.  
  1086.   2. EXEC-PC BBS - Free download collection section of the BBS (414)-789-4210
  1087.                  - Filename VUIMGxyz.* where xyz is the version number.
  1088.  
  1089.   3. Computer Connections BBS  (202)-547-2008
  1090.  
  1091.