From: Carl Hetherington Date: Wed, 10 Jun 2015 22:02:41 +0000 (+0100) Subject: Some manual bits from master. X-Git-Tag: v2.0.51~24 X-Git-Url: https://main.carlh.net/gitweb/?p=dcpomatic.git;a=commitdiff_plain;h=c3d02996590fb4589b547cf81fb9c69ce34d98bc Some manual bits from master. --- diff --git a/doc/manual/dcpomatic.xml b/doc/manual/dcpomatic.xml index 734e13de5..a2610f990 100644 --- a/doc/manual/dcpomatic.xml +++ b/doc/manual/dcpomatic.xml @@ -16,7 +16,7 @@ --> -DCP-o-matic +DCP-o-matic users' manual CarlHetherington @@ -39,12 +39,6 @@ and AVI, or still images. The resulting DCPs will play on modern digital cinema projectors. - -You might find it useful to make DVDs easier to present, to encode -independently-shot feature films, or to generate local advertising for -your cinema. - - @@ -70,6 +64,8 @@ This manual uses icons from the Tango + + Installation @@ -181,7 +177,6 @@ The following dependencies are required: libssh GTK (on Linux) wxWidgets -libquickmail libxml++ xmlsec curl @@ -519,8 +514,13 @@ images which should be treated as the frames of a video. To add one or more movie, sound or still-image files, select Add file(s)... and choose them from the selector. -To add a directory of images, choose Add -directory... and do similar. + + + +To add a directory (folder) of images, choose Add +folder... and choose the directory from the selector. +DCP-o-matic will open a small dialogue box where you can enter the +frame rate that your image sequence should be run at. @@ -542,6 +542,13 @@ content list. The content property controls will then become active for that piece of content. + +If you want to change the properties for multiple pieces of content at +the same time, select the content in the list by clicking the first +piece then clicking the other pieces with shift key +held down. Note that not all settings can be changed in this way. + + The content properties are split up into four sections: Video, Audio, @@ -681,21 +688,43 @@ dialogue box, as shown in . In most cases, it is only necessary to select one of DCP-o-matic's -presets. DCP-o-matic knows how to convert from two common -colourspaces: sRGB and Rec. 709, so if your content was graded using -one of those you can select the appropriate preset. +presets. DCP-o-matic knows how to convert from four common +colourspaces: sRGB, Rec. 601, Rec. 709 and P3. If you do not know +which preset you should use, refer to the suggestions in . + +Suggested colour conversion settings + + + + + +sRGBStill images in RGB, e.g. photographs + + +Rec. 601Standard-definition content (lower than about 1000 pixels across) including DVD rips. + + +Rec. 709High-definition content including Blu-Ray rips. + + +P3Content explicitly graded to P3. + + + +
+ -For other colour spaces you can edit the values in the lower half of -the dialogue box as you wish. Alternatively, create a new colour -conversion preset using the preferences dialog, as described in . +For other required colour conversion, and if you know what you are +doing, you can edit the values in the lower half of the dialogue box. -Colour conversion is discussed in more detail in a separate document -colour.pdf. +Colour conversion is discussed in much more detail in a separate +document colour.pdf. @@ -728,10 +757,11 @@ ratio that your content should be presented in. At the bottom of the video tab is a short description of what will happen to your video with the current settings. In the example of , DCP-o-matic is telling you that the -video file is 1920x1080 pixels (which is a ratio of 1.78:1). Since -the controls specify ‘Flat’ for the ratio, DCP-o-matic -scales the content image to 1998x1080, which is the DCI flat -resolution at 2K. +video file is 1920x1080 pixels and it has square pixels (a pixel +aspect ratio of 1.00) hence its display aspect ratio is 1.78:1. Since +the controls specify ‘16.9’ for the ratio, DCP-o-matic +does not scale the image but pads it to the DCP's container ratio of +1.85:1. For a 2K DCP this is 1998x1080 pixels. @@ -1267,6 +1297,16 @@ can be specified in the ISDCF name details dialogue box, which you can open by clicking on the Details button. + +If you want to take the ISDCF-compliant name that DCP-o-matic +generates and modify it, click Copy as name and +the ISDCF name will be copied into the Name box. +You can then edit it as you wish. The DCP name should not matter (in +that it should not affect how the DCP ingests or plays) but +projectionists will appreciate it if you use the standard naming +scheme as it makes it easier to identify details of the content. + + 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. @@ -1297,6 +1337,12 @@ content to fit the specified frame rate. Frame rates are discussed in more detail in . + +The Use best button sets the DCP video frame rate +to what DCP-o-matic thinks is the best given the content that you have +added. + + The Signed check-box sets whether or not the DCP is signed. This is rarely important; if in doubt, tick it. @@ -1310,15 +1356,19 @@ linkend="ch-encryption"/>. -The Use best button sets the DCP video frame rate -to what DCP-o-matic thinks is the best given the content that you have -added. +If you use encryption DCP-o-matic will generate a random encryption +key for you. To specify your own key, click the +Edit.. button next to the key. The Audio Channels control sets the number of audio channels that the DCP will have. If the DCP has any channels for which there is no content audio they will be replaced by silence. +You can only set an even number of channels here, since that is +required by the DCI standard. If you want an odd number of channels, +set the DCP channel count to one greater than you need and the +unused channel will be filled with silence. @@ -1336,10 +1386,11 @@ high enough resolution to be worth presenting in 4K. -The JPEG2000 bandwidth; 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 (Mbit/s). +The JPEG2000 bandwidth; 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 (Mbit/s). +Most commercial DCPs use bit rates between 75 and 125 MBit/s. @@ -1392,8 +1443,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 distribute a DCP, to +Alice's cinema, without a troublemaker called Mallory being able to watch it himself. @@ -1528,10 +1579,41 @@ from a file. The certificate should be in SHA256 PEM format. -Once you have set up all the screens that you need KDMs for, -DCP-o-matic can generate KDMs for the last DCP that you generated for -the currently-loaded film. Select the cinemas and/or screens that you -want KDMs for and fill in the start and end dates and times. +Alternatively, certificates for projection systems made by some +manufacturers can be downloaded from databases provided by the +manufacturer. Currently this is supported for Doremi and Dolby +equipment. If you are targeting a screen with equipment by one of +these manufacturers you can select Doremi or Dolby from the +Server manufacturer selection and then click +Download. In the next dialogue box, enter +details of the screen and click Download and, all +being well, the certificate will be fetched. + + + +Using the download system you will need to know the serial number of +the media server in use in the screen. Most cinema projection or +technical departments will know these serial numbers. + + + +Note that the reliability of the manufacturers' certificate databases +cannot be guaranteed. It is vital that KDMs are tested by the +destination cinema will in advance of show time to identify any +problems. + + + +Once you have set up all the screens that you need KDMs for, select +the CPL that you want to create the KDM for. You can use the +drop-down list to select the CPLs in the current film project, or load +a CPL from somewhere else. Select the cinemas and/or screens that you +want KDMs for and fill in the start and end dates and times. + + + +You must also select the type of KDM that you want to generate. If in +doubt, use Modified Transitional 1. @@ -1550,9 +1632,6 @@ generate the KDMs. - - - Preferences @@ -1569,7 +1648,7 @@ behaviour. This chapter explains those options. The preferences dialogue is opened by choosing Preferences... from the Edit -menu. The dialogue is split into eight tabs. +menu. The dialogue is split into seven tabs. @@ -1670,7 +1749,36 @@ various properties of new films. - + +
+Servers + + +The servers tab is shown in . + + +
+ Servers preferences + + + + + +
+ + +If Use all servers is ticked DCP-o-matic will +locate encoding servers automatically (see ). + + + +Instead of this (or in addition) servers can be specified explicitly. +To add a server, click Add... and enter the host +name or IP address of the server to use. + + +
@@ -1964,12 +2072,12 @@ with minimal loss in quality. -Video rate conversion is harder. DCP-o-matic's strategy to deal +Video rate conversion is harder. DCP-o-matic's basic strategy to deal with a non-supported content rate is to run it at the wrong speed, and to adjust the audio to keep it in sync. -Consider the example of a 25fps source for which you want +Let us consider the example of a 25fps source for which you want to create a 24fps DCP. DCP-o-matic will put the frames from the source directly into the DCP without modification, but will tell the projector to play them back at 24fps. This means that the DCP's video