TMSB on Unix-like Operating Systems
There are two main categories of setup work needed to run The Mirror's Surface Breaks on a Unix-like operating system: getting a current version of Mono installed, and building the DaVinci's Shadow script processor.
Mono is the open-source implementation of Microsoft's .NET framework. The Mirror's Surface Breaks is a .NET (2.0) application, so you will definitely need Mono to run it anywhere else. You will specifically need at least version 2.10.2 of Mono, and it is very important that you realize that the "10" in "2.10.2" is greater than the "6" in "2.6.x". Software version numbers are not decimal numbers!
The difficulty of achieving this depends on the operating system in question. If the packaging system for yours makes a reasonably current version of Mono available, just go ahead and install it that way. For example, OpenSUSE users can just install mono-core, mono-data, mono-winforms, and so on and be ready to go. If your operating system does not have a precompiled version available, or (like Kubuntu/Ubuntu) only has an embarassingly-outdated version in its repository, you will need to download and compile Mono yourself. This can be a daunting process.
I was able to update Mono to a non-paleolithic version on a Kubuntu 10.10 VM by following these steps, which are based on Nathan Bridgewater's instructions:
I used a similar process (also based on the same original instructions) to get it installed on Fedora 16:
"The more complicated change to the script" is that you should find this block:
...and change it so it reads:
That is, you want to get rid of the parts that install xsp and mod_mono, because those are only useful if you're running a webserver.
I was able to update Mono to 2.10.6 on a PC-BSD 8.2 VM by running these commands, although this is not guarantee they will work for you:
make install clean
make install clean
The second package is necessary because for whatever reason, the main Mono package for BSD doesn't include libgdiplus, which is very much required for The Mirror's Surface Breaks.
Compiling DaVinci's Shadow
Once DaVinci's Shadow has been compiled, you can point TMSB to the location of the compiled executable in the Execution tab, as discussed in TMSB Tutorial 1: Basic Use. For example, on my systems, I usually end up with that path being /home/blincoln/dshadow-2.9.2/dshadow, or wherever the current version is if it's no longer 2.9.2.
IMPORTANT: if your compiled libraries, headers, and so forth are placed in a location other than /usr (for example /usr/local), you will need to update the library_linux.dvrc file in the shared location (for example, /usr/local/share/dshadow/library/) and also the build directory (for example ~/dshadow-2.9.2/library/), or TMSB will fail to process any images.
Limitations and Other Issues
I am currently aware of the following issues when running TMSB on non-Windows systems:
|1.||...except when they are, because some developers also don't follow the standard practice.|