home *** CD-ROM | disk | FTP | other *** search
/ ftp.4front-tech.com / ftp.4front-tech.com.tar / ftp.4front-tech.com / ossfree / snd-util-3.8.tar.gz / snd-util-3.8.tar / sndkit / mplay / Readme < prev   
Text File  |  1997-12-08  |  2KB  |  47 lines
  1. mplay 0.2 (formerly mtest)
  2. --------------------------
  3.  
  4. Copyright (C) Hannu Savolainen, 1994, 1996, 1997.
  5.  
  6. This incomplete version is released just as an example program. You
  7. may use it as defined in GNU General Public License (GPL). 
  8. However using this library in other programs
  9. is not recommended due to serious limitations in the design.
  10. In spite of experimental nature of the program it's still very usefull
  11. due to it's hardware independence.
  12.  
  13. This directory contains an early prototype of a library for loading and
  14. saving MIDI files. This current version is a disaster but
  15. it works in some cases. My goal is to make a library which works as a
  16. work space for some GUI based sequencer programs. The current one is
  17. capable to load a MIDI file correctly (almost) but the interface to
  18. the client software is useless. 
  19.  
  20. I have included this package here just because it's the only program 
  21. which uses the new /dev/sequencer2 interface. By default it outputs
  22. to the synth device number 0 (GUS or OPL3 depending on your config). 
  23. If you use this program with an internal synthesizer, you have to use
  24. an external patch manager program.
  25.  
  26. I have usually used this program with a WaveBlaster. The device number
  27. may be given as the first parameter (mtest [devno] midifile). The proper
  28. device number (devno) can be found easily by looking at the /dev/sndstat
  29. printout. The number before the device in the "Synth devices:" section
  30. is the number to be used. For devices in the "Midi decvices:" section
  31. you should add number of "synth" devices into this number. For example
  32. if you have two devices in the "synth" section then number of the first
  33. MIDI port will be 2+0=2.
  34.  
  35. Running "mplay" without arguments lists the available playback devices.
  36.  
  37. This version supports OSSlib which is also included this snd-util package
  38. (in the OSSlib/ directory). OSSlib supports patch caching which
  39. makes programming easier with some synthesizer devices such as GUS and SoftOSS.
  40. OSSlib is enabled by default but can be disabled by editing Makefile.
  41. If you use this program with OSSlib you should have OSS version
  42. 3.8-beta2 or later installed on your machine. In addition you will have
  43. to compile and install OSSlib before compiling this program.
  44.  
  45. Hannu Savolainen
  46. hannu@opensound.com
  47.