home *** CD-ROM | disk | FTP | other *** search
/ The Best of Select: Multimedia 4 / tbosmm4.rar / PCX / SVGA.TXT < prev    next >
Text File  |  1992-03-22  |  15KB  |  355 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12. SVGA
  13.  
  14. An Image Viewing Utility
  15.  
  16. Version 1.02 - March 1992
  17.  
  18.  
  19.  
  20.  
  21.  
  22. Program Reference Manual
  23.  
  24.  
  25.  
  26.  
  27.  
  28. Copyright (C) 1992 by John P. Silva
  29. All Rights Reserved
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36. John P. Silva
  37. 3429 Maywood Dr.
  38. Richmond, CA  94803  U.S.A.
  39.  
  40. (510) 222-9255
  41.  
  42. Internet: jsilva@cogsci.berkeley.edu
  43. GE Mail:  J.SILVA1
  44. SVGA Version 1.02                  Page 1                     March 1992
  45.  
  46.                         TABLE OF CONTENTS
  47.  
  48. SVGA LICENSE INFORMATION                                 2
  49.      Shareware & Registration                            2
  50.      Terms and Conditions                                2
  51.      Limited Warranty                                    3
  52.      Limitation of Liability                             3
  53.      Shareware Distributor License Agreement             3
  54.      Trademark Information                 3
  55. INTRODUCTION                                             4
  56.      Program Description                                 4
  57.      Features                                            4
  58.      Machine Requirements                                4
  59.      Installation                                        4
  60. USING SVGA                                               5
  61.      SVGA Command Line                                   5
  62.      SVGA Environment Variable                           5
  63.      File Selection Screen                               5
  64.           Getting Help                                   5
  65.           Moving Around                                  5
  66.           View Image                                     5
  67.           Change Directory                               5
  68.           Change drive                                   6
  69.           Toggle 4DOS Description Display                6
  70.           Toggle Image Resolution Display                6
  71.           Toggle 43/50 Line Mode                         6
  72.           Change Display Resolution                      6
  73.           Get File Information                           6
  74.           Edit 4DOS Description                          6
  75.           Rename File                                    6
  76.           Delete File                                    6
  77.      Image Display Screen                                6
  78.           Getting Help                                   6
  79.           Moving Around                                  6
  80.           Color Mix                                      6
  81.           Change Display Resolution                      6
  82. SVGA Version 1.02                  Page 2                     March 1992
  83.  
  84. SVGA LICENSE INFORMATION
  85.      
  86.   Shareware & Registration
  87.      SVGA is Copyright (C) 1992 by John P. Silva.  All Rights Reserved.
  88.      
  89.      SVGA is SHAREWARE, user supported software for the IBM PC.  SVGA is
  90.      made available for a free 30 day trial period.  If you find this
  91.      program useful, you may license your copy of the program for use on
  92.      one machine by sending US$15 (see below) to:
  93.      
  94.            John P. Silva
  95.            3429 Maywood Dr.
  96.            Richmond, CA  94803  U.S.A.
  97.      
  98.   Terms and Conditions
  99.      SVGA is copyrighted software, and all rights are reserved.  SVGA may
  100.      not be changed or modified in any way except by the author.  SVGA is
  101.      SHAREWARE, and may be freely distributed, as long as it remains in
  102.      its complete form with all support and documentation files.  It may
  103.      be used for a 30 day free trial period.  Regardless of how the copy
  104.      is obtained, it is requested that all users comply with the
  105.      following licensing and registration provisions if they continue to
  106.      use it after the 30 day trial period:
  107.      
  108.      You may license multiple copies of SVGA with discounts as follows:
  109.                  1 -  10 copies         US$15
  110.                 11 -  50 copies         20% discount
  111.                 51 - 100 copies         35% discount
  112.                     101+ copies         50% discount
  113.                    Site License         US$750
  114.  
  115.         All prices and discounts are subject to change without notice.
  116.         Discounts apply only to individual orders, they are not cumulative.
  117.  
  118.         Registration entitles you to:
  119.                 Use all updates at no cost.
  120.                 Receive free updates by sending me a diskette and a self
  121.                 addressed stamped disk mailer.
  122.                 Receive free technical support either by phone (you call me)
  123.                 or by letter.
  124.      
  125.      SVGA should be distributed intact, with all executable and
  126.      documentation files.
  127.      
  128.      A registered user may install SVGA on more than one machine,
  129.      provided he is the only user on each machine.  The registration and
  130.      license policy is similar to a book, which can be taken with you but
  131.      used only by you.
  132. SVGA Version 1.02                  Page 4                     March 1992
  133.  
  134.   Limited Warranty
  135.      The author makes no warranty of any kind, either expressed or
  136.      implied.  This includes, but is not limited to, implied warranties
  137.      of merchantability, and fitness for any particular purpose with
  138.      respect to both the software and the documentation included in this
  139.      package.
  140.      
  141.      IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
  142.      CONSEQUENTIAL, OR INCIDENTAL DAMAGES ARISING OUT OF THE USE OR
  143.      INABILITY TO USE THIS PRODUCT EVEN IF THE AUTHOR HAS BEEN ADVISED OF
  144.      THE POSSIBILITY OF SUCH DAMAGES OR CLAIM.  Some states do not allow
  145.      the exclusion or limitation of liability for consequential or
  146.      incidental damages, so the above limitation may not apply to you.
  147.      
  148.      The warranties set forth above are in lieu of all other express and
  149.      implied warranties, whether oral, written, or implied, and the
  150.      remedies set forth above are your sole and exclusive remedies.
  151.      
  152.   Limitation of Liability
  153.      In no case shall the authors liability exceed the license fees paid
  154.      for the right to use SVGA or five dollars (US$5.00), whichever is
  155.      greater.
  156.  
  157.   Shareware Distributor License Agreement
  158.      Shareware distributors may distribute this program as long as the
  159.      Author has been notified prior to ANY distribution.  The "per disk"
  160.      charge may not exceed $10 and the shareware distributor will not
  161.      change the above license agreement for the end user of SVGA.  End
  162.      users are still required to register each shareware copy of SVGA.
  163.      
  164.   Trademark Information
  165.      Graphics Interchange Format (C) Copyright CompuServe Incorporated.
  166.      GIF(sm) is a Service Mark owned by CompuServe Incorporated.  For
  167.      further information, please contact:
  168.          CompuServe Incorporated, Graphics Technology Department,
  169.     5000 Arlington Center Boulevard, Columbus, Ohio  43220, USA
  170.  
  171.      4DOS(tm) is a trademark of JP Software, Inc.
  172.  
  173.      Other product and company names are trademarks of their respective
  174.      owners.
  175. SVGA Version 1.02                  Page 5                     March 1992
  176.  
  177. INTRODUCTION
  178.      
  179.   Program Description
  180.      SVGA is an easy to use multi-format image viewer designed to quickly
  181.      browse through a collection of image files.
  182.      
  183.   Features
  184.      SVGA is a general purpose image file viewer for VGA and SuperVGA
  185.      with the following features:
  186.      
  187.      * High speed viewing of the following image formats:
  188.          1. CompuServe GIF87a and limited GIF89a support.  SVGA only
  189.             supports the image storage portion of GIF89a, not the
  190.             pseudo-animation and text extensions.
  191.          2. ZSoft PCX files (except 24 bit images).
  192.          3. MicroSoft Windows BMP files (except 24 bit images), both
  193.             compressed and uncompressed.
  194.      
  195.      * Self configuring for most display boards using Ahead, ATI, C&T,
  196.        Everex, Genoa, NCR, Headland, Oak, Paradise, Trident, Tseng Labs
  197.        (ET3000/ET4000), Video 7, Western Digital, and Zymos VGA chips.
  198.        SVGA fully supports the VESA standard, and will use the VESA
  199.        standard (through BIOS or TSR support) if detected.
  200.      
  201.      * SVGA can view images much larger than the available video hardware
  202.        may allow.  This is accomplished by preloading the image and then
  203.        displaying in whichever mode the user desires.  This allows the
  204.        display mode to be changed on the fly without having to reload the
  205.        image from disk.
  206.      
  207.      * Will use all available main memory, EMS, XMS, and hard disk space
  208.        to view images up to 8192x8192 in size.  If there is insufficient
  209.        real memory to load an image, SVGA will create temporary files on
  210.        disk as a virtual memory buffer to allow the image to be fully
  211.        loaded.
  212.      
  213.      * Fully supports 4DOS compatible file descriptions, and can edit
  214.        file descriptions at the file display screen.
  215.      
  216.      * Updates the display screen automatically when images are renamed,
  217.        deleted or descriptions changed.
  218.      
  219.      * Can be compressed with PKLite or other executable file compressor
  220.        with no ill effects.
  221.      
  222.   Machine Requirements
  223.      SVGA requires a VGA equipped IBM PC compatible computer with a
  224.      minimum of 384k of memory.  1MB of memory is desired for efficient
  225.      viewing of most image files.
  226.      
  227.   Installation
  228.      Installation of SVGA is straightforward.  Simply place the SVGA.EXE
  229.      executable someplace in the DOS path, and the rest is automatic.
  230.      SVGA requires no configuration or data files for correct operation.
  231. SVGA Version 1.02                  Page 6                     March 1992
  232.  
  233. USING SVGA
  234.      
  235.   SVGA Command Line
  236.      SVGA Command Line Format:
  237.                 SVGA [/drb4] [/x xres] [/y yres] [/p startpath]
  238.      
  239.      The /d option selects display of 4DOS descriptions at startup.
  240.      The /r option selects file list image resolution display at startup.
  241.      The /b option selects BIOS for screen I/O rather than direct screen
  242.      writes.
  243.      The /4 option selects 43/50 line mode at startup.
  244.      The /p option specifies the path SVGA should switch to at startup.
  245.      The /x and /y options specify the largest allowable display mode at
  246.      startup.
  247.      
  248.      All command line switches are optional, and may be specified in
  249.      any order.
  250.      
  251.   SVGA Environment Variable
  252.      Default command line switches may be specified in the dos
  253.      environment variable 'SVGA'.  DOS environment variables are set by
  254.      giving a command to DOS before running SVGA.  You can add these
  255.      commands to your AUTOEXEC.BAT file.
  256.      
  257.      The format of the SVGA environment variable is identical to the SVGA
  258.      command line format.  All command line options may be set in this
  259.      variable.
  260.      
  261.      Example:  set SVGA=/dr4 /x 800 /y 600 /p C:\GIF
  262.      
  263.      These options select as default 4DOS descriptions, image resolution
  264.      display, 43/50 line mode, 800x600 startup resolution (or the largest
  265.      resolution available below 800x600), and a startup path of C:\GIF.
  266.      
  267.   File Selection Screen
  268.      The File Selection Screen consists of the display mode list, the
  269.      file selection area, and the help line.  The currently selected mode
  270.      is the mode displayed in yellow.
  271.      
  272.      Getting Help
  273.      The F1 key will display the SVGA help and program information
  274.      screen.
  275.      
  276.      Moving Around
  277.      You may position the cursor on the screen by using the arrow keys,
  278.      the HOME/END keys, the PGUP/PGDN keys, or by pressing the first
  279.      letter of the desired filename.  HOME will move the cursor to the
  280.      start of the list.  END will move the cursor to the end of the list.
  281.      PGUP will jump up one screenful of names.  PGDN will jump down one
  282.      screenful.
  283.      
  284.      View Image
  285.      To view an image, position the cursor to the desired image and press
  286.      the Enter key to initiate image display.
  287.      
  288.      Change Directory
  289.      To change the current directory, position the cursor to the desired
  290.      directory and press the Enter key to select the directory.  When
  291.      changing to the directory one level up, the cursor will be
  292.      positioned at the name of the previously selected directory.
  293. SVGA Version 1.02                  Page 6                     March 1992
  294.  
  295.      Change drive
  296.      The F2 key will bring up the drive selection dialog box.  Simply
  297.      press the desired drive letter, and SVGA will attempt to change to
  298.      the desired drive.  If an error occurs, SVGA will present an error
  299.      message and remain at the current drive.
  300.  
  301.      Toggle 4DOS Description Display
  302.      The F5 key will toggle the display between multiple columns and 4DOS
  303.      descriptions.  The default mode is multiple column display.
  304.      
  305.      Toggle Image Resolution Display
  306.      The F6 key will toggle the display between file date/time and image
  307.      resolutions.  The default mode is file date/time display.
  308.      
  309.      Toggle 43/50 Line Mode
  310.      The F7 key will toggle between the startup mode and 43/50 line mode.
  311.      The default mode is usually 80x25 text mode.  Certain utilities such
  312.      as UltraVision may change the default mode.  SVGA fully supports the
  313.      large screen sizes provided by such utilities.
  314.      
  315.      Change Display Resolution
  316.      The F9/F10 keys will decrease and increase the current mode,
  317.      respectively.  The default mode is the mode with the highest
  318.      possible resolution.
  319.      
  320.      Get File Information
  321.      Information on the current file can be obtained by pressing Alt-I.
  322.      This information is the same information that is found under various
  323.      aspects of the file display screen.
  324.      
  325.      Edit 4DOS Description
  326.      4DOS descriptions can be edited by pressing Alt-E.  Descriptions may
  327.      be edited whether or not descriptions are currently being displayed.
  328.      
  329.      Rename File
  330.      The current file can be renamed by pressing Alt-R.
  331.      
  332.      Delete File
  333.      The current file can be deleted by pressing Alt-D.  This also
  334.      deletes the description in the 4DOS description file.
  335.      
  336.   Image Display Screen
  337.      
  338.      Getting Help
  339.      The '?' key will show available commands in Image Display Mode.
  340.      
  341.      Moving Around
  342.      The arrow keys will scroll the image around the screen, if the
  343.      current image is larger than the current display mode.  ESCAPE/Enter
  344.      will return to the File Selection Screen.
  345.      
  346.      Color Mix
  347.      F1/F2 will decrease/increase the red content of the image.
  348.      F3/F4 will decrease/increase the green content of the image.
  349.      F5/F6 will decrease/increase the blue content of the image.
  350.      F7/F8 will darken/lighten the image.
  351.      Alt-F10 will return the palette to normal.
  352.      
  353.      Change Display Resolution
  354.      F9/F10 will decrease/increase the current display mode.
  355.