blob: e40349363c6d7cbb6270145148de454b717cc558 (
plain)
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
|
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, signals2, datetime and unit testing libraries
- openssl
- libsigc++
- libxml++
- xmlsec
- ImageMagick or GraphicsMagick
- sndfile
- openjpeg (1.5.0 or above)
- [libasdcp-cth](https://github.com/cth103/asdcplib-cth/tree/cth)
- [libcxml](https://github.com/cth103/libcxml)
- (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.
|
