Add basic Plugin DSP Load documentation

diff --git a/include/plugin-dsp-load.html b/include/plugin-dsp-load.html
new file mode 100644 (file)
index 0000000..2867615
--- /dev/null
+++ b/include/plugin-dsp-load.html
@@ -0,0 +1,30 @@
+<p>
+       The <dfn>Plugin DSP Load</dfn> window is helpful in cases where
+       some of the plugins in use overload the CPU, resulting in audible
+       clicks and pops in the output, but you aren't quire sure which ones
+       are causing this exactly.
+</p>
+
+<figure class=center>
+<img src="/images/plugin-dsp-load.png" alt="The Plugin DSP Load window" width="50%" />
+<figcaption class=center>The Plugin DSP Load window</figcaption>
+</figure>
+
+<p>
+       For each plugin in use, there is a chart and numeric data that represents
+       minumum, maximum, and average CPU time used, as well as standard deviation.
+       This, along with simple color coding — green for safe amount of CPU use,
+       red for CPU overload — gives you a good overview of what's going on
+       in the session.
+</p>
+
+<p>
+       You can use this data to decide whether you want to replace a plugin with
+       a less resource-hungry one, freeze a track, or report a potential bug
+       to the plugin's developer and wait for an update.
+</p>
+
+<p>
+       It's worth noting that certain type of plugins, like convolution reverbs
+       and guitar amp simulators, tend to consume more resources.
+</p>
\ No newline at end of file

diff --git a/master-doc.txt b/master-doc.txt
index cba4e7f486eba5aa89c40795615bb8f44be8b517..bb588c2224eb5385a25c05edd5c01aff6d804d77 100644 (file)
--- a/master-doc.txt
+++ b/master-doc.txt
@@ -2047,6 +2047,20 @@ uri: using-control-surfaces/Ableton_Push2
 part: chapter
 ---
 
+---
+title: Troubleshooting
+part: part
+---
+
+---
+title: Plugin DSP Load
+menu_title: Plugin DSP Load
+include: plugin-dsp-load.html
+link: plugin-dsp-load
+uri: troubleshooting/plugin-dsp-load
+part: chapter
+---
+
 ---
 title: Scripting
 part: part

diff --git a/source/images/plugin-dsp-load.png b/source/images/plugin-dsp-load.png
new file mode 100644 (file)
index 0000000..e913a28
Binary files /dev/null and b/source/images/plugin-dsp-load.png differ