From: Carl Hetherington Date: Mon, 28 Jan 2019 22:39:42 +0000 (+0000) Subject: Update subtitles -> timed text in manual. X-Git-Tag: v2.13.112~32 X-Git-Url: https://main.carlh.net/gitweb/?p=dcpomatic.git;a=commitdiff_plain;h=4117c113eeffe817fddc1c63f5d10eb4e6ada4f9 Update subtitles -> timed text in manual. --- diff --git a/doc/manual/dcpomatic.xml b/doc/manual/dcpomatic.xml index 72bbedb56..cc19d9ebf 100644 --- a/doc/manual/dcpomatic.xml +++ b/doc/manual/dcpomatic.xml @@ -1306,29 +1306,37 @@ with respect to the video, and a negative delay will move it earlier.
-Subtitles +Timed text (subtitles and closed captions) -The subtitles tab contains settings related to subtitles in your -content, as shown in . +The timed text tab contains settings related to subtitles and closed captions in your +content, as shown in . -
- Subtitle settings tab +
+ Timed text settings tab - +
+ +Depending on where timed text comes from it can sometimes be used as +either an open subtitle (to be overlaid onto the cinema screen and so +seen by everybody) or as a closed caption (to be displayed to +individual viewers using a special system such as the Doremi +CaptiView™) + + DCP-o-matic can either: - Extract subtitles that are embedded in video files, or - Use subtitles from SubRip (.srt), SubStation + Extract timed text that is embedded in video files, or + Use timed text from SubRip (.srt), SubStation Alpha (.ssa or .ass) or DCP XML files. You may find the great free program Subtitle Edit useful @@ -1336,15 +1344,18 @@ DCP-o-matic can either: -Embedded subtitles are usually represented using a set of bitmaps, -especially on files that have come from DVD or BluRay. Such subtitles -can (currently) only be ‘burnt’ into the DCP (that is, -they are included in the image and not overlaid by the projector). +Embedded timed text is usually represented using a set of bitmaps, +especially on files that have come from DVD or BluRay. Such text can +be used as a subtitle, but not a closed caption (since the closed +captioning system requires the text to be delivered as +character codes rather than an image). +In contrast, SubRip, SubStation Alpha or DCP text can be used as either a subtitle or a closed caption. + -With SubRip, SubStation Alpha or DCP subtitles you have the choice to -either burn-in or include the subtitles as separate subtitle +With subtitles you have the further choice of whether to burn the +subtitles into the image or include them as a separate subtitle ‘asset’ within your DCP (in which case the projector overlays them onto the image on playback). The difference between burn-in and overlay is illustrated by @@ -1379,42 +1390,44 @@ every language. -Select the Use Subtitles check-box to enable -the subtitles in the selected content. +Select the Use as check-box to enable the timed +text in the selected content, then choose what you want to use the +text for: open subtitles or closed captions. Select the Burn subtitles into image check-box to -burn these subtitles into the image; if this is not ticked the +burn subtitles into the image; if this is not ticked the subtitles will be included separately in the DCP to be rendered by the -projector. This check-box will always be ticked if you are using -embedded ‘image’ subtitles. +projector. The X Offset and Y Offset -controls move the subtitles around within the image. The offsets are -expressed as a percentage of the video frame size; 100% X offset is -the entire width of the frame, and 100% Y offset is the entire height. -Hence, to move the subtitles down by half the frame height you would -use a Y offset of 50%. +controls move subtitles around within the image. These controls have +no effect for closed captions. The offsets are expressed as a +percentage of the video frame size; 100% X offset is the entire width +of the frame, and 100% Y offset is the entire height. Hence, to move +the subtitles down by half the frame height you would use a Y offset +of 50%. The X Scale and Y Scale -controls scale the subtitles. Scale values of 1 make the subtitles -the same size (relative to the size of the image) as they are on the -original. Values lower than 1 make them smaller, and values higher -make them larger. You can stretch the subtitles in either direction -by specifying different values for X and Y scale. Subtitles from DVD -and Blu Ray sources are frequently larger (relative to the video -frame) than those typically used for DCP, so it is often useful to -scale such subtitles down using these controls. +controls scale subtitles. These controls have no effect for closed +captions. Scale values of 1 make the subtitles the same size +(relative to the size of the image) as they are on the original. +Values lower than 1 make them smaller, and values higher make them +larger. You can stretch the subtitles in either direction by +specifying different values for X and Y scale. Subtitles from DVD and +Blu Ray sources are frequently larger (relative to the video frame) +than those typically used for DCP, so it is often useful to scale such +subtitles down using these controls. The Line spacing control adjusts the line spacing -of the subtitles. This only works for non-embedded (text) subtitles. +of the subtitles. This only works for subtitles that did not come from bitmaps. @@ -1423,14 +1436,17 @@ that is used when the content has more than one. -If you are using non-embedded (text) subtitles you can see the +If you are using non-image (text) subtitles or closed captions you can see the subtitle text and timings by clicking the View... button, or specify the fonts that should be used by clicking Fonts.... With any subtitles you can click Appearance... to -change how the subtitles look. +change how the subtitles look. Some of the controls in the +Apperance only apply to burnt-in subtitles, as +only limited control is available for subtitles rendered by the +projection system.
diff --git a/doc/manual/screenshots/subtitles-tab.png b/doc/manual/screenshots/subtitles-tab.png deleted file mode 100644 index 1ff80c525..000000000 Binary files a/doc/manual/screenshots/subtitles-tab.png and /dev/null differ diff --git a/doc/manual/screenshots/timed-text-tab.png b/doc/manual/screenshots/timed-text-tab.png index 983d788be..10add9fb3 100644 Binary files a/doc/manual/screenshots/timed-text-tab.png and b/doc/manual/screenshots/timed-text-tab.png differ