-=+=- -=+=- -=+=- -=+=- -=+=- -=+=- -=+=- -=+=- -=+=- -=+=- -=+=- -=+=- -=+=- -=+=- -=+=- -=+=- -=+=- -=+=- -=+=- -=+=- -=+=- -=+=- -=+=- -=+=- -=+=- -=+=- -=+=- -=+=- -=+=- -=+=- (c) WidthPadding Industries 1987 0|448|0 -=+=- -=+=- -=+=- -=+=- -=+=- -=+=- -=+=- -=+=- -=+=- -=+=- -=+=- -=+=- -=+=- -=+=- -=+=- -=+=- -=+=- -=+=- -=+=- -=+=- -=+=- -=+=- -=+=- -=+=- -=+=- -=+=- -=+=- -=+=- -=+=- -=+=-

It's not exact yet, so though you can happily play with it, don't lock down anything, because I might tweak how it sounds/works in the next short while.

Currently the commands work like so..

NewSound "Sound Name"

SoundTone "Sound Name","wave type",Start Frequency, End Frequency, length of event, "event parameters"

where "wave type" = sine, sawtooth, square, triangle, noise, or brown
and "event type" =
Step : Makes the sound step from Start to End
Ramp : Makes the sound ramp smoothly

Loop : Causes the sound to loop between Start and End
Repeat : Takes the distance between Start and End and repeatedly adds (or subtracts) it until the sound ends.
Jump : Ramps from Start to End, then Steps back down.
Drop : Jumps from Start to End, then Steps back down.
(I think.. Or are those two the other way round?!)

and also
Time : Changes the length of event to being in seconds (otherwise it's 0.0-1.0 based on the length of the sound .. I couldn't think of a snappy name for that. Suggestions welcome)

You should | those together, eg "step|loop|time" or "ramp|repeat"

Next up is the SoundEnv command, which currently only does ADSR values.
SoundEnv "Sound Name", Attack, Decay, Sustain, Release

Attack = time in seconds that the sound should take to ramp from 0 to full
Decay = time in seconds that it then takes to reach the Sustain volume
Sustain = 0.0-1.0 volume
Release = time in seconds that it then takes until the volume reaches 0

And then, of course, there's a Sound command.

Sound "Sound Name", pitch (0.5 to about 4'ish), volume (0 to 1), pan (-1 to 1)

... That sound complicated enough for ya?!

Of course, that's with it doing 21 sounds per frame, and in real gameplay situations that "should" probably be a little less!
It's also "blowing out" the audio buffer a bit, due to there being so many sounds being played simultaneously, all over the top of each other, so I need to find a way to avoid that.

I really do need to do a lot of tweaks to this engine!!

  --v