decompiler is based on a slightly amended version of ProjectorRays:
https://github.com/ProjectorRays/ProjectorRays


Usage
=====

Drop dcr/dxt/dir/cct/cxt/cst/exe/app file(s) into the application window


What it can do
==============

- Convert protected/compressed Director files (dcr/dxt/cct/cxt) into editable
  Director files (dir/cst), including Lingo code. Sometimes such decompiled
  movies directly work as expected, often some post-editing in the Director
  IDE is needed to make them run.

- Update old Director files (D4 to D11) to current versions (D10/D11/D12,
  depending on the decompiler version used)

- Extract Director files (dxr/cxt) from Windows or macOS projectors (exe/app),
  which can then be decompiled in a second step


Flavors
=======

There are 3 versions of decompiler, all based on the same code. They only differ
in the Director file format they produce as output, and the Director file
versions they support:

- The D10 version outputs files in the Director 10.x format, and supports
  non-compressed Director files up to version 10.x and (Shockwave-)compressed
  Director files up to version 9.x (which is actually the same as 8.5, since D9
  didn't change the file format) as input.

- The D11 version outputs files in the Director 11.x format, and supports
  non-compressed Director files up to version 11.x and (Shockwave-)compressed
  Director files up to version 10.x as input.

- The D12 version outputs files in the Director 12.x format, and supports
  non-compressed Director files up to version 12.x and (Shockwave-)compressed
  Director files up to version 11.x as input.


Notes on 3rd party xtras
========================

When input files depend on 3rd party asset xtras, you will see message box
alerts when trying to process them (since such alerts can't be blocked by an
alertHook handler). Often simply confirming those dialogs and proceeding works
fine, in some cases the processing will fail and no output is created. In this
case, add the missing xtras to the decompiler's xtras folder and try again.