From 684d10c4eee5462b3bcdddead74fdba26d40a123 Mon Sep 17 00:00:00 2001 From: Carl Hetherington Date: Mon, 23 Jun 2014 17:02:06 +0100 Subject: [PATCH] Add some stuff about video processing. --- doc/manual/Makefile | 3 +- doc/manual/dcpomatic.xml | 89 +++++++ doc/manual/diagrams/pipeline1.svg | 403 ++++++++++++++++++++++++++++++ doc/manual/diagrams/pipeline2.svg | 332 ++++++++++++++++++++++++ doc/manual/diagrams/pipeline3.svg | 336 +++++++++++++++++++++++++ 5 files changed, 1162 insertions(+), 1 deletion(-) create mode 100644 doc/manual/diagrams/pipeline1.svg create mode 100644 doc/manual/diagrams/pipeline2.svg create mode 100644 doc/manual/diagrams/pipeline3.svg diff --git a/doc/manual/Makefile b/doc/manual/Makefile index 2e37c96be..83e05b434 100644 --- a/doc/manual/Makefile +++ b/doc/manual/Makefile @@ -2,7 +2,8 @@ all: html pdf -DIAGRAMS := file-structure.svg 3d-left-right.svg 3d-top-bottom.svg timecode.svg +DIAGRAMS := file-structure.svg 3d-left-right.svg 3d-top-bottom.svg timecode.svg pipeline1.svg pipeline2.svg \ + pipeline3.svg SCREENSHOTS := file-new.png video-new-film.png still-new-film.png video-select-content-file.png \ still-select-content-file.png examine-thumbs.png examine-content.png timing-tab.png \ diff --git a/doc/manual/dcpomatic.xml b/doc/manual/dcpomatic.xml index dd0d3bf0c..39bc0987c 100644 --- a/doc/manual/dcpomatic.xml +++ b/doc/manual/dcpomatic.xml @@ -953,6 +953,95 @@ any changes to the corresponding timecode. +
+Video processing pipeline + + +This section gives a little more detail about how DCP-o-matic process +video as it takes it from a source and puts it into a DCP. + + + +Consider, as a somewhat over-the-top example, that we have a 720 x 576 +image which is letterboxed with 36 black pixels each at the top and +bottom, and the video content within the letterbox should be presented +in the DCP at ratio of 2.39:1. Such an image is shown in . + + +
+ Example image to demonstrate video processing + + + + + +
+ + +DCP-o-matic runs through the following steps when preparing an image for a DCP: + + + +Crop +Scale +Place in container + + + +First, some amount of the image can be cropped. This is almost always +used to remove black borders (letterboxing and/or pillarboxing) around +images. + + + +In our example image, we would use 36 pixels of crop from the top and +bottom. This would give the new image shown in . + + +
+ Example image after cropping + + + + + +
+ + +The next step is to scale the image. Since this content should be +presented in a 2.39:1 aspect ratio, we would select +Scope from the Scale to +option in the Video tab. This option should +always be set to the aspect ratio at which the content should be +presented. DCP-o-matic will work out how big the image should be to +fit into the configured DCP's container; in the case of 2K, a 'scope +container should be 2048x858 pixels, and so DCP-o-matic scales to that +size. This gives us a new version of the image as shown in . + + +
+ Example image after cropping and scaling + + + + + +
+ + +The final step is to place the image into the DCP. In this case, +since we have a 2.39:1 image that should be presented as a 2.39:1 DCP, +we set the container in the +DCP tab to be 'scope. Since the content has been +scaled to 2.39:1, and the DCP is in 2.39:1, there is nothing +complicated to do here: DCP-o-matic can just place the image directly +into the DCP. + + +
+ diff --git a/doc/manual/diagrams/pipeline1.svg b/doc/manual/diagrams/pipeline1.svg new file mode 100644 index 000000000..a38babe72 --- /dev/null +++ b/doc/manual/diagrams/pipeline1.svg @@ -0,0 +1,403 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + image/svg+xml + + + + + + + + + + + + + + + + My scope image + + + + 36 pixels + + + + + 36 pixels + + + + + diff --git a/doc/manual/diagrams/pipeline2.svg b/doc/manual/diagrams/pipeline2.svg new file mode 100644 index 000000000..eac77b401 --- /dev/null +++ b/doc/manual/diagrams/pipeline2.svg @@ -0,0 +1,332 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + image/svg+xml + + + + + + + + + + + + My scope image + + + + diff --git a/doc/manual/diagrams/pipeline3.svg b/doc/manual/diagrams/pipeline3.svg new file mode 100644 index 000000000..432516c4b --- /dev/null +++ b/doc/manual/diagrams/pipeline3.svg @@ -0,0 +1,336 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + image/svg+xml + + + + + + + + + + + + + My scope image + + + + + -- 2.30.2