From 10deef3e9619446c21398ab23649d302e2d66adc Mon Sep 17 00:00:00 2001 From: Carl Hetherington Date: Mon, 23 Jun 2014 19:39:03 +0100 Subject: [PATCH] More manual adjustments wrt scaling. --- doc/manual/Makefile | 2 +- doc/manual/dcpomatic.xml | 62 ++++-- doc/manual/diagrams/pipeline3.svg | 18 +- doc/manual/diagrams/pipeline4.svg | 343 ++++++++++++++++++++++++++++++ 4 files changed, 400 insertions(+), 25 deletions(-) create mode 100644 doc/manual/diagrams/pipeline4.svg diff --git a/doc/manual/Makefile b/doc/manual/Makefile index 83e05b434..408f874f6 100644 --- a/doc/manual/Makefile +++ b/doc/manual/Makefile @@ -3,7 +3,7 @@ all: html pdf DIAGRAMS := file-structure.svg 3d-left-right.svg 3d-top-bottom.svg timecode.svg pipeline1.svg pipeline2.svg \ - pipeline3.svg + pipeline3.svg pipeline4.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 39bc0987c..dee7fe052 100644 --- a/doc/manual/dcpomatic.xml +++ b/doc/manual/dcpomatic.xml @@ -965,7 +965,9 @@ 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 . +in the DCP at ratio of 2.39:1 within a 1.85:1 frame (such as might +happen with a trailer). The source image is shown in .
@@ -1010,15 +1012,35 @@ linkend="fig-pipeline2"/>. The next step is to scale the image. Since this content should be -presented in a 2.39:1 aspect ratio, we would select +presented in a 2.39:1 aspect ratio inside a 1.85:1 DCP 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 . +option in the Video tab and +Flat from the Container +option in the DCP tab. + + +The Scale to option should always be set to +the aspect ratio at which the content should be seen. The +Container option should be set to the preset that +you want to use on the projector. Of course, these two settings will +often be the same. + + + +Given the scaling and container information, DCP-o-matic will look at +the DCP's container size, and then scale the source image up until one +or both of its dimensions (width, height or both) fits the size of the +container, all the while preserving the desired aspect ratio. + + + +In our example here, the DCP's container is specified as 1.85:1 (so +that the DCP will play back correctly using the projector's +‘Flat’ preset). At 2K, 1.85:1 is 1998 pixels by 1080. +Scaling the source up whilst preserving its 1.85:1 aspect ratio will +result in the image hitting the sides of the container first, at a +size of 1998 x 836. This gives us a new version of the image as shown +in .
@@ -1032,14 +1054,24 @@ linkend="fig-pipeline3"/>. 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. +since we have a 2.39:1 image that should be presented as a 1.85:1 DCP, +we have set the container in the +DCP tab to be Scope. Since the content has been +scaled to 1998 x 836, and a Flat container is 1998 x 1080, there will +be some black bars at the top and bottom of the image. DCP-o-matic +shares out this black equally, as shown in . +
+ Example image in the DCP + + + + + +
+ diff --git a/doc/manual/diagrams/pipeline3.svg b/doc/manual/diagrams/pipeline3.svg index 432516c4b..976418b1a 100644 --- a/doc/manual/diagrams/pipeline3.svg +++ b/doc/manual/diagrams/pipeline3.svg @@ -235,14 +235,14 @@ inkscape:pageopacity="0.0" inkscape:pageshadow="2" inkscape:zoom="0.68026787" - inkscape:cx="230.11551" + inkscape:cx="-16.846029" inkscape:cy="731.88908" inkscape:document-units="px" inkscape:current-layer="layer1" showgrid="false" inkscape:window-width="1366" inkscape:window-height="714" - inkscape:window-x="1024" + inkscape:window-x="0" inkscape:window-y="27" inkscape:window-maximized="1" /> image/svg+xml - + @@ -263,34 +263,34 @@ id="layer1"> + transform="matrix(1.3949981,0,0,0.80970039,-33.234153,29.7975)"> + style="color:#000000;fill:#ffffff;fill-opacity:1;fill-rule:nonzero;stroke:#ff0000;stroke-width:3.76366544;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-opacity:1;stroke-dasharray:none;stroke-dashoffset:0;marker:none;visibility:visible;display:inline;overflow:visible;enable-background:accumulate" /> + style="fill:none;stroke:#000000;stroke-width:0.94091618px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;marker-end:url(#Arrow2Mend)" /> + style="fill:none;stroke:#000000;stroke-width:0.94091618px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;marker-end:url(#Arrow2Mend)" /> + style="fill:none;stroke:#000000;stroke-width:0.94091618px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;marker-end:url(#Arrow2Mend)" /> + style="fill:none;stroke:#000000;stroke-width:0.94091618px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;marker-end:url(#Arrow2Mend)" /> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + image/svg+xml + + + + + + + + + + + + + + My scope image + + + + + -- 2.30.2