docs/user/midi/midi1intro.dox

   1 /*!
   2 \page midi1 The old Midi Kit (libmidi.so)
   3
   4 The old Midi Kit, or midi1 for short, goes all the way back to DR8, when the
   5 BeOS only ran on BeBoxen. Fortunately for us, it is pretty well documented:
   6
   7 - <A HREF="https://www.haiku-os.org/legacy-docs/bebook/TheMidiKit_Overview.html">Midi
   8 Kit chapter in the online Be Book</A>
   9 - <A HREF="http://web.archive.org/web/20010618100542/www-classic.be.com/developers/developer_library/midi_kit.html">Midi
  10 Kit section of the old Be Developer Library</A>
  11 - Be Newsletter Volume 1, Issue 49 - Introduces the MIDI synth
  12 - Be Newsletter Volume 1, Issue 52 - Follow-up on issue 49
  13 - Be Newsletter Volume 1, Issue 91 - How to use BSynth
  14 - Be Newsletter Volume 1, Issue 102 - Axe sample code
  15 - Be Newsletter Volume 1, Issue 104 - How to use BMidiPort
  16 - Be Newsletter Volume 2, Issue 23 - EdMidi sample code
  17 - Be Newsletter Volume 2, Issue 37 - How to use the MIDI synth
  18 - Be Newsletter Volume 3, Issue 37 - Whistle sample code
  19
  20 To summarize, there are four basic MIDI classes:
  21
  22 - BMidi is the base class for most other classes from the Midi Kit
  23 - BMidiPort can talk to a MIDI hardware port
  24 - BMidiStore can read, write, and perform Standard MIDI files
  25 - BMidiText is a debugging aid that dumps MIDI messages to <CODE>stdout</CODE>
  26
  27 The following classes let you use the Midi Kit's General MIDI synthesizer:
  28
  29 - BSynth controls the synthesizer
  30 - BMidiSynth connects a BMidi object to the synth
  31 - BMidiSynthFile connects a MIDI file to the synth
  32 - BSamples lets you access the synth's sound data stream
  33
  34 To make MIDI data stream through your application, you create a "network" of
  35 BMidi-derived objects that send and receive MIDI messages.
  36
  37 The old Midi Kit is slowly fading into obscurity. You may want to use the
  38 \ref midi2 "new kit" instead. Also note that the Haiku implementation
  39 of the kit sometimes behaves differently than the one from BeOS R5 or what
  40 the BeBook says, but usually for the better.
  41
  42 Especially the synth classes are not completely functional, but enough to
  43 play back General MIDI tunes. They should be backwards compatible with the
  44 majority of BeOS MIDI applications. Not all methods of BSynth, BMidiSynth,
  45 and BMidiSynthFile are implemented because some of them are rather obscure.
  46 BSamples is a complete no-op; in other words, with the Haiku Midi Kit
  47 you cannot push waveform data into the output stream of the softsynth.
  48 */