From: Carl Hetherington Date: Sun, 22 Jun 2014 15:52:03 +0000 (+0100) Subject: Document advanced preferences. X-Git-Tag: v2.0.48~551^2~68 X-Git-Url: https://main.carlh.net/gitweb/?p=dcpomatic.git;a=commitdiff_plain;h=14b1f672dc92ae8e1385c75e30420a4dcb4e32c9 Document advanced preferences. --- diff --git a/doc/manual/Makefile b/doc/manual/Makefile index eb10af245..2e37c96be 100644 --- a/doc/manual/Makefile +++ b/doc/manual/Makefile @@ -8,6 +8,7 @@ SCREENSHOTS := file-new.png video-new-film.png still-new-film.png video-select-c still-select-content-file.png examine-thumbs.png examine-content.png timing-tab.png \ calculate-audio-gain.png add-file.png dcp-tab.png \ prefs-kdm-email.png prefs-colour-conversions.png prefs-metadata.png prefs-misc.png prefs-tms.png \ + prefs-advanced.png \ making-dcp.png filters.png video-tab.png audio-tab.png subtitles-tab.png timing-tab.png \ audio-plot.png audio-map-eg1.png audio-map-eg2.png audio-map-eg3.png kdm.png diff --git a/doc/manual/dcpomatic.xml b/doc/manual/dcpomatic.xml index 8460c2cbc..dd0d3bf0c 100644 --- a/doc/manual/dcpomatic.xml +++ b/doc/manual/dcpomatic.xml @@ -375,7 +375,7 @@ linkend="ch-files"/> for details about the files that DCP-o-matic creates. Alternatively, if you have a projector or TMS that is accessible via SCP across your network, you can upload the content directly from -DCP-o-matic. See the preferences in . +DCP-o-matic. See the . @@ -1411,6 +1411,7 @@ into the DCP. The default values should cause no problems.
TMS +TMS preferences The TMS tab (shown in ) gives some @@ -1463,8 +1464,56 @@ DCP's title.
- +
+Advanced +Advanced preferences + + +The advanced preferences are shown in . + + +
+ Advanced preferences + + + + + +
+ + +Maximum JPEG2000 bandwidth specifies the maximum +bit-rate of JPEG2000 that DCP-o-matic will allow you to create. You +are advised to leave this at 250Mbit/s in normal use for maximum DCP +compatibility. + + + +Allow any DCP frame rate removes the limits on +the DCP video frame rates that DCP-o-matic will create. This may be +useful for experimentation. Again, you are strongly advised to leave +this unticked for normal use. + + + +The four checkboxes labelled Log control what +sort of messages DCP-o-matic writes to its log file when creating a +DCP. It is useful to leave General, +Warnings and Errors ticked +as this makes the log files useful for tracking down bugs. + + + +The Timing checkbox will enable extra log entries +to allow developers to investigate and optimize the speed of +DCP-o-matic. It will significantly increase the size of the log files +that are generated, so in normal use it is best to leave this +unticked. + + +
+ @@ -1477,12 +1526,12 @@ however, always possible.
-DCP rate limitations +DCP frame rate limitations -There are some limitations to video and audio rates in DCPs. This is +There are some limitations to video and audio frame rates in DCPs. This is complicated by the fact that not all projectors will play DCPs at the -same rates. It is possible to create a DCP which one projector will +same frame rates. It is possible to create a DCP which one projector will play fine, but another (of a different type) will refuse to play, or even refuse to ingest. @@ -1567,6 +1616,15 @@ content will give a summary of what DCP-o-matic is doing with that content. + +If you want to experiment with other non-standard frame rates, you can +do so by ticking the Allow any DCP frame rate in +the Advanced tab of the preferences dialogue (see the +). You are strongly advised to +use this only on your own equipment, and only for experimentation +purposes. + +
diff --git a/doc/manual/screenshots/prefs-advanced.png b/doc/manual/screenshots/prefs-advanced.png new file mode 100644 index 000000000..b8db5f494 Binary files /dev/null and b/doc/manual/screenshots/prefs-advanced.png differ