home *** CD-ROM | disk | FTP | other *** search
-
-
-
-
- MUSIC CODES and SOUND CODES REFERENCE
-
- Below is a reference listing of MUSIC CODES and SOUND CODES
- available. For information on how to use the "Music String
- Syntax", consult the user's manual (file: ANSIPLAY.DOC).
-
- MUSIC CODE SYNTAX: ESC[MF <music codes or sound codes)> (music note)
- or ESC[MB <music codes or sound codes)> (music note)
-
- OCTAVES AND TONES
- -----------------
- A-G Plays A, B, ..., G in current octave
- # or + After the note specifies sharp
- - After the note specifies flat
- > Increases octave by 1. Octave cannot go beyond 6.
- >> Increases by 2 octaves, etc.
-
- < Decreases octave by 1. Octave cannot drop below 0.
- << Decreases by 2 octaves, etc.
-
- OCTAVE:
- On Sets current octave (0-6)
- Sets the current octave. There are seven octaves,
- numbered 0-6.
-
- NOTE:
- Nn Plays note n (0-84)
- The range for n is 0-84. In the seven possible
- octaves, there are 84 notes. When n = 0, this means a rest.
-
- *(Below is a listing of notes, both by MUSIC CODES and
- by SOUND CODES)
-
-
- TONE DURATION AND TEMPO
- -----------------------
- LENGTH:
- Ln Sets length of a note. (1-64)
- The range for n is 1-64. L 4 is a quarter note, L 1 is a
- whole note, etc.
-
- The length may also follow the note when a change of
- length only is desired for a particular note. For
- example,
- A 16 can be equivalent to L 16 A
-
- TEMPO:
- Tn Sets number of quarter notes per minute (32-255)
- The range for n is 32-255. The default for n is 120.
-
- Note: Because of the slow clock-interrupt rate, some notes
- will not play at higher tempos (L 64 at T 255, for
- example).
-
- MUSIC STACCATO:
- MS Sets "music staccato" so that each note will play 3/4 of
- the time determined by the length (L).
-
- -1-
-
-
-
-
-
-
- MUSIC NORMAL:
- MN Sets "music normal" so that each note will play 7/8 of
- the time determined by the length (L).
-
- MUSIC LEGATO:
- ML Sets "music legato" so that each note will play the full
- period set by length (L).
-
- PAUSE:
- Pn Pause for the duration of n quarternotes (1-64)
- Specifies a pause, ranging from 1-64. This option
- corresponds to the length of each note, set with Ln.
-
- DOT:
- . A period after a note causes the note to play 3/2 times
- the length determined by L (length) times T (tempo). The
- period has the same meaning as in a musical score.
-
- Multiple periods can appear after a note. Each period
- adds a length equal to one half the length of the previous
- period. For example,
- "A." plays 1 + 1/2 or 3/2 times the length
- "A.." plays 1 + 1/2 + 1/4 or 7/4 times the length.
-
- Periods can appear after a pause (P). In this case, the
- pause length is scaled in the same way notes are scaled.
-
- OPERATION
- ---------
- MUSIC FOREGROUND:
- MF Sets music/sound to run in foreground
-
- MUSIC BACKGROUND:
- MB Sets music/sound to run in background
-
- See the manual (ANSIPLAY.DOC) for more details on MF and MB.
-
- ========================================================
- LISTING OF TONES, both by MUSIC CODES and by SOUND CODES
- --------------------------------------------------------
-
- Example: The following codes will all yield the same tone...
-
- MUSIC CODE ESC[O0 C (music note)
- MUSIC CODE ESC[N1 (music note)
- SOUND CODE ESC[65.406;8 (music note)
-
-
- IBM HELMHOLTZ MUSIC SOUND
- OCTAVE NOTE NOTATION CODE (NOTE) = CODE (FREQUENCY)
- ------ ---------- --------- ------------- ----------------
- D#,E- 38.890
- E 41.204
- F 43.654
- F#,G- 46.250
- G 49.000
-
- -2-
-
-
-
-
-
-
-
- IBM HELMHOLTZ MUSIC SOUND
- OCTAVE NOTE NOTATION CODE (NOTE) = CODE (FREQUENCY)
- ------ ---------- --------- ------------- ----------------
- G#,A- 51.914
- A 55.000
- A#,B- 58.270
- B 61.736
- -------------------------------------------------------------
- 00 C CC N1 65.406
- C#,D- N2 69.296
- D N3 73.416
- D#,E- N4 77.782
- E N5 82.406
- F N6 87.308
- F#,G- N7 92.498
- G N8 97.998
- G#,A- N9 103.826
- A N10 110.000
- A#,B- N11 116.540
- B N12 123.470
- -------------------------------------------------------------
- 01 C C N13 130.812
- C#,D- N14 138.592
- D N15 146.832
- D#,E- N16 155.564
- E N17 164.821
- F N18 174.614
- F#,G- N19 185.000
- G N20 195.998
- G#,A- N21 207.660
- A N22 220.000
- A#,B- N23 233.080
- B N24 246.940
- -------------------------------------------------------------
- 02 C c N25 261.620
- C#,D- N26 277.180
- D N27 296.660
- D#,E- N28 311.120
- E N29 329.620
- F N30 349.220
- F#,G- N31 370.000
- G N32 392.000
- G#,A- N33 415.300
- A N34 440.000
- A#,B- N35 466.160
- B N36 493.880
- -------------------------------------------------------------
- 03 C c' (middle) N37 523.260
- C#,D- N38 554.360
- D N39 587.320
- D#,E- N40 622.260
- E N41 659.260
- F N42 698.460
- F#,G- N43 739.980
- G N44 784.000
- G#,A- N45 830.600
-
-
- -3-
-
-
-
-
-
-
- IBM HELMHOLTZ MUSIC SOUND
- OCTAVE NOTE NOTATION CODE (NOTE) = CODE (FREQUENCY)
- ------ ---------- --------- ------------- ----------------
- A N46 880.000
- A#,B- N47 892.320
- B N48 987.760
- -------------------------------------------------------------
- 04 C c'' N49 1046.500
- default C#,D- N50 1108.740
- octave D N51 1174.660
- D#,E- N52 1244.500
- E N53 1318.520
- F N54 1396.920
- F#,G- N55 1479.980
- G N56 1567.980
- G#,A- N57 1661.220
- A N58 1760.000
- A#,B- N59 1864.660
- B N60 1975.540
- -------------------------------------------------------------
- 05 C c''' N61 2093.000
- C#,D- N62 2217.400
- D N63 2349.400
- D#,E- N64 2489.000
- E N65 2637.000
- F N66 2793.800
- F#,G- N67 2960.000
- G N68 3136.000
- G#,A- N69 3322.400
- A N70 3520.000
- A#,B- N71 3729.400
- B N72 3951.000
- -------------------------------------------------------------
- 06 C c'''' N73 4186.000
- C#,D- N74 4435.000
- D N75 4698.600
- D#,E- N76 4978.000
- E N77 5274.000
- F N78 5587.600
- F#,G- N79 5920.000
- G N80 6272.000
- G#,A- N81 6644.800
- A N82 7040.000
- A#,B- N83 7458.600
- B N84 7902.200
- -------------------------------------------------------------
- C cv - 8372.000
- C#,D- - 8869.800
- D - 9397.200
- D#,E- - 9956.000
- E - 10548.000
- F - 11175.400
- F#,G- - 11839.800
- G - 12543.800
- G#,A- - 13289.800
- A - 14080.000
-
-
- -4-
-
-
-
-
-
-
- IBM HELMHOLTZ MUSIC SOUND
- OCTAVE NOTE NOTATION CODE (NOTE) = CODE (FREQUENCY)
- ------ ---------- --------- ------------- ----------------
- A#,B- - 14917.200
- B - 15804.200
- -------------------------------------------------------------
- C - 16744.000
- C#,D- - 17739.600
- D - 18794.600
- D#,E- - 19912.200
- E - 21096.200
- F - 22350.600
- F#,G- - 23679.600
- G - 25083.800
- G#,A- - 26579.400
- A - 28160.000
- A#,B- - 29834.400
- B - 31608.600
-
- =============================================================
-
-
- SOUND CODES REFERENCE
-
-
- SOUND CODE SYNTAX:
-
- ESC[MF <FREQ; DURA; CYCLES; DELAY; VARI> (music note)
-
- FREQUENCY : a numeric value from 37 to 32,767
- Frequency is the desired frequency in hertz.
-
- DURATION : an numberic value from 0 to 65,535
- Duration is how long the tone should play, measured
- in clock ticks. There are 18.2 clock ticks per second
- regardless of CPU speed.
-
- CYCLES (optional) : an integer from 0 to 9,999
- Cycles is the number of times to repeat the
- frequency/duration.
-
- DELAY (optional) : an integer from 0 to 999,999,999
- Delay is the length of pause between cycles.
- ANSIPLAY will count from 0 to DELAY before proceeding.
-
- VARIATION (optional): an numeric value from -9,999 to 9,999
- Variation will change the FREQUENCY each time the tone
- is repeated using the CYCLES variable. FREQUENCY will
- use it's current value, add the VARIATION value to
- itself (per cycle) to get a new FREQUENCY, then play
- the new FREQUENCY.
-
-
- * Note: also see the file ANSICODE.TXT for a listing of
- ANSI escape control codes.
-
- -5-
-
- --end of documentation--
-