Artifact 6ed39b268e1b789d9b29caed6709419483d54dff:
Wiki page
[
Muzic MIDI sound package] by
chw
2019-04-26 06:41:44.
0000: 44 20 32 30 31 39 2d 30 34 2d 32 36 54 30 36 3a D 2019-04-26T06:
0010: 34 31 3a 34 34 2e 34 31 39 0a 4c 20 4d 75 7a 69 41:44.419.L Muzi
0020: 63 5c 73 4d 49 44 49 5c 73 73 6f 75 6e 64 5c 73 c\sMIDI\ssound\s
0030: 70 61 63 6b 61 67 65 0a 50 20 63 65 38 62 34 63 package.P ce8b4c
0040: 62 38 34 61 34 32 62 63 65 61 32 65 38 37 62 61 b84a42bcea2e87ba
0050: 64 38 34 61 32 37 36 65 35 62 36 64 33 62 38 36 d84a276e5b6d3b86
0060: 39 34 0a 55 20 63 68 77 0a 57 20 32 31 33 34 0a 94.U chw.W 2134.
0070: 3c 68 32 3e 6d 75 7a 69 63 20 63 6f 6d 6d 61 6e <h2>muzic comman
0080: 64 3c 2f 68 32 3e 0d 0a 0d 0a 3c 68 33 3e 4e 61 d</h2>....<h3>Na
0090: 6d 65 3c 2f 68 33 3e 0d 0a 0d 0a 3c 62 3e 6d 75 me</h3>....<b>mu
00a0: 7a 69 63 3c 2f 62 3e 20 2d 20 61 20 4d 49 44 49 zic</b> - a MIDI
00b0: 20 73 6f 75 6e 64 20 70 61 63 6b 61 67 65 20 63 sound package c
00c0: 6f 6d 70 61 74 69 62 6c 65 20 77 69 74 68 20 3c ompatible with <
00d0: 61 20 68 72 65 66 3d 22 68 74 74 70 3a 2f 2f 77 a href="http://w
00e0: 69 6b 69 2e 74 63 6c 2e 74 6b 2f 31 34 36 35 32 iki.tcl.tk/14652
00f0: 22 3e 4d 75 7a 69 63 3c 2f 61 3e 2e 0d 0a 0d 0a ">Muzic</a>.....
0100: 3c 68 33 3e 53 79 6e 6f 70 73 69 73 3c 2f 68 33 <h3>Synopsis</h3
0110: 3e 0d 0a 0d 0a 3c 74 74 3e 70 61 63 6b 61 67 65 >....<tt>package
0120: 20 72 65 71 75 69 72 65 20 4d 75 7a 69 63 3c 2f require Muzic</
0130: 74 74 3e 3c 62 72 3e 0d 0a 3c 74 74 3e 6d 75 7a tt><br>..<tt>muz
0140: 69 63 3a 3a 3c 69 3e 73 75 62 63 6f 6d 6d 61 6e ic::<i>subcomman
0150: 64 3c 2f 69 3e 20 2e 2e 2e 3c 2f 74 74 3e 0d 0a d</i> ...</tt>..
0160: 0d 0a 3c 68 33 3e 44 65 73 63 72 69 70 74 69 6f ..<h3>Descriptio
0170: 6e 3c 2f 68 33 3e 0d 0a 0d 0a 3c 62 3e 6d 75 7a n</h3>....<b>muz
0180: 69 63 3c 2f 62 3e 20 69 73 20 61 20 54 63 6c 20 ic</b> is a Tcl
0190: 6d 75 73 69 63 20 69 6e 74 65 72 66 61 63 65 20 music interface
01a0: 74 6f 20 74 68 65 20 53 6f 6e 69 76 6f 78 20 4d to the Sonivox M
01b0: 49 44 49 20 72 65 6e 64 65 72 69 6e 67 20 28 73 IDI rendering (s
01c0: 6f 66 74 77 61 72 65 20 73 79 6e 74 68 65 73 69 oftware synthesi
01d0: 73 29 20 6c 69 62 72 61 72 79 20 6f 6e 20 41 6e s) library on An
01e0: 64 72 6f 69 64 2e 20 54 68 65 20 6f 72 69 67 69 droid. The origi
01f0: 6e 61 6c 20 70 61 63 6b 61 67 65 20 77 61 73 20 nal package was
0200: 64 65 76 65 6c 6f 70 65 64 20 62 79 20 53 74 65 developed by Ste
0210: 76 65 20 4c 61 6e 64 65 72 73 20 61 6e 64 20 69 ve Landers and i
0220: 73 20 43 6f 70 79 72 69 67 68 74 20 28 63 29 20 s Copyright (c)
0230: 32 30 30 35 20 45 6f 6c 61 73 20 54 65 63 68 6e 2005 Eolas Techn
0240: 6f 6c 6f 67 69 65 73 20 49 6e 63 2e 20 49 74 20 ologies Inc. It
0250: 69 73 20 72 65 6c 65 61 73 65 64 20 75 6e 64 65 is released unde
0260: 72 20 61 20 54 63 6c 2f 42 53 44 20 73 74 79 6c r a Tcl/BSD styl
0270: 65 20 6c 69 63 65 6e 73 65 2e 0d 0a 0d 0a 54 6f e license.....To
0280: 20 75 73 65 20 4d 75 7a 69 63 2c 20 6e 6f 20 73 use Muzic, no s
0290: 70 65 63 69 61 6c 20 70 72 6f 76 69 73 69 6f 6e pecial provision
02a0: 73 20 61 72 65 20 6e 65 65 64 65 64 2c 20 73 69 s are needed, si
02b0: 6e 63 65 20 69 74 20 69 73 20 66 75 6c 6c 79 20 nce it is fully
02c0: 69 6e 74 65 67 72 61 74 65 64 20 69 6e 20 5b 41 integrated in [A
02d0: 6e 64 72 6f 57 69 73 68 5d 2e 0d 0a 0d 0a 54 68 ndroWish].....Th
02e0: 65 20 4d 75 7a 69 63 20 41 50 49 20 63 6f 6e 74 e Muzic API cont
02f0: 61 69 6e 73 20 6a 75 73 74 20 66 69 76 65 20 70 ains just five p
0300: 72 6f 63 65 64 75 72 65 73 3a 0d 0a 0d 0a 3c 74 rocedures:....<t
0310: 74 3e 6d 75 7a 69 63 3a 3a 69 6e 69 74 3c 2f 74 t>muzic::init</t
0320: 74 3e 0d 0a 0d 0a 20 20 20 20 4d 75 73 74 20 62 t>.... Must b
0330: 65 20 63 61 6c 6c 65 64 20 6f 6e 63 65 20 74 6f e called once to
0340: 20 69 6e 69 74 69 61 6c 69 7a 65 20 61 75 64 69 initialize audi
0350: 6f 20 70 6c 61 79 62 61 63 6b 2e 0d 0a 0d 0a 3c o playback.....<
0360: 74 74 3e 6d 75 7a 69 63 3a 3a 73 6f 75 6e 64 66 tt>muzic::soundf
0370: 6f 6e 74 20 3c 2f 69 3e 66 69 6c 65 3c 2f 69 3e ont </i>file</i>
0380: 3c 2f 74 74 3e 0d 0a 0d 0a 20 20 20 20 54 68 69 </tt>.... Thi
0390: 73 20 63 6f 6d 6d 61 6e 64 20 65 78 69 73 74 73 s command exists
03a0: 20 66 6f 72 20 63 6f 6d 70 61 74 69 62 69 6c 69 for compatibili
03b0: 74 79 20 77 69 74 68 20 74 68 65 20 6f 72 69 67 ty with the orig
03c0: 69 6e 61 6c 20 70 61 63 6b 61 67 65 2e 20 49 74 inal package. It
03d0: 20 63 61 6e 20 62 65 20 63 61 6c 6c 65 64 20 77 can be called w
03e0: 69 74 68 20 6e 6f 20 61 72 67 75 6d 65 6e 74 73 ith no arguments
03f0: 20 6f 72 20 77 69 74 68 20 3c 74 74 3e 62 75 69 or with <tt>bui
0400: 6c 74 69 6e 3c 2f 74 74 3e 2e 20 45 76 65 72 79 ltin</tt>. Every
0410: 74 68 69 6e 67 20 65 6c 73 65 20 74 68 72 6f 77 thing else throw
0420: 73 20 61 6e 20 65 72 72 6f 72 20 73 69 6e 63 65 s an error since
0430: 20 74 68 65 20 41 6e 64 72 6f 69 64 20 73 6f 66 the Android sof
0440: 74 77 61 72 65 20 73 79 6e 74 68 65 73 69 7a 65 tware synthesize
0450: 72 20 68 61 73 20 6e 6f 20 73 75 70 70 6f 72 74 r has no support
0460: 20 66 6f 72 20 53 6f 75 6e 64 46 6f 6e 74 20 66 for SoundFont f
0470: 69 6c 65 73 2e 0d 0a 0d 0a 3c 74 74 3e 6d 75 7a iles.....<tt>muz
0480: 69 63 3a 3a 63 68 61 6e 6e 65 6c 20 3c 69 3e 63 ic::channel <i>c
0490: 68 61 6e 6e 65 6c 20 69 6e 73 74 72 75 6d 65 6e hannel instrumen
04a0: 74 3c 2f 69 3e 3c 2f 74 74 3e 0d 0a 0d 0a 20 20 t</i></tt>....
04b0: 20 20 41 73 73 69 67 6e 73 20 61 6e 20 69 6e 73 Assigns an ins
04c0: 74 72 75 6d 65 6e 74 20 74 6f 20 61 20 63 68 61 trument to a cha
04d0: 6e 6e 65 6c 2e 20 3c 74 74 3e 3c 69 3e 63 68 61 nnel. <tt><i>cha
04e0: 6e 6e 65 6c 3c 2f 69 3e 3c 2f 74 74 3e 20 69 73 nnel</i></tt> is
04f0: 20 61 6e 20 69 6e 74 65 67 65 72 20 20 66 72 6f an integer fro
0500: 6d 20 30 20 74 6f 20 31 35 20 69 64 65 6e 74 69 m 0 to 15 identi
0510: 66 79 69 6e 67 20 74 68 65 20 4d 49 44 49 20 63 fying the MIDI c
0520: 68 61 6e 6e 65 6c 2e 20 3c 74 74 3e 3c 69 3e 69 hannel. <tt><i>i
0530: 6e 73 74 72 75 6d 65 6e 74 3c 2f 74 74 3e 20 69 nstrument</tt> i
0540: 73 20 74 68 65 20 69 6e 73 74 72 75 6d 65 6e 74 s the instrument
0550: 20 6e 75 6d 62 65 72 2c 20 74 79 70 69 63 61 6c number, typical
0560: 6c 79 20 61 20 4d 49 44 49 20 69 6e 73 74 72 75 ly a MIDI instru
0570: 6d 65 6e 74 20 6e 75 6d 62 65 72 20 66 72 6f 6d ment number from
0580: 20 30 20 74 6f 20 31 32 37 2e 0d 0a 0d 0a 3c 74 0 to 127.....<t
0590: 74 3e 6d 75 7a 69 63 3a 3a 70 6c 61 79 6e 6f 74 t>muzic::playnot
05a0: 65 20 3c 69 3e 63 68 61 6e 6e 65 6c 20 70 69 74 e <i>channel pit
05b0: 63 68 20 76 6f 6c 75 6d 65 20 3f 64 75 72 61 74 ch volume ?durat
05c0: 69 6f 6e 3f 3c 2f 69 3e 3c 2f 74 74 3e 0d 0a 0d ion?</i></tt>...
05d0: 0a 20 20 20 20 50 6c 61 79 73 20 61 20 6e 6f 74 . Plays a not
05e0: 65 20 6f 6e 20 73 70 65 63 69 66 69 65 64 20 3c e on specified <
05f0: 74 74 3e 3c 69 3e 63 68 61 6e 6e 65 6c 3c 2f 69 tt><i>channel</i
0600: 3e 3c 2f 74 74 3e 2c 20 61 74 20 73 70 65 63 69 ></tt>, at speci
0610: 66 69 65 64 20 3c 74 74 3e 3c 69 3e 70 69 74 63 fied <tt><i>pitc
0620: 68 3c 2f 69 3e 3c 2f 74 74 3e 20 61 6e 64 20 3c h</i></tt> and <
0630: 74 74 3e 3c 69 3e 76 6f 6c 75 6d 65 3c 2f 69 3e tt><i>volume</i>
0640: 3c 2f 74 74 3e 2e 20 54 68 65 20 70 69 74 63 68 </tt>. The pitch
0650: 20 69 73 20 74 68 65 20 72 61 77 20 4d 49 44 49 is the raw MIDI
0660: 20 70 69 74 63 68 2c 20 61 73 20 70 65 72 20 74 pitch, as per t
0670: 68 65 20 67 65 6e 65 72 61 6c 20 6d 69 64 69 20 he general midi
0680: 73 74 61 6e 64 61 72 64 20 2d 20 77 68 65 72 65 standard - where
0690: 20 6d 69 64 64 6c 65 20 43 20 69 73 20 36 30 20 middle C is 60
06a0: 28 73 65 65 20 3c 61 20 68 72 65 66 3d 22 68 74 (see <a href="ht
06b0: 74 70 3a 2f 2f 77 77 77 2e 6d 6f 7a 61 72 74 2e tp://www.mozart.
06c0: 63 6f 2e 75 6b 2f 69 6e 66 6f 72 6d 61 74 69 6f co.uk/informatio
06d0: 6e 2f 61 72 74 69 63 6c 65 73 2f 6d 69 64 69 6e n/articles/midin
06e0: 6f 74 65 2e 68 74 6d 22 3e 68 74 74 70 3a 2f 2f ote.htm">http://
06f0: 77 77 77 2e 6d 6f 7a 61 72 74 2e 63 6f 2e 75 6b www.mozart.co.uk
0700: 2f 69 6e 66 6f 72 6d 61 74 69 6f 6e 2f 61 72 74 /information/art
0710: 69 63 6c 65 73 2f 6d 69 64 69 6e 6f 74 65 2e 68 icles/midinote.h
0720: 74 6d 3c 2f 61 3e 20 77 68 69 63 68 20 68 61 73 tm</a> which has
0730: 20 61 20 74 61 62 6c 65 20 6f 66 20 4d 49 44 49 a table of MIDI
0740: 20 70 69 74 63 68 20 76 61 6c 75 65 73 29 2e 20 pitch values).
0750: 3c 74 74 3e 3c 69 3e 76 6f 6c 75 6d 65 3c 2f 69 <tt><i>volume</i
0760: 3e 3c 2f 74 74 3e 20 69 73 20 61 20 6e 75 6d 62 ></tt> is a numb
0770: 65 72 20 62 65 74 77 65 65 6e 20 30 20 61 6e 64 er between 0 and
0780: 20 31 30 30 2e 20 3c 74 74 3e 3c 69 3e 64 75 72 100. <tt><i>dur
0790: 61 74 69 6f 6e 3c 2f 69 3e 3c 2f 74 74 3e 20 69 ation</i></tt> i
07a0: 73 20 6f 70 74 69 6f 6e 61 6c 2c 20 61 6e 64 20 s optional, and
07b0: 64 65 66 61 75 6c 74 73 20 74 6f 20 35 30 30 20 defaults to 500
07c0: 28 69 2e 65 2e 20 35 30 30 20 6d 73 29 2e 20 49 (i.e. 500 ms). I
07d0: 66 20 61 20 6e 65 67 61 74 69 76 65 20 64 75 72 f a negative dur
07e0: 61 74 69 6f 6e 20 69 73 20 67 69 76 65 6e 2c 20 ation is given,
07f0: 74 68 65 20 6e 6f 74 65 20 69 73 20 70 6c 61 79 the note is play
0800: 65 64 20 63 6f 6e 74 69 6e 75 6f 75 73 6c 79 2e ed continuously.
0810: 20 49 66 20 61 20 76 6f 6c 75 6d 65 20 6f 66 20 If a volume of
0820: 7a 65 72 6f 20 69 73 20 67 69 76 65 6e 2c 20 70 zero is given, p
0830: 6c 61 79 62 61 63 6b 20 6f 66 20 74 68 65 20 6e layback of the n
0840: 6f 74 65 20 65 6e 64 73 2e 0d 0a 0d 0a 3c 74 74 ote ends.....<tt
0850: 3e 6d 75 7a 69 63 3a 3a 63 6c 6f 73 65 3c 2f 74 >muzic::close</t
0860: 74 3e 0d 0a 0d 0a 20 20 20 20 54 6f 20 62 65 20 t>.... To be
0870: 63 61 6c 6c 65 64 20 77 68 65 6e 20 4d 49 44 49 called when MIDI
0880: 20 61 75 64 69 6f 20 70 6c 61 79 62 61 63 6b 20 audio playback
0890: 73 68 61 6c 6c 20 62 65 20 73 74 6f 70 70 65 64 shall be stopped
08a0: 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 63 6f 6e in order to con
08b0: 73 65 72 76 65 20 62 61 74 74 65 72 79 20 70 6f serve battery po
08c0: 77 65 72 2e 0d 0a 0a 5a 20 37 66 37 64 66 35 62 wer....Z 7f7df5b
08d0: 63 62 39 62 30 66 31 62 35 64 34 64 64 30 34 32 cb9b0f1b5d4dd042
08e0: 33 63 36 31 63 37 38 31 61 0a 3c61c781a.