X-Git-Url: https://git.carlh.net/gitweb/?p=dcpomatic.git;a=blobdiff_plain;f=doc%2Fmanual%2Fdcpomatic.xml;h=312e3324b0ca917b24d2bb73b2b72045dc8218d9;hp=3df603a85d55e83261011e911b730732eebaa094;hb=7fc0f6e56c25f01b3bc42f8b5f8d3cf5935bb875;hpb=15a22a16c999a936f945d8620d2c64eb5248a505 diff --git a/doc/manual/dcpomatic.xml b/doc/manual/dcpomatic.xml index 3df603a85..312e3324b 100644 --- a/doc/manual/dcpomatic.xml +++ b/doc/manual/dcpomatic.xml @@ -10,11 +10,6 @@ ]> - - DCP-o-matic users' manual CarlHetherington @@ -34,8 +29,8 @@ Hello, and welcome to DCP-o-matic! DCP-o-matic is a program to generate Digital -Cinema Packages (DCPs) from DVDs, Blu-Rays, video files such as MP4 -and AVI, or still images. The resulting DCPs will play on modern digital +Cinema Packages (DCPs) from almost any video, audio and/or +subtitle source files. The resulting DCPs will play on modern digital cinema projectors. @@ -110,40 +105,53 @@ like to install it. +
-Ubuntu Linux +Debian or Ubuntu Linux -You can install DCP-o-matic on Ubuntu 12.04 (‘Precise -Pangolin’), 14.04 (‘Trusty Tahr’) or 15.04 -(‘Vivid Vervet’) using .deb packages: -download the appropriate package from http://dcpomatic.com/ and -double-click it. Ubuntu will install the necessary bits and pieces -and set DCP-o-matic up for you. + You can install DCP-o-matic on: + + Debian 7 (‘wheezy’) + Debian 8 (‘jessie’) + Debian unstable (‘sid’) + Ubuntu 12.04 (‘Precise Pangolin’) + Ubuntu 14.04 (‘Trusty Tahr’) + Ubuntu 15.04 (‘Vivid Vervet’) + Ubuntu 15.10 (‘Wily Werewolf’) + + + +using .deb packages: download the appropriate package +from http://dcpomatic.com/ +and double-click it. Debian or Ubuntu will install the necessary bits and +pieces and set DCP-o-matic up for you. +
+
-Debian Linux - -Packages are available for Debian 7 (squeeze), 8 (jessie) and unstable (sid) from http://dcpomatic.com/. - + Fedora Linux + + There are .rpm packages for Fedora 22 and 23 on + http://dcpomatic.com/ +
+
-Centos Linux - -Packages are available for Centos 6.5 and 7 from http://dcpomatic.com/. - + Centos Linux + There are .rpm packages for Centos 6.5 and 7 on + http://dcpomatic.com/ +
+ @@ -174,6 +182,7 @@ The following dependencies are required: FFmpeg libsndfile +libsamplerate OpenSSL libopenjpeg ImageMagick @@ -185,8 +194,10 @@ The following dependencies are required: xmlsec curl libzip -libdcp -libcxml +libdcp +libsub +libcxml +libicu @@ -478,6 +489,161 @@ to encode a single frame which it can then repeat. + + +Manipulating existing DCPs + + +Frequently DCP-o-matic is used to take content in formats such as MP4 +and convert it to JPEG2000 for a DCP. Alternatively, it can be used +to take existing DCPs and modify them in various ways. + + +
+Importing a DCP into DCP-o-matic + + +If you want to do something to an existing DCP the first step is to +import it. Click Add folder... and select your +DCP's folder. It will be added to the DCP-o-matic project. If the +DCP is unencrypted you can preview it in the normal way, though +playback will be very slow as decoding of DCPs is almost as +computationally intensive as encoding them. + + +
+ + +
+Decrypting encrypted DCPs + + +DCPs can be encrypted (see for +details). If you import an encrypted DCP you will need a key, in the +form of a Key Delivery Message (KDM), to decrypt it. + + + +KDMs must be prepared by the organisation which created the DCP. They +contain the keys to decrypt the DCP wrapped up in such a way that only +the intended recipient can read them. You will need to provide the +organisation with a certificate which identifies your copy of +DCP-o-matic and allows them to create a KDM for you. + + + +To get DCP-o-matic's decryption certificate, open the Preferences +dialogue (see ) and go to the +Keys tab. Click the Export DCP +decryption certificate... button at the bottom of this tab +and save the certificate. Send this certificate to the DCP creators +and they can create a KDM to allow DCP-o-matic to decrypt their DCP. + + + +Once you have your KDM, right-click the DCP's name in DCP-o-matic and +choose Add KDM.... Specify your KDM and (all +being well) the DCP will be decrypted and become available for preview. + + +
+ + +
+Making a DCP from a DCP + + +In many ways, using DCPs as content in +DCP-o-matic is the same as using any other content. There are a few +things to note, though. + + + +
+Re-use of existing data + + +Where possible DCP-o-matic will re-use existing JPEG2000-compressed +data from DCP content without modification. This has the advantage +that creation of the new DCP will be quick, as the time-consuming +JPEG2000 encoding is not necessary. + + + +DCP-o-matic can do this if you avoid changes to the following content +settings: + + + +Crop +Scaling +Subtitle burn-in +Fades +Colour conversion + + + +If you do change any of these settings on a piece of DCP content +DCP-o-matic will decode and then re-encode the JPEG2000 data. + + +
+ + +
+Making overlay files + + +With its default settings, DCP-o-matic will take any data from DCP +content and copy it into the DCP that it creates. See . + + +
+Creating a new DCP by copying an existing one + +
+ + +This can be inefficient in some cases. Consider, for example, a film +which has ten different translations for which the subtitles are +different but video and audio are the same. If the video and audio +content takes up, say, 100Gb this means that the set of DCPs for every +translation would be about 1Tb with a lot of duplicated data. + + + +The DCP format has a solution to this problem. One DCP can refer to +the ‘assets’ (picture, sound or subtitle) of another DCP. +For our translation example this means that we could have a +‘base’ DCP (often called the OV or Original Version) +containing video, audio and one set of subtitles and then any number +of overlay DCPs (often called VF or Version Files) which refer to the +base version and replace the original subtitles with their own. shows this principle for one of our +translations. The DCP that we make refers to the original content +DCP's video and audio rather than containing a copy. + + +
+Creating a new DCP by referring to an existing one + +
+ + +To play back the subtitled DCP the projectionist ingests both the base +(OV) DCP and the overlay (VF) DCP, then plays the VF one. + + +
+ +
+ + + + + + + Content settings @@ -485,8 +651,8 @@ to encode a single frame which it can then repeat. 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 chapter describes those features in -detail. +content that goes into your DCP, and this chapter describes those +features in detail.
@@ -1028,7 +1194,7 @@ linkend="fig-burn-in"/> and Burnt-in subtitles - + @@ -1037,7 +1203,7 @@ linkend="fig-burn-in"/> and Separate subtitles - + @@ -1129,7 +1295,7 @@ linkend="fig-timecode"/>. Timecode - + @@ -1464,13 +1630,20 @@ cinema audio systems. DCP Ls is input L bandpass-filtered between 4.8kHz and 20kHz. DCP Rs is input R bandpass-filtered between 4.8kHz and 20kHz. - - - This upmixing algorithm is due to Gérald Maruccia. - + +Stereo to 5.1 up-mixer B — this uses a different approach: + + DCP L is input L. + DCP R is input R. + DCP C is input L + input R taken down by 3dB. + DCP Lfe is DCP C bandpass filtered between 20Hz and 150Hz. + DCP Ls and Rs are input L - input R with a 20ms delay. + + +
@@ -1686,7 +1859,7 @@ KDMs for any screens that it knows about. To add a cinema, click Add Cinema.... This opens a dialogue box into which you can enter the cinema's name, and optionally an email address. This email address can be used to -get DCP-o-matic to deliver KDMs via email, but it is optional. +get DCP-o-matic to deliver KDMs via email. @@ -2377,7 +2550,7 @@ after you have created a DCP for a film called ‘DCP Test’. Creating a new film - +