Installation guide
Views
Personal tools
From LuxRender Wiki
Contents |
Installation guide
Linux
Linux executable can be obtained by compiling the sources from CVS (more details Building_on_Linux) or downloading one of the latest stable version from Luxrender home page. Please, do not underestimated the value of a well compiled/optimized binary for your platform: a statically linked, well optimized binary compiled with Intel CC can be even 40% faster than a generic version compiled with GCC.
Package luxrender-linux-ARCH-RELEASE.tgz
ARCH stands for i386 (32bit executables for Pentium 4, Core 2, Athlon, etc.) or x86 (64bit executable for Pentium 4, Core 2, Athlon 64, etc.). RELEASE is the latest stable release. The luxrender-linux-ARCH-RELEASE.tgz file has the following directory structure:
- bin/
- luxconsole-gcc-ARCH
- luxconsole-icc-ARCH-static
- luxrender-gcc-ARCH
- luxrender-icc-ARCH-static
- test/
- bumptestimage.png
- fullcornell-geom.lxo
- fullcornell-mat.lxm
- fullcornell-metropolis.lxs
- jpgtestimage.jpg
- pngtestimage.png
- suzanne-geom.lxo
- suzanne.lxs
- suzanne-mat.lxm
- License.txt
- Readme.txt
Available executables
Luxrender can be executed with 2 different front ends:
- luxconsole: char based interface, useful to run on remote servers;
- luxrender: GUI.
You can choose to use an Intel CC (*-icc* executable) or a GCC (*-gcc executable) compiled version. Intel CC compiled version is usually a 20/30% faster than the GCC version. Indeed Intel CC compiled executables will work only on recent Intel CPUs (latest Pentium 4 or better). The Intel CC compiled version is also statically linked with most external libraries in order to slightly increase the performances and reduce the amount of required libraries to install. For instance they can be used to run on Debian 4.0 systems where Boost 1.34.1 is not available.
Prerequisite for GCC executables
You have to install a number of libraries in order to be able to run one of the GCC executables. On Ubuntu 7.10 or 8.04, you have to execute the following command:
sudo apt-get install libboost-dev libfltk1.1-dev libboost-thread-dev \ libboost-date-time-dev libboost-program-options-dev libboost-filesystem-dev \ libopenexr-dev libboost-iostreams-dev libboost-regex-dev libboost-serialization-dev \ libboost-wave-dev libtiff4-dev libpng12-dev libwxgtk2.8-dev
Prerequisite for Intel CC executables
luxconsole-icc-static do not requires to install any additional libraries on your system. luxrender-icc-static (the graphical front-end) requires X11, OpenGL (i.e. Mesa) and wxgtk 2.8. For instance, on an Ubuntu Linux you have only to install the following package:
sudo apt-get install libwxgtk2.8-0
Testing the installation
The "test" directory includes 2 test scenes. The rendering result of suzanne.lxs is:
and, for instance, can be obtained by running the following sequence of commands:
cd test ../bin/luxrender-icc-ARCH -t 4 suzanne.lxs
where "-t 4" means: use 4 threads for the rendering. The rendering result of fullcornell-metropolis.lxs:
and, for instance, can be obtained by running the following sequence of commands:
cd test ../bin/luxrender-icc-ARCH -t 4 fullcornell-metropolis.lxs
Different executable performances
The package includes a long list of binaries: luxconsole/luxrender/wxluxgui compiled with gcc/Intel cc and static/dynamically linked. Using the best option available for your platform can do a huge difference in the length of your rendering time. For instance, luxconsole-gcc-x64 running on a MacMini with Ubuntu 8.04 64bit:
[Lux 2008-Jun-13 15:15:47 INFO : 0] Lux version 0.5 of Jun 13 2008 at 12:01:43 [Lux 2008-Jun-13 15:15:47 INFO : 0] Threads: 2 [Lux 2008-Jun-13 15:15:47 INFO : 0] Loading Cimg Texture: 'pngtestimage.png'... [Lux 2008-Jun-13 15:15:47 INFO : 0] 1002x668 (4 channels) [Lux 2008-Jun-13 15:15:48 INFO : 0] Memory used for imagemap 'pngtestimage.png': 2614KBytes [Lux 2008-Jun-13 15:15:48 INFO : 0] Loading Cimg Texture: 'jpgtestimage.jpg'... [Lux 2008-Jun-13 15:15:48 INFO : 0] 1000x674 (3 channels) [Lux 2008-Jun-13 15:15:48 INFO : 0] Memory used for imagemap 'jpgtestimage.jpg': 1974KBytes [Lux 2008-Jun-13 15:15:48 INFO : 0] Loading Cimg Texture: 'bumptestimage.png'... [Lux 2008-Jun-13 15:15:48 INFO : 0] 1009x953 (3 channels) [Lux 2008-Jun-13 15:15:48 INFO : 0] Memory used for imagemap 'bumptestimage.png': 2817KBytes [Lux 2008-Jun-13 15:15:48 INFO : 0] Loading Cimg Texture: 'bumptestimage.png'... [Lux 2008-Jun-13 15:15:48 INFO : 0] 1009x953 (3 channels) [Lux 2008-Jun-13 15:15:48 INFO : 0] Memory used for imagemap 'bumptestimage.png': 2817KBytes [Lux 2008-Jun-13 15:15:48 INFO : 0] Building KDTree, primitives: 23654 [Lux 2008-Jun-13 15:15:48 INFO : 0] Preprocess thread uses seed: 1804289382 [Lux 2008-Jun-13 15:15:48 INFO : 0] Thread 0 uses seed: 1804289383 [Lux 2008-Jun-13 15:15:48 INFO : 0] Thread 1 uses seed: 1804289384 [Lux 2008-Jun-13 15:15:53 INFO : 0] [2 threads] 00:00:05 23461 samples/sec 23461 samples/totsec 0.187096 samples/pix [Lux 2008-Jun-13 15:15:58 INFO : 0] [2 threads] 00:00:10 22589 samples/sec 23032 samples/totsec 0.361834 samples/pix [Lux 2008-Jun-13 15:16:03 INFO : 0] [2 threads] 00:00:15 22557 samples/sec 22875 samples/totsec 0.53632 samples/pix [Lux 2008-Jun-13 15:16:08 INFO : 0] [2 threads] 00:00:20 22563 samples/sec 22798 samples/totsec 0.710858 samples/pix
while luxconsole-icc-x64-static:
[Lux 2008-Jun-13 15:17:39 INFO : 0] Lux version 0.5 of Jun 13 2008 at 13:26:25 [Lux 2008-Jun-13 15:17:39 INFO : 0] Threads: 2 [Lux 2008-Jun-13 15:17:39 INFO : 0] Loading Cimg Texture: 'pngtestimage.png'... [Lux 2008-Jun-13 15:17:39 INFO : 0] 1002x668 (4 channels) [Lux 2008-Jun-13 15:17:39 INFO : 0] Memory used for imagemap 'pngtestimage.png': 2614KBytes [Lux 2008-Jun-13 15:17:39 INFO : 0] Loading Cimg Texture: 'jpgtestimage.jpg'... [Lux 2008-Jun-13 15:17:39 INFO : 0] 1000x674 (3 channels) [Lux 2008-Jun-13 15:17:39 INFO : 0] Memory used for imagemap 'jpgtestimage.jpg': 1974KBytes [Lux 2008-Jun-13 15:17:39 INFO : 0] Loading Cimg Texture: 'bumptestimage.png'... [Lux 2008-Jun-13 15:17:39 INFO : 0] 1009x953 (3 channels) [Lux 2008-Jun-13 15:17:39 INFO : 0] Memory used for imagemap 'bumptestimage.png': 2817KBytes [Lux 2008-Jun-13 15:17:39 INFO : 0] Loading Cimg Texture: 'bumptestimage.png'... [Lux 2008-Jun-13 15:17:39 INFO : 0] 1009x953 (3 channels) [Lux 2008-Jun-13 15:17:39 INFO : 0] Memory used for imagemap 'bumptestimage.png': 2817KBytes [Lux 2008-Jun-13 15:17:39 INFO : 0] Building KDTree, primitives: 23654 [Lux 2008-Jun-13 15:17:40 INFO : 0] Preprocess thread uses seed: 1804289382 [Lux 2008-Jun-13 15:17:40 INFO : 0] Thread 0 uses seed: 1804289383 [Lux 2008-Jun-13 15:17:40 INFO : 0] Thread 1 uses seed: 1804289384 [Lux 2008-Jun-13 15:17:45 INFO : 0] [2 threads] 00:00:05 30157 samples/sec 30157 samples/totsec 0.235813 samples/pix [Lux 2008-Jun-13 15:17:50 INFO : 0] [2 threads] 00:00:10 28837 samples/sec 29501 samples/totsec 0.458878 samples/pix [Lux 2008-Jun-13 15:17:55 INFO : 0] [2 threads] 00:00:15 29238 samples/sec 29413 samples/totsec 0.685033 samples/pix [Lux 2008-Jun-13 15:18:00 INFO : 0] [2 threads] 00:00:20 28757 samples/sec 29250 samples/totsec 0.907481 samples/pix [Lux 2008-Jun-13 15:18:05 INFO : 0] [2 threads] 00:00:25 29168 samples/sec 29233 samples/totsec 1.1331 samples/pix [Lux 2008-Jun-13 15:18:10 INFO : 0] [2 threads] 00:00:30 29255 samples/sec 29237 samples/totsec 1.35939 samples/pix
Statically linked Intel CC executable is 28.2% faster than the GCC on the same hardware.
Follow a follow a list of rules to understand which executable is faster:
- Intel CC faster than GCC;
- 64bit faster than 32bit;
- Statically linked faster than dynamically linked.
Package .deb
Not yet available.
Package .rpm
Not yet available.