home *** CD-ROM | disk | FTP | other *** search
/ Current Shareware 1994 January / SHAR194.ISO / viewers / vpgif.zip / VESAVIEW.DOC < prev    next >
Text File  |  1993-07-21  |  65KB  |  1,191 lines
  1. VESAVIEW.EXE   v 4.5    (This document is in WordPerfect 5.1 format
  2.                          in the registered program.)
  3.  
  4.  
  5. TABLE of CONTENTS:
  6.      
  7.      Keywords. . . . . . . . . . . . . . . . . . . . . . . . . .   3
  8.      
  9.      Brief Desc. . . . . . . . . . . . . . . . . . . . . . . . .   3
  10.      
  11.      LEGAL STUFF . . . . . . . . . . . . . . . . . . . . . . . .   3
  12.      
  13.      REGISTRATION. . . . . . . . . . . . . . . . . . . . . . . .   3
  14.      
  15.      DISCLAIMER. . . . . . . . . . . . . . . . . . . . . . . . .   3
  16.      
  17.      REQUIREMENTS. . . . . . . . . . . . . . . . . . . . . . . .   4
  18.      
  19.      FEATURES. . . . . . . . . . . . . . . . . . . . . . . . . .   4
  20.      
  21.      RUNNING with COMMAND LINE QUALIFIERS. . . . . . . . . . . .   5
  22.      
  23.      SYSTEM DEFAULTS . . . . . . . . . . . . . . . . . . . . . .   8
  24.      
  25.      CHANGING DIRECTORY. . . . . . . . . . . . . . . . . . . . .   8
  26.      
  27.      VIEW SINGLE IMAGE (from Text directory) . . . . . . . . . .   9
  28.      
  29.      VIEW MULTIPLE IMAGES (slide show) (from Text
  30.                directory). . . . . . . . . . . . . . . . . . . .   9
  31.      
  32.      VIEW / CREAT AN ARRAY OF IMAGES (from Text
  33.                directory). . . . . . . . . . . . . . . . . . . .   9
  34.      
  35.      AUTO ARRAY GENERATION/SAVING. . . . . . . . . . . . . . . .  10
  36.      
  37.      VIEWING FILES (from a previously created Array
  38.                image). . . . . . . . . . . . . . . . . . . . . .  10
  39.      
  40.      VIEWING GIF89A FILES - Special Case . . . . . . . . . . . .  11
  41.      
  42.      VIEWING HPG or PLT FILES. . . . . . . . . . . . . . . . . .  11
  43.      
  44.      DELETING FILES. . . . . . . . . . . . . . . . . . . . . . .  12
  45.      
  46.      SEARCHING FILENAMES . . . . . . . . . . . . . . . . . . . .  12
  47.      
  48.      SPECIAL KEYS WHILE VIEWING. . . . . . . . . . . . . . . . .  12
  49.      
  50.      SAVING SCREEN AS a  BMP, GIF or PCX FILE. . . . . . . . . .  13
  51.      
  52.      SAVING SCREEN AS a JPG FILE:. . . . . . . . . . . . . . . .  13
  53.      
  54.      CROPPING SCREEN & SAVING AS a  BMP, GIF, JPG or PCX
  55.                FILE. . . . . . . . . . . . . . . . . . . . . . .  13
  56.      
  57.      SCALING XMEM CONTENTS TO SCREEN & SAVING. . . . . . . . . .  14
  58.      
  59.      SAVING XMEM CONTENTS AS an IMG or PCX FILE. . . . . . . . .  14
  60.      
  61.      PRINTING IMAGES . . . . . . . . . . . . . . . . . . . . . .  14
  62.      
  63.      MOUSE USE . . . . . . . . . . . . . . . . . . . . . . . . .  15
  64.      
  65.      RUNNING Under WINDOWS 3.1:. . . . . . . . . . . . . . . . .  15
  66.      
  67.      CAUTIONS. . . . . . . . . . . . . . . . . . . . . . . . . .  16
  68.      
  69.      HINTS . . . . . . . . . . . . . . . . . . . . . . . . . . .  16
  70.      
  71.      CARDS TESTED. . . . . . . . . . . . . . . . . . . . . . . .  17
  72.      
  73.      SUPPORT . . . . . . . . . . . . . . . . . . . . . . . . . .  18
  74.      
  75.      REVISION HISTORY. . . . . . . . . . . . . . . . . . . . . .  18
  76.      
  77.  
  78. VESAVIEW.EXE   v 4.5
  79.  
  80.  
  81. Keywords: VESA BMP GIF IMG JPG PCX TGA TIF HPGL PRINT CATALOG VIEWER DESKJET
  82.           LASERJET PAINTJET
  83.  
  84. Brief Desc:    View and print BMP, GIF, IMG/GEM, JPG, PCX, TGA & TIF images
  85.                & HPGL plotter files.  Arrays of up to 81 images/screen can be
  86.                generated and saved for easy cataloging.  HPGL plot files can
  87.                be saved as B&W files.  Mouse support.  Requires a VESA driver
  88.                for your graphics card and enough extended memory to hold
  89.                entire image.   Supports VESA modes thru 1280x1024x256.  Quick
  90.                panning of images larger than your screen resolution.
  91.                Color/brightness/contrast adjustments, scaling & cropping of
  92.                color images. Fade control for slide shows. 24 bit color
  93.                reduction for BMP, JPG, TGA & PCX. Excellent Black & White
  94.                printing to HP DeskJet or LaserJet.  Superb Color printing to
  95.                HP PaintJet, PaintJet XL, PaintJet XL300 and DeskJet
  96.                500C/550C.  Images can be selected graphically from previously
  97.                created arrays.
  98.  
  99.  
  100.  
  101. LEGAL STUFF:   Copyright (c) William M. White 1992,1993.
  102.                Compuserve ID: 71770,2340
  103.  
  104. The VESAVIEW product is Shareware. If you find it useful, please register
  105. your copy and tell your friends about it.  This product may not be sold or
  106. packaged, either individually, or as part of any other product without the
  107. express written consent of the author. This product may not be changed or
  108. altered and then distributed without the express written consent of the
  109. author.  The VESAVIEW.DOC & VESAVIEW.LGO files must accompany VESAVIEW.EXE
  110. whenever the non-registered version is distributed.
  111.  
  112. The JPEG decoding and encoding portion of this program "is based in part on
  113. the work of the Independent JPEG Group".  "The Graphics Interchange Format
  114. (c) is the Copyright property of CompuServe Incorporated.  GIF (sm) is a
  115. Service Mark property of CompuServe Incorporated."
  116.  
  117. REGISTRATION:
  118.      Please send your $30.00 registration fee to:
  119.           William M. White
  120.           P. O. Box 2273
  121.           Glen Allen, VA. 23058-2273
  122.  
  123. By Registering your copy, you will receive an unhindered copy of the latest
  124. version of VESAVIEW and help support the continued development of the
  125. product.  Current shareware versions of the product will always be available
  126. on Compuserve in the GRAPHSUPPORT forum (GO PICS) and on the Blue Ridge
  127. Express Bulletin Board (804)-790-1675.. Updates for registered users are
  128. available for $5.00 to cover handling.  Your registered copy of the program
  129. should never be distributed since it will be encoded with your name.
  130.  
  131. DISCLAIMER:
  132.  
  133. VESAVIEW is offered to you on an as-is-basis without any guarantee as to the
  134. correct functioning or fitness for a specific purpose.  The author believes
  135. this program to work as described but you use the program entirely at your
  136. own risk.  The author will not be responsible for any hardware or software
  137. damage, loss of data, or incidental or consequential damage that may result
  138. from its use, whether or not such use is in accordance with the instructions.
  139.  
  140. REQUIREMENTS:
  141.  
  142. o    IBM compatible 286 or better
  143. o    Extended memory (and driver such as HIMEM).  For 256 (& higher) color
  144.      files, you'll need 1 byte/pixel in your image.  For 2 color files,
  145.      you'll need 1 byte per 8 pixels in your image.  This program conforms to
  146.      XMS 2.0 specification.  8MB of extended memory is recommended expecially
  147.      if you will be using graphic array menus and working with JPEG files.
  148. o    Will use a math coprocessor if available
  149. o    A graphics card that supports the VESA BIOS EXTENSIONS for the 'Super
  150.      VGA modes' either through hardware or a software driver.  NOTE: If no
  151.      VESA driver is found, you will be limited to 320x200x256 or 640x480x2
  152.      non-VESA modes which won't allow arrays to be generated.
  153.  
  154. FEATURES:
  155.  
  156. o    Will read in any size up to 1280 x 1024:
  157.           BMP (Windows) -   16, 256 color & 24 bit (16 million colors)
  158.           GIF (Compuserve 87a/89a) -   16 & 256 color
  159.           IMG (GEM/Digital Research Inc) -   B & W
  160.           JPG (JPEG/JFIF) - Grayscale & 24 bit (16 million colors)
  161.           PCX (Zsoft) -   2, 16, 256 color & 24 bit (16 million colors)
  162.           TGA (Targa) -   8,16, 24 & 32 bit (non-compressed RGB & Run length
  163.                           encoded RGB)
  164.           TIF -     B & W, 16c, 256c  & 24 bit (non-compressed & run length
  165.                     encoded)
  166.           HPG -     (Hewlett Packard) HPGL plot files (.HPG or .PLT)
  167.  
  168. o    Files can be selected either from a text directory listing or
  169.      graphically from a previously created array of images (mouse required
  170.      for graphic selection).  Multiple selections are displayed in the order
  171.      selected.
  172.  
  173. o    If the file is larger than the screen mode you selected, you can quickly
  174.      pan around the image.  Size of image is limited only by the amount of
  175.      extended memory you have.  NOTE:  The entire image is read into Extended
  176.      memory to allow for quick panning of large images.  Black & White images
  177.      are stored in memory with 1 byte per 8 pixels. 16 (4 bit) and 256 color
  178.      (8 bit) images are stored in memory with 1 byte per pixel.  24 & 32 bit
  179.      images are stored in memory as 256 color images so only 1 byte per pixel
  180.      is required.
  181.  
  182. o    Black & White printing (color images will be halftoned) and Color
  183.      printing are supported.  Prints can be sized, rotated and positioned on
  184.      paper.  Printers supported are HP LaserJet Series, DeskJets, DeskJet
  185.      500/500C/550C, PaintJet, PaintJet XL, and PaintJet XL300.
  186.  
  187. o    Red/Blue/Green/Contrast/Brightness values may be changed while viewing
  188.      a color image.  Image can be converted to GrayTone.
  189.  
  190. o    Color screen images can be saved as a 256 color BMP, GIF, JPG or PCX
  191.      file. These images may be cropped & scaled before saving.
  192.  
  193. o    Black & White images can be saved as an IMG or 2 color PCX file. This is
  194.      useful to save a HPGL file that is displayed on screen out to a quicker
  195.      retrieving raster file.  If these images are displayed in a color VESA
  196.      mode they can also be saved &/or cropped as 256 color  BMP, GIF, JPG or
  197.      PCX files.
  198.  
  199. o    Arrays of up to 81 images can be displayed on a single screen at once. 
  200.      This screen can then be saved as a single  BMP, GIF, JPG or PCX file for
  201.      cataloging or printing or use as a graphic menu for VESAVIEW.
  202.  
  203. o    Supports VESA modes (assuming your graphics card can handle):
  204.           100 -  640 x  400 x 256
  205.           101 -  640 x  480 x 256
  206.           103 -  800 x  600 x 256
  207.           105 - 1024 x  768 x 256
  208.           107 - 1280 x 1024 x 256
  209.  
  210. o    Will support a 800 x 600 x 2 color B&W mode if your card has one.  (See
  211.      /SVn option below)
  212.  
  213. o    Supports the use of a MicroSoft compatible 2-button mouse.
  214.  
  215. NOTE:     The annoying beeps and NON-Registered notices will be removed from
  216.           registered copies.  Also, the NON-Registered version does not
  217.           support the new printing options (sizing, rotating and
  218.           positioning), nor the Compressing of printer data.
  219.  
  220. RUNNING with COMMAND LINE QUALIFIERS:
  221.  
  222. Make sure you have enough extended memory available and that a driver (such
  223. as HIMEM) is loaded.  Make sure your graphics card has VESA BIOS EXTENSIONS
  224. (VBE) either built-in or that you have installed a VESA software driver. 
  225. Keyin:
  226.  
  227.      VESAVIEW [/AB or /AW] [/AMmode] [/AS] [/CS, /CO or /COD] [/Dn] [/Fn]
  228.      [/FN, /FB or /BW] [/FTMn] [/LOmode] [Mx] [/NB] [/NLAM] [/P1, /P2 or /PF]
  229.      [/PAn] [/PC] [/PGn] [/PLMn] [/PRn] [/PTMn] [/PSBH, /PSBS, /PSCH or
  230.      /PSCS] [/PTDJ, /PTLJ, /PTPJ, /PTPJXL, /PTPJXL3, /PTDJC or /PTDJ5C]
  231.      [/PWn] [/PXSn] [/PYSn] [/SVn] [/UPSA, /UPSB or /UPSC] [/WN, /WH or /WF]
  232.      where items in brackets are optional.
  233.  
  234. CAUTION:  DOS has a limitation of 127 characters on the command line.  If you
  235. exceed this when adding qualifiers, some may be truncated.
  236. NOTE: Underlined (or *) qualifiers are only available in the REGISTERED
  237. VERSION.  The optional qualifiers can also be changed while in the program by
  238. pressing <O> (or pointing to OPTS with the mouse).  These changes are only
  239. for the current session and will not be saved.  A 'space' is needed between
  240. each qualifier on the command line.  If you wish to use the same qualifiers
  241. each time you evoke the program, write a BAT file like:
  242.  
  243.      CD \GIF                  rem Assumes your graphics files are here
  244.      \VV\VESAVIEW /P1 /NW /CO      rem Assumes program in VV dir
  245.  
  246. The /AB forces the array mode to use a black background and white text for
  247. the filenames.  
  248. The /AW forces the array mode to use a white background and black text (saves
  249. black ink when printing).
  250.  
  251. The /AMmode (where mode is 100, 101, 103, 105 or 107) will let you default to
  252. a specific mode when displaying arrays.  The program will default to mode 101
  253. if this switch is not used.  Only use a mode number that your card can
  254. support!
  255.  
  256. The /AS (array sizes) enables the display of image sizes above each image of
  257. an array.  The size will be displayed after the filename of each image only
  258. if it will fit.  Typically at a resolution of 1024x768, the sizes will fit on
  259. 6x6 arrays and below.  At 800x600, the sizes will fit on 5x5 arrays and
  260. below.  At 640x480, the sizes will fit on 4x4 arrays.  Each image is tested
  261. individually, so on a given array screen, some sizes may appear and some may
  262. not.  You will see the sizes displayed after all images on a page have been
  263. processed.
  264.  
  265. The /CO (color-optimized) will force 16, 24 & 32 bit images to be processed
  266. using an optimized 256 color palette.  The process reads in all the colors in
  267. your image, creates a histogram of the most used colors, and then creates an
  268. optimized palette of the results. The processing time is greater than if the
  269. /CS option is used, but the results are spectacular.  The color reduction
  270. method used is much faster than that of other program that I have tested. 
  271. After the image has been displayed on the screen, you might want to save it
  272. as a 256 BMP, GIF, JPG or PCX file, so that the next time you want to display
  273. it, you can use the quicker 256 color version.
  274.  
  275. The /COD qualifier is similar to /CO above, expect that besides using an
  276. optimized palette, the image will also be dithered to smooth out the
  277. transition between colors.
  278.  
  279. The /CS (color-standard) will force 16, 24 & 32 bit images to be displayed
  280. using a standard palette.  The colors will be adequate for previewing, but
  281. for more exact colors, use the /CO.
  282.  
  283. The /Dn (delay) is for setting the delay in seconds to use between slides. 
  284. The n is an integer number from 1 to 999 and defaults to 5 seconds.  This
  285. time is approximate and will vary depending  on the size of the image being
  286. read in.
  287.  
  288.  
  289. The /Fn (fade) option will fade in and out your images on screen when
  290. displaying them as a slide show.  The n can range from 0 to 10.  0 is no
  291. fade, 1 is the fastest fade and 10 is the slowest fade.
  292.  
  293. The /FN, /FB or /FW specify the foreground color (N=none, B=Black and
  294. W=White) of your Black & White images.  By specified foreground color, the
  295. program will be able to save more of your image's original context when
  296. scaling down.  This qualifier works best if your images are line drawings and
  297. not pictures.  For example, if your image appears on the screen as black
  298. lines on a white background, use the /FB qualifier.  If your images don't
  299. have a main foreground color such as the case with pictures, use /FN. Note
  300. that using either the /FB or /FW qualifiers will increase the processing time
  301. for B&W scaling.  If you don't need the increased quality, use /FN.
  302.  
  303. The /FTMn (fixed top margin) option will allow you to override the program's
  304. default values for that part on the top of a page that your printer can't
  305. print on.  The defaults are:
  306.      0.1" -    DeskJet, DeskJet 500, DeskJet 500C
  307.      0.05"-    DeskJet 550C
  308.      0.0" -    LaserJet Series, PaintJet XL, PaintJet XL300
  309.      0.0" -    PaintJet (tractor feed)
  310.  
  311. If your printed margins don't match what you set in the Printer Setup Menu,
  312. then use this qualifier to adjust them.
  313.  
  314. The /LOmode (lockout mode) (where mode is 100, 101, 103, 105 or 107) will
  315. lock out a mode.  This is useful if your VESA driver is designed for a
  316. graphics card which has been fully populated with memory chips but your card
  317. doesn't have all of this memory installed.  You may use more than one of
  318. these switches on your command line.
  319.         
  320. The /Mx (mask for filenames) will allow you to include only certain file
  321. types in your directory listing.  It can be one of the following:   /MALL
  322. (all filenames), /MDIS (all displayable graphics files), /MBMP (only *.BMPs),
  323. /MGIF (only *.GIFs),  /MIMG (only *.IMGs), /MJPG (only *.JPGs), /MPCX (only
  324. *.PCXs), /MTGA (only *.TGAs) /MTIF (only *.TIFs).  Note:  Array index files
  325. (.VNX) are always accessible by the program, even if they are not being
  326. displayed in your directory listing.  Caution:  When you use this qualifier
  327. to eliminate the display of certain file types from your screen, and you
  328. display a previously created array image that includes file types that are
  329. not currently displaying, those files will not be found even though they are
  330. actually in the directory. (they will be flaged on screen with a red
  331. crosshatch)
  332.  
  333. The /NB (no beep) option will disable the beeps after images are displayed on
  334. screen.  The default is to beep.
  335.  
  336. The /NLAM (no load array into memory) will disable the automatic loading of
  337. the first graphic array menu into XMEM even if there is enough memory to do
  338. so.  The program by default will load the first array image that will be used
  339. as a graphic menu into XMEM, if there is enough memory to hold this array and
  340. one more image (both are assummed to be the maximum size of 1280x1024x256). 
  341. If you are low on XMEM and you wish to be able to pull up larger files (B&W
  342. for example) from the array menu, you will probably need to use this
  343. qualifier.
  344.  
  345. The /P1 or /P2 (port) designates which printer port to use for printing (LPT1
  346. or LPT2).
  347. The /PF option forces printer output to a file instead of a port.  The file
  348. will be created in your current directory with the same filename as your
  349. image file but with an extension of  .VVP .  This option works with multiple
  350. plots as well.  No checking for duplicate filenames is done.  To plot the
  351. file(s), from DOS keyin:
  352.      COPY/B  filename.VVP  LPT1:  
  353. where filename could be a wildcard and LPT1: could be LPT2:.  The /B
  354. instructs DOS to use a binary copy mode.
  355.  
  356. The /PAn (print angle) is used to rotate your print on the printed page. 
  357. Values for n can be 0, 90, 180 or 270.
  358.  
  359. *    The /PC (print compress) option will force the transfer of data from your
  360. computer to the printer to be in a compressed (encoded) format.  This will
  361. speed up the transfer of data (especially for serial or networked printers). 
  362. Time savings will vary depending on the type and size of plot.  In some
  363. cases, you may find no time savings overall since the printer has to
  364. decompress the data, but your CPU should be freed up from processing sooner. 
  365. (default is no compress).  The PaintJet and LaserJet II don't support this
  366. type of data compression.  If your printouts look garbled, don't use this
  367. qualifier.
  368.  
  369. The /PGn (print gamma correction) option will allow you to adjust the gamma
  370. of your Black & White or Color print.  Simply put, gamma correction will
  371. adjust the intensities of red, green & blue values logarithmically since the
  372. human eye's perception of color intensity is non-linear.  The gamma value is
  373. a decimal value between 0.5 and 2.0.  If set to 0, no gamma correction will
  374. be performed.  If this qualifier is not used, gamma defaults to a value best
  375. suited for the printer type selected.  Using higher values will result in the
  376. darker colors in your image being printed lighter and the lighter ones
  377. remaining the same.  This gives a much more natural looking printout.
  378.  
  379. *    The /PRn (printer resolution) is used to specify the resolution in dots per
  380. inch (dpi) of your active printer.  For the DeskJet series, it can be 75, 150
  381. or 300.  For the PaintJet series (except XL300), it can be 90 or 180. 
  382. Defaults to highest resolution for selected printer.
  383.  
  384. The /PXSn and /PYSn (plot scale) qualifiers can be used to slightly adjust
  385. the X-scale and/or Y-scale of your B&W plots.  These are useful if your plot
  386. needs to be an exact scale and your printer is not scaling the plot the same
  387. in the X & Y directions.  Increasing the /PXSn parameter will lengthen the
  388. plot along the 8 1/2" dimension and increasing the /PYSn parameter will
  389. lengthen the plot along the 11" direction.  The defaults for n are 1.0 and
  390. their ranges are between 0.9500 and 1.0500.  For example, on my DeskJet I use
  391. /PYS1.005 and /PYS1.015.
  392.  
  393. The /PSx (print style) option allows you to select the style of printing for
  394. Black & White or Color prints.  It can be one of the following:  /PSBH (B&W
  395. Halftone), /PSBS (B&W Scatter), /PSCH (Color Halftone) or /PSCS (Color
  396. Scatter).  The Halftone styles will process much faster than the Scatter
  397. dithering types which use an error difusing algorithm, however, the Scatter
  398. styles will in most cases have much better detailing and quality.  Halftoning
  399. is the default.
  400.  
  401. The /PTx (printer type) is used to select your printer.  It can be one of the
  402. following:  /PTDJ (HP DeskJet), /PTLJ (HP LaserJet), /PTPJ (HP PaintJet),
  403. /PTPJXL (HP PaintJet XL), /PTPJXL3 (HP PaintJet XL300), /PTDJC (HP DeskJet
  404. 500C) or /PTDJ5C (HP DeskJet 550C).
  405.  
  406. *    The /PWn (print width) is used to specify a print width.  It is a decimal
  407. value from 0.0 to 10.5.  If you enter a number greater than 8.0, the print
  408. will automatically be rotated 90 degrees.  The print width represents the
  409. width that you want the horizontal image dimension as seen on your screen to
  410. be printed, no matter what rotation angle you use.
  411.  
  412. *    The /PTMn (printer top margin) sets the number of inches from the current
  413. position of printhead that the image will start printing.  It is a decimal
  414. value ranging from the minimum value of your printer (see /FTMn above) to
  415. 10.0.  If set to 99, your image will be centered from top to bottom.
  416.  
  417. *    The /PLMn (printer left margin) sets the number of inches from the left side
  418. of page that the image will start printing.  It is a decimal value from 0.25
  419. to 7.5.  If set to 99, your image will be centered from left to right.  The
  420. maximum printable width on all printers is 8.0" (1/4" left & right margins).
  421.  
  422. The /SVn (SVGA) will allow you to use a 800 x 600 x 2 color mode to display
  423. IMG or HPGL files in a high resolution mode if your graphics card supports
  424. it.  The n is the decimal mode number that your card uses for this mode. 
  425. Most Paradise cards use 41 decimal for this mode, and the Tseng cards
  426. (including Orchid) use 89 decimal.  This special mode and the standard 640 x
  427. 480 x 2 mode will allow faster panning on screen than the same resolutions in
  428. VESA modes will for large B & W images.  NOTE: The panning icon which is
  429. available in VESA modes is not available for B & W modes.
  430.  
  431. The /UPSA, /UPSB & /UPSC (unknown plot size) qualifiers will allow the user
  432. to specify a default plot size (A, B. or C) if the program that created the
  433. .PLT file did not include the HPGL cmd PS to signify what the Plot Size was. 
  434. If one of these qualifiers is not used, and the .PLT file doesn't have a PS
  435. cmd, VESAVIEW will default to a 'C' size plot.
  436.  
  437. The /WF (full weights) will display the weights as originally drawn.
  438. The /WH (weight half) is similar to /WN except that the weights of lines will
  439. be halved (divided by 2).
  440. The /WN (weight none) will not display weights of lines in an HPGL plot file
  441. if the SP (select pen) keyword was used when creating the plots.  This will
  442. greatly speed up the screen drawing if you don't need to look at or print the
  443. weights.  Some CAD programs which generate the plot files create weighted
  444. lines by simply drawing the lines multiple times in the plot file (each
  445. slightly offset) and not by using the SP (set pen) command.  The /WN & /WH
  446. switches will have no effect on this type of plot files.
  447.  
  448.  
  449. SYSTEM DEFAULTS:    /AB /AM101 /COD /D5 /F0 /FB /MALL /P1 /PTDJ /PW8.0 /PA0
  450.                     /PTM0.25 /PLM0.25 /PXS1.0 /PYS1.0 /UPSC  /WF
  451.  
  452.      Ex:  VESAVIEW /P2 /AW /D10  - Will use printer port LPT2:, display
  453.      arrays with a white background, and delay 10 seconds between slides.
  454.  
  455.      Ex:  VESAVIEW /LO105 /LO107 /AM103 - Will lockout modes 105 and 107 from
  456.      being valid VESA modes and will use mode 103 when displaying arrays.
  457.  
  458. The program will test to see if your graphics card supports the VESA Bios
  459. Extensions by either hardware or software driver, whether you have a HIMEM
  460. driver loaded and how much extended memory you have available.
  461.  
  462. Use the <ESC> key to exit program.  A mouse button can not be used to exit
  463. the program.
  464.  
  465. CHANGING DIRECTORY:
  466.  
  467. While the list of files is on your screen, you can change your current
  468. directory by placing the cursor on the lite blue entries (which are directory
  469. names) and pressing <ENTER>.  The . (single dot) will take you back to the
  470. root directory, and the .. (double dots) will take you back one directory
  471. level.
  472.  
  473. You can also press the <C> key (or point to CDIR with mouse) to keyin a new
  474. path that can include a new disk drive. (Ex: B:\ or C:\GIF or C:\IMAGES\GIF
  475. or \GIF)
  476.  
  477. VIEW SINGLE IMAGE (from Text directory):
  478.  
  479. To view a single image move the cursor (with arrows, pageup, pagedown, home
  480. or end keys) to the desired image file and press <ENTER>.  Then select a Vesa
  481. Mode from the Mode Menu. An asterisk denotes the Best Mode (calculated by the
  482. program) which will display the most of your entire image on a single screen
  483. in the best resolution.  After your image is displayed, press <ESC> (or right
  484. mouse button) to return to main menu.  Note that when viewing IMG files or
  485. HPGL files, you can use a VESA mode (only B&W colors used), use the standard
  486. 640 x 480 x 2 mode or use the Super VGA mode that you optionally entered on
  487. the command line.  Entries in gray on the Mode Menu are not available for
  488. your graphics card.
  489.  
  490. VIEW MULTIPLE IMAGES (slide show) (from Text directory):
  491.  
  492. To view multiple images as a 'slide show', use the <Space Bar> (or right
  493. mouse button) to select the images you wish to view.  You can mark all images
  494. in the current directory with the <M> key (or point to MARK with mouse) or
  495. unmark them with the <U> key (or UNMARK with mouse).  These can include BMP,
  496. GIF, IMG, JPG, PCX, TGA, TIF, PLT and HPG files.  By pressing the <C> key,
  497. you can change your current Disk &/or Directory.  Press <ENTER> (or left
  498. mouse button) to start the slide show.  The files will be displayed one by
  499. one in the best VESA mode as determined by the program (640x480x2 mode is
  500. used for PLT & HPG files).  The delay between slides will vary depending on
  501. the time it takes to read in the next file while one is on your screen and
  502. the value used in the  /Dn switch.  Fading in and out between multiple images
  503. can be done by using the /Fn switch.  After the last file is displayed, the
  504. program will loop back to first slide.  Pressing <ESC> (or right mouse
  505. button) during the display will stop the slide show. (this may take several
  506. seconds).  Note:  Files will be displayed  in the order in which they were
  507. selected.  You can pause the slide show by pressing the <Pause> key on
  508. keyboard.  Any other key will continue the show.
  509.  
  510. VIEW / CREAT AN ARRAY OF IMAGES (from Text directory):
  511.  
  512. To view multiple images on a single screen at once, use the <Space Bar> (or
  513. right mouse button) to select the images you wish to view.  These can include
  514. BMP, GIF, IMG, JPG, PCX, TGA and TIF files but not PLT or HPG files.  Press
  515. <A> (or point to ARRAY with mouse) to select array display.  Select the VESA
  516. mode from Mode Menu and then select the number of images to display per
  517. screen page. Then sit back and watch your images appear.  Pressing <ESC> (or
  518. right mouse button) will  abort the display after the current image is
  519. displayed.  After each page is displayed, you could press <B> to save the
  520. currently displayed page as a Windows BMP file, <G> for GIF file, <J> for JPG
  521. or <Z> for ZSoft PCX file or <PAGE DN> will continue to display the next
  522. page.
  523.  
  524. If you used the /AS qualifier or selected 'Show Array Sizes' from the Options
  525. Menu, the image sizes will be displayed alongside the filenames.
  526.  
  527. Since each image uses it own unique 256 colors, a special optimized color
  528. table and color dithering is used to display arrays.  Note that when
  529. displaying a 2-color file in an array, the scaling down of the original image
  530. (especially a line type drawing) will cause much of the info to be lost on
  531. the screen unless the /FB or /FW command qualifier is used.
  532.  
  533. Creating arrays of your images is a good method of saving a sequence of
  534. images for a slide show.  They are saved in the array in the order you
  535. selected them.  To play them back, just pull up that array image, press 'M'
  536. to mark all images, and press left mouse button to display them.
  537.  
  538. NOTE:  Arrays are only available in VESA modes.  Files will be arranged in
  539. the array in the order in which they were selected.
  540.  
  541. AUTO ARRAY GENERATION/SAVING:
  542.  
  543. If you are going to have many pages (screens) of array images and you will be
  544. saving them all out as single files, you can do this automatically by the <G>
  545. (or point to AUTO/GEN with mouse) to activate the generate option.  This will
  546. automatically display the arrays on the screen and then save them out without
  547. any user intervention until the last one is processed.  You begin just as you
  548. would for the standard array option by selecting the files to display, the
  549. VESA mode, and then the number of images/page. You are first prompted for the
  550. file type to use when saving.  Then you are prompted for the first 1-6
  551. characters of the filename that the program will use for the files it
  552. generates.  You may precede the filename with a Disk & Directory if you don't
  553. want to use the current Disk/Dir.    The system will append a 2 digit page
  554. number and appropriate extension to your input.
  555.  
  556. EX:  You are going to have 3 pages of array images and you select <G>IF as
  557. the filetype and  enter TEST as the filename.  The System will generate 3
  558. files named TEST01.GIF, TEST02.GIF & TEST03.GIF.
  559.  
  560. VIEWING FILES (from a previously created Array image):
  561.  
  562. If you have previously created and saved an array of images, you can use it
  563. to graphically select the images you want to display either singularly or as
  564. a slide show or for plotting.  NOTE: A mouse is required for this mode.  Just
  565. select the array image from the Text directory listing.  After it is
  566. displayed, use the box shaped cursor to select the files.  The left mouse
  567. button will select one file and display it immediately.  The right mouse
  568. button is used to Mark/Unmark files for a slide show or multiple plotting.
  569. Files are outlined with a red box when they are marked.  If a file on your
  570. array menu does not exist in your current any more, the file will be cross-
  571. hatched with red lines.   After all files you desire are marked, press the
  572. left mouse button to start the display.  The /Dn and /Fn (delay and fade)
  573. work with multiple selections from arrays.  Files will be displayed in the
  574. order that they were selected on the screen.  If you want to display all of
  575. the files in the same order they were created, just press 'M' to mark them
  576. all, and press the left mouse button to start the show.  NOTE: Normally a
  577. right mouse button is used to Quit the current image, but since that button
  578. is used to Mark/Unmark files in the array menu, you must simultaneously press
  579. both the left and right button to Quit.  You can still use the <ESC> key to
  580. quit.
  581.  
  582. Array images created before VESAVIEW version 4.0 will not allow graphic file
  583. selection.  Version 4.0 and above creates an additional index file for each
  584. array image you create.  This file will have the same filename as your array
  585. image but with an extension of  .VNX .  If this files does not exist in the
  586. same directory as your array image file, you will not be able to use the
  587. array image as a graphic menu, but you can still view it as a normal image. 
  588. The index file is very small, and unlike other graphic packages which allow
  589. graphical selection of images from the screen, VESAVIEW does not require
  590. separate THUMBNAIL files for each image which saves considerable time and
  591. disk space.  As of version 4.3, the array image together with its index file
  592. may be stored (or saved) on a Disk/Directory that is different from the
  593. location of the images in the array.  This will allow users to catalog images
  594. from CDROMs (which can't be written to) etc.  VESAVIEW assumes that if your
  595. array images have nested arrays, all of these arrays are located in the same
  596. directory, but each of the array's images can be located on different
  597. Disk/Directories if needed.  The index file stores the Disk & Directory of
  598. the images in the array.  NOTE:  If you ever move your images from where the
  599. array was initially created, you will either need to re-catalog them or use
  600. a text editor to change the path (first entry) in the .VNX file.  To make the
  601. index file downward compatable with versions prior to 4.3, the program will
  602. accept index files that didn't store the images path in them as the first
  603. entry.
  604.  
  605. Up to six levels of array menus can be used (nested).  For example, you could
  606. have one array image that had other array images in it.  One idea would be to
  607. have individual array images for BMPs, GIFs, JPGs, PCXs and TGAs.  Then have
  608. a master array image which would include the BMP, GIF, JPG, PCX  and TGA
  609. arrays.  While an array image is displayed, selecting another array image
  610. from it will pull up that new array menu and so on.  If you have displayed an
  611. image out of a sub-level array menu, the <ESC> or right mouse button will
  612. return you to the previously displayed array menu. (remember that if you are
  613. displaying an array file, you must use both the left and right mouse button
  614. together to return to previous image).
  615.  
  616. If you need to add or delete an image from the array image, you will need to
  617. re-create it.  New array images can only be created from the Text directory
  618. listing.
  619.  
  620. Additional Keys available while displaying an array image:  
  621.  
  622.      M1 (left mouse button)   Used to start displaying a single or marked
  623.                               multiple images
  624.      M2 (right mouse button)  Used to Mark or Unmark files
  625.      M1 & M2 (together)       Used to Quit from an array image
  626.  
  627. (See 'SPECIAL KEYS WHILE VIEWING'  later for standard keys available)
  628.      
  629. Warning: You cannot have different array files with the same filename and
  630. different extensions in the same directory since each file will use the
  631. extension .VNX for its index file.   Ex:  You cannot have DIR01.GIF and
  632. DIR01.BMP array files in the same directory since the program would not know
  633. which one the index file DIR01.VNX should be associated with.
  634.  
  635.  
  636. VIEWING GIF89A FILES - Special Case:
  637.  
  638. If you are viewing a single GIF89A file, most of the 89A extensions will be
  639. processed including multiple images, plain text and control blocks.  Comments
  640. will not be displayed.  Because of the way VESAVIEW reads images into
  641. Extended memory before displaying them, the plain text will only be displayed
  642. on the screen (not XMEM).  This will prevent the printing of the text since
  643. printing is done from what is in Extended memory.  One way around this, if
  644. your screen has enough resolution to display the entire file, is to save your
  645. screen out to another file with <G> and then pull up that file and print it. 
  646. NOTE, that the save commands will only save out what is on the screen after
  647. all of the 89A extensions are processed.  If the extensions include delays
  648. between images, or require the user to <press> a key, the program will
  649. continue after 15 seconds maximum so that slide shows will not be put in a
  650. wait state looking for user input.  
  651.  
  652. If you are viewing arrays which include GIF89A files, the extensions will be
  653. processed entirely in XMEM before displaying them in the array.  No text
  654. extensions will be displayed (they would probably be too small to read
  655. anyway).  Delays between GIF89A extensions are not processed when displaying
  656. array images for increased speed.
  657.  
  658. VIEWING HPG or PLT FILES:
  659.  
  660. To view a plot file created in a HPGL format, move the cursor to the filename
  661. and press <ENTER>.  Then choose the Display Mode and Plot Mode you wish to
  662. use.  The program will try and determine the size of plot from the plot file
  663. header, but some CADD packages don't supply this info in which case the
  664. program will assume a "C size".  The HPGL codes for Plot Sizes are:
  665.  
  666.      PS4 = 'A' size
  667.      PS0 = 'B' size
  668.      PS1 = 'C' size
  669.  
  670. Choosing a display mode of FIT, 2X or 4X will speed up the drawing process
  671. but the resolution of the image will be diminished. As the image is decoded,
  672. you will see it being drawn in a preview mode at screen size.  After the
  673. image is complete, pressing any key will swap you to the actual image as
  674. stored in Extended memory for panning around in.  Pressing <ESC> (or right
  675. mouse button) as the image is being decoded will abort it.
  676.  
  677. Currently supported HPGL commands are:  PU,PD,PA,PR,PS,IP,SC,SP, CI and AA
  678.  
  679. Even though the LB,SI,SR,DF,DI & DR commands are parsed and used to display
  680. the image on the initial preview screen, they are not supported as the
  681. drawing is being created in Extended memory. This won't usually pose a
  682. problem since this program was designed to view HPGL files created by CADD
  683. programs and most of those programs represent Text etc. as vector elements.
  684.  
  685. WARNING:  Only plot files which were created as C size or smaller should be
  686. viewed, since the program does no checking for elements which could be drawn
  687. 'off' the page if too big.  This check was omitted to speed up the drawing.
  688.  
  689. DELETING FILES:
  690.  
  691. While the file list is displayed on your screen, you may delete a file by
  692. moving the cursor to it and pressing <DEL> on the keyboard.  To delete
  693. multiple files, mark them with the <spacebar> (or right mouse button) and
  694. then press <DEL>.  You will be asked to confirm each deletion.
  695.  
  696. SEARCHING FILENAMES:
  697.  
  698. While the file list is displayed on your screen, you may select files by
  699. searching their filenames for a specific string.  Press <S> (or point to
  700. SEARCH with mouse) and keyin the search string.  The file will be selected if
  701. it contains the exact string anywhere in its filename.  Don't use the
  702. wildcard characters * or ? since they will be search for literally.
  703.  
  704. SPECIAL KEYS WHILE VIEWING:
  705.  
  706. While viewing images in a VESA mode (other than arrays):
  707.  
  708.      F1/F2     Increase/Decrease RED
  709.      F3/F4     Increase/Decrease GREEN
  710.      F5/F6     Increase/Decrease BLUE
  711.      F7/F8     Increase/Decrease RED
  712.      F9/F10    Increase/Decrease RED
  713.      ALT F9    Change to Gray tones
  714.      ALT F10   Restore original palette
  715.      B         Create a BMP file (256 c) of screen contents
  716.      C         Crop an image and save as  BMP, GIF, JPG or PCX file
  717.      G         Create a GIF file (256 c) of screen contents
  718.      H or ?    Graphics Help
  719.      J         Create a JPG file (24 bit) of screen contents
  720.      P         Send XMEM contents to printer as B&W or Color image
  721.      S         Scale XMEM contents to screen and save as BMP, GIF, JPG or PCX
  722.                file
  723.      V         Display the current VGA palette
  724.      Z         Create a PCX file (256 c) of screen contents
  725.      +         Zoom in (change VESA resolution to next lower mode)
  726.      -         Zoom out (change VESA resolution to next higher mode)
  727.                NOTE: Mode 100 (640x400) is skipped when using +/- above.
  728.      
  729. While viewing an array (one about to be saved, not a previously saved one):
  730.  
  731.      B    Create a BMP file (256 c) of screen contents
  732.      C    Crop an image and create a  BMP, GIF, JPG or PCX file
  733.      G    Create a GIF file (256 c) of screen contents
  734.      J    Create a JPG file (24 bit) of screen contents
  735.      Z    Create a PCX file (256 c) of screen contents
  736.  
  737. While viewing IMG or HPGL files in a B & W mode:
  738.  
  739.      P    Send XMEM contents to printer as B&W image
  740.      I    Create an IMG file (2 c) of entire XMEM contents.  The 'I' option
  741.           may also be used if you are viewing an IMG or HPGL file in a color
  742.           VESA mode.
  743.      Z    Create a PCX (2 c) file of entire XMEM contents.
  744.  
  745. In both Color and B & W modes you may pan screen with:
  746.     (make sure the NUMLOCK key is on to use keypad)
  747.  
  748.      HOME      Top left of image
  749.      END       Bottom right of image
  750.      Page Up   Move up approx. 1 inch
  751.      Page Dn   Move down approx. 1 inch
  752.      ESC       Return to File Selection Menu
  753.  
  754. The arrow keys on either numeric keypad or separate arrow keypad pan the
  755. image approx. 1/4 inch in that direction. In addition, on the numeric keypad,
  756. the 1,3,7 & 9 keys pan the image diagonally and the 5 pans to center of
  757. image.
  758.  
  759. Use the Control key with left or right arrows to pan 1 inch to the left or
  760. right.
  761.  
  762. SAVING SCREEN AS a  BMP, GIF or PCX FILE:
  763.  
  764. While viewing an image in a VESA mode, pressing <B> will save the current
  765. screen (not necessarily everything in Extended memory) to a BMP file with the
  766. filename of your choosing.  Pressing <G> will save to a GIF file.  Pressing
  767. <Z> will save to a PCX file.  The dimensions will come from the mode you are
  768. currently viewing the image in or the cropped size that you used.  The color
  769. table written to file will reflect any adjustments you've made with the
  770. Function keys.  When keying in the filename, if you don't include the period
  771. or extension, the program will append the correct extension to your keyin. 
  772. If you keyin the extension with your filename, the program will use that
  773. instead, but make sure you keyin the appropriate extension since the
  774. extension is how the program determines the file type to display!  You may
  775. precede the filename with a Disk & Directory if you don't want to use the
  776. current Disk/Dir.
  777.  
  778. SAVING SCREEN AS a JPG FILE:
  779.  
  780. JPEG is a standardized compression method for full-color (24 bit) and
  781. grayscale images.  JPEG is a lossy type of compression, meaning that the
  782. output image is not necessarily identical to the input image.  This software
  783. implements JPEG baseline and extended-sequential compression processes and
  784. the file format used is called JFIF.  This format has been agreed to by a
  785. number of major commercial JPEG vendors and probably will become the de facto
  786. standard.  Some commercial JPEG implementations are incompatible, especially
  787. if they were written before the summer of 1991.  Some other shareware JPEG
  788. program's output will only work if they have the option of outputing as JFIF
  789. standard files.
  790.  
  791. The procedure for saving the current screen to a JPG file is the same as for
  792. saving to a GIF, BMP or PCX (see above section), except that an extra
  793. question is asked after you key in the filename.   You will need to enter a
  794. JPEG quality factor ranging from 25 to 95.  The default if you just press
  795. <CR> is 75.  A higher quality factor will result in larger files and less
  796. loss of image quality.   A lower quality factor will result in smaller files
  797. with more loss of image quality.  
  798.  
  799. It is not recommended to save array images as JPG files if they will be used
  800. as graphic menus, since they will take considerably longer to decode.
  801.  
  802. CROPPING SCREEN & SAVING AS a  BMP, GIF, JPG or PCX FILE:
  803.  
  804. If you press <C> you will be able to crop your screen image before saving as
  805. a BMP, GIF, JPG or PCX file.  You will see a box drawn around your screen
  806. image when you first press <C>.  Press a <T> to move the TopLeft corner of
  807. box.  Press <B> to move the BottomRight corner. Use the arrow keys to move a
  808. single pixel at a time, or PageUp, <CTRL>Leftarrow or <CTRL>Rightarrow to
  809. move 10 pixels at a time.  <HOME> will move the Topleft corner of box to
  810. Topleft of screen.  <END> will move the Bottomright corner of box to
  811. Bottomright of screen.  <ESC> will abort and a <CR> will start the screen
  812. save. You will be prompted whether to save as a BMP, GIF, JPG or PCX file. 
  813. See 'Using a Mouse' below.
  814.  
  815. SCALING XMEM CONTENTS TO SCREEN & SAVING:
  816.  
  817. If you press <S> you will be able to scale the entire image in XMEM to your
  818. screen.  You will see a box drawn around your screen when you first press
  819. <S>.  If you just press the <CR> key at this time, your entire image will be
  820. fitted to your screen at the current VESA resolution.  Use the arrow keys
  821. etc. (like in cropping above) to move the lower right corner of box.  Scaling
  822. always occurs about the upper left corner of image, so you can't move this
  823. point. <ESC> will abort and a <CR> will start the screen save.  See 'Using
  824. Mouse' below.
  825.  
  826. SAVING XMEM CONTENTS AS an IMG or PCX FILE:
  827.  
  828. While viewing a 2 color Black/White image (either IMG, 2-color PCX or HPGL
  829. files), pressing an <I> will save the entire eXtended memory contents to a
  830. IMG file, or pressing <Z> will save as a 2-color PCX file.  You will have the
  831. opportunity to reverse the image before saving.  It doesn't matter whether
  832. you are viewing the image in a color VESA mode or one of the Black & White
  833. modes in order to with the <I> mode, as long as the original image was
  834. actually a 2 color image.  Currently, there is not a cropping option before
  835. saving as a IMG file.  However, if you are viewing the 2-color image in a
  836. color VESA mode, you could save out as a cropped BMP, GIF, JPG or PCX file.
  837.  
  838. PRINTING IMAGES:
  839.  
  840. Before displaying an image that you will be printing, you should pull up the
  841. Printer Setup Menu and Printer Model Menu (submenus of OPTS menu) and make
  842. any necessary changes to model, style, size, margins, rotation and gamma etc. 
  843. After an image is displayed, any adjustments to color/brightness/contrast
  844. will be reflected in your print.  The gamma value (see description of /PGn
  845. qualifier above) is a good tool to use if adjustment to brightness is needed
  846. for printouts.  The maximum size of image is limited only by the amount of
  847. free XMEM you have.  The maximum size of print is 10.5 x 8.0 inches on most
  848. printers.  On the DeskJet 550C printer, note that you can't print on the
  849. bottom 1/2" of page, so if you are centering your print, the maximum length
  850. can't be greater than 10.0", but if you set your Top Margin to the minimum of
  851. 0.05", you can squeeze in about 10.4".
  852.  
  853. If you want to print multiple images, select them from the file list with the
  854. <Space Bar> (or right mouse button) as for slides, and then press <P> (or
  855. point to PLOT with mouse).  Each file will be displayed on screen and
  856. automatically plotted until the last one is processed.  NOTE that all of the
  857. plots will use the same size, rotation, justification etc. from the plotting
  858. options menu.  Pressing <ESC> (or right mouse button) will abort the
  859. plotting.  NOTE:  This option is only available in Registered Versions.
  860.  
  861. While a color image file is displayed on the screen, pressing <P> will create
  862. a print on your active printer in the current print style.  The fastest print
  863. style is the halftoning process. The scatter style will produce a better
  864. quality print in most cases, but will take longer to process.  You may cancel
  865. the plot by pressing <ESC> (or right mouse button) during the plot. The port
  866. defaults to LPT1 unless you specified a command line argument of /P2 or /PF
  867. when starting the program.  The actual plot will be of your entire image
  868. (stored in extended memory) and not just what you may be viewing on your
  869. screen.
  870.  
  871. While viewing a 2-color (black & white) file or HPGL (.PLT or .HPG), pressing
  872. <P> will create a Black & White print.  
  873.  
  874. See description of /FB, /FW & /FN above to preserve image context when your
  875. print is being scaled down from the original size.  You can use any of the
  876. printer qualifiers (available as command line qualifiers or from the Printer
  877. Menu within program) to change the defaults for Printer Port, Printer Type,
  878. Resolution, Rotation Angle, Width and Top & Left Margins.  
  879.  
  880. If you select a Print Width greater than 8.5", the program will automatically
  881. rotate print 90 degrees (unless 270 was already selected).  The program will
  882. beep if you try to use an invalid combination of size, rotation angle,
  883. margins or resolution.
  884.  
  885. MOUSE USE:
  886.  
  887. In most cases where the keypad is used to move the text cursor, a MicroSoft
  888. compatible mouse can also be used.  You must install any required mouse
  889. drivers before running VESAVIEW.
  890.  
  891. The Left button is used just like the <CR> key on the keyboard to display one
  892. image. It is also used to select choices from pop-up menus, to select
  893. commands at the bottom of screen and to select the PageUp and PageDown icons
  894. from the vertical bar on the right side of screen.
  895.  
  896. The Right button is used just like the <ESC> key on the keyboard to abort
  897. displays and menus.  It is also used to mark files for use in arrays or for
  898. displaying them as slides (like the <spacebar>).
  899.  
  900. If a large image has been displayed in one of the 256 color VESA modes,
  901. holding down the Left mouse button will display a panning icon on your
  902. screen.  The green box represents your entire image size and the red box
  903. represents your screen size.  While holding down the Left button, move the
  904. mouse and the red box will pan around with the green box.  When you let go of
  905. the button, the screen with be moved to reflect your new window area.  This
  906. mode of panning is much quicker than using the arrow keys, although you will
  907. probably use the arrow keys for fine tuning the pan.  If a double-beep is
  908. heard when trying to use this feature, your image is probably smaller than
  909. your screen and no panning is possible.
  910.  
  911. When Cropping an image, the Left mouse button will move the upper left corner
  912. of the cropping box and the Right mouse button will move the lower right
  913. corner of box.  Pressing both the Left and Right buttons simultaneously will
  914. start the save (like pressing <CR>).  Scaling works the same except the Left
  915. mouse button is not used (can't move the upper left corner of scaling box).
  916.  
  917. RUNNING Under WINDOWS 3.1:
  918.  
  919. VESAVIEW can be run in a Full Screen mode from Windows 3.1.  Because of the
  920. way Windows 3.1 allocates memory, it is suggested that you use a  .PIF file
  921. to run VESAVIEW.  The following are recommended settings for the PIF file
  922. when running under Windows:
  923.      
  924.      Program Item Properties
  925.      Description:        VesaView       
  926.      Command Line:  VESAVIEW.PIF   
  927.      Working Directory:  C:\GIF          <-- Path of initial image directory
  928.      Shortcut Key:       None           
  929.  
  930.      (NOTE:  You can use the ICON that is delivered with VESAVIEW or your
  931.      own.  The supplied icon is in the file VESAVIEW.ICO.)
  932.  
  933. Use the following for 386 ENHANCED MODE -
  934.      PIF EDITOR - VESAVIEW.PIF
  935.      Program Filename:   C:\VV\VESAVIEW.EXE       <-- Path of VESAVIEW.EXE
  936.      Window Title:       VesaView       
  937.      Optional Parameters:  /AW /AM103 /PTDJ /AS   <-- Modify these as needed
  938.      Start-up Directory:                
  939.      Video Memory:       _  Text        _  Low Graphics     X  High Graphics
  940.      Memory Requiremts:  KB Required    -1   KB Desired     -1
  941.      EMS Memory:         KB Required    0    KB Limit  1024
  942.      XMS Memory:         KB Required    1024 KB Limit  -1
  943.      Display Usage: X  Full Screen      Execution:     _  Background
  944.                     _  Windowed                        X  Exclusive
  945.      X  Close Window on Exit
  946.  
  947.      PIF EDITOR - Advanced Options
  948.  
  949.      Background Priority:     50   Foreground Priority:     100
  950.                     X  Detect Idle Time
  951.      Memory Options:
  952.           _  EMS Memory Locked          X  XMS Memory Locked
  953.           _  Uses High Memory Area      X  Lock Application Memory
  954.      Display Options:
  955.           X  Text        _  Low Graphics          X  High Graphics
  956.           X  Emulate Text Mode     X  Retain Video Memory
  957.      Other Options: (leave as default)
  958.  
  959. Use the following for STANDARD MODE -
  960.      PIF EDITOR - VESAVIEW.PIF
  961.      Program Filename:   C:\VV\VESAVIEW.EXE       <-- Path of VESAVIEW.EXE
  962.      Window Title:       VesaView       
  963.      Optional Parameters: /AW /AM103 /PTDJ /AS     <-- Modify these as needed
  964.      Start-up Directory:                
  965.      Video Memory:       _  Text        X Graphics/Multiple Text
  966.      Memory Requiremts:  KB Required    -1
  967.      XMS Memory:         KB Required    1024 KB Limit  -1
  968.      Direct Modifiers:   _ COM1    _ COM3    _ Keyboard
  969.                          _ COM2    _ COM4
  970.      _ No Screen Exchange               _ Prevent Program Switch
  971.      X  Close Window on Exit            _ No Save Screen
  972.  
  973.           
  974. CAUTIONS:
  975.  
  976. The array used to store the files in current directory is limited to 500
  977. files.  More files than this will just be truncated from directory listing.
  978.  
  979. The program determines the type of file to display by the extension used on
  980. the filename.  Supported extensions are BMP, GIF, IMG, JPG, PCX, TGA, TIF,
  981. HPG and PLT.  Any other extensions are ignored.  Incorrect extensions may
  982. cause program to hang  (ie. Don't name a PCX file with a GIF extension).
  983.  
  984. Even though your VESA driver thinks it supports some of the higher resolution
  985. modes, your hardware may not have the required memory to do so.  Therefore,
  986. you need to lockout these modes from the program with the /LOmode command
  987. line switch.  If you don't lock out these modes, the program may hang and
  988. you'll have to do the 3 finger trick (<CTRL> <ALT> <DEL>).
  989.  
  990. When printing, make sure your printer is online before pressing the <P> key,
  991. otherwise the printer may lose some of the data or lock up the program.
  992.  
  993. HINTS:
  994.  
  995. When creating arrays of images that include 24 bit files, you may want to
  996. toggle the 24 bit palette option to STANDARD to speed up the processing. The
  997. color detail will not be too apparent at this small scale.
  998.  
  999. To create and save a slide show sequence, just create an array image and save
  1000. it.  The images on the array will be arranged in the order in which they were
  1001. selected originally.  All you need to do to play the slide show is pull up
  1002. that array image, press 'M' to mark all files, and then press the left mouse
  1003. button to start the show.  You should set the delay and fade before pulling
  1004. up the array if desired.
  1005.  
  1006. It is suggested that you prefix your array filenames with a 0 (zero) so that
  1007. they will be alphabetized at the beginning of the directory listing for
  1008. easier location. (Ex.  0DIR01.GIF, 0DIR02.GIF  etc).
  1009.  
  1010. If you will be using your array images as graphic menus for file selection,
  1011. a lower resolution array image will update on the screen faster.  Even if you
  1012. have just a few images to catalog, by placing them in a larger format array
  1013. image (ie. You have only 9 images to catalog but create a 6 x 6 array image),
  1014. the screen will be able to recall this array as a menu much faster than
  1015. creating it in a 3 x 3 array image.  This is due to the greater compression
  1016. of large areas of blank space on the screen.
  1017.  
  1018. If you don't have a mouse, the graphic arrays you create can't be used
  1019. graphic menus.  You will need to manually delete the .VNX file for the array
  1020. file so that the system will think the array file is just an ordinary image.
  1021.  
  1022. If you are using a printer supported by the DOS GRAPHICS command, you can get
  1023. a quick print of a Black & White screen by using the GRAPHICS command before
  1024. running VESAVIEW.  Version 5.0 of DOS supports the DeskJet & LaserJets and
  1025. the syntax would be:
  1026.      GRAPHICS DESKJET /r     (the /r will reverse black & white)
  1027.  
  1028.      Use <SHIFT><PRT SCRN> while graphics are on the screen to initiate the
  1029.      print.
  1030.  
  1031. If you are printing to a color printer and you need to lighten up your print,
  1032. try increasing the Gamma value instead of the brightness.  This will lighten
  1033. up the lower intensities and leave the higher intensities as they are.
  1034.  
  1035. Besides using the SCALE option, there is a trick you can use to scale down an
  1036. image by 1/2,1/3,1/4...1/9.  Mark just one image and display it as an array. 
  1037. Select the Array Size according to the scale factor you wish to use. (The
  1038. color table used to display a single image as an array will be the true color
  1039. table of that image and not the standard palette).  After the image is
  1040. displayed, use the CROP feature to save the area you desire as a color image. 
  1041. Note that when a single array image is displayed, the background color and
  1042. text colors will change according to the color table of the single image
  1043. being displayed.
  1044.  
  1045. If you need a VESA driver for your graphics card, login to Compuserve and go
  1046. to the IBMPRO forum (GO VESA).  In Lib #12 (Vesa), you will find VESA drivers
  1047. for almost any card.
  1048.  
  1049. If you are not sure what graphics card you have in your machine, there is a
  1050. great little program in the GRAPHSUPPORT forum on Compuserve (GO PICS).  In
  1051. Lib #14 (Misc Util & Code) download VDEOID.EXE.  This program will try and
  1052. determine the card manufacturer & memory on it.
  1053.  
  1054. CARDS TESTED:
  1055.  
  1056. This program has been tested on the following computers and graphics cards:
  1057.  
  1058. DELL 325D - Using built-in Paradise card
  1059. DELL 325D - Using a CompuAdd Hi-rez card
  1060. DELL 433D - Using Trident 8900 card
  1061. DELL 433P - Using built-in Paradise card
  1062. DELL 433P - Using a Video-7 VRAM II card
  1063. DELL 486D/50 - Using built-in Paradise card
  1064. DELL 486D/66 - Using built-in Paradise card & ATI Ultra card
  1065. NEC 386SX - Using a CompuAdd Hi-rez card
  1066. AST 286/386 Premium - Using Orchid Designer Pro card
  1067. AST 286/386 Premium - Using Diamond Stealth card (has built in VESA Bios on
  1068. card)
  1069. IBM 286 AT - Using a Paradise VGA Plus
  1070. IBM 286 AT - Using an ATI Wonder card & ATI Vantage
  1071. GATEWAY 2000 486/33 - Using an ATI Ultra card
  1072. DEC PC 486 - Using built-in graphics card
  1073.  
  1074. SUPPORT:
  1075.  
  1076. If you have any comments, suggestions or questions, please leave me a message
  1077. in the GRAPHSUPPORT forum (GO PICS) on Compuserve. My CIS ID number is
  1078. 71170,2340.  The current shareware version of VESAVIEW will always be posted
  1079. in the LIB #3 (Decoders & Encoders) of the GRAPHSUPPORT forum on Compuserve. 
  1080. It can also be found on the Blue Ridge Express Bulletin Board (804)-790-1675. 
  1081. The Zipped archival of VESAVIEW will usually be named  VESAVW.ZIP or
  1082. VESAVWxx.ZIP where xx is the version number.  If you can't find it by
  1083. filename, try searching for the keywords VESA and HPGL.  You can also reach
  1084. me at the P. O. Box listed in the Registration section.
  1085.  
  1086. REVISION HISTORY:
  1087.  
  1088. v1.0 - v1.9         Developmental versions
  1089. v2.0 (4/03/92) First release to the Public as Shareware
  1090. v2.1 (4/10/92) Changed algorithm used for arrays color palette.  Now uses
  1091.                color dithering for much more accurate color reproduction.
  1092. v2.2 (4/21/92) Added new option to Automatically generate multiple pages of
  1093.                array images and save them to GIF files without user
  1094.                intervention. Also added a Scaling option.
  1095. v2.3 (4/27/92) Fixed a minor bug while displaying multiple pages of arrays.
  1096. v2.4 (6/05/92) Changed GIF decoder so that files which do not follow the
  1097.                standard of setting byte 13 of header as a zero are decoded
  1098.                anyway.
  1099. v2.5 (7/6/92)  Added saving as PCX files (both 2 & 256 color).  Added
  1100.                cmd line qualifiers /FN, /FB & /FW so that scaling of B&W
  1101.                images could retain more info of the original.  Can now
  1102.                read in Windows 3.X .BMP files (256 color).  Added
  1103.                ability to select files for display with a search string.
  1104.                Added AA (absolute arc) & CI (circle) cmds to HPGL module
  1105.                & fixed minor bug in display size.
  1106. v2.6 (7/16/92) Added decoding of TIF (2 color) files and fixed bug with
  1107.                Filename Search option. Only decodes non-compressed and
  1108.                run-length encoded TIFs.
  1109. v2.7 (10/9/92) Added decoding of 24 bit PCX & BMP files and decoding of 16,
  1110.                24 & 32 bit TGA (Targa) files.  Added ability to change
  1111.                command line options from within the program from a menu.
  1112. v2.8(11/20/92) Added qualifier to disable beep after displaying images. Added
  1113.                print enhancements: Color printing to HP PaintJet, PaintJet
  1114.                XL, PaintJet XL300, DeskJet 500C & DeskJet 550C.  REGISTERED
  1115.                VERSION ONLY:  Added ability to select plot size, rotation
  1116.                angle, resolution, gamma correction and page placement.  Data
  1117.                can now be compressed before sending to printer to reduce size
  1118.                and speedup printing.
  1119. V2.9 (12/9/92) Added qualifier (/COD) to optimize color palette and dither
  1120.                the image when 16, 24 or 32 bit bit images are read in.  Fixed
  1121.                a bug which wouldn't allow an array of images to be saved as
  1122.                a GIF file if no GIF file was displayed in the array.
  1123. V3.0(12/14/92) Added new B & W Scatter print style and Color Halftone print
  1124.                style.  Also added qualifiers for these styles (/PSBH, /PSBS,
  1125.                /PSCH & /PSCS).  Added /FTMn (fixed top margin).
  1126. V3.1 (1/11/93) Changed halftone printing pixels from 4 bits to 5 bits to
  1127.                allow more shades.  Added saving as a Windows BMP (256c). 
  1128.                Arrays can now be saved as either GIF, BMP or PCX files.  The
  1129.                screen is now erased around a cropped area before saving for
  1130.                easier viewing.
  1131. V3.2 (1/22/93) Added support for 16 color PCX, BMP & GIF files.  Added
  1132.                support for 256 color (8 bit) TGA files.  Saving of images or
  1133.                arrays is now 3-4 times faster.
  1134. V3.3 (2/2/93)  Added support for 16 and 256 color TIF files.  Added
  1135.                ability to use 320x200x256 & 640x480x2 modes without
  1136.                requiring a VESA driver.  These modes do not allow array
  1137.                generation.  Added panning with window icon for B&W
  1138.                display modes.  Added qualifiers /PXSn & /PYSn to allow
  1139.                slight adjustment of X & Y scales when plotting HPGL & 2-
  1140.                color files.  Fixed bug where multiple image GIFs would
  1141.                hang.  Now, only the 1st image of these multi-image GIFs
  1142.                is displayed.
  1143. V3.4 (2/9/93)  Added support for GIF89A files by completely rewriting
  1144.                the GIF decoder module.  Multiple files can now be
  1145.                selected for automated plotting (only available in
  1146.                Registered Version).  File directory is now sorted
  1147.                vertically instead of horizontally for easier viewing.
  1148.                Zooming (changing resolution) is now possible while
  1149.                viewing in a VESA mode with the +- keys.
  1150. V3.5 (2/26/93) Fixed bug with vertical directory listing which caused
  1151.                incorrect scrolling.
  1152. V3.6 (3/18/93) Added cmd qualifiers /UPSA, /UPSB & /UPSC so user could select
  1153.                a default plot size if the .PLT file did not have an embedded
  1154.                PS cmd to signify what plot size to use.
  1155. V3.7 (4/12/93) Added printer output to a file option (from menu or new /PF
  1156.                qualifier).  Added support for 24 TIF and 32 bit TGA files.
  1157. V4.0 (4/20/93) Images can now be graphically selected for display or printing
  1158.                from previously created array images.  These previously
  1159.                created arrays images act as graphic directory menus.  Also,
  1160.                a help menu is now available while displaying graphics.
  1161. V4.1 (5/14/93) Program now checks for sufficient disk space before writing
  1162.                out files. When keying in a filename, you don't have to
  1163.                include the extension (ex:  .GIF) anymore.  If your keyin
  1164.                doesn't contain a period, the appropriate extension will
  1165.                automatically be appended to your keyin.
  1166. V4.2 (5/18/93) If you have enough XMEM, the first graphic array menu you
  1167.                select will be stored in memory, so that returning to that
  1168.                menu screen will be instantaneous instead of having to re-read
  1169.                in the file on each return. This can be overridden with the
  1170.                /NLAM  qualifier.  Added a new Printer Model submenu to the
  1171.                Options Menu.
  1172. V4.3 (6/11/93) Added capability to put an array image and its index file on
  1173.                a different disk/directory than its images are on.  This
  1174.                allows cataloging of images on a CDROM etc.  Image sizes can
  1175.                now be displayed on the images of an array if you use the
  1176.                qualifier /AS (array sizes).  Some changes in the way stack
  1177.                memory was allocated were made to hopefully alleviate some
  1178.                users memory restraint problems.
  1179. V4.4 (7/2/93)  Added a fade in/out of images when displaying a slide
  1180.                show.  This is done with new qualifier /Fx or from
  1181.                Options Menu.  The order in which files are selected is
  1182.                now used when displaying or creating arrays of them.  The
  1183.                sequence numbers are shown on the text directory listing.
  1184.                A filename mask option has been added.  The new qualifier
  1185.                /Mxxx sets the mask to use.  Enhanced error checking when
  1186.                printing to prevent hangups when user input print sizes
  1187.                & margins were invalid.
  1188. V4.5 (7/21/93) Added the reading and saving of 24 bit and grayscale JPEG
  1189.                files (.JPG).  Added a progress bar when reading in files from
  1190.                the graphics menu to prevent boredom.
  1191.