home *** CD-ROM | disk | FTP | other *** search
/ 17 Bit Software 3: The Continuation / 17-Bit_The_Continuation_Disc.iso / files / 2432.dms / 2432.adf / PINKNOISE / PINKnoise.doc < prev    next >
Text File  |  1992-12-16  |  3KB  |  103 lines
  1.  
  2.                       PINKnoise V1.00 - by /\/ / /-<
  3.                          CreationDate: 17-Dec-1992
  4.  
  5.  
  6. Do you need a multitasking compliant, compact, stable, configurable,
  7. flexible and documented, pink noise generator for your Amiga?
  8. you need PINKnoise!
  9.  
  10.  
  11. FOREWORD
  12.  
  13. I directly used the hardware to generate the noise, because sometimes
  14. audio.device hangs if some program steals a channel using Paula registers.
  15. This may ensure program's reliability as all ph utilities I have seen don't
  16. use audio.device.
  17.  
  18. This program has been tested only on a vanilla A500 + HD & Fastram under
  19. kickstart 1.3 and 2.0.
  20.  
  21.  
  22. USAGE
  23.  
  24. Usage of the program is quite intuitive: run it before every other
  25. program, to stop noise hit the close gadget.
  26.  
  27. This is a CLI based application even if you can also execute it from WB.
  28. I designed this program to be pure, so feel free to resident it.
  29.  
  30. Valid CLI arguments are the "?" (question mark) and digits from 0 to 3.
  31. The parser is a little poor: it will scan the command line until a digit
  32. between 0 and 3 is found, so 
  33. > PINKnoise channel 825 Amiga is great!
  34. is a valid command line to enable channel 2.
  35.  
  36. I picked channel #3 as default one because programmers usually use channels
  37. 0 and 1, so the pink noise can be directly mixed with tones.
  38. Usually this works, but I cannot guarantee that other programmers correctly
  39. use Paula's registers.
  40.  
  41.  
  42. RETURNCODES
  43.  
  44. 21 = no intuition.library.
  45. Cause: you are running under kickstart 1.0 or 1.1
  46. You have to upgrade your system software
  47.  
  48. 22 = workbench screen is closed
  49. Cause: attempt to open a workbench window failed
  50. You have to re-open the workbench
  51.  
  52. 23 = no graphics.library
  53. Cause: you are running under kickstart 1.0 or 1.1
  54. You have to upgrade your system software
  55.  
  56. 24 = can't open window
  57. Cause: workbench screen is closes or there's not enough chip memory
  58. You have to re-open workbench and close some chip ram consuming application
  59.  
  60. 25 = no dos.library
  61. Cause: you are running under kickstart 1.0 or 1.1
  62. You have to upgrade your system software
  63.  
  64.  
  65. TO-DO
  66.  
  67. * Could be useful to change tone's frequency (hard to implement. any idea?)
  68. * WB hack is too quick, I hope it works. I will not revise it unless
  69.   there are no problems.
  70.  
  71. BUGS
  72.  
  73. Direct Paula's registers usage may hang some audio.device based
  74. application.
  75.  
  76.  
  77. DISCLAIMER
  78.  
  79. I wrote this package for study purposes, I am not responsible of the
  80. results of the use of the package.
  81. This package is provided "as is", without warranty of any kind, either
  82. expressed or implied.
  83. Should the package prove defective, you assume the entire cost of all
  84. necessary servicing, repair or correction even if I have been advised of
  85. the possibility of such damages.
  86.  
  87.  
  88. SUPPORT
  89.  
  90. Support bbs for this program is: Digital (sysop LuxGraph) ++39-543-918361
  91.  
  92. If you like this program, then let me know dropping an E-Mail to:
  93. Nicola.Soggia@p3.f315.n331.z2.fidonet.org
  94.  
  95. Hey lame_asses out there! I know you are waiting to disassemble my program.
  96. You poor loozers are lucky this time. Christmas spirit is in me: look in
  97. the archive for the source code (and understand what real coders are).
  98.  
  99. Have phun,
  100.  
  101. /\/ / /-<
  102.  
  103.