PINKnoise V1.00 - by /\/ / /-<
                         CreationDate: 17-Dec-1992


Do you need a multitasking compliant, compact, stable, configurable,
flexible and documented, pink noise generator for your Amiga?
you need PINKnoise!


FOREWORD

I directly used the hardware to generate the noise, because sometimes
audio.device hangs if some program steals a channel using Paula registers.
This may ensure program's reliability as all ph utilities I have seen don't
use audio.device.

This program has been tested only on a vanilla A500 + HD & Fastram under
kickstart 1.3 and 2.0.


USAGE

Usage of the program is quite intuitive: run it before every other
program, to stop noise hit the close gadget.

This is a CLI based application even if you can also execute it from WB.
I designed this program to be pure, so feel free to resident it.

Valid CLI arguments are the "?" (question mark) and digits from 0 to 3.
The parser is a little poor: it will scan the command line until a digit
between 0 and 3 is found, so 
> PINKnoise channel 825 Amiga is great!
is a valid command line to enable channel 2.

I picked channel #3 as default one because programmers usually use channels
0 and 1, so the pink noise can be directly mixed with tones.
Usually this works, but I cannot guarantee that other programmers correctly
use Paula's registers.


RETURNCODES

21 = no intuition.library.
Cause: you are running under kickstart 1.0 or 1.1
You have to upgrade your system software

22 = workbench screen is closed
Cause: attempt to open a workbench window failed
You have to re-open the workbench

23 = no graphics.library
Cause: you are running under kickstart 1.0 or 1.1
You have to upgrade your system software

24 = can't open window
Cause: workbench screen is closes or there's not enough chip memory
You have to re-open workbench and close some chip ram consuming application

25 = no dos.library
Cause: you are running under kickstart 1.0 or 1.1
You have to upgrade your system software


TO-DO

* Could be useful to change tone's frequency (hard to implement. any idea?)
* WB hack is too quick, I hope it works. I will not revise it unless
  there are no problems.

BUGS

Direct Paula's registers usage may hang some audio.device based
application.


DISCLAIMER

I wrote this package for study purposes, I am not responsible of the
results of the use of the package.
This package is provided "as is", without warranty of any kind, either
expressed or implied.
Should the package prove defective, you assume the entire cost of all
necessary servicing, repair or correction even if I have been advised of
the possibility of such damages.


SUPPORT

Support bbs for this program is: Digital (sysop LuxGraph) ++39-543-918361

If you like this program, then let me know dropping an E-Mail to:
Nicola.Soggia@p3.f315.n331.z2.fidonet.org

Hey lame_asses out there! I know you are waiting to disassemble my program.
You poor loozers are lucky this time. Christmas spirit is in me: look in
the archive for the source code (and understand what real coders are).

Have phun,

/\/ / /-<