NAME

       wildmidi - example player for libWildMidi

LIBRARY

       libWildMidi

FILES

       /etc/wildmidi.cfg

SYNOPSIS

       wildmidi [-behlv] [-c config-file] [-d device] [-m volume-level] [-o wav-file] midifile ...

DESCRIPTION

       This is a demonstration program to show the capabilities of libWildMidi.

       midifile is processed by libWildMidi and the resulting audio is output by the player.

       You  can  have  more than one midifile on the command line and wildmidi will pass them to libWildMidi for
       processing, one after the other. You can also use wildcards, for example: wildmidi *.mid

OPTIONS

       -b | --reverb
              Turns on an 8 point reverb engine that adds depth to the final mix.

       -c config-file | --config_file config-file
              Uses the configuration file stated by config-file instead of /etc/wildmidi.cfg

       -d device | --auddev=device
              Send the audio to device instead of the default. ALSA defaults to the system "default"  while  OSS
              defaults to "/dev/dsp". Win32 environments ignore this option.

       -e | --enhanced_resample
              Switches to a gauss based resampling algorithm which can improve the shape of the sound.

       -h | --help
              Displays command line options

       -l | --log_vol
              Some  MIDI files have been recorded on hardware that uses a volume curve, making them sound really
              badly mixed on other MIDI devices. Use this option to use volume curves.

       -m volume-level | --master_volume=volume-level
              Set the overall volume level to volume-level. The minimum is 0 and the maximum is  127,  with  the
              default being 100.

       -o wav-file | --wavout=wav-file
              Records the audio in wav format to wav-file.

       -r sndrate | --rate=sndrate
              Set the audio output rate to sndrate. The default rate is 32072.

       -v | --version
              Display version and copyright information

TEST OPTIONS

       These  options  are not designed for general use. Instead these options are designed to make it easier to
       listen to specific sound samples.

       Note: These options are not displayed by -h | --help

       -k N | --test_bank=N
              Set the test bank to N. Range is 0 to 127.

       -p N | --test_patch=N
              Set the test patch to N. Range is 0 to 127.

       -t | --test_midi
              Plays the built in test midi which plays all 127 notes.

USER INTERFACE

       The player accepts limited user input that allows some interaction while playing midi files.

       +      Turns the master volume up.

       -      Turns the master volume down.

       e      Turns enhanced resampling on and off.

       l      Turns volume curves on and off.

       r      Turns the final mix reverb on and off.

       n      Play the next midi on the command line.

       p      Pause the playback. Note: since the audio is buffered it will stop when the audio buffer is empty.

       .      Seek forward 1 second. Note: Clears active midi events and will only play midi events  from  after
              the new position.

       ,      Seek backwards 1 second. Note: Clears active midi events and will only play midi events from after
              the new position.

       q      Quit wildmidi.

SEE ALSO

       WildMidi_GetString(3),        WildMidi_Init(3),        WildMidi_MasterVolume(3),        WildMidi_Open(3),
       WildMidi_OpenBuffer(3),      WildMidi_SetOption(3),      WildMidi_GetOutput(3),      WildMidi_GetInfo(3),
       WildMidi_FastSeek(3), WildMidi_Close(3), WildMidi_Shutdown(3), wildmidi.cfg(5)

AUTHOR

       Chris Ison <wildcode@users.sourceforge.net>

COPYRIGHT

       Copyright (C) Chris Ison 2001-2010

       This file is part of WildMIDI.

       WildMIDI is free software: you can redistribute and/or modify the player  under  the  terms  of  the  GNU
       General  Public  License  and  you  can redistribute and/or modify the library under the terms of the GNU
       Lesser General Public License as published by the Free Software  Foundation,  either  version  3  of  the
       licenses, or(at your option) any later version.

       WildMIDI  is  distributed  in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the
       implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR  PURPOSE.  See  the  GNU  General  Public
       License and the GNU Lesser General Public License for more details.

       You  should  have  received  a  copy  of the GNU General Public License and the GNU Lesser General Public
       License along with WildMIDI. If not, see <http://www.gnu.org/licenses/>.

       This manpage is licensed under the Creative Commons Attribution-Share Alike 3.0 Unported License. To view
       a copy of this license, visit http://creativecommons.org/licenses/by-sa/3.0/ or send a letter to Creative
       Commons, 171 Second Street, Suite 300, San Francisco, California, 94105, USA.

                                                  05 June 2010                                       wildmidi(1)