home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / graf / fantasy.zip / FANTASY.DOC < prev    next >
Text File  |  1988-01-17  |  13KB  |  295 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                                   Fantasy
  7.  
  8.                                 Version 2.0
  9.  
  10.                     Copyright 1987 by Natural Software
  11.                            19 South 5th. Street
  12.                         St. Charles Illinois 60174
  13.                               (312) 377-7320
  14.                             All Rights Reserved
  15.  
  16.  
  17.  
  18.                              January 17, 1988
  19.  
  20.  
  21.  
  22.  
  23.  
  24.                             Equipment required:
  25.                             -------------------
  26.  
  27.    -    IBM compatible PC, XT, AT with IBM compatible Color Graphics
  28.         Display Adapter and (preferably) a color display. Fantasy writes
  29.         directly to the graphics screen buffer for speed. It is therefore
  30.         not compatible with other display adapters such as the Hercules
  31.         standard.
  32.  
  33.    -    MicroSoft compatible mouse, with either MOUSE.SYS or MOUSE.COM
  34.         loaded. (Fantasy will run without the mouse, and you can cause
  35.         movement with the cursor keys -- but it just isn't the same.)
  36.  
  37.  
  38.                              What is Fantasy?
  39.                              ----------------
  40.  
  41.    -    Quick summary: fantasy creates flowing graphic images on your
  42.                        display as you move your mouse.
  43.  
  44. If art can be fleeting, transitory and personal -- then Fantasy is an
  45. artist's tool, and you are the artist, and you are the audience.
  46.  
  47. Fantasy is a tool for personal performance art. Like building sand castles
  48. or blowing bubbles, each performance is different and highly personal.
  49.  
  50. Fantasy lets you control a variety of pleasing and sometimes hypnotic
  51. images on your graphic display. As you move the mouse the image constantly
  52. moves and responds in never-ending, never-repeating animated sequences.
  53.  
  54.  
  55.                             How to use Fantasy:
  56.                             -------------------
  57.  
  58. Simply run FANTASY.EXE. An initial display will show a list of valid
  59. commands and the keys used to evoke them:
  60.  
  61.                   |--------------------------------------------|
  62.                   | Copyright 1987 by Michael Allen            |
  63.                   | Move the mouse for some action             |
  64.                   | [right button] = change color              |
  65.                   | [left  button] = end effect                |
  66.                   | [both buttons] = change effect             |
  67.                   | [F1] help           [F2] color             |
  68.                   | [F3] cursor off/on  [F4] change cursor     |
  69.                   | [F5] record file    [F6] replay file       |
  70.                   | [F7] erase off/on     [F8] sound on/off    |
  71.                   | [Shift F1] Scroll-1   [Shift F2] Scroll-2  |
  72.                   | [Esc] stop effect     [F10] Exit           |
  73.                   | -------------- Effects ---------------     |
  74.                   | [V] Centered Boxes    [B] Boxes            |
  75.                   | [R] Rectangles        [L] Lines            |
  76.                   | [H] Move Home         [C] Circles          |
  77.                   | [M] Multi-Lines       [F] Free lines       |
  78.                   | Enter a number to change box size          |
  79.                   |--------------------------------------------|
  80.  
  81.  
  82. The keys and their effects are as follows:
  83.  
  84.    [B] Boxes           constant sized square boxes
  85.    [C] Circles         circles
  86.    [F] Free lines      line length depends on cursor movement lines seem to
  87.                        follow your movement.
  88.    [V] Vert boxes      rectangles remain centered around orig. cursor
  89.                        position
  90.    [L] Lines           normal lines
  91.    [M] Multi-Lines     lets you start new origin with Enter key (Left
  92.                        Button)
  93.    [R] Rectangles      normal rectangles
  94.  
  95.    [F5]                enter filename to record your performance
  96.    [F6]                enter filename to playback recorded performance
  97.    [F7]                toggle erase (xor) graphics effect
  98.    [F8]                toggle sound - pitch is determined by cursor
  99.                        position
  100.    [Shift F1]          scroll full screen up
  101.    [Shift F2]          scroll top and bottom half of screen toward center
  102.  
  103.  
  104. To start the action press any key on your keyboard. Then move your mouse
  105. and keep it moving slow and steady to get the idea. You should see the
  106. initial square mouse cursor shape move in response to the mouse, creating a
  107. snaking trail moving off the top of the display. When you stop moving the
  108. mouse, animation stops. The idea is to "conduct" the performance by
  109. constantly moving in small or large sweeping curves.
  110.  
  111. You can re-display the initial help screen by pressing the [F1] key
  112. (without moving the mouse).
  113.  
  114.  
  115.                             Alternative method:
  116.                             -------------------
  117.  
  118. You can also run FANTASY.EXE with an optional command line argument to
  119. specify a command file or list of files. This method causes Fantasy to
  120. automatically run a pre-recorded performance. For example to automatically
  121. run the two command files: DEMO1 and DEMO2, type:
  122.  
  123.                        FANTASY DEMO1 DEMO2 [ENTER]
  124.  
  125.  
  126.                               Special effects
  127.                               ---------------
  128.  
  129. You turn on one of the special effects by pressing the key letter for that
  130. effect. For example press [B] to start the Box effect.
  131.  
  132. The Box effect: press [B] to start the box effect. This causes a square box
  133. to be drawn as the mouse is moved. Initially, the size of the box is eight
  134. pixels. You can change this size by: 
  135.  
  136.         1.   press [Esc] to end the current effect.
  137.         2.   enter the new size using the number keys. For example enter
  138.              [48] to change the box size to 48 pixels.
  139.         3.   return to the box effect by pressing [B].
  140.         4.   Then return to a lower scroll increment value by pressing the
  141.              number keys: [4] for instance.
  142.  
  143.  
  144. The Rectangle effect: press [R] to start the rectangle effect. This draws
  145. rectangles of varying size originating from the position of the mouse
  146. cursor when the effect was started, moving to the new mouse position as you
  147. move.
  148.  
  149. The Circle effect: press [C] to start the circle effect. This draws circles
  150. of varying size with their center at the position of the mouse cursor when
  151. the effect was started. Their diameter is changed as you move the mouse.
  152.  
  153. The Line effect: press [L] to start the line effect. This draws a sequence
  154. of lines starting from the position of the mouse cursor when the effect was
  155. started, moving to the new mouse position as you move.
  156.  
  157. The Multi-Line effect: press [M] to start the Multi_line effect. This is
  158. similar to the line effect, except that you can change the origin point by
  159. pressing the mouse left button. Each time you press the left button line
  160. drawing starts from that new position.
  161.  
  162. The Free lines: press [F] to start the Free lines effect. This draws a
  163. short line (depending on how fast you move the mouse) that seems to follow
  164. the mouse movement like a tail. This effect is most effective with the
  165. mouse cursor off.
  166.  
  167.  
  168.                              Switching Effects
  169.                              -----------------
  170.  
  171. To end one effect and start a new one, press the [Esc] key, then press the
  172. selection key for the new effect.
  173.  
  174. Another way to switch: press both mouse buttons to switch from one effect
  175. to another in sequence without needing to exit. This allows a more seamless
  176. transition from one effect to the next in your performance. This method
  177. will not get you into the Multi-Line effect, but if you start with the
  178. Multi-Line effect then press both mouse buttons you will eventually return
  179. to it.  
  180.  
  181.  
  182.                              The mouse cursor
  183.                              ----------------
  184.  
  185. Turning off the mouse cursor: Some effects appear better with the mouse
  186. cursor turned off. To turn it off:
  187.  
  188.         1.   press [Esc] to end the current effect.
  189.         2.   press [F3] to turn the mouse cursor off.
  190.  
  191. You can turn the mouse cursor back on by repeating the above steps.
  192.  
  193. Changing the mouse cursor: there are currently three cursor shapes: The
  194. initial square box cursor, a cross cursor and a diagonal cross with arrows.
  195. You change to a new shape by:
  196.  
  197.         1.   press [Esc] to end the current effect.
  198.         2.   press [F4] to turn the change to a new mouse cursor shape.
  199.  
  200.  
  201.                                Screen Color
  202.                                ------------
  203.  
  204. Fantasy uses the Color Graphics Adapter's high resolution mode of 640 by
  205. 200 pixels. In this mode the background is always black, but you can change
  206. the foreground color to one of the 16 possible by either:
  207.  
  208.         1.   press the [F2] key, or
  209.         2.   press the mouse right button.
  210.  
  211. This works even while a special effect is on.
  212.  
  213.  
  214.                             Recording to a File
  215.                             -------------------
  216.  
  217. To save (record) your fantasy performance for later playback, press the
  218. [F5] key. You will be asked to enter a filename. Enter any valid filename
  219. with optional drive and path designation. (It will overwrite any existing
  220. files with the same name in the same path, so be careful.) From that point
  221. on, each keystroke and mouse movement will be saved in that file. To stop
  222. recording, type: [%] (shifted 5). This is the special character to
  223. terminate recording (it is placed in the file to terminate the playback
  224. also).
  225.  
  226.  
  227.                          Playing back from a File
  228.                          ------------------------
  229.  
  230. To begin playing back a performance from a file recorded as described
  231. above, press the [F6] key and enter the filename (drive and path optional)
  232. of a valid performance file. The keystrokes and mouse movements stored in
  233. the file will begin being executed just as they were recorded. The only
  234. difference is that the timing between events is regular and static. This
  235. allows you to compose your performance files slowly and carefully -- they
  236. will be played back fast and snappy.
  237.  
  238.                               Ending Fantasy
  239.                               --------------
  240.  
  241.         1.   press [Esc] to end the current effect.
  242.         2.   press [F10] to exit and return to DOS.
  243.  
  244.         
  245.                             Genesis of Fantasy
  246.                             ------------------
  247.  
  248. You may find it interesting: The fantasy program is the result of a simple
  249. error made while debugging a new graphics program. This new program called
  250. PC-Draft III is an object oriented CAD drafting program which will be
  251. similar to our PC-Draft II product which is a pixel based drafting program.
  252. In the course of debugging, a trace message inadvertently caused the
  253. graphics display to scroll each time the cursor was moved. This caused
  254. effects similar to what you see with Fantasy. We found ourselves delighted
  255. with some of the effects, playing with them for hours. We have no idea
  256. whether this will have the same impact on others, or whether this
  257. phenomenon is strictly personal -- perhaps because it is our own
  258. programming effort. 
  259.  
  260.  
  261.                              Status of Fantasy
  262.                              -----------------
  263.  
  264. The Fantasy program is protected by copyright. It is not to be resold or
  265. used for any commercial purpose or included with any other product or
  266. software collection without our permission. It is being distributed as
  267. shareware. This means that you are granted the right to freely use Fantasy
  268. and to make copies for your friends.
  269.  
  270. The shareware philosophy is to pay smaller amounts for well crafted and
  271. useful software from developers who cannot spend the millions of dollars on
  272. marketing necessary to compete with the large software development
  273. companies. You benefit by being able to try a wider variety of software
  274. products to find the ones that suit your particular purpose. And the trial
  275. is free. The shareware developer benefits from being able to distribute his
  276. work to a wider audience than would be possible through normal channels.
  277.  
  278. Your share of the responsibility for shareware to continue, and to support
  279. the development of more and better products is to distribute your shareware
  280. programs to others and become a registered user of those products you like
  281. and use. 
  282.  
  283. If you want register your copy of Fantasy or to use Fantasy in a commercial
  284. environment (not for your non-business personal use) you can obtain a
  285. license:
  286.  
  287.              Send: $20.00 to:    
  288.  
  289.                        Natural Software
  290.                        19 South 5th. Street
  291.                        St. Charles, Illinois 60174
  292.  
  293. If you would like information on our other products, specifically PC-Draft
  294. II, or would like to order with your VISA or Master Card, call: (312) 377-
  295. 7320