home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 12 / CD_ASCQ_12_0294.iso / vrac / vgapal40.zip / VGAPAL.DOC < prev    next >
Text File  |  1993-10-31  |  13KB  |  324 lines
  1.        
  2.         ╔══════════════════════════════════════════╗
  3.         ║ VGAPAL  Copyright (c) 1993 Malcolm Drury ║
  4.         ╚══════════════════════════════════════════╝
  5.  
  6.      Note: this package contains the following files:
  7.  
  8.                      VGAPAL.EXE 4.0
  9.                      SETPAL.COM
  10.                      MODE3.COM
  11.                      VGAPAL.DOC
  12.                      STARTUP.VGA
  13.                      LOADIN.COM*
  14.                      REMOVE.COM*
  15.  
  16. (* copyright Ziff Davis)
  17.  
  18. VGAPAL.EXE is a utility that allows you to customize the colors
  19. your VGA card uses for text, by individually adjusting their red,
  20. green and blue components (in stages from 0 to 63).  The standard
  21. set of VGA colors is equivalent to those used by the EGA card;
  22. VGAPAL allows you to create a TSR (Terminate and Stay Resident)
  23. program called RAINBOW.COM that automatically maintains a text mode
  24. color scheme YOU define.  It also allows you to switch off the
  25. "blink" text mode and thereby give you access to 256 color
  26. combinations (i.e. 16 foreground by 16 background).  The
  27. accompanying program SETPAL allows you to display these
  28. combinations.
  29.  
  30.  
  31. RAINBOW requires only 2k of RAM; if you use DOS 5.0 or a memory
  32. mapping utility such as QEMM, you should be able to load it into
  33. high memory without difficulty.
  34.  
  35.  
  36. *** IMPORTANT ***
  37.  
  38. The author makes no warranty that VGAPAL and RAINBOW will work with
  39. your particular hardware configuration.  Further, you use the
  40. programs entirely at your own risk, and the author will not be held
  41. liable for any damage caused to your hardware or software through
  42. use of VGAPAL.EXE or RAINBOW.COM.
  43.  
  44. Legalities aside, you should not run into difficulties with this
  45. software.
  46.  
  47. VGAPAL and the other programs in this package are distributed as
  48. "contributory shareware".  You do not have to register as a user,
  49. nor are you under any obligation to pay for the use of the
  50. programs.  However, in the spirit of shareware, you are requested
  51. to consider making a small donation to the author if you find the
  52. software in this package useful.  The suggested contribution is
  53. $10, but less (or more!) would be fine.  Should you decide to make
  54. a contribution, please remit to:
  55.  
  56.                    Malcolm Drury
  57.                    11 Adele Crescent
  58.                    Nepean
  59.                    ON  K2J 2T7
  60.                    Canada
  61.  
  62. Thank you.
  63.  
  64. Please note that at the level of contribution requested, I cannot provide
  65. automatic upgrades or technical support by telephone. I will try to answer
  66. written questions (try leaving a message on the BBS from which you obtained
  67. this version, or to my CIS ID - 70574,3457, or to my INTERNET e-mail address -
  68. drury@gsc.emr.ca).  Future upgrades should be available on the BBS from which
  69. you obtained this version. IF YOU HAVE PAID FOR AN EARLIER VERSION - THANKS,
  70. AND YOU ARE NOT EXPECTED TO PAY AGAIN!
  71.  
  72. The software is supplied on an "as is" basis, and is fully functional - not
  73. crippled in any way.  Furthermore, you will never be prompted with "Have you
  74. paid me yet?" notices. I would appreciate receiving your feedback, comments,
  75. bug reports etc.  For the latter, please give me as much detail as you can -
  76. system, RAM, monitor type etc.
  77.  
  78. You are free to distribute this software package provided that you
  79. distribute the ENTIRE package, including this documentation file.
  80.  
  81. Now to the fun stuff!
  82.  
  83.  
  84.         **************************************************
  85.  
  86. VGAPAL
  87.  
  88.  
  89. VGAPAL allows you to change all of the 16 colors available to DOS
  90. programs, and to establish color schemes for up to four different
  91. palettes.  You can save your palette settings to an ASCII file for
  92. later retrieval, and you can also save the color scheme for palette
  93. 1 (the DOS default) to create a small TSR, RAINBOW.COM, that, when
  94. loaded, will maintain your text color schemes under most
  95. circumstances.  It will NOT maintain your chosen scheme with ill-
  96. behaved software that resets the DOS default color scheme. (If you
  97. run such software, type  mode3  after exiting; this will cause a
  98. mode change that will trigger rainbow.com). RAINBOW knows when it
  99. is loaded, so you can't inadvertently load it more than once, thus
  100. using up precious memory.
  101.  
  102. Usage:  vgapal [filename] [/s]
  103.  
  104. 1. Editing color palettes
  105.  
  106. Editing is simple.
  107.  
  108. The up and down arrow keys select the color to be edited.
  109.  
  110. The  r, g and b keys select which component (red, green or blue) of
  111. the selected color to change.
  112.  
  113. The left and right arrow keys decrease or increase the selected
  114. component (between 0 and 63).
  115.  
  116. The Ctrl-left arrow and Ctrl-right arrow keys  darken or lighten
  117. the selected color by decrementing or incrementing the value of
  118. each component (red, green ,blue).  This process stops when one or
  119. more component reaches zero in decrement mode or 63 in increment
  120. mode).
  121.  
  122. Each time you press a left or right arrow, or Ctrl-left arrow or
  123. Ctrl-right arrow, the new color appears on the display, and the
  124. numeric values of the components are indicated to
  125. the right of the component selection scale.  Just try it!
  126.  
  127. At any time you can also cause the colors to grade uniformly from
  128. color 1 to color 15; just press s.  To undo this effect, press u.
  129.  
  130. You can also toggle blinking for colors 8-15.  THE COLORS WILL NOT
  131. BLINK ON SCREEN IN VGAPAL BUT WILL DO SO IF YOU CREATE RAINBOW.COM
  132. TO HAVE BLINK ENABLED.  To toggle blink, press t.
  133.  
  134. 2. Saving your chosen scheme
  135.  
  136. You can exit the program any time without permanently saving your
  137. changes by pressing  End.
  138.  
  139. You can exit the program and save your changes by pressing Esc.  If
  140. you do this, you will first be asked if you want to write a new
  141. palette file for later use.  Press y or n as required.
  142.  
  143. Next, you will be asked if you want to save one of the current
  144. palette settings and create RAINBOW.COM.  If you select yes (by
  145. pressing y), you will then be given two further choices.  You can
  146. select the cursor shape - either block (press b) or normal
  147. DOS-default underline (u). Personally, I prefer the block.
  148.  
  149. You will also be asked if you want RAINBOW.COM to maintain your
  150. palette for normal VGA text mode (mode 3, 80 column by 25 lines)
  151. only, or for all enhanced modes (e.g. 132 column x 43 lines).  If
  152. you choose the latter, you may find that colors in some graphics
  153. modes are also affected.  I suggest you choose this setting only to
  154. fine tune the brightness of the default EGA colors (which, on some
  155. hardware configurations, are rather drab).  If you run into
  156. unacceptable problems, rerun VGAPAL and choose normal text mode
  157. only (press t).
  158.  
  159. POWER USERS:  if you select all enhanced modes, RAINBOW.COM maintains
  160.               your chosen color scheme for all modes below (and
  161.               including) mode 85 (hex 55).  You can change this through
  162.               DEBUG by typing:
  163.  
  164.                 debug rainbow.com  {Enter}
  165.                 e 179 xx  {Enter}
  166.                 w {Enter}
  167.                 q {Enter}
  168.  
  169.               where xx is the mode number, IN HEXADECIMAL NOTATION, above
  170.               which you wish RAINBOW.COM to be inactive.  You will need
  171.               to determine this mode from your SVGA adapter manual.        
  172.  
  173. Finally, you will be asked if you wish to enable the "blinking"
  174. text.  If you choose yes (by pressing y), you will have access to
  175. 256 color combinations (16 foreground, 16 background).  Chooses no
  176. (by pressing n) if you want to see blinking text.  NOTE: IF YOU
  177. HAVE SELECTED "all enhanced VGA modes" IN THE SELECTION ABOVE,
  178. CHOOSE "y" TO DISABLE BLINKING, OTHERWISE SOME OF YOUR GRAPHICS
  179. MODES WILL ALSO SHOW THE BLINKING EFFECT.
  180.  
  181. 3. Using a pre-defined palette
  182.  
  183. On the VGAPAL command line, "filename" is the name of a palette
  184. file containing color settings that you have chosen using VGAPAL
  185. previously.  A palette file called STARTUP.VGA is provided with
  186. this package.  
  187.  
  188.  
  189. Additional color palettes
  190.  
  191. In addition to the default 16 color palette, you can use VGAPAL to
  192. set three other VGA palettes.  Cycle through the available palettes
  193. by pressing p.  If your screen goes blank when you do this, it
  194. means that the colors for the selected palette have not yet been
  195. set (or that your system has blown a fuse!).  Just press the left
  196. arrow; this will establish a color for the background, and allow
  197. you to read the screen.  You can then edit the colors as usual.  
  198.  
  199.  
  200. 5. SETPAL.COM
  201.  
  202. Usage: setpal n [/b]
  203.                
  204.               n is the color palette you want (1-4, or 5 for grey 
  205.               scale)
  206.  
  207.               /b (optional) enables blinking text; the default is 
  208.               blinking text set off.                 
  209.  
  210. This program allows you to switch among the four color palettes,
  211. or, alternatively, to establsih a grey scale palette. Note that
  212. some DOS software will switch to default palette 1. Sorry, RAINBOW
  213. won't handle that.  Don't you just hate software that won't allow
  214. you to configure your color scheme the way YOU want it?
  215.  
  216. This program will help power users who want to change color schemes
  217. through DEBUG or another byte editor.  (For example, many of PC
  218. Magazine's utilities can be customized).  SETPAL shows the full
  219. range of colors available in the current palette, along with their
  220. hex number identifiers.
  221.  
  222.  
  223.  
  224. USING RAINBOW.COM
  225.  
  226. When you have created a palette scheme you like for palette 1, exit
  227. VGAPAL by pressing Esc and answer y at the prompt "create
  228. RAINBOW.COM?".  Copy RAINBOW.COM into your root directory, or any
  229. directory referenced by your PATH statement, then place the
  230. following statements, in sequence, in your AUTOEXEC.BAT file, then
  231. re-boot (press Ctrl-Alt-Del):
  232.  
  233. rainbow
  234. mode3
  235.  
  236.  
  237. MODE3.COM is a small program that resets your system to text mode
  238. 3; it is necessary to initialize RAINBOW.COM.
  239.  
  240.  
  241. Unlike some TSR programs, RAINBOW.COM contains no "nasty surprises"
  242. such as undocumented or barely legal calls to the system.  If you
  243. should experience problems in which RAINBOW seems to conflict with
  244. other TSR programs, try removing them one by one; if removing one
  245. remedies the situation, that is probably the one causing rhe
  246. problems.  You could then try rearranging the order in which you
  247. load your TSRs.  If your problem persists, and you can't live
  248. without the TSRs you were using before you tried RAINBOW, all I can
  249. say is sorry, but it's tough out there in TSR-land. 
  250.  
  251. RAINBOW may not work with some graphics programs, particularly shareware
  252. games.  If you run into problems, you might try using the routines
  253. LOADIN.COM and REMOVE.COM. These are from PC Magazine (loadin was
  254. originally called install). They enable you to load and remove TSRs
  255. from memory.  
  256. To use:
  257.  
  258. loadin rainbow
  259. rainbow
  260. mode3
  261.  
  262.  
  263. To remove rainbow as a TSR:
  264. remove
  265. {Enter}
  266.  
  267. LOADIN AND REMOVE ARE DISTRIBUTED FREE OF CHARGE, COURTESY OF ZIFF DAVIS
  268. PUBLISHING.  YOU MAY PASS COPIES TO OTHERS BUT YOU MUST NOT CHARGE FOR THEM.
  269.  
  270.  
  271. SETTING PALETTES WITHOUT RAINBOW
  272.  
  273. If memory is a problem, you can set your color scheme, as saved in
  274. an ASCII file format, by running VGAPAL as follows:
  275.  
  276. VGAPAL filename /s
  277.  
  278. The /s switch causes VGAPAL to load the palette file and then exit
  279. without showing the edit screen.  Please note, however, that your
  280. color scheme will NOT be maintained following a mode change (e.g.
  281. switching back to text mode from graphics mode).  You would have to
  282. run VGAPAL as shown again to re-establish your color scheme. As
  283. RAINBOW only uses about 2k of RAM, and is a simple TSR that has no
  284. "hot key" functions or screen display functions that eat memory,
  285. its memory requirement should not be a problem.  
  286.  
  287.  
  288. I hope you find this package useful. 
  289.  
  290. ***************************************************************************
  291.  
  292.             Look for the following shareware on this BBS
  293.  
  294.  
  295. DSPACE40.ZIP - gas gauge display of all or selected hard drives, including
  296.                remove drives; plus SMEM - detailed gas gauge display of 
  297.                one drive plus information on installed and available RAM,
  298.                EMS, XMS memory.  Gas gauge display is of following form:
  299.  
  300.               E ███████████████║║║║║║║║║║║║║║║║║║║ F
  301.  
  302.                and numerical data are also given.
  303.  
  304. DDIRV73.ZIP - double-column non-scrolling directory display that
  305.               highlights new files, flags system, hidden and read-only files,
  306.               and optionally shows the "dead" space on disk associated with
  307.               each file.  Full on-scren sort/re-sort.  You can scroll up and
  308.               down in the file list.
  309.  
  310. ADR50.ZIP - address and telephone number filer, and label maker.  Suitable
  311.             for personal databases or for small clubs etc.  Ideal for finding
  312.             telephone numbers quickly.
  313.  
  314. VIEW71.ZIP - file viewer for WordPerfect 5.0 and above, ASCII and Word (DOS
  315.              and Windows 1/2); includes text search, printing full or partial
  316.              file, etc.
  317.  
  318. IF YOU DO NOT FIND ANY OF THESE, LEAVE ME A MESSAGE!
  319.  
  320. CIS 70574,3457
  321. INTERNET drury@gsc.emr.ca
  322.  
  323.  
  324. 25 January 1993