From: Carl Hetherington <cth@carlh.net>
Date: Mon, 28 Jan 2019 23:10:22 +0000 (+0000)
Subject: Export in the manual.
X-Git-Tag: v2.13.112~30
X-Git-Url: https://git.carlh.net/gitweb/?p=dcpomatic.git;a=commitdiff_plain;h=0317705d1031d4f529a99b26034a8c9ab7f72ba1

Export in the manual.
---

diff --git a/doc/manual/Makefile b/doc/manual/Makefile
index 8d9ee9149..8e19040b7 100644
--- a/doc/manual/Makefile
+++ b/doc/manual/Makefile
@@ -11,7 +11,7 @@ SCREENSHOTS := file-new.png video-new-film.png still-new-film.png video-select-c
                calculate-audio-gain.png add-file.png dcp-tab.png colour-conversion.png \
                prefs-kdm-email.png prefs-general.png prefs-tms.png \
                prefs-advanced.png prefs-defaults.png prefs-servers.png prefs-keys.png \
-               making-dcp.png filters.png video-tab.png audio-tab.png subtitles-tab.png timing-tab.png \
+               making-dcp.png filters.png video-tab.png audio-tab.png timing-tab.png \
                audio-plot.png audio-map-eg1.png audio-map-eg2.png audio-map-eg3.png kdm.png \
 	       kdm-creator.png
 
diff --git a/doc/manual/dcpomatic.xml b/doc/manual/dcpomatic.xml
index cc19d9ebf..0e3a9a7dd 100644
--- a/doc/manual/dcpomatic.xml
+++ b/doc/manual/dcpomatic.xml
@@ -526,7 +526,7 @@ to encode a single frame which it can then repeat.
 
 
 <!-- ============================================================== -->
-<chapter xmlns="http://docbook.org/ns/docbook" version="5.0" xml:lang="en">
+<chapter xmlns="http://docbook.org/ns/docbook" version="5.0" xml:lang="en" id="ch-manipulating-existing-dcps">
 <title>Manipulating existing DCPs</title>
 
 <para>
@@ -2065,6 +2065,43 @@ from the timeline is also preserved.
 </chapter>
 
 
+<!-- ============================================================== -->
+<chapter xml:id="ch-export" xmlns="http://docbook.org/ns/docbook" version="5.0" xml:lang="en">
+  <title>Export</title>
+
+  <para>
+    As well as creating DCPs from the content you specify, DCP-o-matic
+    can also export projects to ProRes and MP4 files.  This is most
+    often useful to convert DCPs to a file that is smaller and easier to play back.
+  </para>
+
+  <para>
+    To convert a DCP to ProRes or MP4, the first step is start a new
+    project and import the DCP (see <xref
+    linkend="ch-manipulating-existing-dcps"/>).  Then, choose
+    <guilabel>Export...</guilabel> from the <guilabel>Jobs</guilabel>
+    menu to open the export dialogue, as shown in <xref linkend="fig-export"/>.
+  </para>
+
+  <figure id="fig-export">
+    <title>Export dialogue</title>
+    <mediaobject>
+      <imageobject>
+	<imagedata fileref="screenshots/export&scs;"/>
+      </imageobject>
+    </mediaobject>
+  </figure>
+
+  <para>
+    From this dialogue you can select the required output format,
+    output file and, in the case of MP4, the quality of the output
+    file.  Higher quality files will, of course, be larger.
+  </para>
+
+  <para>
+    You can also choose whether to mix down multichannel sources to stereo and whether you want to write separate reels to separate files.
+  </para>
+</chapter>
 
 <!-- ============================================================== -->
 <chapter xml:id="ch-encryption" xmlns="http://docbook.org/ns/docbook" version="5.0" xml:lang="en">
diff --git a/doc/manual/screenshots/export.png b/doc/manual/screenshots/export.png
new file mode 100644
index 000000000..9204a66c6
Binary files /dev/null and b/doc/manual/screenshots/export.png differ