Source

masagin /

Filename Size Date modified Message
altona
bin
content
fonts
libs
masagin
meshview
tools
2.4 KB
2.8 KB
5.8 KB
22.4 KB
152.6 KB
585 B
396 B
139.0 KB
186.5 KB
148.0 KB
154.1 KB
This is a short manual for the source base. It contains code as well as 
binaries:

To translate animation scripts and SVG files you will need Python, SCons and a few
additional dependencies.

These are the links to additional dependencies:

* http://www.python.org/ftp/python/2.5.1/python-2.5.1.msi ( http://www.python.org )
* http://prdownloads.sourceforge.net/scons/scons-0.97.win32.exe ( http://www.scons.org )
* http://downloads.sourceforge.net/pyopengl/PyOpenGL-3.0.0b1.win32.exe ( http://pyopengl.sourceforge.net/ )
* http://pypi.python.org/packages/2.5/s/setuptools/setuptools-0.6c7.win32-py2.5.exe ( http://pypi.python.org/pypi/setuptools )
* http://downloads.sourceforge.net/numpy/numpy-1.0.4.win32-p3-py2.5.exe ( http://numpy.scipy.org/ )

It's recommended to add Python to your PATH, or a few custom scripts won't work.

Current binaries are usually in ./bin, unless I forgot to update them, then
they will crash ;-)

Individual content folders are in ./content/<username> ; Scripts and SVG files belong to these individual folders.

Run "scons USER=<username>" (the USER argument can be omitted for subsequent
calls) to pick one of the subfolders as content source. Scons will translate all
animation scripts and SVG files and put them into ./build/<username>, together
with the binaries from the ./bin subdirectory. This gives you a complete
working image of the demo. You should do this at least once before you run it.

I'm current working with USER=test, and all examples and test cases are in this
folder.

Animation scripts end in ".msg" and look a bit similar to Python. Translated
scripts end in ".msg.o"; they are binaries to be read by the interpreter.

To edit scripts I recommend SciTE ( http://prdownloads.sourceforge.net/scintilla/wscite175.zip?download ).
You should also put it in your PATH. After installation, run
"Options -> Open User Options File" from the menu. The empty user options file
will be loaded. Paste the content from ./SCiTEUser.properties into this empty file
and save. That way you will get the settings that I use.

SVG shapes should be created and edited with Inkscape ( http://www.inkscape.org).
Translated shapes end with ".bsm" (Billstedt-Mesh ;-)) and are binaries as well.

To compile the player source code, which is C++, you'll need VS Express 2005
or 2008. For 2008 an additional define must be added to altona_config.hpp
which I forgot.