From f7e853e710214fd00f467a9d179586a4a5fbdaa7 Mon Sep 17 00:00:00 2001 From: Carl Hetherington Date: Fri, 26 Jul 2013 13:04:24 +0100 Subject: [PATCH] Some manual updates. --- doc/manual/dcpomatic.xml | 309 ++++++++++++++++++++++----------------- 1 file changed, 177 insertions(+), 132 deletions(-) diff --git a/doc/manual/dcpomatic.xml b/doc/manual/dcpomatic.xml index cbc4b3c25..68c73b84f 100644 --- a/doc/manual/dcpomatic.xml +++ b/doc/manual/dcpomatic.xml @@ -201,7 +201,7 @@ creates the DCP. You can create a new film by selecting shown in . -
+
Creating a new film @@ -215,7 +215,7 @@ This will open a dialogue box for the new film, as shown in . -
+
Dialogue box for creating a new film @@ -233,6 +233,12 @@ folder called ‘DCP Test’ inside my home folder (carl) into which it will write its working files. + +The folder that you choose should have plenty of free disc space +available. As a very rough guide, you will need about 25Mb per second +of your DCP. This works out at 1.5Gb per minute, or 90Gb per hour. + + If you always create your DCPs in a particular folder, you can use DCP-o-matic's Preferences to make life a little @@ -243,21 +249,22 @@ See .
-Selecting content +Adding content -The next step is to set the content that you want to use. Click the -content selector, as shown in , and a file chooser will -open for you to select the content file to use, as shown in Add +file... button, and a file chooser will open for you to +select the content file to use, as shown in . -
- Opening the content selector +
+ Adding content - +
@@ -305,107 +312,53 @@ such as Totem, <
-Setting up +Setting up the content -Now there are a few things to set up to describe how the DCP should be -created. The settings are divided into four tabs: film, video, audio and subtitles. +Now there are a few things to set up to describe how the content you just added should be used. +created. The settings are divided into four tabs: video, audio, subtitles and timing.
-Film tab +Video content tab -The ‘film’ tab contains settings that pertain to the whole film, as shown in . +This tab contains settings related to the video (i.e. the picture) of your content, as shown in . -
- Film settings tab +
+ Video settings tab - +
- -The first thing here is the name. This is generally set to the title -of the film that is being encoded. If Use DCI -name is not ticked, the name that you specify will be used -as-is for the name of the DCP. If Use DCI name -is ticked, the name that you enter will be used as part of a -DCI-compliant name. - - - -Underneath the name field is a preview of the name that the DCP will -get. To use a DCI-compliant name, tick the Use DCI -name checkbox. The DCI name will be composed using details -of your content's soundtrack, the current date and other things that -can be specified in the DCI name details dialogue box, which you can -open by clicking on the Details button. - - - -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. - - - -The Trust content's header button starts off -checked, and this means that DCP-o-matic will use the content's header -information to determine its length. If, for some reason, this header -length is wrong, uncheck the Trust content's -header button and DCP-o-matic will run through the content -to find its exact length. This may take a while for large pieces of content. - +The default values in this tab are fine for our example, but the +options are described here anyway. -Next up is the content type. This can be -‘feature’, ‘trailer’ or whatever; select the -required type from the drop-down list. - - - -The trim frames settings allow you to trim frames -from the beginning and end of the content; any trimmed frames will not -be included in the DCP. - - -
- -
-Video tab - - -This tab contains settings related to the picture in your DCP, as shown in . +The first option on this tab is the ‘type’ of the video. +This specifies how DCP-o-matic should interpret the video's image. +2D is the default; this just takes the video +image as a standard 2D frame. The other options allow the video to be +interpreted as 3D; this is described later in the manual. + -
- Video settings tab - - - - - -
- -The first option on this tab is the format. This will govern the -shape that DCP-o-matic will make your image into. Select the aspect -ratio that your content should be presented in. The ‘4:3 within -Flat’ and ‘16:9 within Flat’ settings will put the -image at the specified ratio within a Flat (1.85:1) frame, so that you -can project the DCP using your projector's Flat preset. +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 remaining options can often be left alone, but may sometimes be -useful. 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 Scale to option governs the shape that +DCP-o-matic will scale the content's image into. Select the aspect +ratio that your content should be presented in. @@ -414,51 +367,41 @@ filters to the image. These may be useful to try to improve poor-quality sources like DVDs. We will discuss filtering later in the manual. - - -The ‘scaler’ is the method that will be used to scale up -your content to the required size for the DCP, if required. We will -discuss the options in more detail later; Bicubic is a fine choice in -most situations. - - - - -The ‘colour look-up table’ specifies the colour space that -your input content will be expected to be in. If in doubt, leave it -set to ‘sRGB’. - - - -Finally, 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 (MBps). - -
Audio tab -This tab contains settings related to the sound in your DCP, as shown in . +This tab contains settings related to the sound in your content, as shown in .
Audio settings tab - +
+ +Once again, these settings can be left at their defaults for our Sintel example. + + + +The Show Audio button will instruct DCP-o-matic +to examine the audio in your content and plot a graph of its level +over time. This can be useful for getting a rough idea of how loud +the sound will be in the cinema auditorium. The audio graphic is +discussed in more detail later in the manual. + + ‘Audio Gain’ is used to alter the volume of the soundtrack. The specified gain (in dB) will be applied to each sound -channel before it is written to the DCP. +channel of your content before it is written to the DCP. @@ -497,44 +440,40 @@ touch. -‘Audio Delay’ is used to adjust the synchronisation +Audio Delay is used to adjust the synchronisation between audio and video. A positive delay will move the audio later with respect to the video, and a negative delay will move it earlier. -By default the Use content‘s audio button -will be selected. This means that the DCP will use one of the -soundtracks from your content file; you can select the soundtrack that -you wish to use from the drop-down box. - - - -Note that if your content's audio is mono, DCP-o-matic will place it -in the centre channel in the DCP. +The Audio Stream option allows you to select the +audio stream to use, if the content contains more than one. There +might be different soundtrack languages, for example. -Alternatively, you can supply different sound files by clicking the -Use external audio button and choosing a WAV file -for any channels that you want to appear in the DCP. These files can -be any bit depth and sampling rate, and will be re-sampled and -bit-depth converted if required. +The final section in the audio tab is the ‘audio map’. +This governs how sound from the content will be arranged in the DCP. +Our Sintel clip is in 5.1, so DCP-o-matic will default to assigning +each channel from the content to the appropriate DCP channel. This +audio mapping is described in more detail later in the manual. +
+
Subtitles tab -This tab contains settings related to subtitles in your DCP, as shown in . +This tab contains settings related to subtitles in your content, as shown in .
Subtitle settings tab - +
@@ -552,7 +491,7 @@ control changes their size. -Future versions of DCP-o-matic will hopefully include the option to +All being well, future versions of DCP-o-matic will include the option to use text subtitles (as is the norm with most professionally-mastered DCPs). @@ -560,6 +499,110 @@ DCPs).
+
+Setting up the DCP + + +Now that we have set up the content that will go into our DCP, we can +set things up for the DCP itself. This is done from the +DCP tab which can be found at the top of the +DCP-o-matic window (next to the Content tab). +The DCP tab is shown in foo. + + + + + +The first thing here is the name. This is generally set to the title +of the film that is being encoded. If Use DCI +name is not ticked, the name that you specify will be used +as-is for the name of the DCP. If Use DCI name +is ticked, the name that you enter will be used as part of a +DCI-compliant name. Set the name to something useful, like +‘Sintel’. + + + +Underneath the name field is a preview of the name that the DCP will +get. To use a DCI-compliant name, tick the Use DCI +name checkbox. The DCI name will be composed using details +of your content's soundtrack, the current date and other things that +can be specified in the DCI name details dialogue box, which you can +open by clicking on the Details button. + + + +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. + + + +The Container option sets the ratio of the image +in the DCP. If this ratio is different to the ratio used for any +content, DCP-o-matic will pad the content with black. In simple cases +this should be set to the same ratio as that for the the primary piece +of video content. Alternatively, you might want to pillarbox a small +format into a Flat container: in this case, select the small format +for the content's ratio and ‘Flat’ for the DCP. + + + +Next up is the content type. This can be +‘feature’, ‘trailer’ or whatever; select the +required type from the drop-down list. + + + +The Frame Rate control sets the frame rate of +your DCP. This can be a little tricky to get right. Ideally, you +want it to be the same as the video content that you are using. If it +is not the same, DCP-o-matic must resort to some tricks to alter your +content to fit the specified frame rate. Frame rates are discussed in more detail later. + + + + +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 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. + + + +The 3D button will set your DCP to 3D mode if it +is checked. This is discussed later. + + + + +The Resolution tab allows you to choose the +resolution for your DCP. Use 2K unless you have content that is of +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 (MBps). + + + +Finally, the scaler is the method that will be used to scale up +your content to the required size for the DCP, if required. We will +discuss the options in more detail later; Bicubic is a fine choice in +most situations. + + + +
+ +
Making the DCP @@ -601,7 +644,7 @@ DCP-o-matic. See . Creating a still-image DCP -DCP-o-matic can also be used to create DCPs of a still image, perhaps +DCP-o-matic can also be used to create DCPs of one or more still images, perhaps for an advertisement or an on-screen announcement. This chapter shows you how to do it. @@ -622,6 +665,8 @@ shown in .
+ + Enter a name and click OK. Then we set up the content; click the content selector as before, and this time we will -- 2.30.2