LuxBlend25 Render Panel - LuxRender Wiki
Luxrender GPL Physically Based Renderer

LuxBlend25 Render Panel

Personal tools

From LuxRender Wiki

Jump to: navigation, search

This page describes functionality that can be accessed through Blender's render panel when LuxBlend25 is activated. For more general information about using LuxBlend25, please visit the LuxBlend25 Manual page.



Luxblend25render render.png


This either starts a rendering or exports the scene in LuxRender's file format, depending on the settings in the LuxRender Engine Configuration panel.


This exports a LuxRender scene file for every frame of an animation. There are several options to make LuxRender render all the frames of an animation:

  1. Use the Internal Rendering Mode
  2. Select "Run Renderer", and set "Render using" to LuxRender GUI, to start LuxRender and load all the frames into its queue
  3. Select "Run Renderer" and set "Render using" to LuxConsole, and render the frames using luxconsole on the command line


This defines how the rendered image will be shown within Blender:

Keep UI

The current view will stay as it is; you can see the image in LuxRender (external) or open a Blender UV/Image Editor window to see the rendered result.

New Window

This will show the rendered result in a secondary Blender window.

Image Editor

This will change one of Blender's windows into a UV/Image Editor window and show the rendered result there.

Full Screen

The whole Blender interface will be replaced by a single UV/Image Editor, showing the rendered result.

Export type

  • internal: this will render the scene within Blender, while using the LuxRender engine behind the scenes. Amongst others, this is suitable for animations.
  • external: this will launch LuxRender whenever a scene is being rendered, so that all LuxRender's controls will be available

Render using (external mode only)

  • LuxRender GUI will launch LuxRender with its graphical interface, so that all controls are accessible.
  • LuxConsole will launch luxconsole, which doesn't have a graphical interface. This option is somewhat faster and is useful for animations.

Path to LuxRender (external mode only)

This defines the place where LuxBlend will look for the LuxRender program when starting a rendering. The icon on the right of the text field can be used to navigate to the right location:

  • on Windows, the path is probably something like C:\Program Files\LuxRender08\luxrender.exe
  • on OS X, the path should be /Applications/LuxRender/ (not or MacOS/luxrender)
  • on Linux, the path should point to wherever you put the LuxRender executable

Write to Disk (internal mode only)

Write scene files to disk first before rendering internally.

Integrated Imaging (internal mode only)

Pipe the image back to Blender rather than writing to disk first.


Luxblend25render dimensions.png

Render Presets

This dropdown menu contains presets of render resolutions in combinations with frame rates. One can add and remove presets from the list.


The resolution of the image or animation that will be rendered. The X and Y values will be multiplied with the percentage that is listed below them.

Aspect Ratio

This value is not used by LuxRender.

Frame Range

Defines the frames to be rendered when creating an animation, where Start and End define the range. The Step value defines if all frames are being rendered or if only one in every so many will be rendered. For example with a Step value of 5 and starting at frame one, the frames that will be rendered are 1, 6, 11, 16, 21 etc.


When setting up a render border with Shift-B, this box will be ticked and LuxRender will only render the area within the border.


Crops the border rendered frame to the border render dimensions, rather than insetting it in the full frame.

Frame Rate

This defines the frame rate if the animation is saved into a movie file format directly. It doesn't have any influence if you're rendering single frames.

Time Remapping

Adjusts framerate to allow for slow-motion and similar effects

Render settings

Luxblend render settings.png

These options allow you to configure LuxRender's render settings, please see the LuxRender Render settings page for more information on these settings. (Note that in LuxBlend, surface integrator and renderer are set as a pair from the "Rendering Mode" menu)

You can click the advanced checkbox to show the full range of possible settings. However, most of these can be left to their defaults (or will be auto-set by LuxBlend) and there is generally not much need to edit them. The simplified (non-advanced) version of the panel will provide the important options.

At the bottom of the panel, you can also set the number of samples per pixel or seconds that LuxRender should stop the rendering after. If both are left at 0, LuxRender will render the image until told to stop.

Additionally, you will find the halt threshold and convergence step options. Halt threshold allows LuxRender to stop rendering automatically at a desired image quality. In LuxBlend, this is set using a value from 0-10 indicating the percentage of pixels that are allowed to fail a convergence test. Each whole number increase requires 10x as many pixels to pass. For example, a threshold of 3.0 requires 99.9% of pixels to pass. 5.0 requires 99.999% to pass, and so on. Convergence step defines the interval (in samples per pixel) where convergence is tested to see if it is time to halt the rendering. If you have enabled noise-aware sampling, LuxRender will automatically focus samples on the areas that are still failing the test.

LuxRender Networking

Luxblend25render networking.png

When activating LuxRender Networking, LuxBlend will pass on the address of a render server to LuxRender, which will then be connected when LuxRender loads the file. The render server is assumed to already running luxconsole. Multiple render server addresses can be entered, separated by a comma.

Upload interval is the time interval at which contributions from the render server are being sent back; for example an interval of 180 will make the server send back its contributions every three minutes.

LuxRender Translator

LuxRender Engine Configuration

Export Smoke

This switch will enable or disable exporting smoke simulations. These can take time to export, so this option allows you to skip them for test renders.

Export Hair

This switch will enable or disable exporting hair particles. These can take time to export, so this option allows you to skip them for test renders.

Embed File data

This option will include all used resources in LuxRender's scene files, including image textures.

Use Cached PLY Files

When enabled, this option will skip exporting a mesh if it already has an exported .ply file for that frame and the mesh has not been updated since the last render. This can improve export times, and should generally be left enabled unless it's causing geometry problems (rare).

Run Renderer

When this option is selected, LuxRender will start when the Render > Image or Render > Animation buttons are pushed. Otherwise, LuxBlend will just write the scene files to disk.

Monitor External

When using external rendering, this option defines whether the render result should be displayed in Blender's UV/Image Editor window. Note that only one instance of LuxRender can be monitored; consequently LuxBlend will not start a new rendering unless the one that is being monitored has quit.

Auto Threads

When using this option, the rendering process will as many rendering threads as there are processor cores available on the processor (or double the amount, if hyperthreading is available). When this option is not selected, you can specify the number of threads manually.

Use Fixed Seeds

This option can reduce noise in animations somewhat by using the same thread seed values on each render.

Log Verbosity

This defines which message types will be shown in LuxRender's log tab:

  • Very Quiet: hardly anything will be written to the log
  • Quiet: very few events will be written to the log
  • Default: most events will be written to the log, including framebuffer updates and files written
  • Verbose: all relevant events will be written to the log, including debugging information


Luxblend25render output.png

The output section defines in which file format the rendered image or animation will be saved when using internal rendering. For external rendering, file output options are set on the camera tab. In both cases, the output file path defines where LuxRender's scene files will be saved.

For most image formats, there is a choice between the following options:

  • BW will write a grayscale image
  • RGB will write an RGB (color) image
  • RGBA will write a RGB image with alpha channel

The File Extensions option will automatically add the file format's extension to the file name, for example .png or .jpg.

With the Overwrite option checked, Blender will overwrite existing files without asking.

The Placeholders option will create an empty image file once the rendering starts. If this option is unchecked, LuxRender will only write an image file after some initial rendering progress.