home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD2.mdf / tools / rainbo / rainbow.doc < prev    next >
Text File  |  1994-03-29  |  9KB  |  212 lines
  1.  
  2.                      ╔════════════════════════╗
  3.                      ║     R A I N B O W      ║
  4.                      ║         V 1.5          ║
  5.                      ║                        ║
  6.                      ║   Copyright (c) 1994   ║
  7.                      ║     Mercé Software     ║
  8.                      ║   All rights reserved  ║
  9.                      ║    CIS [100330,3606]   ║
  10.                      ╚════════════════════════╝
  11.  
  12.  
  13.  
  14.  
  15. Disclaimer (must be)
  16. **********
  17.  
  18.      This software ( RAINBOW ) is provided on an "as is" basis without
  19.      warranty of any kind, expressed or implied, including but not limited
  20.      to the implied warranties of merchantability and fitness for a
  21.      particular purpose.  The person using the software bears all risk as
  22.      to the quality and performance of the software.  The author will not
  23.      be liable for any special, incidental, consequential, indirect or
  24.      similar damages due to loss of data or any other reason, even if the
  25.      author or an agent of the author has been advised of the possibility
  26.      of such damages.  In no event shall the author's liability for any
  27.      damages ever exceed the price paid for the license to use the
  28.      software, regardless of the form of the claim.
  29.  
  30.      This Software is freeware and may be distributed free of charges.
  31.      However sending a $10 gift with suggestions will help for their
  32.      realization.
  33.  
  34.                           Bernard Mercé
  35.                           Le Poulindu
  36.                           France 56610 Arradon
  37.  
  38.  
  39. What is RAINBOW ?
  40. *****************
  41. RAINBOW is an editor which allows creating a 256 colors palette for some Super-
  42. VGA modes. It works in the 640 x 480 and 800 x 600 graphic modes ( and perhaps
  43. higher ).
  44.  
  45. Quick start.
  46. ************
  47. Type 'rainbow colors.pal' at DOS prompt.
  48. The whole color table 'colors.pal' is displayed. This screen is the pivot
  49. of the program. Whatever you like to do, you must begin it at this point.
  50. Any action begins with selecting a color field.
  51. Move the mouse cursor to a field and click it with the left mouse button.
  52. A menu is displayed on the right. Because 'Edit' is the main function of
  53. Rainbow, the cursor is already on the 'Edit' item. Click it.
  54. Three sliders appear corresponding to the three basic colors. Select one slider
  55. clicking on it. It becomes thicker and the cross line may be moved verticaly
  56. with the mouse. When doing this, you can see how the color changes in the
  57. selected field. Clicking again with the left button will enter the new value,
  58. clicking with the right button will restore the old value. Another slider may be
  59. now selected. When the color is what you expect, click the rigth button to leave
  60. the slider field and come back to the colors field where a new color may be
  61. selected.
  62.  
  63. Keep in mind this rule:
  64. the left mouse button is used to select or enter a value, the right one
  65. to leave a function. Additionaly, the <Esc> key has the same function as
  66. the right button.
  67.  
  68. You are now back to the main 'Select' screen.
  69. If you like to see better the color fields, you can change to the coarse mode.
  70. Press the <F2> key. Only 64 fields are now displayed. The visible page may be
  71. changed with <PgDn> and <PgUp>. Colors may be edited as explained above.
  72. Additionnaly, the RGB values of each color are displayed.
  73.  
  74.  
  75. Misceleanous functions.
  76. ***********************
  77. COPY
  78. To copy a field over another, select the source field, then the 'Copy' item of
  79. the menu and at last click on the destination field.
  80. Note that both fields must be visible.
  81.  
  82. INSERT
  83. To insert a field at any place in the table, select the field where to insert,
  84. then the 'Insert' menu item. All color fields after the selected place will be
  85. shifted to the right. Note the highest field will be lost.
  86.  
  87. DELETE
  88. To delete a field, proceed on the same way as for insert but click the 'Delete'
  89. menu item.
  90.  
  91. BASIC COLORS in the 5 top entries.
  92. Rainbow needs black, white, red, green and blue for text, cursor and sliders .
  93. It looks for them in the table and chooses the nearest colors it can find.
  94. Do'nt wonder if slider's or text's color changes. If you really need the left
  95. slider red ...and so on, force it with <F4>. The last 5 entries of the table
  96. will be set to the basic colors (RBGWB). Pressing <F4> again will bring you back
  97. to your whole palette. Forced basic colors can't be selected or changed.
  98.  
  99.  
  100. Working with PCX pictures.
  101. **************************
  102. Rainbow accepts also PCX images as input files. They must be in 256 colors mode
  103. ( in the PCX file second byte = 5 ).
  104. First the image is displayed, press any key to continue. The color palette will
  105. be displayed. From the 'select' screen or in the editing function, you may
  106. toggle the display between table and picture with the middle mouse button
  107. or <F3>.
  108. This feature use intensively the paging facilities of the SuperVGA card.
  109. Because this paging have never been a standard, some cards may display the
  110. image truncated or splitted. In that case, start the program with the switch -p
  111. to disable the paging function; you have only the possibility to toggle with
  112. <F3> between picture and palette at 'select' screen level.
  113. For some large pictures, using a higher resolution may be necessary. Use the
  114. switch -m4 will start Rainbow in the resolution 600x800, -m5 should do it
  115. with 1024x748. In that case use the -p switch if your SuperVGA card has
  116. 'only'  1Mb, 2Mb are necessary for paging at this high resolution.
  117.  
  118.  
  119. Input and output files
  120. **********************
  121. Input file name may be entered without any switch. Output file name may be
  122. defined with the '-o' switch.
  123. The command :
  124.               rainbow colors.pal -ocolors2.pal
  125. will read colors.pal and write the result to the file colors2.pal.
  126.  
  127. If no output file is entered, the input file will be used ( and overwritten).
  128. If neither input nor output file are defined, the build in color table will be
  129. displayed ( depending on the graphic driver ) and the default output file name
  130. 'test.pal" will be proposed.
  131.  
  132. If the input file was a PCX image you have both possibilities to save the color
  133. table separatly or to insert it into the PCX file.
  134.  
  135.  
  136. Files format
  137. ************
  138. File are ASCII.
  139. No header, every line correspond to a color and contains four values:
  140.  
  141. 12, 48, 124, 196
  142. where
  143. 12 is the name ( index 0..255) of the color in the table,
  144. 48 is the red componant
  145. 124       green
  146. 196       blue.
  147.  
  148. Note that the RGB values may be varied from 0 to 252 in steps of 4. The 2 LSB
  149. are ignored and may be, you will have to shift 2 bits to the right, depending
  150. on your application.
  151.  
  152. GRAPHIC MODES
  153. *************
  154.         1 -->   Autodetect
  155.         2 -->   Autodetect 640*400
  156.         3 -->   Autodetect 640*480  ** DEFAULT **
  157.         4 -->   Autodetect 800*600
  158.         5 -->   Autodetect 1024*768
  159.         6 -->   640x350x256 Tseng ET3000
  160.         7 -->   640x480x256 Tseng ET3000
  161.         8 -->   800x600x256 Tseng ET3000
  162.         9 -->   640x350x256 Tseng ET4000
  163.        10 -->   640x400x256 Tseng ET4000
  164.        11 -->   640x480x256 Tseng ET4000
  165.        12 -->   800x600x256 Tseng ET4000
  166.        13 -->   1024x768x256 Tseng ET4000
  167.        14 -->   640x400x256 Trident 8900
  168.        15 -->   640x480x256 Trident 8900
  169.        16 -->   800x600x256 Trident 8900
  170.        17 -->   1024x768x256 Trident 8900
  171.        18 -->   640x400x256 Video7
  172.        19 -->   640x480x256 Video7
  173.        20 -->   800x600x256 Video7
  174.        21 -->   640x400x256 ATI VGA
  175.        22 -->   640x480x256 ATI VGA
  176.        23 -->   800x600x256 ATI VGA
  177.        24 -->   640x400x256 Paradise
  178.        25 -->   640x480x256 Paradise
  179.        26 -->   800x600x256 Paradise
  180.        27 -->   640x350x256 Everex
  181.        28 -->   640x400x256 Everex
  182.        29 -->   640x480x256 Everex
  183.        30 -->   800x600x256 Everex
  184.        31 -->   640x400x256 Oak
  185.        32 -->   800x600x256 Oak
  186.        33 -->   640x400x256 VESA
  187.        34 -->   640x480x256 VESA
  188.        35 -->   800x600x256 VESA
  189.        36 -->   1024x768x256 VESA
  190.  
  191.  
  192. Troubles
  193. ********
  194.  A graphic driver is included which should support the most current SuperVGA
  195. cards ( thanks U. v. Bassewitz ).
  196. The most probable source of troubles will be the high diversity of SuperVGa
  197. cards. If you get any error message including the word 'graphic', do'nt be
  198. depressed, I provided an rescue solution. It is possible to use a third-party
  199. external BGI driver which you expect to fit to your SuperVGA card.
  200. Call 'Rainbow', with the following parameters:
  201.  
  202. rainbow colors.pal -d[drivername] -m[mode]
  203.  
  204. where -d is the switch and 'drivername' ... but WITHOUT extension (.BGI)
  205.       -m is the switch and 'mode' is the code the driver uses for the video
  206.         mode you like to use.
  207. The driver must be in the same directory as Rainbow.
  208.  
  209. **************
  210. Sun and rain are necessary for a rainbow. I wish you both when using 'Rainbow'.
  211. **************
  212.