home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-387-Vol-3of3.iso / v / vesavw34.zip / VESAVIEW.DOC < prev    next >
Text File  |  1993-02-17  |  42KB  |  786 lines
  1. VESAVIEW.EXE   v 3.4  
  2.  
  3.  
  4. Keywords: VESA GIF PCX BMP TGA IMG TIF HPGL PRINT CATALOG VIEWER PAN DESKJET
  5.           LASERJET PAINTJET
  6.  
  7. Brief Desc:    View and print GIF, PCX, BMP, TGA, TIF & IMG/GEM images & HPGL
  8.                plotter files.  Arrays of up to 81 images/screen can be
  9.                generated and saved for easy cataloging.  HPGL plot files can
  10.                be saved as IMG files.  Mouse support.  Requires a VESA driver
  11.                for your graphics card and enough extended memory to hold
  12.                entire image.   Supports VESA modes thru 1280x1024x256. Size
  13.                of image is limited only by the amount of extended memory.
  14.                Quick panning of images larger than your screen resolution.
  15.                Color/brightness/contrast adjustments, scaling & cropping of
  16.                color images. 24 bit color reduction for BMP, TGA & PCX.
  17.                Excellent Black & White printing to HP DeskJet or LaserJet. 
  18.                Superb Color printing to HP PaintJet, PaintJet XL, PaintJet
  19.                XL300 and DeskJet 500C/550C.
  20.  
  21.  
  22.  
  23. VESAVIEW.EXE   Copyright (c) William M. White 1992.
  24.                Compuserve ID: 71770,2340
  25.  
  26. This product is Shareware. If you find it useful, please register your copy
  27. and tell your friends about it.  This product may not be sold or packaged,
  28. either individually, or as part of any other product without the express
  29. written consent of the author. This product may not be changed or altered and
  30. then distributed without the express written consent of the author.  The
  31. VESAVIEW.DOC file must accompany VESAVIEW.EXE whenever the non-registered
  32. version is distributed.
  33.  
  34. REGISTRATION:
  35.      Please send your $30.00 registration fee to:
  36.           William M. White
  37.           P. O. Box 2273
  38.           Glen Allen, VA. 23058-2273
  39.  
  40. By Registering your copy, you will receive an unhindered copy of the latest
  41. version of VESAVIEW and help support the continued development of the
  42. product.  Current shareware versions of the product will always be available
  43. on Compuserve in the GRAPHSUPPORT forum (GO PICS). Updates for registered
  44. users are available for $5.00 to cover handling.  Your registered copy of the
  45. program should never be distributed since it will be encoded with your name.
  46.  
  47. DISCLAIMER:
  48.  
  49. VESAVIEW is offered to you on an as-is-basis without any guarantee as to the
  50. correct functioning or fitness for a specific purpose.  The author believes
  51. this program to work as described but you use the program entirely at your
  52. own risk.  The author will not be responsible for any hardware or software
  53. damage, loss of data, or incidental or consequential damage that may result
  54. from its use, whether or not such use is in accordance with the instructions.
  55.  
  56. REVISION HISTORY:
  57.  
  58. v1.0 - v1.9    Developmental versions
  59. v2.0 (4/03/92) First release to the Public as Shareware
  60. v2.1 (4/10/92) Changed algorithm used for arrays color palette.  Now uses
  61.                color dithering for much more accurate color reproduction.
  62. v2.2 (4/21/92) Added new option to Automatically generate multiple pages of
  63.                array images and save them to GIF files without user
  64.                intervention. Also added a Scaling option.
  65. v2.3 (4/27/92) Fixed a minor bug while displaying multiple pages of arrays.
  66. v2.4 (6/05/92) Changed GIF decoder so that files which do not follow the
  67.                standard of setting byte 13 of header as a zero are decoded
  68.                anyway.
  69. v2.5 (7/06/92) Added saving as PCX files (both 2 & 256 color).  Added cmd
  70.                line qualifiers /FN, /FB & /FW so that scaling of B&W images
  71.                could retain more info of the original.  Can now read in
  72.                Windows 3.X .BMP files (256 color).  Added ability to select
  73.                files for display with a search string.  Added AA (absolute
  74.                arc) & CI (circle) cmds to HPGL module & fixed minor bug in
  75.                display size.
  76. v2.6 (7/16/92) Added decoding of TIF (2 color) files and fixed bug with
  77.                Filename Search option. Only decodes non-compressed and
  78.                run-length encoded TIFs.
  79. v2.7 (10/9/92) Added decoding of 24 bit PCX & BMP files and decoding of 16,
  80.                24 & 32 bit TGA (Targa) files.  Added ability to change
  81.                command line options from within the program from a menu.
  82. v2.8(11/20/92) Added qualifier to disable beep after displaying images. Added
  83.                print enhancements: Color printing to HP PaintJet, PaintJet
  84.                XL, PaintJet XL300, DeskJet 500C & DeskJet 550C.  REGISTERED
  85.                VERSION ONLY:  Added ability to select plot size, rotation
  86.                angle, resolution, gamma correction and page placement.  Data
  87.                can now be compressed before sending to printer to reduce size
  88.                and speedup printing.
  89. V2.9 (12/9/92) Added qualifier (/COD) to optimize color palette and dither
  90.                the image when 16, 24 or 32 bit bit images are read in.  Fixed
  91.                a bug which wouldn't allow an array of images to be saved as
  92.                a GIF file if no GIF file was displayed in the array.
  93. V3.0(12/14/92) Added new B & W Scatter print style and Color Halftone print
  94.                style.  Also added qualifiers for these styles (/PSBH, /PSBS,
  95.                /PSCH & /PSCS).  Added /FTMn (fixed top margin).
  96. V3.1 (1/11/93) Changed halftone printing pixels from 4 bits to 5 bits to
  97.                allow more shades.  Added saving as a Windows BMP (256c). 
  98.                Arrays can now be saved as either GIF, BMP or PCX files.  The
  99.                screen is now erased around a cropped area before saving for
  100.                easier viewing.
  101. V3.2 (1/22/93) Added support for 16 color PCX, BMP & GIF files.  Added
  102.                support for 256 color (8 bit) TGA files.  Saving of images or
  103.                arrays is now 3-4 times faster.
  104. V3.3 (2/2/93)  Added support for 16 and 256 color TIF files.  Added ability
  105.                to use 320x200x256 & 640x480x2 modes without requiring a VESA
  106.                driver.  These modes do not allow array generation.  Added
  107.                panning with window icon for B&W display modes.  Added
  108.                qualifiers /PXSn & /PYSn to allow slight adjustment of X & Y
  109.                scales when plotting HPGL & 2-color files.  Fixed bug where
  110.                multiple image GIFs would hang.  Now, only the 1st image of
  111.                these multi-image GIFs is displayed.
  112. V3.4 (2/9/93)  Added support for GIF89A files by completely rewriting the GIF
  113.                decoder module.  Multiple files can now be selected for
  114.                automated plotting (in registered version only).  File directory
  115.                is now sorted vertically instead of horizontally for easier
  116.                viewing.
  117.  
  118. REQUIREMENTS:
  119.  
  120.     IBM compatible 286 or better
  121.     Extended memory (and driver such as HIMEM).  For 256 (& higher) color
  122.      files, you'll need 1 byte/pixel in your image.  For 2 color files,
  123.      you'll need 1 byte per 8 pixels in your image.  This program conforms to
  124.      XMS 2.0 specification.
  125.     Will use a math coprocessor if available
  126.     A graphics card that supports the VESA BIOS EXTENSIONS for the 'Super
  127.      VGA modes' either through hardware or a software driver.  NOTE: If no
  128.      VESA driver is found, you will be limited to 320x200x256 or 640x480x2
  129.      non-VESA modes which won't allow arrays to be generated.
  130.  
  131. FEATURES:
  132.  
  133.     Will read in any size up to 1280 x 1024:
  134.           GIF (Compuserve 87a) - 16 & 256 color
  135.           PCX (Zsoft) - 2, 16, 256 color & 24 bit (16 million colors)
  136.           BMP (Windows) - 16, 256 color & 24 bit (16 million colors)
  137.           TGA (Targa) - 8,16, 24 & 32 bit (non-compressed RGB &
  138.                     Run length encoded RGB)
  139.           IMG (GEM/Digital Research Inc) - B & W
  140.           TIF - B & W, 16c & 256c (non-compressed & run length encoded)
  141.           HPG - (Hewlett Packard) HPGL plot files (.HPG or .PLT)
  142.  
  143.     If the file is larger than the screen mode you selected, you can quickly
  144.      pan around the image.  Size of image is limited only by the amount of
  145.      extended memory you have.  NOTE:  The entire image is read into Extended
  146.      memory to allow for quick panning of large images.  Black & White images
  147.      are stored in memory with 1 byte per 8 pixels. 16 (4 bit) and 256 color
  148.      (8 bit) images are stored in memory with 1 byte per pixel.  24 & 32 bit
  149.      images are stored in memory as 256 color images so only 1 byte per pixel
  150.      is required.
  151.  
  152.     Black & White printing (color images will be halftoned) and Color
  153.      printing are supported.  Prints can be sized, rotated and positioned on
  154.      paper.
  155.  
  156.     Red/Blue/Green/Contrast/Brightness values may be changed while viewing
  157.      a color image.
  158.  
  159.     Color screen images can be saved as a 256 color GIF, BMP or PCX file.
  160.      These images may be cropped & scaled before saving.
  161.  
  162.     Black & White images can be saved as an IMG or 2 color PCX file. This is
  163.      useful to save a HPGL file that is displayed on screen out to a quicker
  164.      retrieving raster file.  If these images are displayed in a color VESA
  165.      mode they can also be saved &/or cropped as 256 color GIF, BMP or PCX
  166.      files.
  167.  
  168.     Arrays of up to 81 images can be displayed on a single screen at once. 
  169.      This screen can then be saved as a single GIF, BMP or PCX file for
  170.      cataloging or printing.
  171.  
  172.     Supports VESA modes (assuming your graphics card can handle):
  173.           100 -  640 x  400 x 256
  174.           101 -  640 x  480 x 256
  175.           103 -  800 x  600 x 256
  176.           105 - 1024 x  768 x 256
  177.           107 - 1280 x 1024 x 256
  178.  
  179.     Will support a 800 x 600 x 2 color B&W mode if your card has one.  (See
  180.      /SVn option below)
  181.  
  182.     Supports the use of a MicroSoft compatible 2-button mouse.
  183.  
  184. NOTE:     The annoying beeps and NON-Registered notices will be removed from
  185.           registered copies.  Also, the NON-Registered version does not
  186.           support the new printing options (sizing, rotating and
  187.           positioning), nor the Compressing of printer data.
  188.  
  189. RUNNING:
  190.  
  191. Make sure you have enough extended memory available and that a driver (such
  192. as HIMEM) is loaded.  Make sure your graphics card has VESA BIOS EXTENSIONS
  193. (VBE) either built-in or that you have installed a VESA software driver. 
  194. Keyin:
  195.  
  196.      VESAVIEW [/P1 or /P2] [/AB or /AW] [/LOmode] [/AMmode] [/WN, /WH or /WF]
  197.      [/Dn] [/SVn] [/FN, /FB or /BW] [/CS, /CO or /COD] [PTDJ, /PTLJ, /PTPJ,
  198.      /PTPJXL, /PTPJXL3, /PTDJC or /PTDJ5C] [/PWn] [/PAn] [/PRn] [/PTMn]
  199.      [/PLMn] [/PC] [/PGn] [/NB] [/PSBH, /PSBS, /PSCH or /PSCS] [FLn]  where
  200.      items in brackets are optional.
  201.  
  202. NOTE: Underlined (or *) qualifiers are only available in the REGISTERED
  203. VERSION.  The optional qualifiers can be changed while in the program by
  204. pressing <O> (or pointing to OPTS with the mouse).  These changes are only
  205. for the current session and will not be saved.  If you wish to use the same
  206. qualifiers each time you evoke the program, write a BAT file like:
  207.  
  208.      CD \GIF                  rem Assumes your graphics files are here
  209.      \VV\VESAVIEW /P1 /NW /CO      rem Assumes program in VV dir
  210.  
  211. The /AB forces the array mode to use a black background and white text for
  212. the filenames.  
  213. The /AW forces the array mode to use a white background and black text (saves
  214. black ink when printing).
  215.  
  216. The /AMmode (where mode is 100, 101, 103, 105 or 107) will let you default to
  217. a specific mode when displaying arrays.  The program will default to mode 101
  218. if this switch is not used.  Only use a mode number that your card can
  219. support!
  220.  
  221. The /CO (color-optimized) will force 16, 24 & 32 bit images to be processed
  222. using an optimized 256 color palette.  The process reads in all the colors in
  223. your image, creates a histogram of the most used colors, and then creates an
  224. optimized palette of the results. The processing time is greater than if the
  225. /CS option is used, but the results are spectacular.  The color reduction
  226. method used is much faster than that of other program that I have tested. 
  227. After the image has been displayed on the screen, you might want to save it
  228. as a 256 GIF, BMP or PCX file, so that the next time you want to display it,
  229. you can use the quicker 256 color version.
  230.  
  231. The /COD qualifier is similar to /CO above, expect that besides using an
  232. optimized palette, the image will also be dithered to smooth out the
  233. transition between colors.
  234.  
  235. The /CS (color-standard) will force 16, 24 & 32 bit images to be displayed
  236. using a standard palette.  The colors will be adequate for previewing, but
  237. for more exact colors, use the /CO.
  238.  
  239. The /Dn is for setting the delay in seconds to use between slides.  The n is
  240. an integer number from 1 to 999 and defaults to 5 seconds.  This time is
  241. approximate and will vary depending  on the size of the image being read in.
  242.  
  243. The /FN, /FB or /FW specify the foreground color (N=none, B=Black and
  244. W=White) of your Black & White images.  By specified foreground color, the
  245. program will be able to save more of your image's original context when
  246. scaling down.  This qualifier works best if your images are line drawings and
  247. not pictures.  For example, if your image appears on the screen as black
  248. lines on a white background, use the /FB qualifier.  If your images don't
  249. have a main foreground color such as the case with pictures, use /FN. Note
  250. that using either the /FB or /FW qualifiers will increase the processing time
  251. for B&W scaling.  If you don't need the increased quality, use /FN.
  252.  
  253. The /FTMn (fixed top margin) option will allow you to override the program's
  254. default values for that part on the top of a page that your printer can't
  255. print on.  The defaults are:
  256.      0.1" -    DeskJet, DeskJet 500, DeskJet 500C
  257.      0.05"     -    DeskJet 550C
  258.      0.0" -    LaserJet Series, PaintJet XL, PaintJet XL300
  259.      0.0" -    PaintJet (tractor feed)
  260.  
  261. If your printed margins don't match what you set in the Printer Setup Menu,
  262. then use this qualifier to adjust them.
  263.  
  264. The /LO mode (where mode is 100, 101, 103, 105 or 107) will lock out a mode. 
  265. This is useful if your VESA driver is designed for a graphics card which has
  266. been fully populated with memory chips but your card doesn't have all of this
  267. memory installed.  You may use more than one of these switches on your
  268. command line.
  269.         
  270. The /NB option will disable the beeps after images are displayed on screen. 
  271. The default is to beep.
  272.  
  273. The /P1 or /P2 designates which printer port to use for printing (LPT1 or
  274. LPT2).
  275.  
  276. The /PAn (print angle) is used to rotate your print on the printed page. 
  277. Values for n can be 0, 90, 180 or 270.
  278.  
  279. *    The /PC option will force the transfer of data from your computer to the
  280. printer to be in a compressed (encoded) format.  This will speed up the
  281. transfer of data (especially for serial or networked printers).  Time savings
  282. will vary depending on the type and size of plot.  In some cases, you may
  283. find no time savings overall since the printer has to decompress the data,
  284. but your CPU should be freed up from processing sooner.  (default is no
  285. compress).  The PaintJet and LaserJet II, do not support this type of data
  286. compression.  If your printouts look garbled, don't use this option.
  287.  
  288. The /PGn (print gamma correction) option will allow you to adjust the gamma
  289. of your Black & White or Color print.  Simply put, gamma correction will
  290. adjust the intensities of red, green & blue values logarithmically since the
  291. human eye's perception of color intensity is non-linear.  The gamma value is
  292. a decimal value between 0.5 and 2.0.  If set to 0, no gamma correction will
  293. be performed.  If this qualifier is not used, gamma defaults to a value best
  294. suited for the printer type selected.  Using higher values will result in the
  295. darker colors in your image being printed lighter and the lighter ones
  296. remaining the same.  This gives a much more natural looking printout.
  297.  
  298. *    The /PRn (printer resolution) is used to specify the resolution in dots per
  299. inch (dpi) of your active printer.  For the DeskJet series, it can be 75, 150
  300. or 300.  For the PaintJet series (except XL300), it can be 90 or 180. 
  301. Defaults to highest resolution for selected printer.
  302.  
  303. The /PXSn and /PYSn qualifiers can be used to slightly adjust the X-scale
  304. and/or Y-scale of your B&W plots.  These are useful if your plot needs to be
  305. an exact scale and your printer is not scaling the plot the same in the X &
  306. Y directions.  Increasing the /PXSn parameter will lengthen the plot along
  307. the 8 1/2" dimension and increasing the /PYSn parameter will lengthen the
  308. plot along the 11" direction.  The defaults for n are 1.0 and their ranges
  309. are between 0.9500 and 1.0500.  For example, on my DeskJet I use /PYS1.005
  310. and /PYS1.015.
  311.  
  312. The /PSx (print style) option allows you to select the style of printing for
  313. Black & White or Color prints.  It can be one of the following:  /PSBH (B&W
  314. Halftone), /PSBS (B&W Scatter), /PSCH (Color Halftone) or /PSCS (Color
  315. Scatter).  The Halftone styles will process much faster than the Scatter
  316. dithering types which use an error difusing algorithm, however, the Scatter
  317. styles will in most cases have much better detailing and quality.  Halftoning
  318. is the default.
  319.  
  320. The /PTx (printer type) is used to select your printer.  It can be one of the
  321. following:  /PTDJ (HP DeskJet), /PTLJ (HP LaserJet), /PTPJ (HP PaintJet),
  322. /PTPJXL (HP PaintJet XL), /PTPJXL3 (HP PaintJet XL300), /PTDJC (HP DeskJet
  323. 500C) or /PTDJ5C (HP DeskJet 550C).
  324.  
  325. *    The /PWn (print width) is used to specify a print width.  It is a decimal
  326. value from 0.0 to 10.5.  If you enter a number greater than 8.0, the print
  327. will automatically be rotated 90 degrees.  The print width represents the
  328. width that you want the horizontal image dimension as seen on your screen to
  329. be printed, no matter what rotation angle you use.
  330.  
  331. *    The /PTMn (printer top margin) sets the number of inches from the current
  332. position of printhead that the image will start printing.  It is a decimal
  333. value ranging from the minimum value of your printer (see /FTMn below) to
  334. 10.0.  If set to 99, your image will be centered from top to bottom.
  335.  
  336. *    The /PLMn (printer left margin) sets the number of inches from the left side
  337. of page that the image will start printing.  It is a decimal value from 0.25
  338. to 7.5.  If set to 99, your image will be centered from left to right.  The
  339. maximum printable width on all printers is 8.0" (1/4" left & right margins).
  340.  
  341. The /SVn will allow you to use a 800 x 600 x 2 color mode to display IMG or
  342. HPGL files in a high resolution mode if your graphics card supports it.  The
  343. n is the decimal mode number that your card uses for this mode.  Most
  344. Paradise cards use 41 decimal for this mode, and the Tseng cards (including
  345. Orchid) use 89 decimal.  This special mode and the standard 640 x 480 x 2
  346. mode will allow faster panning on screen than the same resolutions in VESA
  347. modes will for large B & W images.  NOTE: The panning icon which is available
  348. in VESA modes is not available for B & W modes.
  349.  
  350. The /WH is similar to /WN except that the weights of lines will be halved
  351. (divided by 2).  The /WF (full weights) will display the weights as
  352. originally drawn.
  353.  
  354. The /WN (no weight) will not display weights of lines in an HPGL plot file if
  355. the SP (select pen) keyword was used when creating the plots.  This will
  356. greatly speed up the screen drawing if you don't need to look at or print the
  357. weights.  Some CAD programs which generate the plot files create weighted
  358. lines by simply drawing the lines multiple times in the plot file (each
  359. slightly offset) and not by using the SP (set pen) command.  The /WN & /WH
  360. switches will have no effect on this type of plot files.
  361.  
  362.  
  363. SYSTEM DEFAULTS:    /P1 /AB /AM101 /D3 /WF /FB /CO /PTDJ /PW8.0 /PA0 /PTM0.25
  364.                     /PLM0.25 /FL10.5 /PXS1.0 /PYS1.0
  365.  
  366.      Ex:  VESAVIEW /L2 /AW /D10  - Will use printer port LPT2:, display
  367.      arrays with a white background, and delay 10 seconds between slides.
  368.  
  369.      Ex:  VESAVIEW /LO105 /LO107 /AM103 - Will lockout modes 105 and 107 from
  370.      being valid VESA modes and will use mode 103 when displaying arrays.
  371.  
  372. The program will test to see if your graphics card supports the VESA Bios
  373. Extensions by either hardware or software driver, whether you have a HIMEM
  374. driver loaded and how much extended memory you have available.
  375.  
  376. Use the <ESC> key to exit program.  A mouse button can not be used to exit
  377. the program.
  378.  
  379. CHANGING DIRECTORY:
  380.  
  381. While the list of files is on your screen, you can change your current
  382. directory by placing the cursor on the lite blue entries (which are directory
  383. names) and pressing <ENTER>.  The . (single dot) will take you back to the
  384. root directory, and the .. (double dots) will take you back one directory
  385. level.
  386.  
  387. You can also press the <C> key (or point to CDIR with mouse) to keyin a new
  388. path that can include a new disk drive. (Ex: B:\ or C:\GIF or C:\IMAGES\GIF
  389. or \GIF)
  390.  
  391. VIEW SINGLE IMAGE:
  392.  
  393. To view a single image move the cursor (with arrows, pageup, pagedown, home
  394. or end keys) to the desired image file and press <ENTER>.  Then select a Vesa
  395. Mode from the Mode Menu. An asterisk denotes the Best Mode (calculated by the
  396. program) which will display the most of your entire image on a single screen
  397. in the best resolution.  After your image is displayed, press <ESC> (or right
  398. mouse button) to return to main menu.  Note that when viewing IMG files or
  399. HPGL files, you can use a VESA mode (only B&W colors used), use the standard
  400. 640 x 480 x 2 mode or use the Super VGA mode that you optionally entered on
  401. the command line.  Entries in gray on the Mode Menu are not available for
  402. your graphics card.
  403.  
  404. VIEW MULTIPLE IMAGES (slide show):
  405.  
  406. To view multiple images as a 'slide show', use the <Space Bar> (or right
  407. mouse button) to select the images you wish to view.  You can mark all images
  408. in the current directory with the <M> key (or point to MARK with mouse) or
  409. unmark them with the <U> key (or UNMARK with mouse).  These can include GIF,
  410. PCX, BMP, TGA, IMG, TIF, PLT and HPG files.  By pressing the <C> key, you can
  411. change your current Disk &/or Directory.  Press <ENTER> (or left mouse
  412. button) to start the slide show.  The files will be displayed one by one in
  413. the best VESA mode as determined by the program (640x480x2 mode is used for
  414. PLT & HPG files).  The delay between slides will vary depending on the time
  415. it takes to read in the next file while one is on your screen and the value
  416. used in the  /Dn switch.  After the last file is displayed, the program will
  417. loop back to first slide.  Pressing <ESC> (or right mouse button) during the
  418. display will stop the slide show. (this may take several seconds)
  419.  
  420. VIEW AN ARRAY OF IMAGES:
  421.  
  422. To view multiple images on a single screen at once, use the <Space Bar> (or
  423. right mouse button) to select the images you wish to view.  These can include
  424. GIF, PCX, BMP, TGA, TIF and IMG files but not PLT or HPG files.  Press <A>
  425. (or point to ARRAY with mouse) to select array display.  Select the VESA mode
  426. from Mode Menu and then select the number of images to display per screen
  427. page. Then sit back and watch your images appear.  Pressing <ESC> (or right
  428. mouse button) will  abort the display after the current image is displayed. 
  429. If more than one page is required, you could press <G> to save the currently
  430. displayed page as a GIF file, <B> for Windows BMP file or <Z> for ZSoft PCX
  431. file or <PAGE DN> will continue to display the next page.
  432.  
  433. Since each image uses it own unique 256 colors, a special optimized color
  434. table and color dithering is used to display arrays.  Note that when
  435. displaying a 2-color file in an array, the scaling down of the original image
  436. (especially a line type drawing) will cause much of the info to be lost on
  437. the screen unless the /FB or /FW command qualifier is used.
  438.  
  439. NOTE:  Arrays are only available in VESA modes.
  440.  
  441. AUTO ARRAY GENERATION/SAVING:
  442.  
  443. If you are going to have many pages (screens) of array images and you will be
  444. saving them all out as single files, you can do this automatically by the <G>
  445. (or point to AUTO/GEN with mouse) to activate the generate option.  This will
  446. automatically display the arrays on the screen and then save them out without
  447. any user intervention until the last one is processed.  You begin just as you
  448. would for the standard array option by selecting the files to display, the
  449. VESA mode, and then the number of images/page. You are first prompted for the
  450. file type to use when saving.  Then you are prompted for the first 1-6
  451. characters of the filename that the program will use for the files it
  452. generates.  The system will append a 2 digit page number and appropriate
  453. extension to your input.
  454.  
  455. EX:  You are going to have 3 pages of array images and you select <G>IF as
  456. the filetype and  enter TEST as the filename.  The System will generate 3
  457. files named TEST01.GIF, TEST02.GIF & TEST03.GIF.
  458.  
  459. VIEWING GIF89A FILES - Special Case:
  460.  
  461. If you are viewing a single GIF89A file, most of the 89A extensions will be
  462. processed including multiple images, plain text and control blocks.  Comments
  463. will not be displayed.  Because of the way VESAVIEW reads images into
  464. Extended memory before displaying them, the plain text will only be displayed
  465. on the screen (not XMEM).  This will prevent the printing of the text since
  466. printing is done from what is in Extended memory.  One way around this, if
  467. your screen has enough resolution to display the entire file, is to save your
  468. screen out to another file with <G> and then pull up that file and print it. 
  469. NOTE, that the save commands will only save out what is on the screen after
  470. all of the 89A extensions are processed.  If the extensions include delays
  471. between images, or require the user to <press> a key, the program will
  472. continue after 15 seconds maximum so that slide shows will not be put in a
  473. wait state looking for user input.  
  474.  
  475. If you are viewing arrays which include GIF89A files, the extensions will be
  476. processed entirely in XMEM before displaying them in the array.  No text
  477. extensions will be displayed (they would be probably be too small to read
  478. anyway).  Delays between GIF89A extensions are not processed when displaying
  479. array images for increased speed.
  480.  
  481. VIEWING HPG or PLT FILES:
  482.  
  483. To view a plot file created in a HPGL format, move the cursor to the filename
  484. and press <ENTER>.  Then choose the Display Mode and Plot Mode you wish to
  485. use.  The program will try and determine the size of plot from the plot file
  486. header, but some CADD packages don't supply this info in which case the
  487. program will assume a "C size".  The HPGL codes for Plot Sizes are:
  488.  
  489.      PS4 = 'A' size
  490.      PS0 = 'B' size
  491.      PS1 = 'C' size
  492.  
  493. Choosing a display mode of FIT, 2X or 4X will speed up the drawing process
  494. but the resolution of the image will be diminished. As the image is decoded,
  495. you will see it being drawn in a preview mode at screen size.  After the
  496. image is complete, pressing any key will swap you to the actual image as
  497. stored in Extended memory for panning around in.  Pressing <ESC> (or right
  498. mouse button) as the image is being decoded will abort it.
  499.  
  500. Currently supported HPGL commands are:  PU,PD,PA,PR,PS,IP,SC,SP, CI,AA
  501.  
  502. Even though the LB,SI,SR,DF,DI & DR commands are parsed and used to display
  503. the image on the initial preview screen, they are not supported as the
  504. drawing is being created in Extended memory. This won't usually pose a
  505. problem since this program was designed to view HPGL files created by CADD
  506. programs and most of those programs represent Text etc. as vector elements.
  507.  
  508. WARNING:  Only plot files which were created as C size or smaller should be
  509. viewed, since the program does no checking for elements which could be drawn
  510. 'off' the page if too big.  This check was omitted to speed up the drawing.
  511.  
  512. DELETING FILES:
  513.  
  514. While the file list is displayed on your screen, you may delete a file by
  515. moving the cursor to it and pressing <DEL> on the keyboard.  To delete
  516. multiple files, mark them with the <spacebar> (or right mouse button) and
  517. then press <DEL>.  You will be asked to confirm each deletion.
  518.  
  519. SEARCHING FILENAMES:
  520.  
  521. While the file list is displayed on your screen, you may select files by
  522. searching their filenames for a specific string.  Press <S> (or point to
  523. SEARCH with mouse) and keyin the search string.  The file will be selected if
  524. it contains the exact string anywhere in its filename.  Don't use the
  525. wildcard characters * or ? since they will be search for literally.
  526.  
  527. SPECIAL KEYS WHILE VIEWING:
  528.  
  529. While viewing images in a VESA mode (other than arrays):
  530.  
  531.      F1/F2     Increase/Decrease RED
  532.      F3/F4     Increase/Decrease GREEN
  533.      F5/F6     Increase/Decrease BLUE
  534.      F7/F8     Increase/Decrease RED
  535.      F9/F10    Increase/Decrease RED
  536.      ALT F9    Change to Gray tones
  537.      ALT F10   Restore original palette
  538.      P         Send XMEM contents to printer as B&W or Color image
  539.      G         Create a GIF file (256 c) of screen contents
  540.      B         Create a BMP file (256 c) of screen contents
  541.      Z         Create a PCX file (256 c) of screen contents
  542.      C         Crop an image and save as GIF, BMP or PCX file (256 c)
  543.      S         Scale XMEM contents to screen and save as GIF, BMP or PCX file
  544.                (256 c)
  545.      V         Display the current VGA palette
  546.  
  547. While viewing an array:
  548.  
  549.      G    Create a GIF file (256 c) of screen contents
  550.      B    Create a BMP file (256 c) of screen contents
  551.      Z    Create a PCX file (256 c) of screen contents
  552.      C    Crop an image and create a GIF, BMP or PCX file (256 c)
  553.  
  554. While viewing IMG or HPGL files in a B & W mode:
  555.  
  556.      P    Send XMEM contents to printer as B&W image
  557.      I    Create an IMG file (2 c) of entire XMEM contents.  The 'I' option
  558.           may also be used if you are viewing an IMG or HPGL file in a color
  559.           VESA mode.
  560.      Z    Create a PCX (2 c) file of entire XMEM contents.
  561.  
  562. In both Color and B & W modes you may pan screen with:
  563.     (make sure the NUMLOCK key is on to use keypad)
  564.  
  565.      HOME      Top left of image
  566.      END       Bottom right of image
  567.      Page Up   Move up approx. 1 inch
  568.      Page Dn   Move down approx. 1 inch
  569.      ESC       Return to File Selection Menu
  570.  
  571. The arrow keys on either numeric keypad or separate arrow keypad pan the
  572. image approx. 1/4 inch in that direction. In addition, on the numeric keypad,
  573. the 1,3,7 & 9 keys pan the image diagonally and the 5 pans to center of
  574. image.
  575.  
  576. Use the Control key with left or right arrows to pan 1 inch to the left or
  577. right.
  578.  
  579. SAVING SCREEN AS a GIF, BMP or PCX FILE:
  580.  
  581. While viewing an image in a VESA mode, pressing <G> will save the current
  582. screen (not necessarily everything in Extended memory) to a GIF file with the
  583. filename of your choosing.  Pressing <B> will save to a Windows BMP file. 
  584. Pressing <Z> will save to a PCX file.  The dimensions will come from the mode
  585. you are currently viewing the image in or the cropped size that you used. 
  586. The color table written to file will reflect any adjustments you've made with
  587. the Function keys.
  588.  
  589. CROPPING SCREEN & SAVING AS a GIF, BMP or PCX FILE:
  590.  
  591. If you press <C> you will be able to crop your screen image before saving as
  592. a GIF or PCX file.  You will see a box drawn around your complete image when
  593. you first press <C>.  Press a <T> to move the TopLeft corner of box.  Press
  594. <B> to move the BottomRight corner. Use the arrow keys to move a single pixel
  595. at a time, or PageUp, <CTRL>Leftarrow or <CTRL>Rightarrow to move 10 pixels
  596. at a time.  <HOME> will move the Topleft corner of box to Topleft of screen. 
  597. <END> will move the Bottomright corner of box to Bottomright of screen. 
  598. <ESC> will abort and a <CR> will start the screen save. You will be prompted
  599. whether to save as GIF, BMP or PCX file.  See 'Using a Mouse' below.
  600.  
  601. SCALING XMEM CONTENTS TO SCREEN & SAVING:
  602.  
  603. If you press <S> you will be able to scale the entire image in XMEM to your
  604. screen.  You will see a box drawn the screen when you first press <S>.  If
  605. you just press the <CR> key at this time, your entire image will be fitted to
  606. your screen at the current VESA resolution.  Use the arrow keys etc. (like in
  607. cropping above) to move the lower right corner of box.  Scaling always occurs
  608. about the upper left corner of image, so you can't move this point. <ESC>
  609. will abort and a <CR> will start the screen save.  See 'Using Mouse' below.
  610.  
  611. SAVING XMEM CONTENTS AS a IMG FILE:
  612.  
  613. While viewing a 2 color Black/White image (either IMG, 2-color PCX or HPGL
  614. files), pressing an <I> will save the entire eXtended memory contents to a
  615. IMG file, or pressing <Z> will save as a 2-color PCX file.  You will have the
  616. opportunity to reverse the image before saving.  It doesn't matter whether
  617. you are viewing the image in a color VESA mode or one of the Black & White
  618. modes in order to with the <I> mode, as long as the original image was
  619. actually a 2 color image.  Currently, there is not a cropping option before
  620. saving as a IMG file.  However, if you are viewing the 2-color image in a
  621. color VESA mode, you could save out as a cropped GIF, BMP or PCX file.
  622.  
  623. PRINTING IMAGES:
  624.  
  625. Before displaying an image that you will be printing, you should pull up the
  626. Printer Setup Menu (submenu of OPTS menu) and make any necessary changes to
  627. style, size, margins, rotation and gamma etc.  After an image is displayed,
  628. any adjustments to color/brightness/contrast will be reflected in your print. 
  629. The gamma value (see description of /PGn qualifier above) is a good tool to
  630. use if adjustment to brightness is needed for printouts.  The maximum size of
  631. image is limited only by the amount of free XMEM you have.  The maximum size
  632. of print is 10.5 x 8.0 inches on most printers.  On the DeskJet 550C printer,
  633. note that you can't print on the bottom 1/2" of page, so if you are centering
  634. your print, the maximum length can't be greater than 10.0", but if you set
  635. your Top Margin to the minimum of 0.05", you can squeeze in about 10.4".
  636.  
  637. If you want to print multiple images, select them from the file list with the
  638. <Space Bar> (or right mouse button) as for slides, and then press <P> (or
  639. point to PLOT with mouse).  Each file will be displayed on screen and
  640. automatically plotted until the last one is processed.  NOTE that all of the
  641. plots will use the same size, rotation, justification etc. from the plotting
  642. options menu.  Pressing <ESC> (or right mouse button) will abort the
  643. plotting.  NOTE: This option is only available in Registered Version.
  644.  
  645. While a color image file is displayed on the screen, pressing <P> will create
  646. a print on your active printer in the current print style.  The fastest print
  647. style is the halftoning process. The scatter style will produce a better
  648. quality print in most cases, but will take longer to process.  You may cancel
  649. the plot by pressing <ESC> (or right mouse button) during the plot. The port
  650. defaults to LPT1 unless you specified a command line argument of /L2 when
  651. starting the program.  The actual plot will be of your entire image (stored
  652. in extended memory) and not just what you may be viewing on your screen.
  653.  
  654. While viewing a 2-color (black & white) file or HPGL (.PLT or .HPG), pressing
  655. <P> will create a Black & White print.  
  656.  
  657. See description of /FB, /FW & /FN above to preserve image context when your
  658. print is being scaled down from the original size.  You can use any of the
  659. printer qualifiers (available as command line qualifiers or from the Printer
  660. Menu within program) to change the defaults for Printer Port, Printer Type,
  661. Resolution, Rotation Angle, Width and Top & Left Margins.  
  662.  
  663. If you select a Print Width greater than 8.5", the program will automatically
  664. rotate print 90 degrees (unless 270 was already selected).  The program will
  665. beep if you try to use an invalid combination of size, rotation angle,
  666. margins or resolution.
  667.  
  668. MOUSE USE:
  669.  
  670. In most cases where the keypad is used to move the text cursor, a MicroSoft
  671. compatible mouse can also be used.  You must install any required mouse
  672. drivers before running VESAVIEW.
  673.  
  674. The Left button is used just like the <CR> key on the keyboard to display one
  675. image. It is also used to select choices from pop-up menus, to select
  676. commands at the bottom of screen and to select the PageUp and PageDown icons
  677. from the vertical bar on the right side of screen.
  678.  
  679. The Right button is used just like the <ESC> key on the keyboard to abort
  680. displays and menus.  It is also used to mark files for use in arrays or for
  681. displaying them as slides (like the <spacebar>).
  682.  
  683. If a large image has been displayed in one of the 256 color VESA modes,
  684. holding down the Left mouse button will display a panning icon on your
  685. screen.  The green box represents your entire image size and the red box
  686. represents your screen size.  While holding down the Left button, move the
  687. mouse and the red box will pan around with the green box.  When you let go of
  688. the button, the screen with be moved to reflect your new window area.  This
  689. mode of panning is much quicker than using the arrow keys, although you will
  690. probably use the arrow keys for fine tuning the pan.  If a double-beep is
  691. heard when trying to use this feature, your image is probably smaller than
  692. your screen and no panning is possible.
  693.  
  694. When Cropping an image, the Left mouse button will move the upper left corner
  695. of the cropping box and the Right mouse button will move the lower right
  696. corner of box.  Pressing both the Left and Right buttons simultaneously will
  697. start the save (like pressing <CR>).  Scaling works the same except the Left
  698. mouse button is not used (can't move the upper left corner of scaling box).
  699.  
  700. CAUTIONS:
  701.  
  702. The array used to store the files in current directory is limited to 400
  703. files.
  704.  
  705. The program determines the type of file to display by the extension used on
  706. the filename.  Supported extensions are PCX, GIF, BMP, TGA, IMG, TIF, HPG and
  707. PLT.  Any other extensions are ignored.  Incorrect extensions may cause
  708. program to hang  (ie. Don't name a PCX file with a GIF extension).
  709.  
  710. Even though your VESA driver thinks it supports some of the higher resolution
  711. modes, your hardware may not have the required memory to do so.  Therefore,
  712. you need to lockout these modes from the program with the /LOmode command
  713. line switch.  If you don't lock out these modes, the program may hang and
  714. you'll have to do the 3 finger trick (<CTRL> <ALT> <DEL>).
  715.  
  716. When printing, make sure your printer is online before pressing the <P> key,
  717. otherwise the printer may lose some of the data or lock up the program.
  718.  
  719. HINTS:
  720.  
  721. When creating arrays of images that include 24 bit files, you may want to
  722. toggle the 24 bit palette option to STANDARD to speed up the processing. The
  723. color detail will not be too apparent at this small scale.
  724.  
  725. If you are using a printer supported by the DOS GRAPHICS command, you can get
  726. a quick print of a Black & White screen by using the GRAPHICS command before
  727. running VESAVIEW.  Version 5.0 of DOS supports the DeskJet & LaserJets and
  728. the syntax would be:
  729.      GRAPHICS DESKJET /r     (the /r will reverse black & white)
  730.  
  731.      Use <SHIFT><PRT SCRN> while graphics are on the screen to initiate the
  732. print.
  733.  
  734. If you are printing to a color printer and you need to lighten up your print,
  735. try increasing the Gamma value instead of the brightness.  This will lighten
  736. up the lower intensities and leave the higher intensities as they are.
  737.  
  738. Besides using the SCALE option, there is a trick you can use to scale down an
  739. image by 1/2,1/3,1/4...1/9.  Mark just one image and display it as an array. 
  740. Select the Array Size according to the scale factor you wish to use. (The
  741. color table used to display a single image as an array will be the true color
  742. table of that image and not the standard palette).  After the image is
  743. displayed, use the CROP feature to save the area you desire as a color image. 
  744. Note that when a single array image is displayed, the background color and
  745. text colors will change according to the color table of the single image
  746. being displayed.
  747.  
  748. If you need a VESA driver for your graphics card, login to Compuserve and go
  749. to the IBMPRO forum (GO VESA).  In Lib #12 (Vesa), you will find VESA drivers
  750. for almost any card.
  751.  
  752. If you are not sure what graphics card you have in your machine, there is a
  753. great little program in the GRAPHSUPPORT forum on Compuserve (GO PICS).  In
  754. Lib #14 (Misc Util & Code) download VDEOID.EXE.  This program will try and
  755. determine the card manufacturer & memory on it.
  756.  
  757. CARDS TESTED:
  758.  
  759. This program has been tested on the following computers and graphics cards:
  760.  
  761. DELL 325D - Using built-in Paradise card
  762. DELL 325D - Using a CompuAdd Hi-rez card
  763. DELL 433D - Using Trident 8900 card
  764. DELL 433P - Using built-in Paradise card
  765. DELL 433P - Using a Video-7 VRAM II card
  766. DELL 486D/50 - Using built-in Paradise card
  767. NEC 386SX - Using a CompuAdd Hi-rez card
  768. AST 286/386 Premium - Using Orchid Designer Pro card
  769. AST 286/386 Premium - Using Diamond Stealth card (has built in VESA Bios on
  770. card)
  771. IBM 286 AT - Using a Paradise VGA Plus
  772. IBM 286 AT - Using an ATI Wonder card & ATI Vantage
  773. GATEWAY 2000 486/33 - Using an ATI Ultra card
  774.  
  775. SUPPORT:
  776.  
  777. If you have any comments, suggestions or questions, please leave me a message
  778. in the GRAPHSUPPORT forum (GO PICS) on Compuserve. My CIS ID number is
  779. 71170,2340.  The current shareware version of VESAVIEW will always be posted
  780. in the LIB #3 (Decoders & Encoders) of the GRAPHSUPPORT forum on Compuserve. 
  781. The Zipped archival of VESAVIEW will usually be named  VEVIxx.ZIP  where xx
  782. is the version number or VESAVW.ZIP.  If you can't find it by filename, try
  783. searching for the keywords VESA and HPGL.  You can also reach me at the P. O.
  784. Box listed in the Registration section.
  785.  
  786.