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.