home *** CD-ROM | disk | FTP | other *** search
/ GIF-GALAXY 1 / gif-galaxy1.iso / programs / svga.man < prev    next >
Text File  |  1992-04-23  |  20KB  |  463 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12. SVGA
  13.  
  14. An Image Viewing Utility
  15.  
  16. Version 1.1 - April 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
  39.  
  40. (510) 222-9255
  41.  
  42. Internet: jsilva@cogsci.berkeley.edu
  43. GE Mail:       J.SILVA1
  44.  
  45. SVGA Version 1.1 - April 1992        -i-             TABLE OF CONTENTS
  46. --------------------------------------------------------------------------
  47.  
  48. SVGA LICENSE INFORMATION                                           1
  49.      Shareware & Registration                                      1
  50.      Terms and Conditions                                          1
  51.      Limited Warranty                                              2
  52.      Limitation of Liability                                       2
  53.      Shareware Distributor License Agreement                       2
  54.      Trademark Information                                         2
  55. INTRODUCTION TO SVGA                                               3
  56.      Program Description                                           3
  57.      Features                                                      3
  58.      Machine Requirements                                          3
  59. USING SVGA                                                         4
  60.      SVGA Command Line                                             4
  61.      Installation                                                  4
  62.      Environment Variables                                         4
  63.           SVGA Environment Variable                                4
  64.           TEMP Environment Variable                                4
  65.      File Selection Screen                                         5
  66.           Getting Help                                             5
  67.           Moving Around                                            5
  68.           View Image                                               5
  69.           Change Directory                                         5
  70.           Change drive                                             5
  71.           Toggle 4DOS Description Display                          5
  72.           Toggle Image Resolution Display                          5
  73.           Toggle 43/50 Line Mode                                   5
  74.           Toggle Automatic Resolution Selection                    5
  75.           Change Display Resolution                                5
  76.           Get File Information                                     6
  77.           Edit 4DOS Description                                    6
  78.           Rename File                                              6
  79.           Delete File                                              6
  80.      Image Display Screen                                          6
  81.           Getting Help                                             6
  82.           Moving Around                                            6
  83.           Color Mix                                                6
  84.           Brightness                                               6
  85.           Restore Palette                                          6
  86.           Change Display Resolution                                6
  87.       Palettes and TrueColor Video Modes                       6
  88. APPENDIX                                                           7
  89.      Troubleshooting                                               7
  90.           386 Memory Managers                                      7
  91.           Tseng Labs ET4000 HiColor and Video Snow                 7
  92.  
  93. SVGA Version 1.1 - April 1992        -1-          SVGA LICENSE INFORMATION
  94. --------------------------------------------------------------------------
  95.  
  96. SVGA LICENSE INFORMATION
  97.      
  98.   Shareware & Registration
  99.      SVGA is Copyright (C) 1992 by John P. Silva.  All Rights Reserved.
  100.      
  101.      SVGA is SHAREWARE, user supported software for the IBM PC.  SVGA is
  102.      made available for a free 30 day trial period.  If you find this
  103.      program useful, you may license your copy of the program for use on
  104.      one machine by sending US$15 to:
  105.      
  106.              John P. Silva
  107.              3429 Maywood Dr.
  108.              Richmond, CA  94803  U.S.A.
  109.      
  110.   Terms and Conditions
  111.      SVGA is copyrighted software, and all rights are reserved.  SVGA may
  112.      not be changed or modified in any way except by the author.  SVGA is
  113.      SHAREWARE, and may be freely distributed, as long as it remains in its
  114.      complete form with all support and documentation files.  It may be
  115.      used for a 30 day free trial period.  Regardless of how the copy is
  116.      obtained, it is requested that all users comply with the following
  117.      licensing and registration provisions if they continue to use it after
  118.      the 30 day trial period:
  119.      
  120.      You may license multiple copies of SVGA with discounts as follows:
  121.           1 - 10 copies       US$15
  122.           11 - 50 copies      20% discount
  123.           51 - 100 copies     35% discount
  124.           100+ copies         50% discount
  125.           Site License        US$750
  126.      
  127.      Manuals and diskettes for the latest version of SVGA are available to
  128.      registered users for US$10 per copy.
  129.  
  130.      All prices and discounts are subject to change without notice.
  131.      Discounts apply only to individual orders, they are not cumulative.
  132.      
  133.      Registration entitles you to:
  134.           Use all updates at no cost.
  135.           Receive free updates by sending me a diskette and a self
  136.           addressed stamped disk mailer.
  137.           Receive free technical support either by phone (you call me) or
  138.           by electronic mail.
  139.      
  140.      SVGA should be distributed intact, with all executable and
  141.      documentation files.
  142.      
  143.      Registered users may install SVGA on more than one machine, provided
  144.      they are the only user on each machine.  The registration and license
  145.      policy is similar to a book, which can be taken with you but used only
  146.      by you.
  147.  
  148. SVGA Version 1.1 - April 1992        -2-          SVGA LICENSE INFORMATION
  149. --------------------------------------------------------------------------
  150.   
  151.   Limited Warranty
  152.      The author makes no warranty of any kind, either expressed or implied.
  153.      This includes, but is not limited to, implied warranties of
  154.      merchantability, and fitness for any particular purpose with respect
  155.      to both the software and the documentation included in this package.
  156.      
  157.      IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
  158.      CONSEQUENTIAL, OR INCIDENTAL DAMAGES ARISING OUT OF THE USE OR
  159.      INABILITY TO USE THIS PRODUCT EVEN IF THE AUTHOR HAS BEEN ADVISED OF
  160.      THE POSSIBILITY OF SUCH DAMAGES OR CLAIM.  Some states do not allow
  161.      the exclusion or limitation of liability for consequential or
  162.      incidental damages, so the above limitation may not apply to you.
  163.      
  164.      The warranties set forth above are in lieu of all other express and
  165.      implied warranties, whether oral, written, or implied, and the
  166.      remedies set forth above are your sole and exclusive remedies.
  167.      
  168.   Limitation of Liability
  169.      In no case shall the authors liability exceed the license fees paid
  170.      for the right to use SVGA or five dollars (US$5.00), whichever is
  171.      greater.
  172.      
  173.   Shareware Distributor License Agreement
  174.      Shareware distributors may distribute this program as long as the
  175.      Author has been notified prior to ANY distribution.  The "per disk"
  176.      charge may not exceed $10 and the shareware distributor will not
  177.      change the above license agreement for the end user of SVGA.  End
  178.      users are still required to register each shareware copy of SVGA.
  179.      
  180.   Trademark Information
  181.      Graphics Interchange Format (C) Copyright CompuServe Incorporated.
  182.      GIF(sm) is a Service Mark owned by CompuServe Incorporated.  For
  183.      further information, please contact:
  184.           CompuServe Incorporated
  185.           Graphics Technology Department
  186.           5000 Arlington Center Boulevard
  187.           Columbus, Ohio  43220    U.S.A.
  188.      
  189.      Truevision is a registered trademark of Truevision, Inc.
  190.      TARGA is a registered trademark of Truevision, Inc.
  191.      
  192.      4DOS(tm) is a trademark of JP Software, Inc.
  193.      
  194.      QEMM-386(tm) is a trademark of Quarterdeck Office Systems.
  195.      
  196.      Other product and company names are trademarks of their respective
  197.      owners.
  198.  
  199. SVGA Version 1.1 - April 1992        -3-              INTRODUCTION TO SVGA
  200. --------------------------------------------------------------------------
  201.  
  202. INTRODUCTION TO SVGA
  203.      
  204.   Program Description
  205.      SVGA is an easy to use multi-format image viewer designed to quickly
  206.      browse through a collection of image files.
  207.      
  208.   Features
  209.      SVGA is a general purpose image file viewer for VGA and SuperVGA with
  210.      the following features:
  211.      
  212.       High speed viewing of the following image formats:
  213.       1.CompuServe GIF87a and limited GIF89a support.  SVGA only supports
  214.         the image storage portion of GIF89a, not the pseudo-animation and
  215.         text extensions.
  216.       2.ZSoft PCX files (including 24 bit PCX).
  217.       3.MicroSoft Windows BMP files (including 24 bit BMP), both
  218.         compressed and uncompressed.
  219.       4.Truevision TARGA files, types 1, 2, 9, and 10.     
  220.  
  221.       Self configuring for most display boards using Ahead, ATI, C&T,
  222.       Everex, Genoa, NCR, Headland, Oak, Paradise, S3, Trident, Tseng Labs
  223.       (ET3000/ET4000), Video 7, and Western Digital chips  (See the
  224.       Appendix for supported chipsets).  SVGA fully supports the VESA
  225.       standard, and will use the VESA standard (through BIOS or TSR
  226.       support) if desired.
  227.      
  228.       Supports viewing TrueColor images on VGA, HiColor, and Everex
  229.       TrueColor display adapters.
  230.      
  231.       SVGA can view images much larger than the available video hardware
  232.       may allow.  This is accomplished by preloading the image and then
  233.       displaying it in whichever mode the user desires.  This allows the
  234.       display mode to be changed on the fly without having to reload the
  235.       image from disk.
  236.      
  237.       Automatic detection of 80386/80486 processors for faster image
  238.       display.
  239.      
  240.       Will use all available main memory, EMS, XMS, and hard disk space to
  241.       view images up to 8192 x 8192 in size.  If there is insufficient
  242.       physical memory to load an image, SVGA will create temporary files
  243.       on disk as a virtual memory buffer to load as much of the image as
  244.       is possible.
  245.      
  246.       Fully supports 4DOS compatible file descriptions, and can edit file
  247.       descriptions at the file display screen.
  248.      
  249.       Updates the display screen automatically when images are renamed,
  250.       deleted or descriptions changed.
  251.      
  252.       Can be compressed with PKLite or other executable file compressors
  253.       with no ill effects.
  254.      
  255.   Machine Requirements
  256.      SVGA requires a VGA or SuperVGA equipped IBM PC compatible computer
  257.      with a minimum of 512k of memory.  2 MB of memory or more is desired
  258.      for efficient viewing of most image files.
  259.  
  260. SVGA Version 1.1 - April 1992        -4-                USING SVGA
  261. --------------------------------------------------------------------------
  262.  
  263. USING SVGA
  264.      
  265.   SVGA Command Line
  266.  
  267.      SVGA Command Line Format:
  268.      
  269.                SVGA [/badrv4] [/x xres] [/y yres] [/p startpath]
  270.      
  271.      The /b option selects BIOS for screen I/O rather than direct screen
  272.      writes.
  273.      The /a option selects automatic resolution selection at startup.
  274.      The /d option selects display of 4DOS descriptions at startup.
  275.      The /r option selects file list image resolution display at startup.
  276.      The /v option selects the VESA interface if VESA is installed.
  277.      The /4 option selects 43/50 line mode at startup.
  278.      The /x and /y options specify the largest allowable display mode at
  279.      startup.
  280.      The /p option specifies the path SVGA should switch to at startup.
  281.      
  282.      All command line switches are optional, and may be specified in any
  283.      order.
  284.      
  285.   Installation
  286.      Installation of SVGA is straightforward.  Simply place the SVGA.EXE
  287.      executable someplace in the DOS path, and the rest is automatic.  SVGA
  288.      will automatically detect your machine, memory and video adapter.
  289.      (See Appendix for supported chipsets.)  SVGA requires no configuration
  290.      or data files for correct operation.   However, there are a number of
  291.      DOS environment variables which may be set to enhance program
  292.      operation.
  293.      
  294.   Environment Variables
  295.      
  296.      SVGA Environment Variable
  297.        Default command line switches may be specified in the dos
  298.        environment variable 'SVGA'.  DOS environment variables are set by
  299.        giving a command to DOS before running SVGA.  You can add these
  300.        commands to your AUTOEXEC.BAT file.
  301.        
  302.        The format of the SVGA environment variable is identical to the
  303.        SVGA command line format.  All command line options may be set in
  304.        this variable.
  305.        
  306.        Example:  set SVGA=/dr4 /x 800 /y 600 /p C:\GIF
  307.        
  308.        These options select as default 4DOS descriptions, image resolution
  309.        display, 43/50 line mode, 800x600 startup resolution (or the
  310.        largest resolution available below 800x600), and a startup path of
  311.        C:\GIF.
  312.        
  313.      TEMP Environment Variable
  314.        The DOS environment variable 'TEMP' may be used to direct SVGA to
  315.        place its virtual memory buffers in a specific location.  If the
  316.        'TEMP' variable is not set, SVGA will place the virtual memory
  317.        buffers in the current working directory.  This may not be
  318.        desirable behavior.  It is recommended that 'TEMP' be set to a
  319.        directory on a hard disk with more than 2 MB of free space.
  320.  
  321. SVGA Version 1.1 - April 1992        -5-                USING SVGA
  322. --------------------------------------------------------------------------
  323.  
  324.   File Selection Screen
  325.      The File Selection Screen consists of the display mode list, the file
  326.      selection area, and the help line.  The currently selected mode is
  327.      displayed in yellow.
  328.      
  329.      Getting Help
  330.        The F1 key will display the SVGA help and program information
  331.        screen.
  332.        
  333.      Moving Around
  334.        You may position the cursor on the screen by using the arrow keys,
  335.        the HOME/END keys, the PGUP/PGDN keys, or by pressing the first
  336.        letter of the desired filename.  HOME will move the cursor to the
  337.        start of the list.  END will move the cursor to the end of the
  338.        list.  PGUP will jump up one screenful of names.  PGDN will jump
  339.        down one screenful.
  340.        
  341.      View Image
  342.        To view an image, position the cursor to the desired image and
  343.        press the Enter key to initiate image display.
  344.        
  345.      Change Directory
  346.        To change the current directory, position the cursor to the desired
  347.        directory and press the Enter key to select the directory.  When
  348.        changing to the directory one level up, the cursor will be
  349.        positioned at the name of the previously selected directory.
  350.        
  351.      Change drive
  352.        The F2 key will bring up the drive selection dialog box.  Simply
  353.        press the desired drive letter, and SVGA will attempt to change to
  354.        the desired drive.  If an error occurs, SVGA will remain at the
  355.        current drive.
  356.        
  357.      Toggle 4DOS Description Display
  358.        The F5 key will toggle the display between multiple columns and
  359.        4DOS descriptions.  The default mode is multiple column display.
  360.        
  361.      Toggle Image Resolution Display
  362.        The F6 key will toggle the display between file date/time and image
  363.        resolutions.  The default mode is file date/time display.
  364.        
  365.      Toggle 43/50 Line Mode
  366.        The F7 key will toggle between the startup mode and 43/50 line
  367.        mode.  The default mode is usually 80x25 text mode.  Certain
  368.        utilities such as UltraVision may change the default mode.  SVGA
  369.        fully supports the large screen sizes provided by such utilities.
  370.        
  371.      Toggle Automatic Resolution Selection
  372.        The F8 key will toggle between locked mode and automatic selection
  373.        mode.  The mode line will change to indicate current mode.
  374.        Automatic mode is indicated when all shown resolutions are the
  375.        same color.  The default mode is locked.
  376.        
  377.      Change Display Resolution
  378.        The F9/F10 keys will decrease and increase the current mode,
  379.        respectively.  The default mode is the mode with the highest
  380.        possible resolution.
  381.  
  382. SVGA Version 1.1 - April 1992        -6-                USING SVGA
  383. --------------------------------------------------------------------------
  384.        
  385.      Get File Information
  386.        Information on the current file can be obtained by pressing Alt-I.
  387.        This information is the same information that is found under
  388.        various aspects of the file display screen.
  389.  
  390.      Edit 4DOS Description
  391.        4DOS descriptions can be edited by pressing Alt-E.  Descriptions
  392.        may be edited whether or not descriptions are currently being
  393.        displayed.
  394.        
  395.      Rename File
  396.        The current file can be renamed by pressing Alt-R.
  397.        
  398.      Delete File
  399.        The current file can be deleted by pressing Alt-D.  This also
  400.        deletes the description in the 4DOS description file.
  401.        
  402.   Image Display Screen
  403.      
  404.      Getting Help
  405.        The '?' key will show available commands in Image Display Mode.
  406.        
  407.      Moving Around
  408.        The arrow keys will scroll the image around the screen, if the
  409.        current image is larger than the current display mode.  Press
  410.        ESCAPE or Enter to return to the File Selection Screen.
  411.        
  412.      Color Mix
  413.        F1 will decrease the red content of the image.
  414.        F2 will increase the red content of the image.
  415.        F3 will decrease the green content of the image.
  416.        F4 will increase the green content of the image.
  417.        F5 will decrease the blue content of the image.
  418.        F6 will increase the blue content of the image.
  419.        
  420.      Brightness
  421.        F7 will darken the image.
  422.        F8 will lighten the image.
  423.        
  424.      Restore Palette
  425.        Alt-F10 will return the palette to normal.
  426.        
  427.      Change Display Resolution
  428.        F9 will decrease the current display mode.
  429.        F10 will increase the current display mode.
  430.  
  431.      Palettes and TrueColor Video Modes
  432.        The palette editing functions in SVGA only effect the paletted
  433.        video modes, such as the standard 256 color SuperVGA video modes.
  434.        TrueColor video modes have no palette, and cannot be color
  435.        corrected using the F1-F8 keys in view mode.
  436.  
  437. SVGA Version 1.1 - April 1992        -7-                  APPENDIX
  438. --------------------------------------------------------------------------
  439.  
  440. APPENDIX
  441.      
  442.   Troubleshooting
  443.      
  444.      386 Memory Managers
  445.        SVGA may have difficulty detecting ATI, Genoa, Paradise and Western
  446.        Digital video adapters when running QEMM-386 or similar memory
  447.        management products which hide the system ROMs behind useable
  448.        memory (QEMM calls this "stealth mode").   To correct this
  449.        difficulty, you should either exclude the range C000-C1FF from use
  450.        by the memory manager, or arrange to have the page frame mapped
  451.        into the range C000-CFFF (this works with QEMM, but may not work
  452.        with other memory managers).  This allows SVGA to correctly access
  453.        the necessary information in ROM.
  454.        
  455.      Tseng Labs ET4000 HiColor and Video Snow
  456.        Most Tseng ET4000 based video boards have timing problems which
  457.        manifest themselves as random changes to pixel data written to
  458.        video memory.  These changes typically appear as brightly colored
  459.        pixels or "snow" in the image being viewed.  This problem is
  460.        particularly apparent in HiColor video modes.  It is a hardware
  461.        bug, not a problem in SVGA.
  462.  
  463.