home *** CD-ROM | disk | FTP | other *** search
/ BCI NET 2 / BCI NET 2.iso / archives / misc / ldi.lha / LDI.doc next >
Encoding:
Text File  |  1995-03-13  |  7.0 KB  |  205 lines
  1.       'Lucid Dream Inducer' V1.08 - A program for Amiga computers
  2.  
  3.                    Copyright © 1993-1995 by Tero Auvinen
  4.                        E-Mail: tauvinen@aton.abo.fi
  5.  
  6.  
  7.                  Read the whole documentation before using!
  8.                  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  9.  
  10.  
  11. 1. Legal things
  12. ===============
  13.  
  14. Copyright:
  15.  
  16. 'Lucid Dream Inducer' (LDI) is a *mailware* program. You are required send me
  17. e-mail if you use this program frequently!!! Permission is granted to freely
  18. distribute this program without ANY profit (except for some reasonable media
  19. fee). The program may not be altered in any way and *cannot* be used for com-
  20. mercial purposes in any situation.
  21.  
  22. Warranty:
  23.  
  24. I hereby reject any liability or responsibility for these or any other direct
  25. /indirect consequences from the use of LDI whatsoever. This includes, but is
  26. not limited to, damage to your equipment, damage to your data, personal inju-
  27. ries, financial loss or any other kinds of side-effects. It is your responsi-
  28. bility to take any precautions necessary to protect yourself from these or 
  29. any other effects.
  30.  
  31. If the laws of your country or territory state that I am responsible of any-
  32. thing mentioned above, you may not use or distribute this program.
  33.  
  34.  
  35. 2. What is 'Lucid Dream Inducer'?
  36. =================================
  37.  
  38. LDI (Lucid Dream Inducer) is a program designed to affect your dreams, and 
  39. by doing so, it may help you to have lucid dreams. LDI does this by either
  40. executing a program/script (for playing samples/speech) or for example flashing
  41. a LED thru the parallel port.
  42.  
  43.  
  44. 3. Requirements
  45. ===============
  46.  
  47. LDI requires Kickstart 2.0+ and ReqTools.library 37+(not included). And if
  48. you want to use LED-inducing you have to build a little bit of electronics
  49. into the parallel port.(read chapter "6. Bugs & more" for information about
  50. this) This program is written in a system friendly matter EXCEPT what comes
  51. to the parallel port handling, it bangs straight to the hardware...So, it
  52. might *not* work on A600, A1200 and up.
  53.  
  54.  
  55. 4. Installation
  56. ===============
  57.  
  58. Just copy the executable somewhere the along the path. Or if you want to,
  59. make a bootable disk which you can use on some old A500 :)
  60.  
  61. The program searches the prefs file from ENVARC:
  62. Remember to assign ENVARC: somewhere if you use bootable floppy!
  63.  
  64.  
  65. 5. Usage
  66. ========
  67.  
  68. If you want it to detach from cli, 'run >nil: <nil:' it. But beware, then you
  69. cannot see any of the possible DOS error messages that may occur when using
  70. the 'Command' cue mode!
  71.  
  72. -= LDI's main interface =-
  73.  
  74. Well, just move those sliders and you'll get the idea. Each slider changes some
  75. value which is on the same vertical level as the slider. Clicking in the contai-
  76. ner area of the gadget allows finer control of the values.
  77.  
  78. Slider gadgets:
  79. ~~~~~~~~~~~~~~~
  80. "Cue starts at"    - This is the time when LDI makes the first cue.
  81.  
  82. "Repat after..."   - These two settings define how many times and how
  83.                      often the cue is repeated.
  84.  
  85. "ON/OFF times"     - These two gadgets define the 'frequency' of which the
  86.                      dataline 0 on the parallel port toggles when making cue.
  87.                      These two settings affect only the 'Parallel' type cue.
  88.  
  89. "Number of cycles" - This setting defines how many 'ON/OFF' sequences
  90.                      are made per cue. This setting affects only the
  91.                      'Parallel' type cue.
  92.  
  93. Button gadgets:
  94. ~~~~~~~~~~~~~~~
  95. "Test"             - This button causes one COMPLETE cue to occur.
  96.  
  97.                      On the right side of the gadget you can see the approximate
  98.                      duration of the cue. If the approx. cue duration exceeds 
  99.                      the 'Repeat after' time, then your are going to get into 
  100.                      trouble. This also applies to the 'Command' type cues, but
  101.                      you have to evaluate the time that the command takes to 
  102.                      execute yourself.
  103.  
  104.  
  105. "Start/Stop"       - This button puts the program into waiting state until the
  106.                      time defined in "Cue starts at" takes place. This button
  107.                      also brings the program back from the waiting state.
  108.  
  109.                      On the right side of the gadget you can see the approximate
  110.                      overall duration of all the cues.
  111.  
  112.  
  113. Cycle gadget:      - This gadget defines the cue type, it has three states:
  114. ~~~~~~~~~~~~~
  115.                       'Parallel' When making cue, dataline 0 in parallel port
  116.                        is toggled.
  117.  
  118.                       'Command' When making cue, the 'command' from the string
  119.                        gadget is executed SYNCHRONOUSLY, so if the command 
  120.                        crashes or hangs LDI hangs too because it waits the 
  121.                        executed command to return.
  122.  
  123.                       'Both' When making cue, LDI makes BOTH cues,
  124.                       'Command' and 'Parallel', in that order!
  125.  
  126.  
  127. -= Menu items =-
  128.  
  129. Project
  130.  
  131.  o Load settings
  132.    - Loads settings from ENVARC:LDI.prefs
  133.  
  134.  o Save settings
  135.    - Saves current settings (including the position of the main window)
  136.      to ENVARC:LDI.prefs
  137.  
  138.  o About
  139.    - Displays some information about the program
  140.  
  141.  o Quit
  142.    - Just try it :)
  143.  
  144. Misc
  145.  
  146.  o Detect REM
  147.    - Not in use yet, but possibly will be in very near future!
  148.      John Thornley is currently working on REM-detecting circuit,
  149.      we'll just have to wait.
  150.  
  151.  
  152. -= Keys =-
  153.  
  154. Pressing 't' when LDI's window is activated, toggles the state of the
  155. Dataline 0.(To help you adjust the right brightness for the LED for example)
  156.  
  157. Pressing 'ESC' quits the program.
  158.  
  159.  
  160. 6. Bugs & more
  161. ==============
  162.  
  163. Known bugs:
  164. ~~~~~~~~~~~
  165. Sometimes when dragging sliders or selecting menus or GENERALLY doing
  166. something that causes intuimessages to arrive, an address error may occur.
  167. I really don't know what causes this, it might be a bug in my message handling
  168. routines or the E compiler could be messing something up.
  169.  
  170. Parallel port:
  171. ~~~~~~~~~~~~~~
  172. The program toggles 'dataline 0' when in 'Parallel' mode.
  173.  
  174. I've built a little circuit which consists of:
  175. 3 resistors, 1 transistor, 1 LED (red, 5mm diam.)
  176.  
  177. It's made up so that when dataline 0 goes HIGH, the transistor saturates and
  178. the LED lights up.
  179.  
  180. I have NOT included any schematics of this circuit, YET! I'll wait until the
  181. REM-detecting circuit is ready.
  182.  
  183. If you want to, you could build one yourself.
  184. BUT I'M NOT IN ANY WAY RESPONSIBLE IF YOU END UP WITH FRIED AMIGA!!!!
  185. READ THE CHAPTER "1.LEGAL THINGS"!!!
  186.  
  187. Misc info:
  188. ~~~~~~~~~~
  189. I've built a headset too, it's made from an old sunglasses :) I tried using
  190. swim-goggles too but they cause 'pressure' to my eyes, so they are somehow
  191. uncomfortable to use. And when I'm sleeping with the headset on, a wire goes
  192. from headset into the little circuit.
  193.  
  194.  
  195.     __/\__                                                          __/\__
  196.     \ oø /   Comments, suggestions and bug reports *are* welcome.   \ oø /
  197.     / \/ \            E-Mail: tauvinen@aton.abo.fi                  / \/ \
  198.     ¯¯\/¯¯                                                          ¯¯\/¯¯
  199.  
  200.  
  201. 7. History
  202. ==========
  203.  
  204. 1.08 - First public relese, problems with intuimessage handling(?!)
  205.