From 41f9cf6fa2718155c8231d579c8af5f24d947b49 Mon Sep 17 00:00:00 2001
From: Chris Xiong <chirs241097@gmail.com>
Date: Fri, 16 Sep 2016 23:27:11 +0800
Subject: Minor bug fix. Update documentation.

---
 ChangeLog                             |  3 +++
 doc/optionsdialog.html                |  8 ++++----
 doc/visualization.html                | 13 ++++++++++---
 qmidiplayer-desktop/qmphelpwindow.hpp |  2 +-
 visualization/qmpvisualization.cpp    |  6 +++---
 5 files changed, 21 insertions(+), 11 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 6d60ff3..0a1e254 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,6 @@
+2016-09-16 0.8.3 alpha
+Minor bug fix. Update documentation.
+
 2016-09-15 0.8.3 alpha
 Add a new visualization mode. Fix minor behavioral bugs.
 
diff --git a/doc/optionsdialog.html b/doc/optionsdialog.html
index 8d59dc2..efa5baf 100644
--- a/doc/optionsdialog.html
+++ b/doc/optionsdialog.html
@@ -44,12 +44,12 @@
 	<img src="../img/options2.png"><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.</li>
-		<li>Audio Buffer Count**: Number of buffers used by the fluidsynth engine.</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.</li>
-		<li>CPU Cores**: threads used by the internal synthesizer.</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
diff --git a/doc/visualization.html b/doc/visualization.html
index 5ca7537..f482744 100644
--- a/doc/visualization.html
+++ b/doc/visualization.html
@@ -42,19 +42,26 @@ left  |  right        ←  →          │     │
       |          Seek left/right    └─────┘
    backward   (Hold shift to seek 5% instead of 1%)
 </pre>
+		<h3>Known problems</h3>
+		<p>
+		In some systems closing and reopening the visualization results in a crash. This is
+		due to a dbus-related conflict in SDL and Qt.
+		</p>
 		<h3>Options</h3>
+		The options listed here are applied after closing and reopening the visualization.
 		<ul>
 			<li>
 				Visualization-Appearance
 				<ul>
-					<li>Show Piano: Whether to show the virtual piano in the visualization scene.</li>
+					<li>Show Piano: Whether to show the virtual piano in the visualization scene. Currently drawing the piano is very expensive, so it is not recommended to enable this unless you have a beefy computer.</li>
 					<li>3D Notes: 2D notes are used when this is unchecked. Using 2D notes is less resource-hungry.</li>
 					<li>Arrange channels on a stair: If checked, virtual pianos will be arranged on a stair-like shape. This option has no effect if virtual piano is not shown.</li>
 					<li>Show channel labels: If checked, channel preset will be shown on the left side.</li>
 					<li>Show particles: Whether to draw particles. Very resource-intensive!</li>
 					<li>Horizontal Visualization: Uses a horizontal visualization style. Overrides everything above except 3D Notes.</li>
 					<li>2D Visualization: Tick this to use a simple 2D visualization instead. Much less resource-demanding.</li>
-					<li>View distance: This option affects the maximum number of notes rendered on the screen. Only applies to 3D visualization.</li>
+					<li>Use spectrum instead of piano roll: Draw spectrum-like bars over the piano.</li>
+					<li>View distance: This option affects the maximum number of notes rendered on the screen. Only applies to the 3D visualization.</li>
 					<li>Note stretch: The length multiplier of notes.</li>
 					<li>Minimum note length: Avoid notes that are too short to be visible by adjusting this value.</li>
 					<li>Chequer board tint (AARRGGBB): change the color of the chequer board background.</li>
@@ -71,7 +78,7 @@ left  |  right        ←  →          │     │
 					<li>Supersampling: Supersample anti-aliasing. 1 means no SSAA.</li>
 					<li>Multisampling: Multisample anti-aliasing. 0 means no MSAA.</li>
 					<li>FOV: Field of view.</li>
-					<li>OSD Position: Change position of the on screen display, or just disable it.</li>
+					<li>OSD Position: Change position of the on screen display, or simply disable it.</li>
 					<li>Font size: Change font size used by the visualization. Useful for HiDPI screens.</li>
 				</ul>
 			</li>
diff --git a/qmidiplayer-desktop/qmphelpwindow.hpp b/qmidiplayer-desktop/qmphelpwindow.hpp
index beae1fa..690d126 100644
--- a/qmidiplayer-desktop/qmphelpwindow.hpp
+++ b/qmidiplayer-desktop/qmphelpwindow.hpp
@@ -2,7 +2,7 @@
 #define QMPHELPWINDOW_H
 
 #include <QDialog>
-#define APP_VERSION "0.8.2"
+#define APP_VERSION "0.8.3"
 
 namespace Ui {
 	class qmpHelpWindow;
diff --git a/visualization/qmpvisualization.cpp b/visualization/qmpvisualization.cpp
index 202b7b0..29a1925 100644
--- a/visualization/qmpvisualization.cpp
+++ b/visualization/qmpvisualization.cpp
@@ -336,10 +336,10 @@ bool qmpVisualization::update()
 			else spectrar[i][j]=spectra[i][j];
 			if(spectrar[i][j])
 			{
-				smvec3d a(0.63*((double)j-64+api->getPitchBend(i))+.1,
+				smvec3d a(0.756*((double)j-64+api->getPitchBend(i))+.12,
 						  (stairpiano?(56-i*7.):(64-i*8.)),
 						  spectrar[i][j]*1.2*(1+0.02*sin(sm->smGetTime()*32))+(stairpiano&&showpiano&&!horizontal)*i*2.);
-				smvec3d b(0.63*((double)j-64+api->getPitchBend(i))+.7,
+				smvec3d b(0.756*((double)j-64+api->getPitchBend(i))+.84,
 						  (stairpiano?(56-i*7.):(64-i*8.))+.4,
 						  (stairpiano&&showpiano&&!horizontal)*i*2.);
 				drawCube(a,b,SETA(iccolors[i],204),0);
@@ -790,7 +790,7 @@ void qmpVisualization::deinit()
 const char* qmpVisualization::pluginGetName()
 {return "QMidiPlayer Default Visualization Plugin";}
 const char* qmpVisualization::pluginGetVersion()
-{return "0.8.1";}
+{return "0.8.3";}
 
 void qmpVisualization::pushNoteOn(uint32_t tc,uint32_t ch,uint32_t key,uint32_t vel)
 {
-- 
cgit v1.2.3