1wildmidi(1)                     WildMidi Player                    wildmidi(1)
2
3
4

NAME

6       wildmidi - example player for libWildMidi
7

LIBRARY

9       libWildMidi
10

FILES

12       /etc/wildmidi.cfg
13

SYNOPSIS

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

DESCRIPTION

19       This is a demonstration program to show the  capabilities  of  libWild‐
20       Midi.
21
22       midifile  is processed by libWildMidi and the resulting audio is output
23       by the player.
24
25       You can have more than one midifile on the command  line  and  wildmidi
26       will  pass them to libWildMidi for processing, one after the other. You
27       can also use wildcards, for example: wildmidi *.mid
28

OPTIONS

30       -b | --reverb
31              Turns on an 8 point reverb engine that adds depth to  the  final
32              mix.
33
34       -c config-file | --config_file config-file
35              Uses  the  configuration  file  stated by config-file instead of
36              /etc/wildmidi.cfg
37
38       -d device | --auddev=device
39              Send the audio to device instead of the default.  ALSA  defaults
40              to  the system "default" while OSS defaults to "/dev/dsp". Win32
41              environments ignore this option.
42
43       -e | --enhanced_resample
44              Switches to a gauss based resampling algorithm which can improve
45              the shape of the sound.
46
47       -h | --help
48              Displays command line options
49
50       -l | --log_vol
51              Some  MIDI files have been recorded on hardware that uses a vol‐
52              ume curve, making them sound really badly mixed  on  other  MIDI
53              devices. Use this option to use volume curves.
54
55       -m volume-level | --master_volume=volume-level
56              Set  the  overall volume level to volume-level. The minimum is 0
57              and the maximum is 127, with the default being 100.
58
59       -o wav-file | --wavout=wav-file
60              Records the audio in wav format to wav-file.
61
62       -r sndrate | --rate=sndrate
63              Set the audio output rate to sndrate. The default rate is 32072.
64
65       -v | --version
66              Display version and copyright information
67

TEST OPTIONS

69       These options are not designed for general use. Instead  these  options
70       are designed to make it easier to listen to specific sound samples.
71
72       Note: These options are not displayed by -h | --help
73
74       -k N | --test_bank=N
75              Set the test bank to N. Range is 0 to 127.
76
77       -p N | --test_patch=N
78              Set the test patch to N. Range is 0 to 127.
79
80       -t | --test_midi
81              Plays the built in test midi which plays all 127 notes.
82

USER INTERFACE

84       The  player  accepts  limited  user  input that allows some interaction
85       while playing midi files.
86
87       +      Turns the master volume up.
88
89       -      Turns the master volume down.
90
91       e      Turns enhanced resampling on and off.
92
93       l      Turns volume curves on and off.
94
95       r      Turns the final mix reverb on and off.
96
97       n      Play the next midi on the command line.
98
99       p      Pause the playback. Note: since the audio is  buffered  it  will
100              stop when the audio buffer is empty.
101
102       .      Seek  forward 1 second. Note: Clears active midi events and will
103              only play midi events from after the new position.
104
105       ,      Seek backwards 1 second. Note: Clears  active  midi  events  and
106              will only play midi events from after the new position.
107
108       q      Quit wildmidi.
109

SEE ALSO

111       WildMidi_GetString(3),    WildMidi_Init(3),   WildMidi_MasterVolume(3),
112       WildMidi_Open(3), WildMidi_OpenBuffer(3), WildMidi_SetOption(3),  Wild‐
113       Midi_GetOutput(3),   WildMidi_GetInfo(3),  WildMidi_FastSeek(3),  Wild‐
114       Midi_Close(3), WildMidi_Shutdown(3), wildmidi.cfg(5)
115

AUTHOR

117       Chris Ison <wildcode@users.sourceforge.net>
118
120       Copyright (C) Chris Ison 2001-2010
121
122       This file is part of WildMIDI.
123
124       WildMIDI is free software:  you  can  redistribute  and/or  modify  the
125       player  under  the  terms of the GNU General Public License and you can
126       redistribute and/or modify the library  under  the  terms  of  the  GNU
127       Lesser General Public License as published by the Free Software Founda‐
128       tion, either version 3 of the licenses, or(at your  option)  any  later
129       version.
130
131       WildMIDI is distributed in the hope that it will be useful, but WITHOUT
132       ANY WARRANTY; without even the implied warranty of  MERCHANTABILITY  or
133       FITNESS  FOR  A  PARTICULAR PURPOSE. See the GNU General Public License
134       and the GNU Lesser General Public License for more details.
135
136       You should have received a copy of the GNU General Public  License  and
137       the  GNU Lesser General Public License along with WildMIDI. If not, see
138       <http://www.gnu.org/licenses/>.
139
140       This manpage is licensed under the Creative  Commons  Attribution-Share
141       Alike  3.0  Unported  License.  To  view  a copy of this license, visit
142       http://creativecommons.org/licenses/by-sa/3.0/ or send a letter to Cre‐
143       ative Commons, 171 Second Street, Suite 300, San Francisco, California,
144       94105, USA.
145
146                                 05 June 2010                      wildmidi(1)
Impressum