readme

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

This is the Guitar Tutor program, as described in chapter 19 of the
Linux Multimedia Guide.

You likely need to edit the Make file to match your system's setup.
Type "make" to build it. You need to have the V toolkit installed.

Be sure to uncompress the sound samples in the samples directory.

This application is released under the GNU GPL. The V toolkit itself
is released under the GNU LGPL.

------------------------------------------------------------------------

Here are some additional notes on the format of the chord database
file. By editing this file you can add your own guitar chords.

The first line of the file should contain the magic string
"#GuitarTutor".

Each subsequent line should contain 4 fields, separated by white
space.  If you want space characters within a file use an underscore
("_") and it will be converted to a space when the file is read.

Field 1: The full name of the chord (e.g. "C_Major")

Field 2: An abbreviated name for the chord (e.g. "C"). This is not
currently used.

Field 3: Fingering for each string. Normally this is for 6 strings,
but you can change the constant numStrings in the source. The strings
are in the order EADGBE. Each string is represented by a
character. "X" indicates the string should not be played for the
chord. "0" indicates an open string. Numbers from 1 through numFrets
(normally 8) indicate the fret number. A typically entry is "X32010".

Field 4: This is the name of a sound sample file for the chord. It
should be an 8-bit unsigned 8 kHz raw sound file. It can be a full
pathname or relative to the working directory.

The supplied chord database has all of the natural major, minor, and
seventh chords (no sharps or flats). Sound files (not particularly
good quality) are also included.

------------------------------------------------------------------------

Known bugs and limitations:

- several menu options are not yet implemented
- loading a binary file (or something strange like /dev/zero) can
  cause a crash
- if the chord file uses relative filenames for the
  samples, they will fail to load if you change directories using the
  file browser