home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: Graphics / Graphics.zip / nhview0e.zip / SVGALIB.TXT < prev    next >
Text File  |  1995-04-14  |  3KB  |  89 lines
  1. Graphics library version 1.0                                  08. March 1995
  2.  
  3.  
  4. This is the first revision of a fullscreen graphics library for OS/2.
  5.  
  6.  
  7. What can it do:
  8.  
  9.   - Setting up a fullscreen session in the following videomodes:
  10.     0- 320x240   8 bit colours
  11.     1- 320x400   8 bit colours
  12.     2- 360x480   8 bit colours
  13.     3- 640x400   4 bit colours
  14.     4- 640x480   4 bit colours
  15.     5- 320x200   8 bit colours
  16.     6- 640x480   8 bit colours
  17.     7- 800x600   4 bit colours
  18.     8- 800x600   8 bit colours
  19.     9- 1024x768  4 bit colours
  20.    10- 1024x768  8 bit colours
  21.    11- 1280x1024 4 bit colours
  22.    12- 1280x1024 8 bit colours
  23.    13- 640x480  15 bit colours
  24.    14- 640x480  16 bit colours
  25.    15- 640x480  24 bit colours
  26.    16- 800x600  15 bit colours
  27.    17- 800x600  16 bit colours
  28.    18- 800x600  24 bit colours
  29.    19- 1024x768 15 bit colours
  30.    20- 1024x768 16 bit colours
  31.      - More can be added by simply editing the grp_mode.c file.
  32.  
  33.    - Setting the video memory bank correctly for all these modes, this is done 
  34.      through the SVGA driver that must be installed *CORRECTLY* for your SVGA graphics 
  35.      card.
  36.  
  37.    - For 8bit video modes there are sample funcions for putting pixels, drawing
  38.      lines and boxes, and for putting images to the screen.
  39.  
  40.    - Functions for working with the palette for 8bit graphics cards.
  41.        Fadeout
  42.        Blackout
  43.        FadeTo
  44.        and more...
  45.  
  46.  
  47. What it doesn't do:
  48.  
  49.    - Switch between pages like in the infamous modeX.
  50.      This can be fixed, but it involves writing directly to the I/O ports of
  51.      the graphics card.
  52.  
  53.  
  54. What this project involved:
  55.     
  56.    - Getting basic I/O access to different ports on the graphics card.
  57.      Solved by setting the correct IOPL for the affected segment.
  58.  
  59.    - Getting general bankswitching in SVGA modes to work.
  60.      Solved by using the SVGA base handler sevices with DosDeviceIOCtls.
  61.  
  62.    - Getting access to the graphics memory using the Watcom 10.A compiler.
  63.      This was complicated by a bug in the generation of thunking code.
  64.      Solved by using DIVE (Direct Interface to Video Extensions).
  65.  
  66.  
  67. what this library demands:
  68.    - OS/2 Warp version 2.x or newer.
  69.    - MMPM/2 and Warp must be installed if Watcom C/C++ 10 is to be used as a compiler.
  70.    - Watcom C/C++ 10.0 or IBM C-set++ 2.1 or newer.
  71.  
  72.  
  73.  
  74. That should be all.
  75.  
  76. I hope you will be satisfied with it.
  77.  
  78.  
  79. Troubleshooting:
  80.  
  81. Q.  It doesn't work?
  82.  
  83. A.  1- Install a SVGA driver or use the normal VGA reolutions.
  84.     2- Check that your svgadata.pmi file supports the resolution you want to 
  85.        set. If not, reinstall the Displaydriver.
  86.  
  87.  
  88. The Nighttime Hackers (C) 1995
  89. Jonny Rein Eriksen