X-Git-Url: https://git.carlh.net/gitweb/?a=blobdiff_plain;f=doc%2Fmanual%2Fdcpomatic.xml;h=3df603a85d55e83261011e911b730732eebaa094;hb=b0297f77b23099a52d37becfa45930ee730bda4b;hp=0200cf26e4a9fd6335d351735556001264aaa5f0;hpb=979ead5948d8831cde9765fdedd322c5deb661d9;p=dcpomatic.git diff --git a/doc/manual/dcpomatic.xml b/doc/manual/dcpomatic.xml index 0200cf26e..3df603a85 100644 --- a/doc/manual/dcpomatic.xml +++ b/doc/manual/dcpomatic.xml @@ -253,11 +253,11 @@ shown in .
- Creating a new film + Creating a new film - + - +
@@ -267,11 +267,11 @@ linkend="fig-video-new-film"/>.
- Dialogue box for creating a new film + Dialogue box for creating a new film - + - +
@@ -301,21 +301,21 @@ select the content file to use, as shown in . -
- Adding content files +
+ Adding content files - + - +
-
- Selecting a video content file +
+ Selecting a video content file - + - +
@@ -331,12 +331,12 @@ has finished), you can look through your content using the slider to the right of the window, as shown in . -
+
Examining the content - + - +
@@ -379,9 +379,9 @@ linkend="fig-making-dcp"/>.
Making the DCP - + - +
@@ -420,12 +420,12 @@ As with video DCPs, the first step is to create a new shown in . -
- Dialogue box for creating a new film +
+ Dialogue box for creating a new film - + - +
@@ -436,12 +436,12 @@ For our example, we will add a single image file, as shown in . -
- Selecting a still content file +
+ Selecting a still content file - + - +
@@ -453,12 +453,12 @@ you will see a Play length setting, as shown in . -
+
The timing tab - + - +
@@ -605,12 +605,12 @@ in each section are described below. The Video tab controls properties of the image, as shown in . -
+
Video settings tab - + - +
@@ -628,12 +628,12 @@ left/right option tells DCP-o-matic to interpret the frame as a left-right pair, as shown in . -
+
3D left/right image type - + - +
@@ -643,12 +643,12 @@ DCP-o-matic to see the frame as a top-bottom pair, as shown in . -
+
3D top/bottom image type - + - +
@@ -680,12 +680,12 @@ setup area of the DCP-o-matic window; this opens the filters selector as shown in . -
- Filters selector +
+ Filters selector - + - +
@@ -746,11 +746,11 @@ colour conversion editing dialogue box:
- Dialogue box for custom colour conversion + Dialogue box for custom colour conversion - + - +
@@ -829,12 +829,12 @@ frame-rate conversion. The Audio tab controls properties of the image, as shown in . -
+
Audio settings tab - + - +
@@ -892,9 +892,9 @@ Consider, for example, the case in .
Audio map example 1 - + - +
@@ -908,9 +908,9 @@ the settings to those shown in
Audio map example 2 - + - +
@@ -927,9 +927,9 @@ and right.
Audio map example 3 - + - +
@@ -961,12 +961,12 @@ button next to the audio gain entry, and the dialogue box in will open. -
+
Calculating audio gain - + - +
@@ -1005,12 +1005,12 @@ The subtitles tab contains settings related to subtitles in your content, as shown in . -
+
Subtitle settings tab - + - +
@@ -1027,18 +1027,18 @@ linkend="fig-burn-in"/> and
Burnt-in subtitles - + - +
Separate subtitles - + - +
@@ -1061,8 +1061,15 @@ burnt into the image. -Select the With Subtitles check-box to enable -subtitles. +Select the Use Subtitles check-box to enable +these subtitles. + + + +Select the Burn subtitles into image check-box to +burn these subtitles into the image; if this is not ticked the +subtitles will be included separately in the DCP to be rendered by the +projector. @@ -1103,12 +1110,12 @@ The timing tab contains settings related to the timing of your content, as shown in . -
+
Timing settings tab - + - +
@@ -1118,12 +1125,12 @@ These are expressed as four numbers, as shown in . -
+
Timecode - + - +
@@ -1190,12 +1197,12 @@ happen with a trailer). The source image is shown in . -
+
Example image to demonstrate video processing - + - +
@@ -1221,12 +1228,12 @@ bottom. This would give the new image shown in . -
+
Example image after cropping - + - +
@@ -1263,12 +1270,12 @@ size of 1998 x 836. This gives us a new version of the image as shown in . -
+
Example image after cropping and scaling - + - +
@@ -1283,12 +1290,12 @@ shares out this black equally, as shown in . -
+
Example image in the DCP - + - +
@@ -1305,12 +1312,12 @@ controls for these settings are in the DCP tab of the main window, as shown in . -
+
DCP settings tab - + - +
@@ -1320,7 +1327,7 @@ of the film that is being encoded. If Use ISDCF name is not ticked, the name that you specify will be used as-is for the name of the DCP. If Use ISDCF name is ticked, the name that you enter will be used as part of a -ISDCF-compliant name. +ISDCF-compliant name. @@ -1404,13 +1411,6 @@ to what DCP-o-matic thinks is the best given the content that you have added. - -Burn subtitles into image should be selected if -you want DCP-o-matic to overlay the subtitles onto the video frame -before encoding. Leave this un-ticked to include the subtitles -separately in the DCP. - - The 3D button will set your DCP to 3D mode if it is checked. A 3D DCP will then be created, and any 2D content will be @@ -1445,7 +1445,7 @@ unused channel will be filled with silence. The Processor control allows you to select a -process to apply to the audio before it goes into the DCP. Two processes are currently provided: +process to apply to the audio before it goes into the DCP. Two processes are currently provided: @@ -1484,12 +1484,12 @@ the sound will be in the cinema auditorium. A typical plot is shown in -
+
Audio plot - + - +
@@ -1560,8 +1560,8 @@ methods to understand it. -We suppose that we are trying to distribute a DCP, to -Alice's cinema, without a troublemaker called Mallory being able to +We suppose that we are trying to send a DCP to +Alice's cinema without a troublemaker called Mallory being able to watch it himself. @@ -1588,11 +1588,12 @@ happened to know Mallory, she could just send him a copy of the key. -The clever bit in DCP encryption requires the use of public-key +The clever bit in the process requires the use of public-key encryption. With this technique we can encrypt a block of data using some ‘public’ key. That data can then only be decrypted -using a different ‘private’ key. The -private and public keys are related mathematically, but it is +using a corresponding private key which is +different to the public key. The private and +public keys form a pair which are related mathematically, but it is extremely hard (or rather, virtually impossible) to derive the private key from the public key. @@ -1659,11 +1660,11 @@ will open the KDM dialogue box, as shown in .
- KDM dialog + KDM dialog - + - +
@@ -1776,12 +1777,12 @@ menu. The dialogue is split into seven tabs. The general tab is shown in . -
- General preferences +
+ General preferences - + - +
@@ -1840,6 +1841,16 @@ like to live on the bleeding edge! + +
+Issuer and creator + + +With these controls you can set the issuer and creator strings that +will be put into the DCPs which you create. + +
+ @@ -1851,11 +1862,11 @@ The defaults tab is shown in .
- Defaults preferences + Defaults preferences - + - +
@@ -1875,11 +1886,11 @@ The servers tab is shown in .
- Servers preferences + Servers preferences - + - +
@@ -1908,21 +1919,21 @@ related to the keys and certificates used in some parts of DCP creation. -
- Keys preferences +
+ Keys preferences - + - +
At the top of the tab is the chain of certificates that will be used to sign DCPs and KDMs. DCP-o-matic creates a random chain when you -first run it, so if you are happy to use a randomly-generated chain -you can ignore the preferences. Otherwise, you can add or remove -certificates from the chain using the Add... and +first run it and if you are happy to use this chain you can ignore the +preferences. Otherwise, you can add or remove certificates from the +chain using the Add... and Remove buttons. @@ -1942,13 +1953,22 @@ corresponds to the public key held in the leaf certificate. -The bottom of the tab specifies the certificate and private key that -is used to decrypt DCPs if they are imported as sources to -DCP-o-matic. If you want to import an encrypted DCP you will need to -give the decryption certificate to the distributor of the DCP so that -they can generate a DKDM for you. As with the certificate chain, -DCP-o-matic will create a certificate and private key for you. You -can also choose to load your own certificate and key. +Underneath the details of the certificate chain and private key for +signing of DCPs and KDMs is a second chain and key which is used by +DCP-o-matic when you import an encrypted DCP as a piece of content. +The leaf certificate of this chain contains the public key that should +be used when targeting a KDM at DCP-o-matic. + + + +If you want to import an encrypted DCP you will need to give the +decryption certificate to the distributor of the DCP so that they can +generate a DKDM for you. You can save this certificate to disk by +clicking Export DCP decryption certificate. As +with the signing chain, DCP-o-matic will create a certificate chain +and private key for you. You can also choose to load your own +certificates and key or re-make the chain and key with new, random +values. @@ -1961,28 +1981,43 @@ can also choose to load your own certificate and key. The TMS tab (shown in ) gives some options for specifying details about your theatre management system -(TMS). If you do this, and your TMS accepts SSH connections, you can -upload DCPs directly from DCP-o-matic to the TMS using the +(TMS). If you do this, and your TMS accepts SSH or FTP connections, +you can upload DCPs directly from DCP-o-matic to the TMS using the Send DCP to TMS option in the Jobs menu. -
- TMS preferences +
+ TMS preferences - + - +
+ +Protocol should be set to SCP or FTP as +appropriate for your TMS. We know that the Arts Alliance Media (AAM) +and the Doremi ranges uses SCP connections, and that Dolby's TMSs use +FTP. Do let us know if you use any other type of TMS with the +Send DCP to TMS feature. + + TMS IP address should be set to the IP address of your TMS, TMS target path to the place that DCPs should be uploaded to (which will be relative to the home directory of -the SSH user). Finally, the user name and password are the -credentials required to log into the TMS via SSH. +the SSH or FTP user). Finally, the user name and password are the +credentials required to log into the TMS via SSH or FTP. + + +Note that for this to work on Doremi servers you will need to set the +PasswordAuthentication option in your server's +sshd_config to yes. + + @@ -1994,12 +2029,12 @@ credentials required to log into the TMS via SSH. The KDM email is shown in . -
- KDM email preferences +
+ KDM email preferences - + - +
@@ -2049,12 +2084,12 @@ The Reset to default text will replace the current KDM emai The advanced preferences are shown in . -
- Advanced preferences +
+ Advanced preferences - + - +
@@ -2072,6 +2107,12 @@ useful for experimentation. Again, you are strongly advised to leave this unticked for normal use. + +Only servers encode makes DCP-o-matic encode +JPEG2000 data only on encoding servers and not on the host. We +suggest you leave this un-ticked unless you have a good reason to do otherwise. + + The four checkboxes labelled Log control what sort of messages DCP-o-matic writes to its log file when creating a @@ -2332,12 +2373,12 @@ linkend="fig-file-structure"/> shows the files that might be generated after you have created a DCP for a film called ‘DCP Test’. -
- Creating a new film +
+ Creating a new film - + - +