Please note that ART is provided under the GNU GPL v. 3.0, and as such, is Open Source Software which is intended to be free, and stay free. Please make sure you are familiar with the legal consequences of using such software before downloading and installing ART.

Documentation

We provide two documents in PDF form:

  • The ART Handbook, which describes basic installation and usage of ART, and also provides technical background information on various aspects of the system.

  • The ARM File Reference Manual, which documents the ARM scene description language that is proprietary to ART.

Both are part of the source tree which you can download in the next section, and can be built by typing make pdf in the directory ART/Documentation.

If you have questions regarding ART, please consult these two documents, and the FAQ provided on this site, before asking us anything.

Source Code

The source tree for ART, which contains both the libraries as well as example scenes and documentation sources, is provided via access to our git repository. The current version is 2.0.0, and the system requirements for it are listed on the “About” page. The normal way to download the source is via anonymous access to our server:

git clone git://cgg.mff.cuni.cz/ART.git

This provides you with a local repository that you can work with: so you can even make local commits, and use the local git repo for your own experiments with the code. However, you cannot write anything back to our server, and have to submit patches if you want to contribute something to the project.

For our collaborators (and only those - see the FAQ), there is also an option to access the git repo via ssh. If you are one of those to whom we give such access, we will need your public ssh key identity to establish your credentials on the server. Once these are installed, you can interact with the server without any password entry. Once you have your account, you can check out the sources for ART via the following command:

git clone ssh://git@cgg.mff.cuni.cz/ART

Access via ssh allows you to directly push your changes to the project server: the rules for working with our git repository are communicated individually to those who get access.

Unfortunately, there is no bug tracker yet. This will be forthcoming in the near future: we are fully aware that ART is not perfect, and we are only a very small team. As development of an entire spectral rendering pipeline is a sizeable project, it is unfortunately fairly certain that there are still pretty severe screw-ups in various places throughout the codebase. They just have not been found yet [0].

Functionality Test

We also provide a functionality test for ART, which runs lots of small rendering and tone mapping jobs, and compares the results to reference images. Due to its size (it contains a considerable number of spectral images), the functionality test environment is provided as a separate archive.

As described in the handbook, we strongly recommend to run this functionality test before pushing a modified version of ART to any repository, even your own. The test suite can also be obtained via git:

# anonymous:
git clone git://cgg.mff.cuni.cz/ART_FunctionalityTest.git

# with ssh ID:
git clone ssh://git@cgg.mff.cuni.cz/ART_FunctionalityTest

[0] Lubarsky’s Law of Cybernetic Entomology: There is always one more bug.