More cscript tweaks.
[dcpomatic.git] / doc / manual / dvdomatic.xml
index 753358c22a84e86d52aa9678b69cb3a25b3008fc..58315eca6ccb53cb28c7aa17df87819267599890 100644 (file)
@@ -277,7 +277,7 @@ that there will be no sound, and playback might not be entirely
 accurate (it may be slightly slower or faster than it should be, for
 example).  This player is really only intended for brief inspection of
 content; if you need to check it more thoroughly, use another player
-such as Totem, mplayer or VLC.
+such as <ulink url="http://projects.gnome.org/totem/index.html">Totem</ulink>, <ulink url="http://www.mplayerhq.hu/design7/news.html">mplayer</ulink> or <ulink url="http://www.videolan.org/vlc/index.html">VLC</ulink>.
 </para>
 
 </section>
@@ -324,6 +324,11 @@ can be specified in the DCI name details dialogue box, which you can
 open by clicking on the <guilabel>Details</guilabel> button.
 </para>
 
+<para>
+If the DCP name is long, it may not all be visible.  You can see the
+full name by hovering the mouse pointer over the partial name.
+</para>
+
 <para>
 The <guilabel>Trust content's header</guilabel> button starts off
 checked, and this means that DVD-o-matic will use the content's header
@@ -376,12 +381,9 @@ can project the DCP using your projector's Flat preset.
 The remaining options can often be left alone, but may sometimes be
 useful.  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 <guilabel>L</guilabel>,
-<guilabel>R</guilabel>, <guilabel>T</guilabel> and
-<guilabel>B</guilabel> settings correspond to the left, right, top and
-bottom of the image respectively.  The specified number of pixels will
+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 cropping in action.
+window will be updated to show the effect of the crop.
 </para>
 
 <para>
@@ -399,6 +401,19 @@ most situations.
 <!-- XXX: link -->
 </para>
 
+<para>
+The &lsquo;colour look-up table&rsquo; specifies the colour space that
+your input content will be expected to be in.  If in doubt, leave it
+set to &lsquo;sRGB&rsquo;.
+</para>
+
+<para>
+Finally, the &lsquo;JPEG2000 bandwidth&rsquo; setting changes how big the final
+image files used within the DCP will be.  Larger numbers will give
+better quality, but correspondingly larger DCPs.  The bandwidth can be
+between 50 and 250 megabits per second (MBps).
+</para>
+
 </section>
 
 <section>
@@ -531,8 +546,7 @@ Now that we have set everything up, choose <guilabel>Make
 DCP</guilabel> from the <guilabel>Jobs</guilabel> menu.  DVD-o-matic
 will encode your DCP.  This may take some time (many hours in some
 cases).  While the job is in progress, DVD-o-matic will update you on
-how it is getting on with the progress bar in the bottom right hand
-corner of its window, as shown in <xref linkend="fig-making-dcp"/>.
+how it is getting on with the progress bar in the bottom of its window, as shown in <xref linkend="fig-making-dcp"/>.
 </para>
 
 <figure id="fig-making-dcp">
@@ -700,16 +714,6 @@ This is the directory which DVD-o-matic will suggest initially as a place to put
 
 </section>
 
-<section>
-<title>Colour look-up table</title>
-
-<para>
-This specifies the colour space that your input content will be
-expected to be in.  If in doubt, leave it set to &lsquo;sRGB&rsquo;.
-</para>
-
-</section>
-
 <section>
 <title>A/B options</title>
 
@@ -767,17 +771,6 @@ as shown in <xref linkend="fig-filters"/>.
   </mediaobject>
 </figure>
 
-<para>
-As it stands, these filters are somewhat disorganised!  Work is
-ongoing to test them with various content and choose a selection which
-work well for cinema applications.
-</para>
-
-<para>
-If you want to examine them yourself, you may find the A/B option (see
-<xref linkend="sec-ab"/>) useful.
-</para>
-
 <para>
 After changing the filters setup, you will need to regenerate the DCP
 to see the effect on the cinema screen.  The preview in DVD-o-matic