blob: c32d9a639914df2f7c394fb1ecd8682317246ceb (
plain) (
tree)
|
|
<!DOCTYPE html>
<html>
<head>
<title>QMidiPlayer Help</title>
<link rel=stylesheet href='styles.css' type='text/css'>
</head>
<body>
<div id="panel">
<ul>
<li><a href="index.html">Overview</a></li>
<li><a href="mainwindow.html">Main Window</a></li>
<li><a href="channeldialog.html">Channels Dialog</a></li>
<li><a href="channeleditor.html">Channel Editor</a></li>
<li><a href="plistdialog.html">Playlist</a></li>
<li><a href="efxdialog.html">Effects</a></li>
<li><a class="active" href="optionsdialog.html">Settings</a></li>
<li><a href="visualization.html">Visualization</a></li>
<li><a href="cmdargs.html">Commandline arguments</a></li>
<li><a href="troubleshooting.html">Troubleshooting</a></li>
<li><a href="miscellaneous.html">Miscellaneous</a></li>
<li><a href="version.html">Version Info.</a></li>
<li><a href="license.html">License</a></li>
</ul>
</div>
<div id="content">
<h1>Settings Dialog</h1>
Options with one asterisk will be applied after QMidiPlayer is restarted.<br>
Options with two asterisks will be applied after the internal fluidsynth is restarted.<br>
Other options take effect immediately (or when the next track is played).<br>
<img src="../img/options1.png" width="440"><br>
<ul>
<li>Disable Midi Mapping*: only use the default output device.</li>
<li>Send SysEx: whether to send system exclusive messages or not.</li>
<li>Wait for remaining voices before stopping:<br>
If checked, the player will not stop until the current polyphone reaches 0 and
the output is silent. Otherwise it will stop immediately after the last event is sent.
This option is only effective if the internal Fluidsynth output is used.
</li>
<li>Fluidsynth Device ID: Device ID of the internal Fluidsynth.<br>
This will affect how the internal Fluidsynth handles system exclusive messages.
The value is 0-based, as they are in actual system exclusive messages.
Please note that some synthesizers use an 1-based value for their user interface.
For playback of most GS files, this should be set to 16.
</li>
<li>Text encoding: text encoding used in the midi file.</li>
<li>Select MIDI output devices*: Choose the MIDI devices to use for default device selection.<br>
When QMidiPlayer starts, selected devices will be examined from top to bottom, the first connected
one will be chosen as the default output device.
</li>
<li>External MIDI output device setup*: set initialzation file for external MIDI devices.
Initialzation file may contain a short, device-specific MIDI sequence to initialize the device
which is sent before a file begins to play, and may also provide information about the device
(instrument preset names, initialzation data etc.) to enhance the user experience.
</li>
</ul>
<img src="../img/options2.png" width="440"><br>
<ul>
<li>Audio Driver**: specify the audio backend used by the internal synthesizer.</li>
<li>Audio Buffer Size**: Size per buffer used by the fluidsynth engine. Increase if experiencing audio interruption, decrease if audio is laggy or messed up.</li>
<li>Audio Buffer Count**: Number of buffers used by the fluidsynth engine. Increase if experiencing audio interruption or messy audio, decrease if audio is laggy.</li>
<li>Audio Format**: audio output format of the fluidsynth engine.</li>
<li>Audio Frequency**: audio output sampling frequency of the fluidsynth engine.</li>
<li>Max Polyphony**: maximum simultaniously played voices of synthesizer. High polyphony limit may cause lags. </li>
<li>CPU Cores**: threads used by the internal synthesizer. Too many threads may result in instability.</li>
<li>Auto bank select mode:<br>
If checked, the player will choose the appropriate bank selecting mode
according to the file standard. If the file doesn't specify the standard
the player will fallback to the default bank select mode.
Otherwise the player will only use the default bank select mode.
</li>
<li>(Fallback) Bank Select Mode: the default bank select mode.</li>
</ul>
<img src="../img/options3.png" width="440"><br>
You can manage a list of soundfonts used by the internal fluidsynth engine here. Unchecked
soundfonts will not be used.<br>
If multiple soundfonts provide instruments with the same bank numbers and preset numbers,
the preset provided by the top most soundfont will be used.<br>
<img src="../img/options4.png" width="440"><br>
<ul>
<li>Restore last playlist on startup*: If checked and QMidiPlayer is started without files
to open, the playlist from the last session will be used instead of an empty playlist.</li>
<li>Load files in the same folder*: If checked, QMidiPlayer will add all midi files in the
same folder to the playlist when started with a file.</li>
<li>Save dialog status*: Save dialog positions and restore on start up.</li>
<li>Save parameters in effects window</li>
<li>Persistent fluidsynth instance: Deprecated. Removing before 0.9.</li>
<li>Show label beside icon in toolbar buttons: If disabled, the toolbar buttons will be
icon only.</li>
<li>Icon Theme: Leave it unchanged unless you can't see the icons on those buttons.</li>
<li>Customize toolbar: customize the functionalities shown in the main window.</li>
<li>Customize actions: customize the functionalities shown in the file action menu.</li>
</ul>
<img src="../img/options5.png" width="440"><br>
Plugin manager. View details of plugins, enable or disable them here.<br>
Changes in this page require a restart to take effect. New plugins are enabled by default.<br>
Plugin scanning follows the order below:
<ul>
<li>(*nix) /usr/lib/qmidiplayer</li>
<li>a folder named "plugins" in the folder containing QMidiPlayer's executable file.</li>
</ul>
<br><a href="index.html">Return</a>
</div>
</body>
</html>
|
