From 5b5eba7e68e7de8d442824d2f5076ec7d623e2b8 Mon Sep 17 00:00:00 2001
From: Chris Xiong <chirs241097@gmail.com>
Date: Tue, 22 Aug 2017 11:35:33 +0800
Subject: Windows type of functionality windows is now Qt::Dialog.
 Initialization fluidsynth asynchronously. Minor documentation update.

---
 doc/troubleshooting.html | 29 ++++++++++++++++++++---------
 1 file changed, 20 insertions(+), 9 deletions(-)

(limited to 'doc/troubleshooting.html')

diff --git a/doc/troubleshooting.html b/doc/troubleshooting.html
index b6b5a8d..184f702 100644
--- a/doc/troubleshooting.html
+++ b/doc/troubleshooting.html
@@ -26,11 +26,13 @@
 		If troubleshooting cannot solve your problem, please don't hesitate to report an issue.
 		<h3>1. I can't hear anything!</h3>
 		<p>
-			1) Check current audio driver in the option dialog. Do not use an audio driver
-			that is not installed on your system.<br>
-			2) If no soundfont is loaded, the synthesizer won't make any sound...<br>
-			3) Check audio buffer settings in the synth section.<br>
-			4) Check if your midi file is valid.
+			<ol>
+			<li>Check current audio driver in the option dialog. Do not use an audio driver
+			that is not installed on your system.</li>
+			<li>If no soundfont is loaded, the internal synthesizer won't make any sound...</li>
+			<li>Check audio driver/buffer settings in the synth section.</li>
+			<li>Check if your midi file is valid/having correct bank selecting method<s>/having zero volume</s>.</li>
+			</ol>
 		</p>
 		<h3>2. The playback is intermittent.</h3>
 		<p>
@@ -60,11 +62,20 @@
 			Bank selecting to external devices is sent in raw format. The midi
 			file may be incompatible with your device.
 		</p>
-		<h3>9. 3D visualization is upsidedown/rotated/black.</h3>
+		<h3>9. 3D visualization is upsidedown/rotated/black/blinking.</h3>
 		<p>
-			For those who see a rotated display, try setting Visualization-Video/Multisampling
-			to 1 or above. If that doesn't solve your problem or you see nothing at
-			all, please send me more details about your problem.
+			For those who see a rotated and blinking display, try setting
+			Visualization-Video/Multisampling to 1 or above. If that doesn't
+			solve your problem or you see nothing at all, please send me more
+			details about your problem (graphics card, drivers etc.).
+		</p>
+		<p>
+			Devices/drivers reported to have this issue:
+			<ul>
+				<li>Intel HD 5500 found in i5-5200U / official Windows driver</li>
+				<li>Unknown low-end AMD card / official Windows driver</li>
+				<li>Raspberry Pi 2 VC4 / Full KMS OpenGL (GLX)</li>
+			</ul>
 		</p>
 	</div>
 </body>
-- 
cgit v1.2.3