Document re-encode checkbox.

[dcpomatic.git] / doc / manual / dcpomatic.xml

diff --git a/doc/manual/dcpomatic.xml b/doc/manual/dcpomatic.xml
index cc19d9ebf9a6e1b3230c2542954006875bf1d757..69eff81383c797d0421819551010d13d1692d476 100644 (file)
--- 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>
@@ -1536,6 +1536,54 @@ any changes to the corresponding timecode.
 </section>
 
 
+<!-- ============================================================== -->
+<section>
+  <title>Timeline</title>
+
+  <para>
+    The timeline window gives an overview of all the pieces of content
+    in your film, and how they are arranged.  You can open the
+    timeline by clicking the <guilabel>Timeline...</guilabel> button
+    next to the content list.  This will open a window like the one in <xref linkend="fig-timeline1"/>.
+  </para>
+
+  <figure id="fig-timeline1">
+    <title>Timeline</title>
+    <mediaobject>
+      <imageobject>
+       <imagedata fileref="screenshots/timeline1&scs;"/>
+      </imageobject>
+    </mediaobject>
+  </figure>
+
+  <para>
+    The X axis represents time, and you can see the time codes (in
+    hours:minutes:seconds) along the bottom of the window.  Pieces of
+    content are represented with rectangles in the main part of the
+    window.  Content containing different types of data (e.g. a MP4
+    file with video, audio and subtitles) have a rectangle for each
+    type.
+  </para>
+
+  <para>
+    Within the timeline you can select content by clicking, and drag
+    it to change its position.  Right-clicking a piece of content will
+    open the content menu.
+  </para>
+
+  <para>
+    The toolbar at the top of the window offers the following tools:
+  </para>
+
+  <itemizedlist>
+    <listitem>Select &mdash; to select and move content.</listitem>
+    <listitem>Zoom in &mdash; to drag out an area that you want to see more closely.</listitem>
+    <listitem>Zoom out &mdash; to zoom out so that the window shows the whole film.</listitem>
+    <listitem>Snap &mdash; when enabled, content will snap to other content when you drag it close.</listitem>
+    <listitem>Sequence &mdash; when enabled, content will be kept in sequence, without gaps, even if some content is removed.</listitem>
+  </itemizedlist>
+</section>
+
 <!-- ============================================================== -->
 <section>
 <title>Video processing pipeline</title>
@@ -1820,6 +1868,17 @@ bandwidth can be between 50 and 250 megabits per second (Mbit/s).
 Most commercial DCPs use bit rates between 75 and 125 Mbit/s.
 </para>
 
+<para>
+<guilabel>Re-encode JPEG2000 data from input</guilabel> governs
+whether or not JPEG2000-encoded data from a piece of content (usually
+a DCP) will be re-used in the output data as-is or whether it will be
+decoded and re-encoded by DCP-o-matic.  If the option is enabled
+DCP-o-matic will decompress any JPEG2000 data it finds and re-encode
+it.  This is useful if you want to reduce the bitrate of a DCP.
+Usually you will achieve better quality and quicker results by leaving
+this option switched off.
+</para>
+
 <para>
 The <guilabel>Audio Channels</guilabel> control sets the number of
 audio channels that the DCP will have.  If the DCP has any channels
@@ -2065,6 +2124,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">