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