1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
|
# libdcp
Library for reading and writing Digital Cinema Packages (DCPs).
# Acknowledgements
Wolfgang Woehl's cinemaslides was most informative on the
nasty details of encryption.
libdcp is written by Carl Hetherington and Mart Jansink.
Bugfixes were received from Philip Tschiemer.
# Building
```
./waf configure
./waf
sudo ./waf install
```
# Dependencies
- pkg-config (for build system)
- boost (1.45 or above): filesystem, datetime and unit testing libraries
- openssl
- libxml++
- xmlsec
- sndfile
- openjpeg (1.5.0 or above)
- [asdcplib](https://github.com/cth103/asdcplib/tree/dcpomatic-2.13.0)
- [libcxml](https://github.com/cth103/libcxml)
- (optional) ImageMagick or GraphicsMagick (for examples)
- (optional) OpenMP
- (optional) gcov (for tests)
# Build options
```
--target-windows set up to do a cross-compile to Windows
--enable-debug build with debugging information and without optimisation
--static build libdcp statically, and link statically to openjpeg, cxml, asdcplib-cth
--disable-tests disable building of tests
--disable-gcov dont use gcov in tests
--disable-examples disable building of examples
--enable-openmp enable use of OpenMP
--openmp=OPENMP Specify OpenMP Library to use: omp, gomp (default), iomp..
--jpeg=JPEG specify JPEG library to build with: oj1 or oj2 for OpenJPEG 1.5.x or OpenJPEG 2.1.x respectively
--force-cpp11 force use of C++11
```
# A note on building for macOS
As goto solution, all dependencies can be installed using [Homebrew](https://brew.sh/).
Make sure to add the respective `PKG_CONFIG_PATH` paths so the packages are indeed found.
```bash
## Default Homebrew paths
PKG_CONFIG_PATH="/usr/local/opt/icu4c/lib/pkgconfig"
PKG_CONFIG_PATH="$PKG_CONFIG_PATH:/usr/local/opt/pangomm/lib/pkgconfig"
PKG_CONFIG_PATH="$PKG_CONFIG_PATH:/usr/local/opt/libffi/lib/pkgconfig" # needed by gobject2
PKG_CONFIG_PATH="$PKG_CONFIG_PATH:/usr/local/opt/openssl/lib/pkgconfig"
PKG_CONFIG_PATH="$PKG_CONFIG_PATH:/usr/local/opt/libxml2/lib/pkgconfig"
## Set as installed
# PKG_CONFIG_PATH="$PKG_CONFIG_PATH:/path-to-your-install-folder/libasdcp-cth"
# PKG_CONFIG_PATH="$PKG_CONFIG_PATH:/path-to-your-install-folder/libcxml"
export PKG_CONFIG_PATH
```
If you want support for *OpenMP*, the standard llvm compiler coming with Xcode (or rather its command line tools) does not support it such that you will have to override the compiler (using the `CXX` environment variable).
The version provided through Homebrew will work (or any of your choice) along with `--openmp=omp`.
```bash
## Default Homebrew path
export CXX=/usr/local/opt/llvm/bin/clang++
```
# Documentation
Run doxygen in the top-level directory and then see build/doc/html/index.html.
There are some examples in the examples/ directory.
# Approach to non-compliant DCPs
In a number of places we read metadata from DCPs that may not be in the correct format. A vague design principle is that we should be
able to read such values, write them back out again the same, and find out that they are invalid. However, it should be difficult to
create new DCPs with badly-formatted metadata.
For example, a `CPL` has a `MainSoundConfiguration` that is essentially a specially-formatted string: a comma-separated list of values,
where the values come from a limited range. A correct value might be "L,R,C,LFE,Ls,Rs,-,-" and an incorrect one "fish" or
"01,02,03,04,05,06"
The "happy" path is:
```
MainSoundConfiguration foo("L,R,C,LFE,Ls,Rs,-,-");
std::cout << "Config has " << foo.channels() << ", first is mapped to " << dcp::channel_to_mca_name(foo.mapping(0).get(), foo.field()) << "\n";
std::cout << "Value for XML: " << foo.to_string() << "\n";
```
In this case `foo.valid()` will be true and the details of the configuration can be accessed.
In the "invalid" case we have:
```
MainSoundConfiguration foo("01,02,03,04,05,06");
std::cout << "Value for XML: " << foo.to_string() << "\n";
```
Now `foo.valid()` will be `false` and calls to (for example) `foo.channels()` will throw `MainSoundConfigurationError`. `foo.to_string()` is
OK, however, and will return the same invalid string "01,02,03,04,05,06" as was passed to the constructor.
# Coding style
* Use C++11 but nothing higher, as we need the library to be usable on some quite old compilers.
* Put a Doxygen @file comment under the GPL banner in each source file.
* Two blank lines between methods, and between 'blocks' in headers.
* Doxygen comments in header files for public methods, source files for protected / private methods; no full stops after simple doxygen strings.
* Use `= delete` on copy constructors and assignment operators instead of boost::noncopyable.
* Initialise POD members in classes in the header.
* Use std::make_shared to create shared pointers to things.
|
