aboutsummaryrefslogtreecommitdiff
path: root/doc/optionsdialog.html
blob: 6a1d26d2b7f46b063e669d2f4dfbd7909bf45ad0 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
<!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 are applied immediately.<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.<br>
		Otherwise it will stop immediately after the last event is sent.
		</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>