home *** CD-ROM | disk | FTP | other *** search
/ Software of the Month Club 1994 October / SOFM_Oct1994.bin / pc / dtp / qb0_11 / qb0.doc < prev    next >
Text File  |  1994-07-04  |  10KB  |  243 lines
  1.  
  2.  
  3.  
  4.   QB0.DOC    ·    ·    ·    ·    ·    ·    ·    page 1
  5.  
  6.      QB0.DOC - documentation for CubiNaut 1.10 (c)'94 silicon alley
  7.  
  8.         [has gaps to print on 66-line continuous paper]
  9.  
  10.  
  11. CubiNaut is a tool to show colors and their RGB co-ordinates. It's also fun to
  12. play with.
  13.  
  14.    Minimum kit: 8086, VGA or MCGA, DOS 2.0.
  15.  
  16.    CubiNaut can show each of the 262144 different VGA shades. To show up to
  17. 248 together on one screen, it uses mode 13h, pretty chunky, i know, but the
  18. only 256-color mode for which you don't need SVGA.
  19.    As for people with CGA or EGA: i'm really sorry you can't run it, but the
  20. whole point of CubiNaut is to let you wade through a quarter million colors,
  21. and you haven't got those colors...
  22.  
  23.  
  24.     What's New
  25.  
  26. For those who know CubiNaut 1.00: the big new feature is Flood, filling the
  27. whole screen with your chosen color (at the request of some of my users).
  28. Also, code is packed yet more tightly - still under 4 K, folks.
  29.  
  30.  
  31.     The Color Cube
  32.  
  33. CubiNaut lets you journey through the color cube, the set of all colors your
  34. screen can display, arranged as a cube, the 3 dimensions being red, green, and
  35. blue content. Each component ranges from 0 to 63 (hex 3F).
  36.    To show you the inside of the cube, CubiNaut cuts pieces off. For example,
  37. to look at the color with red, green, blue values of 32, 42, 21 (a greenish
  38.                                               beige) it makes a cut to expose
  39.     this      .M.      this            .M.       the colors with red content
  40.  way more  .·'   `·.  way more      .·'   ;·     of 32 (about halfway the
  41.    red   R'         ;B  blue      R'   .·' :     cube).
  42.          : `·.   .·' :            : `·'    :        The chosen color is some-
  43.          :   BLACK   :            :  : o  .·     where on the cut face, but can
  44.          Y.    :    .C            Y. : .·'       be exposed further. The blue
  45.            `·. : .·'                `·'       content being 21 (one third of
  46.               `G'                          the maximum), it will cut away one
  47.            this way                           third in the blue direction.
  48.           more green                   .M.
  49.                                     .·'   ;·
  50. Now the color is on both the cut    :`·.·' :               .·.
  51. faces, so it must be on the edge    :  :   :            .·'   ;·
  52. between them.                       :  o  .·            :`·o·'.·
  53.    A final cut, corresponding to     `·:·'               `·:·'
  54. the green content of 42 (two thirds
  55. down the way), exposes our color from 3 sides. There it is (marked o), on the
  56. intersection of 3 edges and 3 cut faces.
  57.  
  58.    The current corner color and its neighbouring colors are shown as little
  59. cubes that stack up.
  60.    The current color is also used as text background, to show how it looks in
  61. bulk.
  62.    The program starts with 19 19 19 (hex 13 13 13), dark grey.
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.   QB0.DOC    ·    ·    ·    ·    ·    ·    ·    page 2
  71.  
  72.     Keys
  73.  
  74.  * Insert/Home/PgUp INCREASES the current color's red/green/blue content. This
  75. slices one layer off the appropriate face to expose another, brighter layer.
  76. The remaining part of the cube is shifted one unit towards you, so the new
  77. corner color is in the same place on screen where the old one was. Works
  78. different after F2.
  79.  
  80.  * Delete/End/PgDn DECREASES the current color's red/green/blue content. This
  81. adds a (darker) layer to the cube, which moves one unit away from you, so once
  82. again you see the new corner color where the old one was. Different after F2.
  83.  
  84.  * Ctrl with any of these keys in/decreases the step between layers. Initially,
  85. you get every fourth layer in the red and blue directions (step +04), but every
  86. other green layer (step +02).
  87.    Choose large steps to ZOOM OUT. Try step sizes all +08, color values 03, to
  88. see the whole cube in the viewport.
  89.    Small steps are essential to ZOOM IN and see fine nuances of shade.
  90.    You'll want to increase a step size when neighbouring colors become indis-
  91. tinguishable. You can set the three step sizes separately.
  92.  
  93.  * F2 flips the sign of the steps. On startup, all the neighbouring colors you
  94. see are BRIGHTER than the corner color. The colors whose red, green or blue
  95. content are lower than those of the corner color have all been cut away, to
  96. expose the corner.
  97.    After F2, you're looking the other way, and the neighbouring colors you see
  98. are DARKER. Now the colors with higher red, green or blue contents have been
  99. cut away.
  100.    Every next F2 reverses the situation.
  101.    This means after using F2 (an odd number of times), changing red/green/blue
  102. has a different visual effect: now INcreasing adds a (brighter) layer, and DE-
  103. creasing slices a layer off.
  104.    If this all sounds complicated, just get to know the program a bit before
  105. using F2.
  106.  
  107.  * F10 does not affect the colors; it toggles between bases 10d (decimal) and
  108. 10h (hex) to display the numbers. You get decimal on startup.
  109.  
  110.  * Enter (or ─┘ or Return) floods the whole display and border with your
  111. chosen color. Press any key to get back into editing mode (a keypress to get
  112. out of flood will not have the key's normal effect).
  113.  
  114.  * Esc, finally, gets you back to the drab white on black DOS prompt.
  115.  
  116.  
  117.     More about Keys
  118.  
  119. You may have seen that, while other keys repeat when held down, Insert doesn't
  120. normally. Ours is not to wonder why, ours is just to compute and sigh...
  121.    This would make increasing red awkward, but i didn't want to give up Insert;
  122. CubiNaut's color keys are (on a 101/102 keyboard) perfectly arranged for their
  123. task. So CubiNaut repeats Insert "by hand", 18 times per second, after a half-
  124. second delay. This may be a bit faster or slower than your other keys, but at
  125. least you don't have to go taptaptap...
  126.    Technical note: CubiNaut detects Ins-down at 0040:0018 bit 7, chains int 1C
  127. for its timing, and restores the vector on exit. Time-of-day routines continue
  128. while CubiNaut runs. My eternal gratitude to anyone who knows a better trick to
  129. make Insert behave like a proper key.
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.   QB0.DOC    ·    ·    ·    ·    ·    ·    ·    page 3
  137.  
  138.    By the way, in/decreasing a color component may be slower than its key's
  139. repeat. CubiNaut clears the keyboard buffer each time it reads a key, so a key
  140. won't go on after it's released, and you shouldn't get a bloodcurdling screech
  141. from a full keyboard buffer.
  142.  
  143.    If you have a non-enhanced (XT) keyboard then CtrlIns and CtrlDel simply
  144. don't exist. My solution is to offer Ctrl-> & Ctrl<- as alternatives and, for
  145. symmetry, -> & <- as alternatives for Ins & Del.
  146.    Ctrl up/down arrows would have been more convenient to use, but these don't
  147. exist either on the XT keyboard... Ours is not etc.
  148.  
  149.  
  150.     Windows
  151.  
  152. CubiNaut is a DOS program. It runs happily under Windows 3.1, if run full-
  153. screen. It only needs a PIF if you have edited your _DEFAULT.PIF to make DOS
  154. programs run windowed by default (in which case you know how to make a PIF).
  155.  
  156.    QB0.ICO is provided, so you can fiddle with Properties in Program Manager
  157. and give CubiNaut its icon. It's nice!
  158.  
  159.  
  160.     The Values
  161.  
  162. The values CubiNaut displays for red, green, and blue range from 0 to 63 (3Fh)
  163. This corresponds to the way VGA colors are stored in the DAC registers, as
  164. accessed by int 10, ah = 10, al = 10/12/15/17 (all hex) and to values C library
  165. remap functions expect.
  166.    If you need R/G/B values in the range 0 - 255 (FFh), the way 24-bit graphics
  167. store their pixel colors, and 2/4/16/256 color BMP's store their palettes, or
  168. for Windows, then you should multiply by 4 (or shift << 2) the values CubiNaut
  169. gives you.
  170.  
  171.  
  172.     Epilog
  173.  
  174. This is an original creation of the mind, and as such copyright material under
  175. British law, and hence under international law (because of various treaties).
  176. The author reserves all rights to her creation. (c)'91-'94 Marijke van Gans,
  177. trading as silicon alley.
  178.  
  179.    CubiNaut is SHAREWARE, so anyone may copy it and pass it round, as long as
  180. you keep the complete package together when you do so: QB0.COM (program),
  181. QB0.ICO (icon), and QB0.DOC (documentation).
  182. This software is not to be sold or hired, but bona fide shareware distributors
  183. may levy a reasonable handling charge (send me your advert or catalog and you
  184. will be informed of all my programs and their upgrades when released).
  185.  
  186.    Try it out to your heart's content. If you decide to keep the program, you
  187. should pay for it. Any money you paid to a distributor was their handling fee,
  188. i don't get a penny of that. Price: 5 ECU, or Britain £4, Deutschland 10 DM,
  189. Éire £4, Nederland ƒ10, Nihon ¥600, USA $6, or equivalent in local currency.
  190.    If used for a business, government agency or other organisation, the maximum
  191. trial period is 59 calendar days, after which registration fees must be paid
  192. for each computer on which the software is to be used. Invoice on request.
  193.    Please send cash, international postal money order, or a cheque drawn on a
  194. British bank (an exotic cheque would cost more to cash than the $6). Or pay me
  195. via CompuServe: GO SWREG (should be available in a few days).
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.   QB0.DOC    ·    ·    ·    ·    ·    ·    ·    page 4
  203.  
  204. Benefits of registration include
  205.  
  206.  + a disk with the latest version (please mention whether you want 3½" or 5¼")
  207.  
  208.  + some more shareware to try out, on the same disk
  209.  
  210.  + good chance of having your suggestions included in next version
  211.  
  212.  + eternal support from the author herself (CompuServe, phone, and mail)
  213.  
  214.  + the right to run any future versions of CubiNaut
  215.  
  216.  
  217.     Credits
  218.  
  219. silicon alley software is lovingly handcrafted, using the finest development
  220. tools available on this planet, including
  221.  
  222.  * SemWare's QEdit (to write the source, and this doc)
  223.  
  224.  * Interrupt List, started by Janet Jack, current ed. Ralf Brown (a huge and
  225.    invaluable resource, and free to use)
  226.  
  227.  * Eric Isaacson's A86 assembler (used for all silicon alley library routines,
  228.    and for time-critical code)
  229.  
  230.  * Microsoft C (to compile the rest of the code, and link it all together)
  231.  
  232.  * ...and a great π486sx33 given to me by my brother & his wife.
  233.  
  234. All trademarks belong to their respective owners.
  235.  
  236.  
  237.         silicon alley
  238.  
  239.         CompuServe: 100345,2675
  240.         InterNet:   100345.2675@compuserve.com
  241.         Snail mail: P O Box 2799, London E9 7AW, England, Europe
  242.  
  243.