readme

在linux下多媒体开发实例linux下多媒体开发

This is the MusicMachine program, from chapter 19 of Multimedia on
Linux.

Type "make" to build it. You need to have the XForms toolkit
installed. Make sure you uncompress the sound samples in the samples
directory.

Here are some basic instructions on how to use the program:

Music Machine allows you to create "songs" by playing sequences of
sound samples. It supports up to 16 different sound samples, stored as
files in 8-bit raw format. The sampling rate is selectable but must be
the same for all samples. Eight independent sound channels are
provided which can play sequences of sound samples.

Quick Demonstration:

- start up the program ("mm")
- use the file menu to load one of the example song files from the
  songs subdirectory
- click on the Play button to start playing the song
- adjust the Tempo using the slider
- stop playing using the Stop button

Writing songs:

- pick the samples you want to use with the Edit/Options menu.  Enter
  the sound file names and other parameters, as needed. Select Apply
  after making changes. Click on the number next to the sound file name
  to hear a sample. Select Dismiss to close the window.

- program the notes for each sound channel by clicking on the
  rectangular array of buttons. Notes are displayed in "pages" of 8
  notes. Using the Page buttons to move to the other pages (32 in all).

- each note can be a sound sample ("0" through "F"), a rest ("-"),
  looped back to the start ("Loop") or can stop the sound channel (the
  stop sign). Mouse button 1 increments to the next sample, button 3
  moves to the previous channel, and 2 selects a rest.

- looping and stopping works independently for each channel. If you
  reach the end of page 31, the channel will loop back to the beginning.

- you can make edits while a song is playing

- you can save and load songs to files. The file format is ASCII, you
  can probably figure it out by looking at it.

- File/New erases all of the song, make all notes rests.

- File/About shows the usual information about the program. It also
  shows off one of the XForms widgets.

- at lot more features could be added, but this was only intended as a
  reasonably small example application.