16/tauron30/README.TXT

   1 =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\r
   2 =-                                                                         -=\r
   3 =-                   Tauron VGA Utilities Version 3.0                      -=\r
   4 =-                      Released September 20, 1998                        -=\r
   5 =-                                                                         -=\r
   6 =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\r
   7 =- Copyright (c) 1997, 1998 by Jeff Morgan  =-= This code is FREE provided -=\r
   8 =- All Rights Reserved.                     =-= that you put my name some- -=\r
   9 =-                                          =-= where in your credits.     -=\r
  10 =- DISCLAIMER:                              =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\r
  11 =- I assume no responsibility whatsoever for any effect that this package, -=\r
  12 =- the information contained therein or the use thereof has on you, your   -=\r
  13 =- sanity, computer, spouse, children, pets or anything else related to    -=\r
  14 =- you or your existance. No warranty is provided nor implied with this    -=\r
  15 =- source code.                                                            -=\r
  16 =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\r
  17 \r
  18 The code in this package will switch video modes on any standard VGA video\r
  19 card.  This is accomplished by programming the VGA Registers directly.\r
  20 \r
  21 ##############################################################################\r
  22 ####          Mode 07H and Mode 0FH are still being worked on.            ####\r
  23 ##############################################################################\r
  24 \r
  25 \r
  26 =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\r
  27 =- Files included in this package: -=                      -=\r
  28 =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=                      -=\r
  29 =-  Assembly version compiles with TASM 4.1 and TLINK 7.0  -=\r
  30 =-  C version compiles with Borland C++ 5.01               -=\r
  31 =-                                                         -=\r
  32 =-   README.TXT       You are reading it.                  -=\r
  33 =-   WHATSNEW.TXT     Whats new in this version            -=\r
  34 =-   USAGE.TXT        How to use these routines.  Also     -=\r
  35 =-                    contains a complete list of the      -=\r
  36 =-                    videomodes supported.                -=\r
  37 =-                                                         -=\r
  38 =-   MAIN.EXE         Assembly version executable demo     -=\r
  39 =-   MAINC.EXE        C version executable demo            -=\r
  40 =-   FEDIT.EXE        Font editor                          -=\r
  41 =-   FEDIT.TXT        Docs for the font editor             -=\r
  42 =-                                                         -=\r
  43 =-   ASM_SRC          The assembly source directory        -=\r
  44 =-    +->MAIN.ASM     The Main source file                 -=\r
  45 =-    +->MODES.ASM    The mode switching file              -=\r
  46 =-    +->CLEAR.ASM    The clear screen routines            -=\r
  47 =-    +->TESTS.ASM    The videomode tests                  -=\r
  48 =-    +->DUAL.ASM     The dual font setup and test         -=\r
  49 =-    +->FONT1.ASM    Font 1 for dual font test            -=\r
  50 =-    +->FONT2.ASM    Font 2 for dual font test            -=\r
  51 =-    +->MODES.INC    The includes for each videomode      -=\r
  52 =-                                                         -=\r
  53 =-   C_SRC            The C source directory               -=\r
  54 =-    +->MAINC.CPP    The main source file                 -=\r
  55 =-    +->MODES.CPP    The mode switching file              -=\r
  56 =-    +->CLEAR.CPP    The clear screen routines            -=\r
  57 =-    +->TESTS.CPP    The videomode tests                  -=\r
  58 =-    +->TAURON.H     The main header file                 -=\r
  59 =-    +->FONT1.H       Font 1 for dual font test           -=\r
  60 =-    +->FONT2.H      Font 2 for dual font test            -=\r
  61 =-    +->MODES_C.INC  The includes for each videomode      -=\r
  62 =-    +->PALETTE.INC  The standard palette                 -=\r
  63 =-                                                         -=\r
  64 =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\r
  65 \r
  66 When running the demo:\r
  67 \r
  68    In graphics modes, there is a vertical line every 40 pixels with a longer\r
  69    vertical line every 80 pixels.\r
  70 \r
  71    I have not yet figured out how to program modes 04H, 05H, or 06H.  Once\r
  72    the mode is set, I only clear the mode to a specified color.\r
  73 \r
  74 \r
  75 \r
  76 The VGA BIOS must be called once at the beginning of the routines so that we\r
  77 know where the fonts are stored.  Once this information is known we no longer\r
  78 need the BIOS.\r
  79 \r
  80 The reason for starting this package is that I am writing an Operating\r
  81 System. (There are a lot of us out there I know.)  I wanted to be able to\r
  82 program standard VGA cards for my OS.\r
  83 \r
  84 This is not a graphics library although there are some clear screen and pixel\r
  85 routines around.  It only sets the video mode. This works in real mode as\r
  86 well as protected mode.  To use it in protected mode you will have to modify\r
  87 it to suit your own needs.\r
  88 \r
  89 The use of the fonts stored in BIOS ROM is now included.  We are using what is\r
  90 already built into the VGA BIOS.\r
  91 \r
  92 \r
  93 E-mail:      kinfira@hotmail.com\r
  94 Homepage:    http://home.onestop.net/kinfira/\r
  95 \r
  96 Drop me a line if you find this package useful.\r
  97 \r
  98 =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\r
  99 =-= Credits:  =-=                                                         =-=\r
 100 =-=-=-=-=-=-=-=-=                                                         =-=\r
 101 =-= A great book: "Programmer's Guide to the EGA, VGA, and Super VGA      =-=\r
 102 =-= Cards" 3rd Edition   Richard F. Ferraro   ISBN 0-201-62490-7          =-=\r
 103 =-= Addison-Wesley Publishing Company.                                    =-=\r
 104 =-=                                                                       =-=\r
 105 =-= A very excellent book: "Programmer's Guide to the EGA & VGA Cards"    =-=\r
 106 =-= Richard F. Ferraro   ISBN 0-201-12692-3                               =-=\r
 107 =-= Addison-Wesley Publishing Company.                                    =-=\r
 108 =-=                                                                       =-=\r
 109 =-= Anthony A.J. Williams for writing MODES.ASM, which I used to help     =-=\r
 110 =-= write the Text Mode routine.  I specifically used the SetFont         =-=\r
 111 =-= procedure which was instrumental in getting the code for Mode 03h     =-=\r
 112 =-= working.                                                              =-=\r
 113 =-=                                                                       =-=\r
 114 =-= Boone (boone@ucsd.edu) for the docs on programming the VGA Registers. =-=\r
 115 =-=                                                                       =-=\r
 116 =-= I also used a really great program called TWEAK to get some of the    =-=\r
 117 =-= values for the non-standard modes.                                    =-=\r
 118 =-=                                                                       =-=\r
 119 =-= Denthor of ASPHYXIA for his trainer on Chain-4 Mode.                  =-=\r
 120 =-=                                                                       =-=\r
 121 =-= Robert Schmidt <robert@stud.unit.no> for the great doc in PCGPE 1.0   =-=\r
 122 =-= about Mode X.  This helped a great deal.                              =-=\r
 123 =-=                                                                       =-=\r
 124 =-= Michael Abrash for his super excellent VGA articles on everything,    =-=\r
 125 =-= plus all of his books and public domain code.                         =-=\r
 126 =-=                                                                       =-=\r
 127 =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\r
 128 \r
 129 \r
 130 =-=-=-=-=-=-=-=-=-=-=-=\r
 131 =- Revision History: -=\r
 132 =-=-=-=-=-=-=-=-=-=-=-=\r
 133 =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\r
 134 Version 3.0 released September 20, 1998\r
 135    I added 2 new text modes, 40x43 and 40x50.  Also I have added a new dual\r
 136    font test which uses 2 of the VGA's 8 font maps.\r
 137 \r
 138 \r
 139 =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\r
 140 Version 2.1 released July 5, 1998\r
 141    The only change is that in the C version, the routine to read fronts from\r
 142    BIOS is now working.  This routine reads a font from the BIOS and places\r
 143    it in memory for use in a textmode.\r
 144 \r
 145 \r
 146 =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\r
 147 Version 2.0 released June 22, 1998\r
 148     I have added more videomodes.  I have also written a version of the\r
 149     source in C.  So the routines are available in Assembly and C.  I have\r
 150     also written some documentation for the font editor.  So now the only\r
 151     modes that are not implemented are the monochrome modes which will still\r
 152     be worked on.\r
 153 \r
 154 \r
 155 Tauron VGA Utilities\r
 156 Version 1.0 released June 14, 1998\r
 157     I changed the name because that other was a little too long.  B->\r
 158     I have packaged in a small font editor.  I have also rearranged the mode\r
 159     numbers and added a few more video modes that will be implemented.\r
 160 \r
 161 \r
 162 =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\r
 163 Source code for switching videomodes without using BIOS\r
 164 Version 4.1 released May 28, 1998\r
 165 \r
 166 New in this version:\r
 167     We call a BIOS function to find out where in memory the fonts are stored.\r
 168     Since this is different on every cards' VGA BIOS, it is absolutely\r
 169     necessary so that in text modes, the proper fonts are displayed.\r
 170 \r
 171 \r
 172 =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\r
 173 Version 4.0 released March 5, 1998\r
 174 \r
 175 New in this version:\r
 176     All VGA Modes are supported! Plus Chain-4 Mode, ModeX, ModeA,\r
 177     ModeB and ModeC.  Modes 07H and 0FH are still being worked on.\r
 178 \r
 179     Use of Fonts stored in ROM.\r
 180     Custom Font data stored in system memory is no longer needed.\r
 181 \r
 182 \r
 183 =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\r
 184 Version 3.0 released January 2, 1998\r
 185     Includes Modes 03h, 10h, 12h, and 13h plus Chain-4 Mode, ModeX, ModeA,\r
 186     ModeB and ModeC.\r
 187 \r
 188 New in this version: Mode 10h (640x350x16), Mode C (640x400x16)\r
 189 \r
 190 \r
 191 =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\r
 192 Version 2.5 not released\r
 193     Includes Modes 03h, 12h, and 13h plus Chain-4 Mode, ModeX, ModeA, and\r
 194     ModeB.\r
 195 \r
 196 New in this version: VGA register data takes up less space.\r
 197 \r
 198 \r
 199 =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\r
 200 Version 2.1 released Nov. 21, 1997\r
 201     Includes Modes 03h, 12h, and 13h plus Chain-4 Mode, ModeX, ModeA, and\r
 202     ModeB.\r
 203 \r
 204 \r
 205 =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\r
 206 Version 2.0 released Nov. 10, 1997\r
 207     Includes Modes 03h, 12h, and 13h plus Chain-4 Mode and ModeX.\r
 208 \r
 209 \r
 210 =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\r
 211 Version 1.5 released late Oct. 1997\r
 212     Includes Modes 03h, 12h, and 13h.  Fully functional\r
 213 \r
 214 \r
 215 =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\r
 216 Version 1.1 released in Oct. 12, 1997\r
 217    Includes Mode 13h, Mode 03h finally works. Realized that I needed to reset\r
 218    the text mode font.\r
 219 \r
 220 \r
 221 =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\r
 222 Version 1.0 released in Oct. 7, 1997\r
 223    Included Mode 13h, Mode 03h partially. (Did not have setfont routine)\r
 224 \r
 225 \r
 226 =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=\r