4

I was wondering if I could get some tips on reverse engineering .dcr/.cct files to get Lingo scripts. I know with recover-cct/recover-dir you can get all the assets etc. but you can't get Lingo scripts. I was told the only way to get them is by reverse engineering.

For people who don't know:

Lingo is a verbose object-oriented (OO) scripting language developed by John H. Thompson for use in Adobe Director (formerly Macromedia Director). Lingo is used to develop desktop application software, interactive kiosks, CD-ROMs and Adobe Shockwave content.

You can see Lingo as the AS3 but for shockwave files.

I heard something about gzip but I'm not 100% sure.

10
  • maybe you should describe what is Lingo because I suspect most people here never heard of it.
    – Igor Skochinsky
    Commented Dec 1, 2016 at 20:05
  • @IgorSkochinsky It's hard to describe but I added a part from Wikipedia. Commented Dec 2, 2016 at 17:48
  • It would be cool to have access to a few simple script and compiled files uploaded somewhere. Commented Dec 5, 2016 at 16:15
  • @joxeankoret deansdirectortutorials.com/3D/3Dlingo.htm it's hard to find something like you're asking for. Commented Dec 5, 2016 at 16:17
  • 1
    @blabb Sorry I don't quite get what you mean. Commented Dec 8, 2016 at 7:41

2 Answers 2

4

I found a project which has some rudimentary documentation on the file format and even some Python code to parse it:

https://github.com/eriksoe/Schockabsorber

It hasn't been updated since 2013 but still may be useful.

There is also some (rather high level) information over at the Archive Team: http://fileformats.archiveteam.org/wiki/Shockwave_(Director)

There is no single solution to reversing undocumented file formats. There are basically two approaches you can try:

1. Observation of the producer.

If you happen to have access to a producer of the files (such as a compiler), then you can compile some simple code, look at the output, make some changes, compile it again and compare with the previous output. If you're lucky the changes will be obvious and give at least some clues about the format structure.

2. Observation of the consumer.

If you have a consumer of the file format (such as a player/viewer app), you can try to observe how it parses the file and what steps it performs. You can use dynamic RE, such as monitoring file accesses and memory accesses to the read data, or fully static RE, i.e. just disassemble the parsing code and deduce what it expects and how it deals with the parsed data. Dynamic approach may be easier in practice but it only covers the actually parsed data, not all the possible variations supported by the parser (so having a broad corpus of input files is essential). Static RE is in general more difficult but is the only sure way to find out the real range of supported features.

BTW, both static and dynamic RE may be applied to the producer as well, although in that case you'd have to RE the binary format producing part (output file writer), plus some of the code which produces data for the writer (e.g. the compiler).

P.S. Found an old tool called dirOpener (saved thanks to the Web Archive!) and the site says the following:

The director engine(that translates machine code into actions on your screen) however does not understand any lingo. Every time you save your movie, close your script window or press the recompile button, your lingo code is compiled into machine code that can be executed by the director engine.

After your lingo code has been compiled director no longer needs it to execute your file, it just needs the machine code it generated from your lingo. For you to be able to make changes to your code however, the lingo is left inside the file. That is, as long as it's unprotected. The moment you protect your director files the lingo code is stripped from the file. Also a certain flag is set so that the director authoring environment can tell it's dealing with a protected file and the extention is changed to .dxr.

I'm not sure what they mean by "machine code" here. I suspect it may be some kind of bytecode, similar to the AS3 bytecode in Flash, so you may be able to come up with some kind of decompilation process, but don't get your hopes too up.

3
  • Machine code or machine language is a set of instructions executed directly by a computer's central processing unit (CPU). Each instruction performs a very specific task, such as a load, a jump, or an ALU operation on a unit of data in a CPU register or memory. Commented Dec 8, 2016 at 7:42
  • 1
    @JoshuaBakker: I know what machine code is, I just doubt that Lingo is actually compiled into machine code as opposed to bytecode.
    – Igor Skochinsky
    Commented Dec 8, 2016 at 8:22
  • ♦ Oh my apologize. Yeah I think it's some kind of bytecode but I'm unsure. Commented Dec 8, 2016 at 8:24
0

There is now a Shockwave Decompiler called ProjectorRays which can decompile DCR files and provide all lingo scripts as if you were looking at the source code.

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.