home *** CD-ROM | disk | FTP | other *** search
/ Current Shareware 1994 January / SHAR194.ISO / helpfile / vesavw44.zip / VESAVIEW.DOC < prev    next >
Text File  |  1993-07-04  |  62KB  |  1,146 lines

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