home *** CD-ROM | disk | FTP | other *** search
/ Share Gallery 1 / share_gal_1.zip / share_gal_1 / GR / GR047.ZIP / VUIMG.DOC < prev    next >
Text File  |  1990-10-01  |  34KB  |  772 lines
  1.                   VUIMAGE(tm) (Version 2.62) (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.  
  12. Additions/Changes from the previous version (V2.60):
  13.   - SuperVGA support added for any SuperVGA card that supports the VESA
  14.     standard.  Most SuperVGA cards now come with VESA BIOS support in the
  15.     form of a device driver (installed through CONFIG.SYS) or TSR (installed
  16.     through AUTOEXEC.BAT).  The VESA driver for VUIMAGE(tm)/VUIMAGE PLUS(tm)
  17.     supports the following VESA standard modes (if available in card):
  18.        800x600x16, 1024x768x26, 1280x1024x16
  19.        640x400x256, 640x480x256, 800x600x256, 1024x768x256, 1280x1024x256
  20.     Use of the VESA extended video driver (dvesa) is strongly recommended.
  21.   - added Chips & Technologies extended video driver
  22.   - added HP Thinkjet printer
  23.   - from main menu and cursorbar menu, can use ctrl-home/ctrl-end to get to
  24.     top of directory or end of directory
  25.   - from main menu, any arrow key takes you to cursorbar selection
  26.   - four digit filenumber display allows upto 9999 files.
  27.  
  28. Additions/Changes from the previous version (V2.53):
  29.   - Now supports printing of images.  To choose printer, use the Options menu.
  30.        Print entire image, set your own print size.
  31.   - Now can dither images in 2-color display modes - none, 2x2, 3x3, 4x4
  32.        dithering
  33.   - Dither print output - none, 2x2, 3x3 or 4x4 dithering
  34.   - better Options menu
  35.   - reads more TIFF files
  36.   - memory requirement has increased to 150K
  37.  
  38. Additions/Changes from the previous version (V2.42):
  39.   - drivers for Trident, Video-7 1024i and Video-7 VRAM cards added
  40.   - select files using cursors, mark/unmark for list of files
  41.   - read more TIFF files - Vuimage Plus(tm) now supports PackBits
  42.     compressed bilevel TIFF files
  43.  
  44. Additions/Changes from the previous version (V2.3):
  45.   - user selectable screen colors ("-cd/-co/-cg/-cm" commandline options).
  46.   - Automatic video mode selection capability - a mode suitable for the
  47.     picture will be selected automatically.  Detects CGA/Hercules/EGA/VGA
  48.     adapters and enables appropriate modes (user can still specify a
  49.     particular video mode).
  50.   - provides drivers for Everex 678, Video-7 Fastwrite
  51.   - 800x600x16 mode support for standard IBM VGA adapter
  52.   - video drivers have been re-named
  53.   - Changed pan step to 1/8 screen for TIFF files only
  54.  
  55. ===============================================================================
  56.  OTHER PROGRAMS AVAILABLE FROM OFFE ENTERPRISES:
  57.  
  58.    TBG(tm)     - TIFF black&white/grayscale image to GIF/TIFF black&white/
  59.                  grayscale converter (can reduce large b&w images to smaller
  60.                  grayscale ones, convert TIFF to GIF etc.)
  61.    SCRtoPS(tm) - Dump text and graphics screens (CGA/EGA/VGA) to PostScript*
  62.                  printer or capture to Encapsulated PostScript file (including
  63.                  line/box characters).  Requires only about 10K of resident
  64.                  memory.
  65.  
  66.    See file PROGRAMS.DOC for more information on these programs.
  67. ===============================================================================
  68.  
  69. *  GIF and "Graphics Interchange Format" are trademarks (tm) of Compuserve,
  70.    Inc., an H&R block company.  PostScript is a trademark of Adobe Systems, Inc.
  71.    VUIMAGE, VUIMAGE PLUS, TBG and SCRtoPS are trademarks of Offe Enterprises.
  72.  
  73.  
  74.  
  75. INTRODUCTION
  76.  
  77. Offe is proud to bring you our GIF/TIFF display software for the IBM PC family.
  78. Its main features are:
  79.  
  80.     - super fast display of GIF files and bilevel/grayscale TIFF files
  81.     - print GIF and TIFF files (four dithering options)
  82.     - print entire image, set your own print size
  83.     - requires only 150K of free memory to run
  84.     - supports a variety of display types - CGA/Hercules/6300/DEB/EGA/MCGA/
  85.       VGA/SuperVGA/VESA SuperVGA
  86.     - 320x400x256, 360x480x256 and 800x600x16 driver for standard IBM VGA
  87.     - VESA SuperVGA driver for all SuperVGA cards that have VESA BIOS support.
  88.       Supports the following VESA standard modes (if available in card):
  89.        800x600x16, 1024x768x26, 1280x1024x16
  90.        640x400x256, 640x480x256, 800x600x256, 1024x768x256, 1280x1024x256
  91.     - excellent color rendition in all video modes
  92.     - four dithering options for two-color video modes
  93.     - handles large images
  94.     - automatic/manual video mode selection capability
  95.     - auto/manual scaling - automatically scale to full screen or
  96.       manually scale from 1% to 999%
  97.     - zoom in / zoom out using the "+" and "-" keys
  98.     - panning - cursor keys allow moving screen window over different sections
  99.       of picture 
  100.     - adjust brightness while picture is on screen
  101.     - supports other boards/future boards through BIOS mode
  102.     - user-friendly, multiple interfaces
  103.         - menu-selectable options
  104.         - command-line selectable options (useful in batch files and when
  105.           called as a sub-program by other programs)
  106.         - pre-programmed keystroke mode (std. input re-direction)
  107.     - select files using cursor or by file numbers
  108.     - specify a list of files to be displayed for slide shows
  109.     - continuously repeat list of files (for demos etc.)
  110.     - abort single picture or list of pictures in the middle
  111.     - handles corrupt files well
  112.     - returns DOS errorlevel value (useful in batch files and when
  113.       called as a sub-program by other programs)
  114.     - user selectable menu screen colors
  115.  
  116.  
  117. We hope you like our product and decide to register.  Registered users get
  118. VUIMAGE PLUS(tm) Version 2.62, our non-shareware version of the program with
  119. the following added features:
  120.  
  121. - menus may be disabled and file (or files) to be shown may be specified from
  122.   the command line (in this mode, the image may be left on the screen when
  123.   the program ends)
  124.  
  125. - print options may be specified from the command line (you can create a
  126.   batch file easily to "configure" VUIMAGE PLUS(tm)).
  127.  
  128. - compressed bilevel TIFF files (compression type - CCITT Group 3-1D or
  129.   compression type PackBits) can be viewed.  Many scanners come with
  130.   software that can produce such files.
  131.  
  132. REGISTRATION
  133.  
  134. This version of the program is released as shareware. It is not free and is
  135. not in the public domain.  Private, non-commercial users are requested to
  136. register and support its continued development.  To register, please send your
  137. name, address and phone number(s) with the registration fee of US $30.00** to:
  138.  
  139. Offe Enterprises, 1163 E. Ogden Ave.  #705-131, Naperville, IL 60563  USA
  140.  
  141. Registered users get VUIMAGE PLUS(tm) Ver 2.62 (Outside US, please add $5.00**).
  142.  
  143. Any form of commercial use of VUIMAGE(tm) is illegal and is strictly prohibited.
  144. Commercial users should purchase VUIMAGE PLUS(tm), the non-shareware version.
  145. Volume discounts and site licenses are available for VUIMAGE PLUS(tm).
  146. Contact Offe Enterprises for customized versions.
  147.  
  148. DISTRIBUTION
  149.  
  150. You may make copies of the program files for VUIMAGE(tm) and the documentation
  151. VUIMG.DOC (this file) together and distribute them to others, upload to
  152. bulletin boards etc. for non-commercial purposes. The program files should
  153. not be distributed without the documentation file VUIMG.DOC.  None of the
  154. files should be modified in any way.  
  155.  
  156. NOTICE
  157.  
  158. This program, and all supporting programs and documentation are provided
  159. "as is" without warranty of any kind, either expressed or implied, including
  160. but not limited to the implied warranties of merchantability and fitness for
  161. a particular purpose.  In no event will Offe Enterprises be liable to you for
  162. any damages arising out of the use or inability to use this program and/or all
  163. supporting programs and documentation.
  164.  
  165. ** All prices and other information are subject to change without notice.
  166.  
  167.  
  168.  
  169. INSTALLATION AND USAGE
  170.  
  171. Note: Requires MS-DOS Version 2.0 or later and at least 150K of free memory.
  172.  
  173. 1.  FLOPPY DISK  Copy all the files from the program disk to another floppy
  174.                  disk.  Use this as your working disk - place this disk into
  175.                  drive A:, type "A:" and press return.  Go to step 2.
  176.  
  177.     HARD DISK    Make a new subdirectory.  For example, if you are using
  178.                  drive C: and the subdirectory name is \VUIMAGE, enter
  179.                           c:
  180.                           md \vuimage
  181.                  Now make this subdirectory your current directory.  In our
  182.                  example, enter
  183.                           cd  \vuimage
  184.                  Copy all the files from the program disk to this subdirectory.
  185.                  Go to step 2.
  186.  
  187. 2.  Now all the files are in the current drive/directory.  To start the program,
  188.     type "vuimg"  at the DOS prompt and press return.
  189.  
  190.     You will be placed in the main menu.  Also shown will be a list of files
  191.     in the current directory that have the extension "GIF".  The current display
  192.     mode will be displayed at the bottom left of the screen.  The main menu
  193.     options are displayed at the bottom right of the screen.
  194.  
  195.     Press "Q" to quit back to DOS.  Go to step 3.
  196.  
  197. 3.  You can execute the program any time by changing to the subdirectory that
  198.     has the program files and typing "vuimg"  as in step 2.  However, it is
  199.     much more convenient to create a "batch file" that will execute the
  200.     program from any directory.  WE RECOMMEND THAT YOU DO THIS so that you
  201.     can "configure" the program this way to suit your own needs.  You can
  202.     create a batch file by typing
  203.  
  204.           copy con: v.bat     <return>
  205.  
  206.     where "v.bat" is the name of the batch file.  Now enter the program
  207.     name along with the drive and directory name.  For example,
  208.  
  209.           c:\vuimage\vuimg    <return>
  210.  
  211.     Then press <ctrl>-Z followed by a <return> to finish creating the batch
  212.     file (you can also use an editor to create this file).  Now you can start
  213.     the program by typing "v" and return.  The batch file need not be kept
  214.     in the same subdirectory as the program files.  However, the sub-directory
  215.     that it is kept in must be part of your "PATH".  The PATH is a list of
  216.     directories that DOS will search when you type in a command.  Refer to
  217.     your DOS manual for information on PATH and how to add a sub-directory to
  218.     your PATH.
  219.  
  220.     After you become familiar with the command line options of the program (see
  221.     later section on command line options), you can re-create the batch file 
  222.     and also specify the command line options that you normally prefer to use.
  223.  
  224.  
  225. MAIN MENU
  226.  
  227. From the main menu, at the "File(s)" prompt, you can enter:
  228.  
  229.         - "t" to select the file type - GIF or TIFF
  230.  
  231.         - "m" to change the display mode
  232.  
  233.         - "s" to change the scaling options
  234.  
  235.         - "o" to change other user selectable options
  236.  
  237.         - "d" to select a different directory/different group of files
  238.  
  239.         - "q" or ESC to quit and go back to DOS.
  240.  
  241.         - a list of picture files to be displayed.  For example, enter
  242.  
  243.                 3,1,5-7,17-14  <return>
  244.  
  245.            to display files 3,1,5,6,7,17,16,15,14 from the list (in that order).
  246.  
  247.         - the up arrow to select files using the cursor keys.  To display a
  248.           single file, move the cursor bar to the file and press enter.  To
  249.           display a list of files, move to each file and press the space bar
  250.           to select (mark) the file.  Press enter to display the marked files
  251.           or "/" to continuously repeat the list of files.  If there are too
  252.           many files to fit on one screen, use the PgUp/PgDn keys to see
  253.           other files.  To get back to the main menu, press the escape key.
  254.  
  255.  
  256.  
  257. SELECTING THE FILE TYPE
  258.  
  259. The default file type is "GIF".  To select between TIFF and GIF, press "t"
  260. at the main menu prompt.  You can also select the file type from the command
  261. line using the "-T" option (for example, -Ttiff will select TIFF - see section
  262. on command line options).
  263.  
  264.  
  265. SETTING THE DISPLAY MODE
  266.  
  267. The program selects a video display mode appropriate for the video adapter
  268. and the picture being displayed automatically.  The mode is chosen from the
  269. CGA/Hercules/EGA/VGA modes present and any modes supported by any extended
  270. mode driver that has been loaded (extended mode drivers are selected by the
  271. command line option "-v" - see section "Display Boards and Extended
  272. Modes/Drivers" for more details on extended modes).  SuperVGA modes are
  273. extended modes.
  274.  
  275. If the user desires to select a particular video mode to display the picture
  276. instead of the automatically selected mode, this can be done by pressing
  277. "m" at the main menu prompt, going into the display mode menu and changing
  278. the display mode.  An appropriate mode supported by your video display
  279. board may be specified.  If any extended video mode drivers have been
  280. loaded, the extended modes supported by these drivers are also listed.
  281.  
  282. Instead of using the menu, you can also specify the mode to be used from the
  283. command line by using the "-m" option (for example, "-m7" will use the
  284. EGA 640x350 16-color mode - see section on command line options).
  285.  
  286. There is also a "BIOS" mode that you can use for extended modes that are
  287. unsupported.  Your display board will need to provide complete BIOS support.
  288. Usually the BIOS mode is extremely slow. 
  289.  
  290. If you are using a video mode that has only 2 colors, you can use dithering
  291. to improve the displayed picture.  Use the Options menu to select a type
  292. of dithering to be used for 2-color modes.
  293.  
  294.  
  295. DISPLAYING PICTURE FILES
  296.  
  297. From the main menu, enter the number of the file you wish to display and
  298. press return.  If you wish to display a sequence of files, you can enter
  299. a set of numbers, separated by commas:
  300.  
  301.         Example:  3,5 <return> will display file 3 followed by file 5. 
  302.  
  303. You can enter a starting number and an ending number to display a list of
  304. files:
  305.  
  306.         Example:  2,5-7 <return> will display files 2, 5, 6 and 7.
  307.         Example:  2,7-5 <return> will display files 2, 7, 6 and 5.
  308.  
  309. After you enter a list of files (or one file) and press return, the picture(s)
  310. are displayed in sequence.
  311.  
  312. Alternately, you can press the "up arrow" to select files using the cursor.
  313. To see one file, move the cursor bar to the file and press return.  To
  314. select a list of files, "mark" each file by moving the cursor bar to it
  315. and then pressing space bar.  When you press return, the files will be 
  316. displayed in sequence.
  317.  
  318.  
  319. TIMEOUT
  320.  
  321. Each picture is displayed for a default time of 20 seconds.  Pressing a
  322. return, however, will force the display to end and move on to the next
  323. picture or back to the main menu.  The timeout value can be changed from
  324. the "Options" menu or from the command line using the -t option.
  325.  
  326.  
  327. ABORT PICTURE
  328.  
  329. Pressing the ESC key while a picture is being drawn aborts that picture.
  330. You can abort a list of pictures by pressing the ESC key twice.
  331.  
  332.  
  333. REPEATING LISTS
  334.  
  335. When you enter a list of pictures in the main menu, if you end the list with
  336. the forward slash ("/") instead of a <return>, the list will be continuously
  337. repeated.  To abort this repeated display, press the ESC key twice in quick
  338. succession.
  339.  
  340.  
  341. SELECTING THE DISPLAY DIRECTORY
  342.  
  343. From the main menu, press "d" to change the display directory (the directory
  344. containing the picture files).  The files in this directory will be listed
  345. when you return to the main menu.
  346.  
  347. If only a directory name is specified, all files that have an extension
  348. of GIF or TIF (depending on file type selected) in that directory will be
  349. displayed.  If you want to list other files also, enter an appropriate string
  350. to be matched.
  351.  
  352. Examples:
  353.           To list                                       Enter
  354.  
  355. all files in the current directory                      *.*<return>
  356.  
  357. all files with extension GIF in the current directory   *.gif<return>
  358.  
  359. all files with extension GIF or TIF (depending on       pics<return>
  360.   file type) in the subdirectory "pics" of the
  361.   current directory
  362.  
  363. all files with extension GIF or TIF (depending on       \picdir<return>
  364.   file type) in the subdirectory "picdir" of the
  365.   root directory
  366.  
  367. all files in the subdirectory "picdir" of the root      \picdir\*.*<return>
  368.         directory.
  369.  
  370. You can also set the display directory from the command line using the -d
  371. option.
  372.  
  373.  
  374. SCALING OF PICTURES
  375.  
  376. There are many scaling options. The default scaling is 1:1 i.e. no scaling.
  377. You can choose to set the scales manually.  You can also have the program
  378. perform auto-scaling.  The "auto-scale full screen" option makes the picture
  379. "fit" the screen horizontally and vertically.  You can also auto-scale
  380. with the constraint that the horizontal and vertical scales should be equal.
  381.  
  382. Use the "Scale" menu to change the scaling options.  You can also select
  383. the scaling method from the command line using the -s option.
  384.  
  385.  
  386. ZOOMING
  387.  
  388. Once a picture is displayed on the screen, you can zoom in using the "+" key
  389. and zoom out using the "-" key.
  390.  
  391.  
  392. PANNING
  393.  
  394. Once a picture is displayed on the screen, you can move the viewing window
  395. around the picture by the use of the cursor keypad:
  396.  
  397.                            (Number lock should be disabled)
  398.  
  399.         down arrow  (or "d")       move down  half screen (1/8 screen for TIFF)
  400.         right arrow (or "r")       move right half screen (1/8 screen for TIFF)
  401.         up   arrow  (or "u")       move up    half screen (1/8 screen for TIFF)
  402.         left arrow  (or "l")       move left  half screen (1/8 screen for TIFF)
  403.         "End"       (or "1")       move to bottom left corner
  404.         "PgDn"      (or "3")       move to bottom right corner
  405.         "PgUp"      (or "9")       move to top right corner
  406.         "Home"      (or "7")       move to top left corner
  407.  
  408.                            (Scroll lock should be disabled)
  409.  
  410.   shift-down  arrow (or "2")       move down  full screen
  411.   shift-right arrow (or "6")       move right full screen
  412.   shift-up    arrow (or "8")       move up    full screen
  413.   shift-left  arrow (or "4")       move left  full screen
  414.  
  415.  
  416.  
  417. BRIGHTNESS
  418.  
  419. Once a picture is displayed on the screen, you can increase the brightness
  420. by pressing the "b" key and reduce the brightness by pressing the "B" key.
  421.  
  422.  
  423. PRINTING
  424.  
  425. Once an image is displayed on the screen, you can print that image by
  426. pressing the "p" key.  Before printing, make sure that you have set up
  427. the printer port and selected the correct printer by going into the
  428. Options menu.
  429.  
  430. The entire image is printed.  Any brightness adjustments you have made
  431. will affect the print output.  The output to 2-color printers (most printers)
  432. can be dithered so as to obtain a better print-out.  You can choose between
  433. no dithering, 2x2 dithering, 3x3 dithering or 4x4 dithering by going
  434. into the Options menu.  You may wish to experiment with the dithering
  435. options to obtain the best print image.  For fairly high resolution
  436. printers (200x200 dpi or greater), 3x3 or 4x4 is suggested for paint-type
  437. images, and 1 or 2x2 for line art/scanned documents.
  438.  
  439. From the Options menu, you can also set the desired size of the print-out.
  440.  
  441. You can specify "lpt1:","lpt2:","lpt3:","com1:","com2:" or a filename
  442. for the printer port.
  443.  
  444.  
  445. TEXT SCREEN COLORS
  446.  
  447. You can change the text screen colors used by going into the "Options"
  448. menu and answering "y" when asked "Change Screen Colors ?".
  449. Use the left/right arrow keys to change the foreground color and the
  450. up/down arrow keys to change the background color. (Alternately, you can use
  451. the "f" and "F" keys for foreground and the "b" and "B" keys for background).
  452. Select the colors you like.  Note the numbers shown that corresponds to each
  453. of the colors that you selected - these numbers can be used with the "-cd",
  454. "-co" and the "-cg" command line options to automatically select your
  455. favourite colors when the program is started.
  456.  
  457. ^L
  458.  
  459.  
  460. COMMAND LINE OPTIONS
  461.  
  462. Many of the options may be set from the command line instead going through
  463. a menu.  For example, to start the program with the mode option set to 9
  464. and the scaling option set to 3, enter:
  465.  
  466.         vuimg  -m9 -s3
  467.  
  468. The available command line options are listed below:
  469.  
  470.   -Tfiletype    where filetype is "gif" or "tiff".
  471.                 to go into the "Mode" menu and make a selection.
  472.  
  473.                 Example:   -Ttiff       (display tiff files)
  474.  
  475.   -vdrivername  where drivername is the name of the extended mode driver
  476.                 appropriate for your board.  If the program files are not in
  477.                 the current directory, then the drive and subdirectory must
  478.                 also be specified.
  479.  
  480.                 Example (load ATI VGAWonder driver):
  481.  
  482.                            -vdativ            (program files in current dir)
  483.                            -vc:\vuimage\dativ (program files in c:\vuimage)
  484.  
  485.   -mmodeindex   where modeindex is the number you would enter if you were
  486.                 to go into the "Mode" menu and make a selection.
  487.  
  488.                 Example:   -m9          (set 320x200x256 mode)
  489.  
  490.   -sscaleindex  where scaleindex is the number you would enter if you were
  491.                 to go into the Scale menu (part of the "Options" menu) and
  492.                 make a selection.
  493.  
  494.                 Example:   -s3          (set autoscale full screen)
  495.  
  496.   -sxhscale     where hscale is the horizontal scale value (1% to 999%).
  497.                 This option should be used only if manual scaling is selected.
  498.  
  499.                 Example:   -sx200       (set horizontal scale to 200%)
  500.  
  501.   -syvscale     where vscale is the vertical scale value (1% to 999%).
  502.                 This option should be used only if manual scaling is selected.
  503.  
  504.                 Example:   -sy50        (set vertical scale to 50%)
  505.  
  506.   -ddirectory   where directory is a directory name (or file matching string)
  507.                 that you would enter when you go into the Dir menu.
  508.  
  509.   -ttimeout     where timeout is the number of seconds to display each picture.
  510.  
  511.                 Example:   -t40         (set timeout to 40 seconds)
  512.  
  513.   -by           enables the beep at the end of a picture
  514.   -bn           disables the beep at the end of the picture
  515.  
  516.                 Example:   -bn          (disable beep)
  517.  
  518.   -Bbrightness  where brightness is the brightness value (100 is nominal)
  519.  
  520.                 Example:   -B120                (set brightness to 120%)
  521.  
  522.   -cddircolor   where dircolor is the color number for the filenames 
  523.   -cofncolor          fncolor  is the color number for the file numbers 
  524.   -cmmodcolor         modcolor is the color number for the display mode
  525.   -cggencolor         gencolor is the color number for general text
  526.                 To find the color numbers for the colors of your choice, first
  527.                 go into the "Options" menu and select the colors that you like.
  528.                 The corresponding color numbers are also displayed.
  529.  
  530.                 Example:   -cd78    (filenames in yellow on a red background)
  531.                            -co10    (filenumbers in bright green on black)
  532.                            -cm4     (video mode in red on black)
  533.                            -cg14    (general text in yellow on black)
  534.  
  535. (*** The following options are available only in VUIMAGE PLUS(tm) ***)
  536.  
  537.   -pdprinternum where printernum is the number you would enter if you were
  538.                 to go into the Options menu and choose a printer.
  539.  
  540.                 Example:   -p1      (select EPSON FX80/100 printer)
  541.  
  542.   -pddevicename where devicename is the printer device (lpt1:, lpt2:, lpt3:,
  543.                 com1:, com2: or filename).
  544.  
  545.                 Example:   -pdlpt1:      (send output to lpt1:)
  546.                            -pdvuimg.prn  (send output to file vuimg.prn)
  547.  
  548.   -pxwidth      where width is the width of the printed image in 1/100 inches
  549.  
  550.                 Example:   -px904   (print image width=9.04 inches)
  551.  
  552.   -pyheight     where height is the height of the printed image in 1/100 inches
  553.  
  554.                 Example:   -py1200  (print image height=12.00 inches)
  555.  
  556.   -fddithertype where dithertype is the number you would enter if you were to
  557.                 go into the Options menu and choose the display dither type.
  558.  
  559.                 Example:   -fd3     (dither 2-color displays using 3x3 matrix)
  560.  
  561.   -fpdithertype where dithertype is the number you would enter if you were to
  562.                 go into the Options menu and choose the printer dither type.
  563.  
  564.                 Example:   -fd4     (dither 2-color printers using 4x4 matrix)
  565.  
  566.   -C            disables the menus.  If you use this option, you must also
  567.                 specify a filename to be displayed including the pathname.
  568.                 This should be the last option entered on the command line.
  569.                 The filename may contain wild card characters ? and * and 
  570.                 should be the last parameter.  Any directory name entered
  571.                 with the -d option will be ignored.
  572.  
  573.                 Examples:   -C somefile.gif
  574.                             -C \pics\*.gif
  575.  
  576.   -L            leave the last image on the screen when the program ends.
  577.                 Valid only when the -C option is used.  Useful when called
  578.                 as a sub-program by another program.
  579.  
  580.  
  581.  
  582.  
  583. PRE-PROGRAMMED MODE
  584.  
  585. You can run the program in a PRE-PROGRAMMED mode where it will go through a
  586. display session with no keyboard input.  To do this, go through a manual
  587. session and write down all keystrokes till you quit back to DOS (this is
  588. important).  If you use the ESC key to abort a picture or list,
  589. the return key to move on to the next picture, or the cursor keys to do
  590. panning, do NOT include these keystrokes.  Then create a file containing
  591. these keystrokes (we will use the filename "vuimg.inp" in the following
  592. example).  To do this, type: 
  593.  
  594.         copy con: vuimg.inp <return>
  595.  
  596. Enter the keystrokes you wrote down and then type a <CTRL>Z to create the
  597. file called vuimg.inp.  A text editor (ex. edlin) may also be used to
  598. create such a file (start a new line for every "return" key).  This file
  599. may then be used to run the program in the PRE-PROGRAMMED mode by typing
  600.  
  601.        vuimg  < vuimg.inp
  602.  
  603.  
  604. DOS EXIT CODES (ERRORLEVEL)
  605. ---------------------------
  606.  
  607. The return codes generated by the program that may be tested in a batch
  608. file are:
  609.  
  610. 0 - no error
  611. 1 - command line option error
  612. 2 - the -C option was used without specifying a file
  613. 3 - file not found or invalid filename
  614.  
  615.  
  616.  
  617.  
  618. DISPLAY BOARDS and EXTENDED VIDEO MODES/DRIVERS
  619. -----------------------------------------------
  620.  
  621. If the program does not work with your display board, try loading any software
  622. drivers (BIOS emulators, int 10h drivers, RAM BIOS drivers) that come with it.
  623. Refer to the instructions that come with your graphics board.
  624.  
  625. Some video display boards support even higher resolutions than standard VGA,
  626. for example, 640x480 in 256 colors and 800x600 in 16 colors.  These are
  627. sometimes referred to as SuperVGA modes.  Additional drivers that support
  628. these "extended modes" are included with the program.  These drivers have
  629. filenames with the extension ".VDR" and are listed later in this section.
  630. They can be loaded using the "-v" command line option (see section on command
  631. line options).
  632.  
  633. Typically, extended modes are dependent on your type of graphics card.
  634. Refer to your graphics card manual to see what extended modes are supported.
  635. Only VGA type extended modes with either 16 or 256 colors out of a palette
  636. of 262,144 colors are supported by the extended mode drivers.  Check the
  637. list of extended mode drivers at the end of this section to see which driver
  638. is suitable for use with your card.
  639.  
  640. However, there is a SuperVGA standard known as the VESA SuperVGA standard.
  641. Many or most of the SuperVGA cards now support this standard.  If your
  642. card supports this standard, then you can take advantage of the VESA driver
  643. (DVESA.VDR) that comes with the program.  Even if there is a separate driver
  644. that supports your card, WE RECOMMEND that you use the VESA driver instead
  645. if the card supports the VESA standard.  In order for your card to support
  646. the VESA standard, you may need to load a device driver or TSR that comes
  647. with your card (through the CONFIG.SYS or AUTOEXEC.BAT file).  Refer to the
  648. documentation that comes with your card (in printed form or disk file form).
  649.  
  650. If you are not using any extended drivers, you may still be able to display
  651. in an extended mode if your BIOS for the board will support this.  Not all
  652. boards come with BIOS that support the extended modes completely.  Installing
  653. any RAM BIOS drivers that come with your board may help.  Display done
  654. through the BIOS is usually extremely slow.
  655.  
  656. To use the BIOS supported extended modes, you need to know the mode number,
  657. the no. of columns, the no. of rows, and the no. of colors for the mode.
  658. Refer to the manual for your graphics card.
  659.  
  660.  
  661. Extended Mode Drivers (SuperVGA drivers) included:
  662.  
  663.     If your display board is:                   Try driver
  664.     ------------------------                    ----------
  665.     Any board that suports the VESA standard    DVESA
  666.     and has VESA BIOS installed
  667.     
  668.         ATI VGAWONDER                           DATIV
  669.         Paradise VGA cards                      DPVGA
  670.         AST VGA cards                           DPVGA
  671.         AT&T VDC600                             DPVGA
  672.         Orchid ProDesigner                      DORCH
  673.         STB VGA cards                           DORCH
  674.         Genoa VGA cards                         DORCH
  675.         Sigma VGA cards                         DORCH
  676.         Standard IBM VGA & register compatibles
  677.                 with multisync monitors         DNVGA
  678.         Everex EV673                            DE673
  679.         Everex EV678                            DE678
  680.         Video-7 Fastwrite                       DV7FW
  681.         Video-7 1024i                           DV71024
  682.         Video-7 VRAM                            DV7VRAM
  683.         Trident Video cards                     DTRID
  684.     Cardinal 600 VGA             DCHT
  685.     Other Chips&Technolgies chipset        DCHT
  686.  
  687.  
  688.     If your board is not listed, you can try one of the supplied drivers
  689.     to see if any of the extended modes will work. Other drivers may become
  690.     available from Offe in the future.  Not all modes available are supported
  691.     on the listed boards.
  692.  
  693.  
  694. Extended Modes Supported by the Drivers (mode numbers in decimal and hex)
  695.  
  696. DVESA
  697.         Mode 256  (100h)         640 x  400 x 256 colors
  698.         Mode 257  (101h)         640 x  480 x 256 colors
  699.         Mode 258  (102h)         800 x  600 x  16 colors
  700.         Mode 259  (103h)         800 x  600 x 256 colors
  701.         Mode 260  (104h)        1024 x  768 x  16 colors
  702.         Mode 261  (105h)        1024 x  768 x 256 colors
  703.         Mode 262  (106h)        1280 x 1024 x  16 colors
  704.         Mode 263  (107h)        1280 x 1024 x 256 colors
  705.  
  706. DATIV
  707.         Mode  84 (54h)           800 x 600 x  16 colors 
  708.         Mode  97 (61h)           640 x 400 x 256 colors
  709.         Mode  98 (62h)           640 x 480 x 256 colors
  710.         Mode  99 (63h)           800 x 600 x 256 colors
  711.         Mode 101 (65h)          1024 x 768 x  16 colors
  712.  
  713. DCHT
  714.         Mode 112 (70h)           800 x 600 x  16 colors 
  715.         Mode 114 (72h)          1024 x 768 x  16 colors
  716.         Mode 120 (78h)           640 x 400 x 256 colors
  717.         Mode 121 (79h)           640 x 480 x 256 colors
  718.         Mode 128 (7bh)           800 x 600 x 256 colors
  719.  
  720. DE673
  721.         Submode 19 (13h)        640 x 350 x 256 colors
  722.         Submode 20 (14h)        640 x 400 x 256 colors
  723.         Submode 21 (15h)        512 x 480 x 256 colors
  724.  
  725. DE678
  726.         Submode 49 (31h)        640 x 400 x 256 colors
  727.         Submode 50 (32h)        512 x 480 x 256 colors
  728.         Submode 77 (4dh)        640 x 480 x 256 colors
  729.         Submode 78 (4eh)        800 x 600 x 256 colors
  730.  
  731. DNVGA
  732.         -------                  320 x 400 x 256 colors
  733.         -------                  360 x 480 x 256 colors
  734.         -------                  800 x 600 x  16 colors
  735.  
  736. DORCH
  737.         Mode  41 (29h)           800 x 600 x  16 colors
  738.         Mode  45 (2Dh)           640 x 350 x 256 colors
  739.         Mode  46 (2Eh)           640 x 480 x 256 colors
  740.         Mode  47 (2Fh)           720 x 512 x 256 colors
  741.         Mode  48 (30h)           800 x 600 x 256 colors
  742.         Mode  55 (37h)          1024 x 768 x  16 colors
  743.  
  744. DPVGA
  745.         Mode  88 (58h)           800 x 600 x  16 colors
  746.         Mode  94 (5Eh)           640 x 400 x 256 colors
  747.         Mode  95 (5Fh)           640 x 480 x 256 colors
  748.  
  749. DV7FW
  750.         Mode  98 (62h)           800 x 600 x  16 colors
  751.         Mode 102 (66h)           640 x 400 x 256 colors
  752.         Mode 103 (67h)           640 x 480 x 256 colors
  753.  
  754. DTRID
  755.         Mode  91 (5Bh)           800 x 600 x  16 colors
  756.         Mode  92 (5Ch)           640 x 400 x 256 colors
  757.         Mode  93 (5Dh)           640 x 480 x 256 colors
  758.         Mode  95 (5Fh)          1024 x 768 x  16 colors
  759.  
  760. DV71024
  761.         Mode  98 (62h)           800 x 600 x  16 colors
  762.         Mode 101 (65h)          1024 x 768 x  16 colors
  763.         Mode 102 (66h)           640 x 400 x 256 colors
  764.         Mode 103 (67h)           640 x 480 x 256 colors
  765.  
  766. DV7VRAM
  767.         Mode  98 (62h)           800 x 600 x  16 colors
  768.         Mode 101 (65h)          1024 x 768 x  16 colors
  769.         Mode 102 (66h)           640 x 400 x 256 colors
  770.         Mode 103 (67h)           640 x 480 x 256 colors
  771.         Mode 105 (69h)           800 x 600 x 256 colors
  772.