README

   1 DCP-o-matic
   2 -----------
   3
   4 Hello!
   5
   6
   7 Building for Linux
   8 ------------------
   9
  10 ./waf configure
  11 ./waf
  12 sudo ./waf install
  13
  14
  15 Building for Windows
  16 --------------------
  17
  18 ...is quite involved.  You need to build (or download) all the dependencies.
  19 I'll put my scripts up at some point.
  20
  21
  22 Dependencies
  23 ------------
  24
  25 You will need these libraries:
  26
  27     libdcp (from http://carlh.net/software/libdcp)
  28     FFmpeg version 0.9.x or higher
  29     libtiff
  30     boost thread and filesystem
  31     libopenjpeg 1.5.0 or higher
  32     wxWidgets
  33     libsndfile
  34     libssh
  35
  36
  37 Documentation
  38 -------------
  39
  40 There is a manual available at http://carlh.net/software/dcpomatic
  41 The DocBook source for this is in doc/manual.
  42
  43
  44 In a nutshell
  45 -------------
  46
  47 The `dcpomatic' program is a GTK front-end which is probably easiest
  48 to use.  It will create a directory for a particular project, and write
  49 its data to that directory.  The basic approach is:
  50
  51 "File->New"; specify a directory.
  52 Fill in the fields in the window (most importantly the `content' field:
  53   specify your video, and the `Name' field: give your project [and hence DCP]
  54   a name.)
  55 Move the slider to see thumbnails; adjust crop if necessary.
  56 Select "Jobs->Make DCP" and go and make a really strong cup of tea.
  57 The DCP will be written to the project's directory; copy this to your
  58   media server and ingest.
  59
  60 The `Format' field dictates what size your image will be:
  61
  62 - 4:3 within Flat: 1.33:1 images inside a flat (1.85:1) frame; play
  63   back using the DCI 1.85 / DCI Flat preset on your projector.
  64 - Academy: 1.37:1; play using DCI 1.37 if you have such a thing.
  65 - 16:9 within Flat: 1.78:1 images inside a 1.85:1 frame.
  66 - Flat: 1.85:1 images to the DCI spec.
  67 - Scope: 2.39:1 images to the DCI spec.
  68
  69
  70 Server/client
  71 -------------
  72
  73 Running the `servomatic' program on a remote machine will make it
  74 listen on port 6192 (by default) and process requests from a dcpomatic
  75 instance.  This has been written with no thought to security, so don't
  76 do it over the public internet!  The connection will probably need to
  77 be 1 Gb/s to make it worthwhile.
  78
  79 To tell the client about available servers you will need to go to
  80 Edit->Preferences and add the server's IP address and the number of
  81 parallel threads that the server should execute (make it equal to the
  82 number of CPUs or cores).
  83
  84
  85
  86 Problems
  87 --------
  88
  89 Email me at cth@carlh.net in the first instance.
  90
  91
  92 Carl Hetherington
  93 August 2012