README
author Radek Brich <radek.brich@devl.cz>
Sun, 20 Apr 2008 16:48:24 +0200
branchpyrit
changeset 72 7c3f38dff082
parent 66 c5b89d16497a
child 94 4c8abb8977dc
permissions -rw-r--r--
kd-tree building - check all axes for best split, add additional shape-bbox check extent Container bounds by Eps to fix invisible triangles on borders new Camera constructor with more intuitive lookat/up vectors fix camera axes (mirrored images) better camera angle-of-view change capitalization of addShape and addLight

==================
 Pyrit Ray Tracer
==================


File Organization
-----------------
/bin      -- output directory for binary objects
/ccdemos  -- ray tracer demos in C++
/demos    -- ray tracer demos in Python
/include  -- header files
/models   -- common models for use by demos
/src      -- ray tracing library source code
/tests    -- test programs for classes

Classes organization throughout header files is explained in DEVNOTES.


Building
--------
Type 'scons all' to build everything and 'scons -h' for list of targets.

Requirements:
    SCons
    pthreads (see bellow)
    Python 2.4 or newer for Python module and demos
    PIL (Python Imaging Library) for Python demos
    SDL for interactive C++ demos
    libpng and zlib for rendering to PNG file from C++ demos


Pthreads
--------
Threads can be used to render rows of picture paralelly. Arbitrary number
of threads can be used, even numbers like 17 are acceptable.

To completely disable this feature just remove "-DPTHREADS -pthreads"
from flags in makefile.

For Windows + Mingw32, get pthreads library here:
http://sources.redhat.com/pthreads-win32/


License
-------
This software is published under terms of MIT license.
See COPYING for full text of license.


Website
-------
Latest version can be obtained at http://wiki.fiction.cz/Pyrit