Updates to manual.

11 files changed, 564 insertions, 188 deletions

diff --git a/doc/manual/Makefile b/doc/manual/Makefile
index f0cef4832..bb3c3167e 100644
--- a/doc/manual/Makefile
+++ b/doc/manual/Makefile
@@ -2,11 +2,12 @@
 
 all:	html pdf
 
-DIAGRAMS := file-structure.svg
+DIAGRAMS := file-structure.svg 3d-left-right.svg
 
-SCREENSHOTS := file-new.png video-new-film.png still-new-film.png click-content-selector.png video-select-content-file.png \
-               still-select-content-file.png examine-thumbs.png \
-               calculate-audio-gain.png prefs.png making-dcp.png filters.png film-tab.png video-tab.png audio-tab.png subtitles-tab.png
+SCREENSHOTS := file-new.png video-new-film.png still-new-film.png video-select-content-file.png \
+               still-select-content-file.png examine-thumbs.png examine-content.png timing-tab.png \
+               calculate-audio-gain.png prefs.png making-dcp.png filters.png video-tab.png audio-tab.png subtitles-tab.png \
+               audio-plot.png audio-map-eg1.png audio-map-eg2.png audio-map-eg3.png
 
 XML := dcpomatic.xml
 
@@ -49,6 +50,9 @@ html/screenshots/new-session.png: screenshots/new-session.png
 html/screenshots/export-dialogue.png: screenshots/export-dialogue.png
 	mkdir -p html/screenshots
 	convert -resize 75% $< $@
+html/screenshots/making-dcp.png: screenshots/making-dcp.png
+	mkdir -p html/screenshots
+	convert -resize 75% $< $@
 
 # For HTML: convert graphics from SVG to PNG
 graphics/%.png:	graphics/%.svg
diff --git a/doc/manual/dcpomatic-pdf.xsl b/doc/manual/dcpomatic-pdf.xsl
index 414fb64b8..c4ced0deb 100644
--- a/doc/manual/dcpomatic-pdf.xsl
+++ b/doc/manual/dcpomatic-pdf.xsl
@@ -9,7 +9,7 @@
 <xsl:param name="latex.output.revhistory">0</xsl:param>
 
 <!-- hack images to vaguely the right size -->
-<xsl:param name="imagedata.default.scale">scale=0.6</xsl:param>
+<xsl:param name="imagedata.default.scale">scale=0.5</xsl:param>
 
 <!-- don't make too-ridiculous section numbers -->
 <xsl:param name="doc.section.depth">3</xsl:param>
diff --git a/doc/manual/dcpomatic.xml b/doc/manual/dcpomatic.xml
index dff11d4a6..c83345af1 100644
--- a/doc/manual/dcpomatic.xml
+++ b/doc/manual/dcpomatic.xml
@@ -10,6 +10,11 @@
 ]>
 <book xmlns="http://docbook.org/ns/docbook" version="5.0" xml:lang="en">
 
+<!-- By good luck or good management, the scale parameter to imagedata
+     appears only to affect PDF output.  HTML scaling is done in the
+     Makefile.
+-->
+
 <bookinfo>
 <title>DCP-o-matic</title>
 <author><firstname>Carl</firstname><surname>Hetherington</surname></author>
@@ -247,11 +252,11 @@ select the content file to use, as shown in <xref
 linkend="fig-video-select-content-file"/>.
 </para>
 
-<figure id="fig-add-content"> 
-  <title>Adding content</title> 
+<figure id="fig-add-file"> 
+  <title>Adding content files</title> 
   <mediaobject>
     <imageobject> 
-      <imagedata fileref="screenshots/add-content&scs;"/>
+      <imagedata fileref="screenshots/add-file&scs;"/>
     </imageobject> 
   </mediaobject>
 </figure>
@@ -324,7 +329,7 @@ linkend="fig-making-dcp"/>.
   <title>Making the DCP</title>
   <mediaobject>
     <imageobject> 
-      <imagedata fileref="screenshots/making-dcp&scs;"/>
+      <imagedata scale="30" fileref="screenshots/making-dcp&scs;"/>
     </imageobject> 
   </mediaobject>
 </figure>
@@ -424,7 +429,7 @@ to encode a single frame which it can then repeat.
 <para>
 The previous chapters showed DCP generation using the default
 settings.  DCP-o-matic offers a range of features to adjust the
-content that goes into your DCP, and this describes those features in
+content that goes into your DCP, and this chapter describes those features in
 detail.
 </para>
 
@@ -468,6 +473,332 @@ clicking the <guilabel>Remove</guilabel> button.
 </para>
 
 </section>
+<section>
+<title>Content Properties</title>
+
+<para>
+Below the content list are the controls to set content properties.  To
+adjust the properties for a piece of content, click its name in the
+content list.  The content property controls will then become active
+for that piece of content.
+</para>
+
+<para>
+The content properties are split up into four sections:
+<guilabel>Video</guilabel>, <guilabel>Audio</guilabel>,
+<guilabel>Subtitles</guilabel> and <guilabel>Timing</guilabel>.  Not
+all of these sections will be active for all content types.  The controls
+in each section are described below.
+</para>
+
+</section>
+
+<section>
+<title>Video</title>
+
+<para>
+The <guilabel>Video</guilabel> tab controls properties of the image, as shown in <xref linkend="fig-video-tab"/>.
+</para>
+
+<figure id="fig-video-tab"> 
+  <title>Video settings tab</title>
+  <mediaobject>
+    <imageobject> 
+       <imagedata fileref="screenshots/video-tab&scs;"/>
+    </imageobject> 
+  </mediaobject>
+</figure>
+
+<section>
+<title>Image type</title>
+
+<para>
+The first option on this tab is the &lsquo;type&rsquo; of the video.
+This specifies how DCP-o-matic should interpret the video's image.
+<guilabel>2D</guilabel> is the default; this just takes the video
+image as a standard 2D frame.  The other option <guilabel>3D
+left/right</guilabel> tells DCP-o-matic to interpret the frame as a
+left-right pair, as shown in <xref linkend="fig-3d-left-right"/>.
+</para>
+
+<figure id="fig-3d-left-right"> 
+  <title>3D left/right image type</title>
+  <mediaobject>
+    <imageobject> 
+       <imagedata scale="100" fileref="diagrams/3d-left-right&dia;"/>
+    </imageobject> 
+  </mediaobject>
+</figure>
+
+<para>
+This option can be used to generate a 3D DCP.  Other means of creating
+3D will be added in the future.
+</para>
+
+</section>
+
+
+<!-- ============================================================== -->
+<section>
+<title>Filtering</title>
+
+<para>
+The &lsquo;filters&rsquo; settings allow you to apply various video
+filters to the image.  These may be useful to try to improve
+poor-quality sources like DVDs.  You can set up the filters by clicking the
+<guilabel>Edit</guilabel> button next to the filters entry in the
+setup area of the DCP-o-matic window; this opens the filters selector
+as shown in <xref linkend="fig-filters"/>.
+</para>
+
+<figure id="fig-filters"> 
+  <title>Filters selector</title> 
+  <mediaobject>
+    <imageobject> 
+      <imagedata fileref="screenshots/filters&scs;"/>
+    </imageobject> 
+  </mediaobject>
+</figure>
+
+<para>
+After changing the filters setup, you will need to regenerate the DCP
+to see the effect on the cinema screen.  The preview in DCP-o-matic
+will update itself whenever filters are changed, though of course this
+image is much smaller and of lower resolution than a projected image!
+</para>
+</section>
+
+
+<!-- ============================================================== -->
+<section>
+<title>Other settings</title>
+
+<para>
+The &lsquo;crop&rsquo; settings can be used to crop your content,
+which can be used to remove black borders from round the edges of DVD
+images, for example.  The specified number of pixels will be trimmed
+from each edge, and the content image in the right of the window will
+be updated to show the effect of the crop.
+</para>
+
+<para>
+The <guilabel>Scale to</guilabel> option governs the shape that
+DCP-o-matic will scale the content's image into.  Select the aspect
+ratio that your content should be presented in.
+</para>
+
+</section>
+<section>
+<title>Video description</title>
+
+<para>
+At the bottom of the video tab is a short description of what will
+happen to your video with the current settings.  In the example of
+<xref linkend="fig-video-tab"/>, DCP-o-matic is telling you that the
+video file is 1920x1080 pixels (which is a ratio of 1.78:1).  Since
+the controls specify &lsquo;Flat&rsquo; for the ratio, DCP-o-matic
+scales the content image to 1998x1080, which is the DCI flat
+resolution at 2K.
+</para>
+
+<para>
+This description also gives the frame rate of the content and what
+will happen to it when it is played at the DCP's frame rate.
+<!-- XXX: link to more detailed discussion of this -->
+</para>
+
+</section>
+
+</section>
+
+<section>
+<title>Audio</title>
+
+<para>
+The <guilabel>Audio</guilabel> tab controls properties of the image, as shown in <xref linkend="fig-audio-tab"/>.
+</para>
+
+<figure id="fig-audio-tab"> 
+  <title>Audio settings tab</title>
+  <mediaobject>
+    <imageobject> 
+       <imagedata fileref="screenshots/audio-tab&scs;"/>
+    </imageobject> 
+  </mediaobject>
+</figure>
+
+<section>
+<title>Show audio</title>
+
+<para>
+The <guilabel>Show Audio</guilabel> button will instruct DCP-o-matic
+to examine the audio in your content and plot a graph of its level
+over time.  This can be useful for getting a rough idea of how loud
+the sound will be in the cinema auditorium.  A typical plot is shown
+in <xref linkend="fig-audio-plot"/>
+</para>
+
+<figure id="fig-audio-plot"> 
+  <title>Audio plot</title>
+  <mediaobject>
+    <imageobject> 
+       <imagedata fileref="screenshots/audio-plot&scs;"/>
+    </imageobject> 
+  </mediaobject>
+</figure>
+
+<para>
+The plot gives the audio level (vertical axis, in dB) with time
+(horizontal axis).  0dB represents full scale, so if there is anything
+near this you are in danger of clipping the projector's audio outputs.
+</para>
+
+<para>
+There are two plot types: the peak level and the RMS, which can be
+shown or hidden using the check-boxes on the right hand side of the
+window.
+</para>
+
+<para>
+The channel check-boxes will show or hide the plot(s) for
+the corresponding channels in the DCP.
+</para>
+
+<para>
+The smoothing slider applies a variable degree of temporal smoothing
+to the plots, which can make them easier to read in some cases.
+</para>
+
+<para>
+Obviously the audio plot is no substitute for listening in an
+auditorium, but it can be useful to get levels in the right rough area.
+</para>
+
+</section>
+
+<section>
+<title>The audio map</title>
+
+<para>
+The section at the bottom of the audio tab is the &lsquo;audio
+map&rsquo;.  This governs how sound from the content will be arranged
+in the DCP.
+</para>
+
+<para>
+Down the left-hand side of the map is the list of audio channels in
+the currently-selected piece of content.  Along the top is each
+channel in the DCP.  A checked box means that the corresponding
+content channel will be copied into the corresponding DCP channel.
+</para>
+
+<para>
+Consider, for example, the case in <xref linkend="fig-audio-map-eg1"/>.
+</para>
+
+<figure id="fig-audio-map-eg1">
+  <title>Audio map example 1</title>
+  <mediaobject>
+    <imageobject> 
+       <imagedata fileref="screenshots/audio-map-eg1&scs;"/>
+    </imageobject> 
+  </mediaobject>
+</figure>
+
+<para>
+Here, we have two channels in the source which are mapped to left and
+right, respectively, in the DCP.  If we modify that as in <xref
+linkend="fig-audio-map-eg2"/>
+</para>
+
+<figure id="fig-audio-map-eg2">
+  <title>Audio map example 2</title>
+  <mediaobject>
+    <imageobject> 
+       <imagedata fileref="screenshots/audio-map-eg2&scs;"/>
+    </imageobject> 
+  </mediaobject>
+</figure>
+
+<para>
+we now have the content's streams mapped to left and right and also
+mixed together and placed in the DCP's centre channel.
+</para>
+
+<figure id="fig-audio-map-eg3">
+  <title>Audio map example 3</title>
+  <mediaobject>
+    <imageobject> 
+       <imagedata fileref="screenshots/audio-map-eg3&scs;"/>
+    </imageobject> 
+  </mediaobject>
+</figure>
+
+<para>
+As a final example, the map in <xref linkend="fig-audio-map-eg3"/>
+shows the mapping of a 5.1 source into a 5.1 DCP.
+</para>
+
+</section>
+
+<section>
+<title>Other controls</title>
+
+<para>
+&lsquo;Audio Gain&rsquo; is used to alter the volume of the
+soundtrack.  The specified gain (in dB) will be applied to each sound
+channel of your content before it is written to the DCP.
+</para>
+
+<para>
+If you use a sound processor that DCP-o-matic knows about, it can help
+you calculate changes in gain that you should apply.  Say, for
+example, that you make a test DCP and find that you have to run it at
+volume 5 instead of volume 7 to get a good sound level in the screen.
+If this is the case, click the <guilabel>Calculate...</guilabel>
+button next to the audio gain entry, and the dialogue box in <xref
+linkend="fig-calculate-audio-gain"/> will open.
+</para>
+
+<figure id="fig-calculate-audio-gain"> 
+  <title>Calculating audio gain</title>
+  <mediaobject>
+    <imageobject> 
+      <imagedata fileref="screenshots/calculate-audio-gain&scs;"/>
+    </imageobject> 
+  </mediaobject>
+</figure>
+
+<para>
+For our example, put 5 in the first box and 7 in the second and click
+<guilabel>OK</guilabel>.  DCP-o-matic will calculate the audio gain
+that it should apply to make this happen.  Then you can re-make the
+DCP (this will be reasonably fast, as the video data will already have
+been done) and it should play back at the correct volume with 7 on
+your sound-rack fader.
+</para>
+
+<para>
+Current versions of DCP-o-matic only know about the Dolby CP750.  If
+you use a different sound processor, and know the gain curve of its
+volume control, <ulink url="mailto:cth@carlh.net">get in
+touch</ulink>.
+</para>
+
+<para>
+<guilabel>Audio Delay</guilabel> is used to adjust the synchronisation
+between audio and video.  A positive delay will move the audio later
+with respect to the video, and a negative delay will move it earlier.
+</para>
+
+<para>
+The <guilabel>Audio Stream</guilabel> option allows you to select the
+audio stream to use, if the content contains more than one.  There
+might be different soundtrack languages, for example.
+</para>
+
+</section>
+</section>
 
 </chapter>
 
@@ -575,35 +906,6 @@ circumstances.
 </para>
 
 <section>
-<title>Filtering</title>
-
-<para>
-DCP-o-matic offers a variety of filters that can be applied to your
-video content.  You can set up the filters by clicking the
-<guilabel>Edit</guilabel> button next to the filters entry in the
-setup area of the DCP-o-matic window; this opens the filters selector
-as shown in <xref linkend="fig-filters"/>.
-</para>
-
-<figure id="fig-filters"> 
-  <title>Filters selector</title> 
-  <mediaobject>
-    <imageobject> 
-      <imagedata fileref="screenshots/filters&scs;"/>
-    </imageobject> 
-  </mediaobject>
-</figure>
-
-<para>
-After changing the filters setup, you will need to regenerate the DCP
-to see the effect on the cinema screen.  The preview in DCP-o-matic
-will update itself whenever filters are changed, though of course this
-image is much smaller and of lower resolution than a projected image!
-</para>
-
-</section>
-
-<section>
 <title>Scaling</title>
 
 <para>
@@ -829,156 +1131,7 @@ easier by setting the default folder that DCP-o-matic will offer in this dialogu
 See <xref linkend="ch-preferences"/>.
 </para>
 
-<section>
-<title>Setting up the content</title>
-
-<para>
-Now there are a few things to set up to describe how the content you just added should be used.
-created.  The settings are divided into four tabs: video, audio, subtitles and timing.
-</para>
-
-<section>
-<title>Video content tab</title>
-
-<para>
-This tab contains settings related to the video (i.e. the picture) of your content, as shown in <xref linkend="fig-video-tab"/>.
-</para>
-
-<figure id="fig-video-tab"> 
-  <title>Video settings tab</title>
-  <mediaobject>
-    <imageobject> 
-       XXX: content video tab
-    </imageobject> 
-  </mediaobject>
-</figure>
-
-<para>The default values in this tab are fine for our example, but the
-options are described here anyway.</para>
-
-<para>
-The first option on this tab is the &lsquo;type&rsquo; of the video.
-This specifies how DCP-o-matic should interpret the video's image.
-<guilabel>2D</guilabel> is the default; this just takes the video
-image as a standard 2D frame.  The other options allow the video to be
-interpreted as 3D; this is described later in the manual.
- XXX: link 
-</para>
-
-<para>
-The &lsquo;crop&rsquo; settings can be used to crop your content,
-which can be used to remove black borders from round the edges of DVD
-images, for example.  The specified number of pixels will be trimmed
-from each edge, and the content image in the right of the window will
-be updated to show the effect of the crop.
-</para>
-
-<para>
-The <guilabel>Scale to</guilabel> option governs the shape that
-DCP-o-matic will scale the content's image into.  Select the aspect
-ratio that your content should be presented in.
-</para>
-
-<para>
-The &lsquo;filters&rsquo; settings allow you to apply various video
-filters to the image.  These may be useful to try to improve
-poor-quality sources like DVDs.  We will discuss filtering later in the manual.
- XXX: link 
-</para>
-</section>
-
-<section>
-<title>Audio tab</title>
-
-<para>
-This tab contains settings related to the sound in your content, as shown in <xref linkend="fig-audio-tab"/>.
-</para>
-
-<figure id="fig-audio-tab"> 
-  <title>Audio settings tab</title>
-  <mediaobject>
-    <imageobject> 
-       XXX: content audio tab 
-    </imageobject> 
-  </mediaobject>
-</figure>
-
-<para>
-Once again, these settings can be left at their defaults for our Sintel example.
-</para>
-
-<para>
-The <guilabel>Show Audio</guilabel> button will instruct DCP-o-matic
-to examine the audio in your content and plot a graph of its level
-over time.  This can be useful for getting a rough idea of how loud
-the sound will be in the cinema auditorium.  The audio graphic is
-discussed in more detail later in the manual.
- XXX: link 
-</para>
-
-<para>
-&lsquo;Audio Gain&rsquo; is used to alter the volume of the
-soundtrack.  The specified gain (in dB) will be applied to each sound
-channel of your content before it is written to the DCP.
-</para>
 
-<para>
-If you use a sound processor that DCP-o-matic knows about, it can help
-you calculate changes in gain that you should apply.  Say, for
-example, that you make a test DCP and find that you have to run it at
-volume 5 instead of volume 7 to get a good sound level in the screen.
-If this is the case, click the <guilabel>Calculate...</guilabel>
-button next to the audio gain entry, and the dialogue box in <xref
-linkend="fig-calculate-audio-gain"/> will open.
-</para>
-
-<figure id="fig-calculate-audio-gain"> 
-  <title>Calculating audio gain</title>
-  <mediaobject>
-    <imageobject> 
-      <imagedata fileref="screenshots/calculate-audio-gain&scs;"/>
-    </imageobject> 
-  </mediaobject>
-</figure>
-
-<para>
-For our example, put 5 in the first box and 7 in the second and click
-<guilabel>OK</guilabel>.  DCP-o-matic will calculate the audio gain
-that it should apply to make this happen.  Then you can re-make the
-DCP (this will be reasonably fast, as the video data will already have
-been done) and it should play back at the correct volume with 7 on
-your sound-rack fader.
-</para>
-
-<para>
-Current versions of DCP-o-matic only know about the Dolby CP750.  If
-you use a different sound processor, and know the gain curve of its
-volume control, <ulink url="mailto:cth@carlh.net">get in
-touch</ulink>.
-</para>
-
-<para>
-<guilabel>Audio Delay</guilabel> is used to adjust the synchronisation
-between audio and video.  A positive delay will move the audio later
-with respect to the video, and a negative delay will move it earlier.
-</para>
-
-<para>
-The <guilabel>Audio Stream</guilabel> option allows you to select the
-audio stream to use, if the content contains more than one.  There
-might be different soundtrack languages, for example.
-</para>
-
-<para>
-The final section in the audio tab is the &lsquo;audio map&rsquo;.
-This governs how sound from the content will be arranged in the DCP.
-Our Sintel clip is in 5.1, so DCP-o-matic will default to assigning
-each channel from the content to the appropriate DCP channel.  This
-audio mapping is described in more detail later in the manual.
- XXX: link 
-</para>
-
-</section>
 
 <section>
 <title>Subtitles tab</title>
diff --git a/doc/manual/diagrams/3d-left-right.svg b/doc/manual/diagrams/3d-left-right.svg
new file mode 100644
index 000000000..02df7092f
--- /dev/null
+++ b/doc/manual/diagrams/3d-left-right.svg
@@ -0,0 +1,219 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+
+<svg
+   xmlns:dc="http://purl.org/dc/elements/1.1/"
+   xmlns:cc="http://creativecommons.org/ns#"
+   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+   xmlns:svg="http://www.w3.org/2000/svg"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   width="744.09448819"
+   height="1052.3622047"
+   id="svg4899"
+   version="1.1"
+   inkscape:version="0.48.4 r9939"
+   sodipodi:docname="New document 5">
+  <defs
+     id="defs4901">
+    <marker
+       inkscape:stockid="Arrow2Mstart"
+       orient="auto"
+       refY="0.0"
+       refX="0.0"
+       id="Arrow2Mstart"
+       style="overflow:visible">
+      <path
+         id="path5751"
+         style="fill-rule:evenodd;stroke-width:0.62500000;stroke-linejoin:round"
+         d="M 8.7185878,4.0337352 L -2.2072895,0.016013256 L 8.7185884,-4.0017078 C 6.9730900,-1.6296469 6.9831476,1.6157441 8.7185878,4.0337352 z "
+         transform="scale(0.6) translate(0,0)" />
+    </marker>
+    <marker
+       inkscape:stockid="Arrow2Mend"
+       orient="auto"
+       refY="0.0"
+       refX="0.0"
+       id="Arrow2Mend"
+       style="overflow:visible;">
+      <path
+         id="path5754"
+         style="fill-rule:evenodd;stroke-width:0.62500000;stroke-linejoin:round;"
+         d="M 8.7185878,4.0337352 L -2.2072895,0.016013256 L 8.7185884,-4.0017078 C 6.9730900,-1.6296469 6.9831476,1.6157441 8.7185878,4.0337352 z "
+         transform="scale(0.6) rotate(180) translate(0,0)" />
+    </marker>
+    <marker
+       inkscape:stockid="Arrow1Mend"
+       orient="auto"
+       refY="0.0"
+       refX="0.0"
+       id="Arrow1Mend"
+       style="overflow:visible;">
+      <path
+         id="path5736"
+         d="M 0.0,0.0 L 5.0,-5.0 L -12.5,0.0 L 5.0,5.0 L 0.0,0.0 z "
+         style="fill-rule:evenodd;stroke:#000000;stroke-width:1.0pt;"
+         transform="scale(0.4) rotate(180) translate(10,0)" />
+    </marker>
+    <marker
+       inkscape:stockid="Arrow2Mstart"
+       orient="auto"
+       refY="0"
+       refX="0"
+       id="Arrow2Mstart-2"
+       style="overflow:visible">
+      <path
+         inkscape:connector-curvature="0"
+         id="path5751-0"
+         style="fill-rule:evenodd;stroke-width:0.625;stroke-linejoin:round"
+         d="M 8.7185878,4.0337352 -2.2072895,0.01601326 8.7185884,-4.0017078 c -1.7454984,2.3720609 -1.7354408,5.6174519 -6e-7,8.035443 z"
+         transform="scale(0.6,0.6)" />
+    </marker>
+    <marker
+       inkscape:stockid="Arrow2Mend"
+       orient="auto"
+       refY="0"
+       refX="0"
+       id="Arrow2Mend-0"
+       style="overflow:visible">
+      <path
+         inkscape:connector-curvature="0"
+         id="path5754-9"
+         style="fill-rule:evenodd;stroke-width:0.625;stroke-linejoin:round"
+         d="M 8.7185878,4.0337352 -2.2072895,0.01601326 8.7185884,-4.0017078 c -1.7454984,2.3720609 -1.7354408,5.6174519 -6e-7,8.035443 z"
+         transform="scale(-0.6,-0.6)" />
+    </marker>
+  </defs>
+  <sodipodi:namedview
+     id="base"
+     pagecolor="#ffffff"
+     bordercolor="#666666"
+     borderopacity="1.0"
+     inkscape:pageopacity="0.0"
+     inkscape:pageshadow="2"
+     inkscape:zoom="1.9220686"
+     inkscape:cx="257.32427"
+     inkscape:cy="523.31639"
+     inkscape:document-units="px"
+     inkscape:current-layer="layer1"
+     showgrid="false"
+     showguides="true"
+     inkscape:guide-bbox="true"
+     inkscape:window-width="1366"
+     inkscape:window-height="714"
+     inkscape:window-x="0"
+     inkscape:window-y="27"
+     inkscape:window-maximized="1">
+    <sodipodi:guide
+       orientation="1,0"
+       position="132.28767,577.04795"
+       id="guide5717" />
+    <sodipodi:guide
+       orientation="1,0"
+       position="389.64041,568.68493"
+       id="guide5719" />
+  </sodipodi:namedview>
+  <metadata
+     id="metadata4904">
+    <rdf:RDF>
+      <cc:Work
+         rdf:about="">
+        <dc:format>image/svg+xml</dc:format>
+        <dc:type
+           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
+        <dc:title></dc:title>
+      </cc:Work>
+    </rdf:RDF>
+  </metadata>
+  <g
+     inkscape:label="Layer 1"
+     inkscape:groupmode="layer"
+     id="layer1">
+    <text
+       xml:space="preserve"
+       style="font-size:12px;font-style:normal;font-weight:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:inconsolata;-inkscape-font-specification:inconsolata"
+       x="182.2476"
+       y="462.34418"
+       id="text4907"
+       sodipodi:linespacing="125%"><tspan
+         sodipodi:role="line"
+         id="tspan4909"
+         x="182.2476"
+         y="462.34418">Left</tspan><tspan
+         sodipodi:role="line"
+         x="182.2476"
+         y="477.34418"
+         id="tspan4911">eye</tspan><tspan
+         sodipodi:role="line"
+         x="182.2476"
+         y="492.34418"
+         id="tspan4913">image</tspan></text>
+    <text
+       xml:space="preserve"
+       style="font-size:12px;font-style:normal;font-weight:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:inconsolata;-inkscape-font-specification:inconsolata"
+       x="310.8606"
+       y="462.3082"
+       id="text4915"
+       sodipodi:linespacing="125%"><tspan
+         sodipodi:role="line"
+         id="tspan4917"
+         x="310.8606"
+         y="462.3082">Right</tspan><tspan
+         sodipodi:role="line"
+         x="310.8606"
+         y="477.3082"
+         id="tspan4919">eye</tspan><tspan
+         sodipodi:role="line"
+         x="310.8606"
+         y="492.3082"
+         id="tspan4921">image</tspan></text>
+    <rect
+       style="color:#000000;fill:none;stroke:#000000;stroke-width:1.25000000000000000;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-opacity:1;stroke-dasharray:none;stroke-dashoffset:0;marker:none;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+       id="rect5713"
+       width="256.84818"
+       height="127.95709"
+       x="132.9384"
+       y="410.08606" />
+    <path
+       style="fill:none;stroke:#4d4d4d;stroke-width:1;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;stroke-miterlimit:4;stroke-dasharray:1,3;stroke-dashoffset:0"
+       d="m 261.20682,410.2865 0,127.33444"
+       id="path5715"
+       inkscape:connector-curvature="0"
+       sodipodi:nodetypes="cc" />
+    <path
+       style="fill:none;stroke:#000000;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;marker-start:url(#Arrow2Mstart);marker-end:url(#Arrow2Mend)"
+       d="m 133.81932,400.42725 254.35326,0"
+       id="path5721"
+       inkscape:connector-curvature="0"
+       sodipodi:nodetypes="cc" />
+    <text
+       xml:space="preserve"
+       style="font-size:12px;font-style:normal;font-weight:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:inconsolata;-inkscape-font-specification:inconsolata"
+       x="246.67448"
+       y="396.21439"
+       id="text6541"
+       sodipodi:linespacing="125%"><tspan
+         sodipodi:role="line"
+         id="tspan6543"
+         x="246.67448"
+         y="396.21439">width</tspan></text>
+    <path
+       style="fill:none;stroke:#000000;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;marker-start:url(#Arrow2Mstart);marker-end:url(#Arrow2Mend)"
+       d="m 133.71272,547.50392 127.24194,0"
+       id="path5721-5"
+       inkscape:connector-curvature="0"
+       sodipodi:nodetypes="cc" />
+    <text
+       xml:space="preserve"
+       style="font-size:12px;font-style:normal;font-weight:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:inconsolata;-inkscape-font-specification:inconsolata"
+       x="170.6097"
+       y="560.70441"
+       id="text6575"
+       sodipodi:linespacing="125%"><tspan
+         sodipodi:role="line"
+         id="tspan6577"
+         x="170.6097"
+         y="560.70441">width / 2</tspan></text>
+  </g>
+</svg>
diff --git a/doc/manual/screenshots/audio-map-eg1.png b/doc/manual/screenshots/audio-map-eg1.png
new file mode 100644
index 000000000..246c2e2d1
--- /dev/null
+++ b/doc/manual/screenshots/audio-map-eg1.png
diff --git a/doc/manual/screenshots/audio-map-eg2.png b/doc/manual/screenshots/audio-map-eg2.png
new file mode 100644
index 000000000..e2a9e1bb3
--- /dev/null
+++ b/doc/manual/screenshots/audio-map-eg2.png
diff --git a/doc/manual/screenshots/audio-map-eg3.png b/doc/manual/screenshots/audio-map-eg3.png
new file mode 100644
index 000000000..a1ebe3848
--- /dev/null
+++ b/doc/manual/screenshots/audio-map-eg3.png
diff --git a/doc/manual/screenshots/audio-plot.png b/doc/manual/screenshots/audio-plot.png
new file mode 100644
index 000000000..80e2fe0a2
--- /dev/null
+++ b/doc/manual/screenshots/audio-plot.png
diff --git a/doc/manual/screenshots/audio-tab.png b/doc/manual/screenshots/audio-tab.png
new file mode 100644
index 000000000..78b216793
--- /dev/null
+++ b/doc/manual/screenshots/audio-tab.png
diff --git a/doc/manual/screenshots/subtitles-tab.png b/doc/manual/screenshots/subtitles-tab.png
new file mode 100644
index 000000000..4880d8391
--- /dev/null
+++ b/doc/manual/screenshots/subtitles-tab.png
diff --git a/doc/manual/screenshots/video-tab.png b/doc/manual/screenshots/video-tab.png
new file mode 100644
index 000000000..31b120a52
--- /dev/null
+++ b/doc/manual/screenshots/video-tab.png