X-Git-Url: https://git.carlh.net/gitweb/?a=blobdiff_plain;f=doc%2Fmanual%2Fdcpomatic.xml;h=1ee817b5d6171ad75c8870657c0fc33e1dc05fdd;hb=8433b9097fb44a965b47f8a8f40bc49fc8d2913e;hp=9155d6a97fb4716a40e2e2f81c3257ecc9bee21d;hpb=424d05c682958992c8b283bdbae0549c5b002730;p=dcpomatic.git
diff --git a/doc/manual/dcpomatic.xml b/doc/manual/dcpomatic.xml
index 9155d6a97..1ee817b5d 100644
--- a/doc/manual/dcpomatic.xml
+++ b/doc/manual/dcpomatic.xml
@@ -32,8 +32,8 @@ Hello, and welcome to DCP-o-matic!
Creation of Digital
Cinema Packages (DCPs) from video, audio and/or
- subtitle files.
- Playback of DCPs on a PC.
+ subtitle and closed caption files.
+ Playback and verification of DCPs on a PC/Mac.Creation of KDMs for DCPs.
@@ -119,7 +119,7 @@ Windows version.
DCP-o-matic will run on Mac OS X version 10.6 (Snow Leopard) and
-higher. DCP-o-matic is split into four separate applications, each of
+higher. DCP-o-matic is split into five separate applications, each of
which can be installed by downloading the .dmg,
double-clicking to open and then dragging the icon to your
Applications folder.
@@ -141,22 +141,15 @@ with the first (main) part.
- Debian 7 (‘wheezy’)
- Debian 8 (‘jessie’)
- Debian 9 (‘squeeze’)
- Debian unstable (‘sid’)
- Ubuntu 14.04 (‘Trusty Tahr’)
- Ubuntu 16.04 (‘Xenial Xerus’)
- Ubuntu 18.04 (‘Bionic Beaver’)
- Mint 17
- Mint 18
- Mint 19
+ Debian 7 (‘wheezy’), 8 (‘jessie’), 9 (‘squeeze’) and unstable (‘sid’)
+ Ubuntu 14.04 (‘Trusty Tahr’), 16.04 (‘Xenial Xerus’), 18.04 (‘Bionic Beaver’) and 18.10 (‘Cosmic Cuttlefish’)
+ Mint 17, 18 and 19
using .deb packages: download the appropriate package
from http://dcpomatic.com/
-and double-click it. Debian or Ubuntu will install the necessary bits and
+and double-click it. Debian, Ubuntu or Mint will install the necessary bits and
pieces and set DCP-o-matic up for you.
@@ -167,7 +160,7 @@ pieces and set DCP-o-matic up for you.
Fedora, Centos and Mageia Linux
- There are .rpm packages for Fedora 27 and 28, Centos 6 and 7 and Mageia 6 on
+ There are .rpm packages for Fedora 27, 28 and 29, Centos 6 and 7 and Mageia 6 on
http://dcpomatic.com/
@@ -204,7 +197,6 @@ The following dependencies are required:
libsamplerateOpenSSLlibopenjpeg
-ImageMagickBoostlibsshGTK (on Linux)
@@ -213,10 +205,10 @@ The following dependencies are required:
xmlseccurllibzip
-asdcplib with some patches
-libdcp
-libsub
-libcxml
+asdcplib with some patches
+libdcp
+libsub
+libcxmllocked_sstreamrtaudiolibicu
@@ -289,7 +281,7 @@ shown in .
Creating a new film
-
+
@@ -405,7 +397,7 @@ linkend="fig-making-dcp"/>.
Making the DCP
-
+
@@ -735,6 +727,55 @@ To add one or more movie, sound, still-image or subtitle files, select
Add file(s)... and choose them from the selector.
+
+DCP-o-matic will automatically map a set of audio files to the correct channels if you include appropriate ‘tags’ in your filenames, as shown in .
+
+
+
+ Audio file naming
+
+
+
+ Tag
+ Examples
+ Channel
+
+
+
+
+ L surrounded by ._ or -
+ film-L.wav my_movie_L_final.wav
+ Left
+
+
+ R surrounded by ._ or -
+ film-R.wav my_movie_R_final.wav
+ Right
+
+
+ C surrounded by ._ or -
+ film-C.wav my_movie_C_final.wav
+ Centre
+
+
+ Lfe surrounded by ._ or -
+ film-Lfe.wav my_movie_Lfe_final.wav
+ LFE (sub)
+
+
+ Ls surrounded by ._ or -
+ film-Ls.wav my_movie_Ls_final.wav
+ Left surround
+
+
+ Rs surrounded by ._ or -
+ film-Rs.wav my_movie_Rs_final.wav
+ Right surround
+
+
+
+
+
To add a directory (folder) of images, choose Add
folder... and choose the directory from the selector.
@@ -996,11 +1037,11 @@ url="http://dcpomatic.com/manual/colour.pdf">colour.pdf.
Other settings
-The crop 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.
+The crop settings can be used to crop your
+content, which is often used to remove black borders from the edges of
+the image. 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.
@@ -2353,8 +2394,8 @@ system; possible locations are listed in Preferences
-DCP-o-matic provides a few preferences which can be used to modify its
-behaviour. This chapter explains those options.
+DCP-o-matic provides preferences which can be used to modify its
+behaviour. They are described in this chapter.
@@ -2726,12 +2767,39 @@ Note that for this to work on Doremi servers you will need to set the
+
+
+Email
+
+
+The Email tab is shown in .
+
+
+
+
+
+These settings are used when DCP-o-matic sends emails.
+
+
+
+ Outgoing mail server should be the host name of a mail (SMTP) server that DCP-o-matic can use. You can also specify the port that DCP-o-matic should use. User name and Password are the credentials that are required to send email through the server you have specified.
+
+
+
+
KDM email
-The KDM email is shown in .
+The KDM email tab is shown in .
+
+
+Accounts
+
+
+The Accounts tab is shown in .
+
+
+
+
+
+DCP-o-matic can download projector certificates from the Barco and
+Christie websites if you have the appropriate credentials. Enter your
+usernames and passwords.
+
+
+
+
+
+
+
+Notifications
+
+
+The Notifications tab is shown in .
+
+
+
+
+
+DCP-o-matic can notify the user when jobs have completed. These
+notifications can be either or both of a message box on-screen (if
+Message box is ticked) and email (if
+Email is ticked). If you enable email
+notifications you can fill in the details of the emails you want to
+send.
+
+
+
+The bottom box in the tab is the contents of the email that should
+be sent. DCP-o-matic will replace the ‘magic’ strings
+$JOB_NAME and $JOB_STATUS in the with the
+details of the job that has completed.
+
+
+
+
+
Cover sheet
@@ -2936,8 +3066,8 @@ even refuse to ingest.
The only rates that are (pretty much) guaranteed to work on all DCI
-projectors are 24 frames per second (fps) for video and 48kHz or 96kHz
-for audio. If you are sending your DCPs to unknown places it wise to
+projectors are 24 frames per second (fps) for video and 48kHz for
+audio. If you are sending DCPs to unknown places it is wise to
consider using these rates if at all possible.
@@ -2949,7 +3079,7 @@ consider using these rates if at all possible.
Other often-supported rates
Many projectors now in the wild support additional video frame rates:
-25, 30 and 48 fps.
+25, 30, 48, 50 and 60 fps.