Installing LuxRender and LuxBlend - LuxRender Wiki
Luxrender GPL Physically Based Renderer

Installing LuxRender and LuxBlend

Personal tools

From LuxRender Wiki

Jump to: navigation, search
This page relates to Blender 2.4x and LuxBlend 0.1

LuxRender is our main program, responsible only for rendering images. LuxBlend is an export script that runs within Blender and provides LuxRender with the geometry, lighting, textures, and scene data it needs to do so. This tutorial shows the steps needed to make LuxBlend 0.1 and LuxRender work with Blender 2.4x on Windows or Linux. For OS X, please refer to the OS X installation instructions page.

the LuxBlend exporter script loaded in the Blender interface


Download and install Python and Blender

LuxBlend needs Python 2.5 or anything higher in the 2.x series to run. The versions of Blender and Python have to match, so if Blender is compiled with Python 2.5, get Python 2.5 and if it is compiled with Python 2.6, get Python 2.6. This information shows in the command window when starting Blender.

Blender 2.49 for Windows uses Python 2.6; for Linux versions for both 2.5 and 2.6 are available so you'll have to check which one you have. Python can be downloaded at [1].

Download LuxRender and LuxBlend

If you haven't already done so, check the the download page for the link to the latest version of LuxRender LuxBlend. Usually, the LuxBlend script is included in the LuxRender download package. If not, please make sure that the versions of LuxBlend and LuxRender match as otherwise errors will occur.

Move LuxRender to the right location

After downloading, put all LuxRender files except LuxBlend in a convenient locations, for example C:/Program Files on Windows.

Move LuxBlend to the right location

Whenever Blender starts, it checks a certain folder to see which Python scripts should be loaded. If we put the LuxBlend file in this folder, it will be recognised by Blender and show up in the export menu.

The exact location of the folder we are looking depends on your operating system. On Windows XP, it is most likely in Program Files\Blender Foundation\Blender\.blender\scripts, on Vista it may either be the same location as XP or otherwise C:\Users\[username]\AppData\Roaming\Blender Foundation\Blender\.blender\scripts. On Linux it should be /usr/lib/blender/scripts. For OS X, please refer to the OS X installation instructions. If for some reason the folder is not to be found, try using the search function for; this file should be located in the folder we're looking for.

Once you've found the right folder, move the LuxBlend file there and start Blender

Run the exporter in Blender

If all went right, LuxBlend should show up in Blender's scripts window under Scripts->Render->LuxBlend v0.9dev Exporter (LuxRender 1.0RC1) or Scripts->Export->LuxBlend (LuxRender 0.5). Selecting it will turn the scripts windows into the LuxBlend panel.

a LuxBlend entry should show up in the "Render" section of the scripts window

The first time you run LuxRender, you may get a popup message asking to specify where to find the LuxRender program. After having located it once, the script should remember this information. Please note that up till LuxRender 0.5 the location of the executable (luxrender.exe or should be entered, whereas in LuxRender 0.6 one should just indicate the folder in which the program is located.

the set LuxRender path dialog

Configure Blender's windows

For many operations, it is convenient to have the LuxBlend window and a 3d window side by side. By right-clicking on a window border, you can split an existing window into two. Change one of the windows back into a 3D view (using the window type button in the lower left corner) and drag the window border to give the windows the desired size.

In case you want to merge the windows into one again, right click on the border between the windows you want to merge and select "Join Areas".

Save default settings

If you want to, you can save the current window configuration as Blender's default, so that the exporter panel will show automatically next time you start Blender. To do so, go to the File menu and select "Save Default Settings". Please make sure you only do this when the scene is still empty as any objects that are present at the time of saving defaults will appear any time you start Blender.