BEEP: system speaker beeps and tunes(H)

Bookmarks:

to
generate simple tones
on the system speaker.
- - BEEP(0) ! the system beep
- - BEEP(1) ! the "!" message beep
- - BEEP(2) ! the "i" message beep
- - BEEP(3) ! the "?" message beep
- - BEEP(4) ! the "X" message beep
to
compose tunes
:
- [bytes =] BEEP( tune [, tune_righthand] [, filename.wav] ) ! tune is a sequence of tones and control characters

optional control characters	valid for next tone of current channel only	example
space or new line	no effect	just to improve readability
any invalid option	pause	3x will pause for 3 tempo units
#	half tone increase	#G #g (G sharp followed by g sharp)
b	half tone decrease (b pitches are denoted by h)	bA bH (A flat, H flat)
"	1 octave increase of next tone
"	2 octave increase of next tone (combined " and " is possible);
1 - 99	tempo units of following note, default is = 1 (128 ms)	c 2d (c and d of length 2)
<n (n=0..99)	n = back n tempo units, next tone ends with current tone	4C <4c (chord Cc of length 4)

	extending to end of current string , if not changed again	example
Vn (n=0..9)	n = initial Volume for following tones (default 9)	V9v0 (decreasing loudnesses)
vm (m=0..9	m = final volume (n>m: decrease, n<m: increase)	V0v9 (increasing loudnesses)
on (n=0..9)	n = octaves above standard for following tones	o2 (2 octaves higher)
(	starts comment, used also to debug notations. Nesting is possible	BEEP("A (left hand)", "a (right hand)")
)	ends comment, default end is last character

	global to current statement , if not changed again	example
Tn (n=0..99)	n = 16 ms tempo units or base duration (default is 8 -> 128 ms)	T16 (shortest duration is 16*16 ms
Pxxxxxxxx	x = relative volume x (x=0..9) for up to 8 harmonics (global)	P901 (3rd harmonic loudness 1)
mono/stereo:	BEEP(monostring) / BEEP(leftstring, rightstring)

the following tones are available:
- C, D, E, F, G, A, H with A = 220/sec
- c, d, e, f, g, a, h with a = 440/sec
- 'c, 'd, 'e, 'f, 'g, 'a, 'h with 'a = 880/sec
- "c, "d, "e, "f, "g, "a, "h with "a = 1760/sec
- BEEP( "a" ) ! mono, "a" for 128 msec at 440/sec
- BEEP( "a", "A" ) ! stereo, "a" is right speaker/hand, "A" is left speaker/hand
- BEEP("_ggg 4be _fff 8d (Beethoven Symphony No. 5 opening motif, mono)")
- BEEP( % A a 'a "a % ) ! Here the % is delimited by %, since the standard delimiters ' and " are used as prefixes in the string itself ⇒ string delimiter.
- ! The tune is a sequence of 220 440 880 1760 Hz, spaces have no effect.
- BEEP( "$9 CEG", "ceg", "cegTriad.wav" ) ! 8 bit/5412 Hz stereo, file length 1920 byte, left channel/hand is CEG, right channel/hand is ceg
play wav_file
- BEEP(wav_file_name) ! to play a wave file
write wav_file
(see the "$n" option for hardware settings)
- BEEP(left_channel, right_channel, file_name ! save your stereo composition
- BEEP(mono_string, file_name ! write a mono composition
BEEP returns control to the script when Escape was pressed.
The "music.hic" demo shows a lot of possible techniques to generate tunes.

generate simple tones