LuxCoreRender Wiki - User contributions [en]

BlendLuxCore FAQ

2021-03-25T11:55:59Z

Byob:

= Frequently Asked Questions =

=== I can not enable the BlendLuxCore addon, it shows errors ===

Most problems in this area stem from broken graphics driver installations. Try to re-install or update your graphics driver.

'''For Windows users:'''
* Make sure that you have installed the [https://www.microsoft.com/en-US/download/details.aspx?id=40784 Visual C++ Redistributable Packages for Visual Studio 2013]
* If you use v2.1alpha0 or later, you will also need:
** [https://aka.ms/vs/15/release/vc_redist.x64.exe Microsoft Visual C++ Redistributable for Visual Studio 2017]
** [https://software.intel.com/sites/default/files/managed/59/aa/ww_icl_redist_msi_2018.3.210.zip Intel C++ redistributable]

If this does not solve the problem, browse the [https://github.com/LuxCoreRender/BlendLuxCore/issues?q=is%3Aissue+label%3Ainstallation installation issues] in the bug tracker to check if your error message was already reported.
If it was not reported yet, open a new issue and copy the error message from the Blender console (on Windows, click Window -> Toggle System Console in Blender's menu. On Linux, start Blender from a terminal and try to enable the addon, then copy the error message from the terminal).

See the [[BlendLuxCore_Installation | installation page]] for information on how to install, update and remove the BlendLuxCore addon.

=== Is there something like Cycles' Layer Weight/Fresnel/Facing node in LuxCore? ===

No, in LuxCore there is no direct equivalent to this node, because it would not work with the many algorithms in LuxCore that trace rays from lights (instead of from the camera), like the bidirectional engine, light tracing mode, or the PhotonGI cache.

Of course, all materials in LuxCore are physically based and have realistic fresnel effects built-in.

You can achieve a similar effect with the dot product node, but it will work only for one viewpoint:

[[File:Layer_weight_for_one_direction.PNG | thumb | 400px | center]]

=== Can Cycles materials be used in BlendLuxCore? ===

To an extent, yes. Many common Cycles shader nodes can be used in BlendLuxCore:

* You can enable this individually for each material with the "Use Cycles Nodes" option in the material properties.
* You can also enable it for the whole scene at once with the "Use Cycles Settings" button in the render properties. This will configure all materials, lights and the world to use Cycles settings

Not all Cycles nodes and settings are supported. Here is an overview: https://github.com/LuxCoreRender/BlendLuxCore/issues/272

=== Can 2D/3D mapping be driven by textures in LuxCore? ===

In general, no, because it would lead to much worse performance on GPUs.

However, if you only need to drive the translation part of a texture mapping, since LuxCore v2.5 you can use the distort texture for this purpose:

[[File:Distort_texture.PNG | thumb | 400px | center | A checker texture (left) is distorted by a clouds texture (right). The result can be seen in the center]]

Texturing of rotation and scale is not yet possible.

=== What can be done against fireflies/hotpixels? ===

Sometimes, pixels appear that are much brighter than the surrounding pixels. Sometimes they are singular, sometimes clumped up. The underlying reason are light paths that are correct, but very hard to find with the current rendering algorithms, and thus they take much longer to render until noise-free than all other light paths in the image.

There are multiple ways to approach this problem:

* '''Try another rendering algorithm''', it might be able to find the firefly-causing light paths much easier than the one you currently use. For example, try going to the render properties, open the Light Paths panel and enable "Light Tracing", or try the [[PhotonGI | PhotonGI caustic cache]], or try using the bidirectional engine.
* You can '''clamp the brightness of all light paths''' to a maximum value, in the render properties, Light Paths panel, "Clamping" setting. BlendLuxCore can auto-detect a value for this setting that is in the right ballpark for your scene if you render once without clamping enabled, but often this value will not be the best, so you will need a bit of trial-and-error to find a good value. Note that the clamping value depends on the lighting in your scene, so there is no one universally good clamping value, and you might need to adjust it if you add a new light source to your scene that is brighter than the others. Using a clamping value that is too low will result in a low-contrast, washed-out image, while a too high value will leave fireflies unaffected.
* Try to find out which lights or materials are responsible for the fireflies. There might be small, hard-to-find light sources that are causing them. Or a specular material is reflecting such a light source. If you are willing to alter the look of the scene, you can make such a light source more visible/larger, or lower the specularity of such a material. You can also make some light sources invisble to indirect light rays, thus eliminating fireflies (light properties, "Visibility" panel). This can be a good idea for the sun, for example, if your scene contains lots of specular materials.

=== Why is my HDRI environment black and not showing up? ===
You probably have other very bright light sources in the scene, for example a sun or a sky lamp.

'''Solution:''' raise the gain value of the area or HDRI light source that is black. The gain value might need to be very high, e.g. 100000.

=== Why is my area lamp black? ===
See [[#"Why is my HDRI environment black and not showing up?"]]

=== When I change the brightness of my lamp, nothing happens ===

You are probably using an automatic tonemapper which adjusts itself to the changed brightness, making it seem like the brightness did not change.

'''Solution:''' Use a non-automatic tonemapper (camera settings -> [[ImagePipeline]]).


=== When I make one of my lights brighter, all the other lights get darker (or vice versa) ===

Similar to [[#"When I change the brightness of my lamp, nothing happens"]]. 
You are using an automatic tonemapper which tries to keep the image at the same brightness, making it seem like the brightness of the lamps changed.

'''Solution:''' Use a non-automatic tonemapper (camera settings -> [[ImagePipeline]]).


=== A material/object appears to be flickering when I move the camera and shows artifacts in final render ===

This effect is called [https://en.wikipedia.org/wiki/Z-fighting Z-fighting] and is usually caused by mesh faces being exactly on top of each other, e.g. two planes on the same world coordinates.

'''Solution:'''
* Check if there are two objects on top of each other, e.g. because you duplicated the object, cancelled the transform and forgot about it.
* Check if the mesh has duplicate faces. Enter edit mode and use the Remove Doubles button in the Tools panel, which might solve the problem in some cases.
Duplicate faces are often caused by extruding, cancelling the transform and forgetting about it.

=== There are dark triangular artifacts on my model, and I already checked for duplicate faces ===

Floating point numbers have a limited precision. When objects are very large (kilometers) or very small (micrometers), these precision issues become visible.

'''Solution:'''
* If the object has a "normal" size (something like 1 cm to 1 km), but was scaled up/down by a huge amount, try to apply the scale (Ctrl+A -> Scale). For example, this often happens with imported CAD models.
* If applying the scale did not help and your object has to be very small or large, consider to bring it into the normal scale mentioned above, and pretend that it has a larger/smaller size. For example, if you make a model of the solar system, you will just have to make the earth something like 12.742 m in diameter, and pretend that 1 m of your model is equal to 10^6 m.
* If both options above are not usable in your case, you can raise the minimum epsilon that LuxCore uses. This setting can be found in the scene properties, Units panel, after clicking "Advanced LuxCore Settings". By default, the minimum epsilon is 0.00001. Try to raise it to 0.0001 (multiply by 10) for a start and see if the artifacts disappear. Do not set this value higher than necessary, because it will cause all sorts of hard-to-track problems. Be especially careful if you are rendering a scene with volumes.

=== An object that I set to "smooth shading" looks like it is shaded flat in shadow penumbras ===

This artifact is called "terminator problem".

'''Solution:''' Unfortunately there is no real solution. You can only try to mitigate the effect by subdividing the geometry further and/or increase the size of the light source that is causing the problem.

=== How do I setup liquid in a glass container correctly? ===

This forum thread shows an example: https://forums.luxcorerender.org/viewtopic.php?f=4&t=728#p7550

=== Can I export my scene in LuxCore format to render it in LuxCore standalone? ===

Yes. In the render properties, LuxCore Tools panel, enable "FileSaver". Then render with F12.

= Getting Help =

If none of the above entries helped to solve your problem, consider asking in the [https://forums.luxcorerender.org/viewforum.php?f=4 user support forum] or [https://forums.luxcorerender.org/viewtopic.php?f=4&t=2 filing a bug report].

[[Category:BlendLuxCore]]

LuxCoreRender Release Notes v2.5

2021-02-26T12:18:13Z

Byob: /* BlendLuxCore */

__TOC__

=LuxCore=

===New Features===

* Added the support for Optix/RTX acceleration
* Added the support for Optix denoiser imagepipeline plugin
* GPU imagepipeline now allocated buffers for only the used AOVs by each plugin
* batch.haltspp now supports 2 parameters too in order to have separate halt conditions for eye and light tracing
* Added the support for camera not uniform and anamorphic bokeh (issue #409)
* Added the support for camera bokeh with custom distribution
* Variance clamping is now applied separately to each radiance group (issue #414)
* Added the support for lateral and longitudinal chromatic aberration (issue #409)
* Added the support for SINC pixel filter (issue #415)
* Added the support for CATMULLROM pixel filter (issue #415)
* It is now possible to disable Optix (with property context.cuda.optix.enable) even if it is detected and available
* Any mesh UV map can now be used for displacement (issue #416)
* Subdiv shape now supports multiple vertex UVs, colors, alphas and AOVs (issue #416)
* Added the support for holdout (issue #423)
* Added the support for wireframe texture
* Variance clamping is applied applied to DIRECT_DIFFUSE, DIRECT_GLOSSY, EMISSION, INDIRECT_DIFFUSE, INDIRECT_GLOSSY and INDIRECT_SPECULAR AOVs too
* GetPlatformDesc() now returns compile.LUXRAYS_ENABLE_OPTIX property to check if Optix is available
* Removed the limit of max. 32 AOV types
* Added the support for new AOVs (issue #429): DIRECT_DIFFUSE_REFLECT, DIRECT_DIFFUSE_TRANSMIT, DIRECT_GLOSSY_REFLECT, DIRECT_GLOSSY_TRANSMIT, INDIRECT_DIFFUSE_REFLECT, INDIRECT_DIFFUSE_TRANSMIT, INDIRECT_GLOSSY_REFLECT, INDIRECT_GLOSSY_TRANSMIT, INDIRECT_SPECULAR_REFLECT and INDIRECT_SPECULAR_TRANSMIT
* Added a fast evaluation path in GPU code for constant and image map textures
* Added the support for Distort texture
* Now individual bricks, in brick texture, have a pseudo-random mix between two colors by default
* Added the support for Randomized Texture Tiling (#228)
* Added the support for UVRandomMapping2D
* Added the support for LocalRandomMapping3D
* Added the support for Caustic AOV when using hybrid rendering
* Added the support for TwoSided material
* Reworked WhiteBalance plugin and light groups white balance support to be coherent with usual photographic white balance process (note: this change breaks the compatibility with past scene settings)
* Added a cap (25% and 75%) to Glass transmission/reflection sampling to not under sample some case
* Added the support to all light sources of ".temperature" and ".temperature.normalize" properties to set light temperature
* Added the support for texture bombing
* Added the support for Caustic AOV to OutputSwitcherPlugin
* LuxCore API has new log system
* Added the support for 180 (or any other amount of degrees) view to Environment camera
* Added the support for 180 (horizontal stacked) and 360 degree (vertical stacked) stereo camera (issue #451)

===Fixed Bugs===

* Added the support for pixel filtering to light tracing (issue #413)
* Now LuxCore works even if OpenCL is available but not a valid OpenCL ICD platform has been found (issue #422)
* Fixed a problem with cloth material when using CUDA and Windows (issue #417)
* Fixed a problem in glossy coating albedo evaluation on GPUs
* Fixed a difference between CPU and GPU rendering when using a roughglass with a shadow transparency color
* Fixed the support in .ply files for triangle AOVs
* Fixed a memory leak when rendering with OpenCL (noticeable when rendering animations)
* Fixed text export of brick texture HERRINGBONE and BASKET
* Fixed scale problem in GPU code for brick texture HERRINGBONE and BASKET (issue #438)
* Fixed a possible crash when using trilinear texture with GPUs
* Reworked some condition in hybrid rendering light tracing to solve the problem of flashing caustics (issue #441)
* Fixed a problem with Blender Translation language preference option and scene export on file
* Fixed a self-shadow problem in BIRCPU render engine
* Fixed a Mix material problem when using solid and transparent materials (issue #461)

===Known Problems===

* accelerator.bvh.builder.type = EMBREE_MORTON doesn't work with the latest Embree
* Python crashes when calling sys.exit()
* TILEPATHOCL (and RTPATHOCL) count the layers of transparent surfaces as an iteration of the rendering finite state machine so they require to increase the max. path depth to avoid black regions.
* Light emitted by motion blurred triangle lights is approximated using the triangle area of time 0.0 (computing triangle area at runtime would be expansive) so it may be not totally accurate if the motion blur transformation include a scale.

= BlendLuxCore =

''(LOL = LuxCore Online Library)''

===New Features===

* Add twosided material node
* New light group editor, now in the compositor for improved workflow: https://youtu.be/vqigKhwWxIs
* Warn if subdiv modifier is enabled in viewport, but disabled in final render, or if the subdiv level in viewport is higher than in final render
* Add support for non-uniform chromatic aberration
* Add support for sinc and catmullrom filter
* Move film device selection to properties, couple to GPU backend
* Add support for OptiX denoiser for viewport renders
* Add support for non-uniform bokeh and custom bokeh images
* Show a more helpful error message for Windows 7 users missing the update needed for AddDllDirectory
* Add stop button, to stop a render and run compositing
* Add support for holdout material option (in material output node)
* Add support for wireframe texture
* Use the new eye/light halt spp conditions (this means that samples from light tracing are now separate, which makes it much easier to set halt spp correctly with light tracing enabled)
* Improve volume node warning about incompatible (2D) texture nodes
* Allow to set the volume ID
* Add distort texture
* Add support for new AOVs (separate reflect/transmit variants of diffuse/glossy/specular direct/indirect light AOVs, caustic AOV)
* Cycles node reader: add support for the Normal input on material nodes, and basic support for the Bump node
* Cycles node reader: add support for holdout shader
* Add support for randomized tiling
* Add support for "reverse" option of white balance imagepipeline plugin
* Add support for temperature property of lights
* Make it possible again to use different devices for viewport and final renders (default for viewport: CPU), because users might prefer the lower latency of CPU preview renders even when using the GPU for final rendering
* Use sensible min value for Blender texture noise size
* Add support for texture bombing node
* Show a warning if an unsupported image source like Movie or UDIM Tiles is selected
* Rename AOV panel from "LuxCore Arbitrary Output Variables (AOVs)" to "LuxCore AOVs"
* LOL: Add support for local material assets and thumbnail rendering
* LOL: Automatically copy and downscale full preview images placed in preview directory (e.g. by manual download)

''v2.5beta1 released''

* Expose bump sampling distance because it requires adjustment in some rare cases (e.g. in very large or very small scenes, when procedural textures with extreme frequencies of detail are used)
* Add notes to tooltips that caches are only used during final render
* Show warning if a material combines volumes with opacity < 1, as this can lead to artifacts
* Add support for hiding planar edges in wireframe node
* Add slower fallback for custom normals if they aren't supported through C++ for a Blender version (a warning is shown if this adds more than 0.3 seconds to the export time of a mesh, so the user can disable custom normals for the mesh if they are not needed and drive up export time too much)
* Pixel filtering is now disabled by default, and forced disabled if light tracing is used together with denoising
* Make it possible to specify custom values for n and k in the Fresnel texture
* A maximum for light path samples to render can now be set in the halt condition settings
* Add support for uvrandommapping2d
* Add support for localrandommapping3d

''v2.5rc1 released''

===Fixed Bugs===

* Fix message about env. light cache building showing in viewport render, even when the cache is not built
* Fix NodeTreeUndefined being returned as node_tree.bl_idname in some cases
* Fix wrong function return values on hair export failure
* Fix NVRTC DLL loading on Linux
* Hide non-functional camera stereoscopy panel
* Cycles node reader: Fix bug with nested node groups
* Brick texture: remove unused bevel option, rename sockets, add support for modulation bias property
* Fix wrong sampler property being used when engine is Bidir and device is OCL
* Set glossytranclucent backface props regardless if double sided is checked or not
* Change Cauchy naming convention in Glass Material
* Fix out of core being used for CPU if enabled for GPU
* LOL: Fix wrong category asset selection
* LOL: Fix bug with assetbar when asset count is smaller than max row count
* LOL: Change colorspace of preview images from linear to default
* LOL: Use low resolution thumbnails in assetbar
* LOL: fix thumbnail download
* LOL: Fix thread handling (start thread twice error) if an error occurs during execution
* LOL: Fix bug in library deactivation in preferences which keep the LOL tab visible

''v2.5beta1 released''

* Fix crash on trying to replace a pinned node tree
* Fix no viewport update being triggered when toggling the advanced options of velvet material
* Fix dimension, lacunarity, octaves and intensity parameters of musgrave texture not working
* Fix noise depth not working in blender marble texture
* Fix RGB color and temperature not working for sun light and its sub-types (sun, distant, hemi)
* Ensure that noisedepth aka oct is in range 0..25 to avoid visual artifacts
* Fix a panel being shown even when the renderengine is not LuxCore
* Implement a workaround for viewport sessions not being deleted after viewport window resize or render configuration change, which led to a memory leak
* Fix regression in material preview
* Fix viewport render session not being stopped correctly in some cases
* LOL: Fix problem of material assets if material name doesn't match asset name
* LOL: Fix error happening when dragging asset from assetbar into the scene in Blender 2.91+ due to changes in the Blender API

''v2.5rc1 released''

===Known Problems===

* [https://github.com/LuxCoreRender/BlendLuxCore/issues/167 Inserted keyframes in material node graph don't show up in graph editor or anywhere else]
* LuxCore node parameters can not be animated in Blender 2.82. This bug is fixed in Blender 2.83 and later
* Rendering with caches (e.g. PhotonGI, DLSC, Env. light cache) can lead to problems '''if border rendering is enabled'''. A workaround is to disable automatic radius estimation and setting the radius manually instead when using border rendering

LuxCoreRender Release Notes v2.5

2021-02-04T14:27:58Z

Byob: /* New Features */

__TOC__

=LuxCore=

===New Features===

* Added the support for Optix/RTX acceleration
* Added the support for Optix denoiser imagepipeline plugin
* GPU imagepipeline now allocated buffers for only the used AOVs by each plugin
* batch.haltspp now supports 2 parameters too in order to have separate halt conditions for eye and light tracing
* Added the support for camera not uniform and anamorphic bokeh (issue #409)
* Added the support for camera bokeh with custom distribution
* Variance clamping is now applied separately to each radiance group (issue #414)
* Added the support for lateral and longitudinal chromatic aberration (issue #409)
* Added the support for SINC pixel filter (issue #415)
* Added the support for CATMULLROM pixel filter (issue #415)
* It is now possible to disable Optix (with property context.cuda.optix.enable) even if it is detected and available
* Any mesh UV map can now be used for displacement (issue #416)
* Subdiv shape now supports multiple vertex UVs, colors, alphas and AOVs (issue #416)
* Added the support for holdout (issue #423)
* Added the support for wireframe texture
* Variance clamping is applied applied to DIRECT_DIFFUSE, DIRECT_GLOSSY, EMISSION, INDIRECT_DIFFUSE, INDIRECT_GLOSSY and INDIRECT_SPECULAR AOVs too
* GetPlatformDesc() now returns compile.LUXRAYS_ENABLE_OPTIX property to check if Optix is available
* Removed the limit of max. 32 AOV types
* Added the support for new AOVs (issue #429): DIRECT_DIFFUSE_REFLECT, DIRECT_DIFFUSE_TRANSMIT, DIRECT_GLOSSY_REFLECT, DIRECT_GLOSSY_TRANSMIT, INDIRECT_DIFFUSE_REFLECT, INDIRECT_DIFFUSE_TRANSMIT, INDIRECT_GLOSSY_REFLECT, INDIRECT_GLOSSY_TRANSMIT, INDIRECT_SPECULAR_REFLECT and INDIRECT_SPECULAR_TRANSMIT
* Added a fast evaluation path in GPU code for constant and image map textures
* Added the support for Distort texture
* Now individual bricks, in brick texture, have a pseudo-random mix between two colors by default
* Added the support for Randomized Texture Tiling (#228)
* Added the support for UVRandomMapping2D
* Added the support for LocalRandomMapping3D
* Added the support for Caustic AOV when using hybrid rendering
* Added the support for TwoSided material
* Reworked WhiteBalance plugin and light groups white balance support to be coherent with usual photographic white balance process (note: this change breaks the compatibility with past scene settings)
* Added a cap (25% and 75%) to Glass transmission/reflection sampling to not under sample some case
* Added the support to all light sources of ".temperature" and ".temperature.normalize" properties to set light temperature
* Added the support for texture bombing
* Added the support for Caustic AOV to OutputSwitcherPlugin
* LuxCore API has new log system
* Added the support for 180 (or any other amount of degrees) view to Environment camera
* Added the support for 180 (horizontal stacked) and 360 degree (vertical stacked) stereo camera (issue #451)

===Fixed Bugs===

* Added the support for pixel filtering to light tracing (issue #413)
* Now LuxCore works even if OpenCL is available but not a valid OpenCL ICD platform has been found (issue #422)
* Fixed a problem with cloth material when using CUDA and Windows (issue #417)
* Fixed a problem in glossy coating albedo evaluation on GPUs
* Fixed a difference between CPU and GPU rendering when using a roughglass with a shadow transparency color
* Fixed the support in .ply files for triangle AOVs
* Fixed a memory leak when rendering with OpenCL (noticeable when rendering animations)
* Fixed text export of brick texture HERRINGBONE and BASKET
* Fixed scale problem in GPU code for brick texture HERRINGBONE and BASKET (issue #438)
* Fixed a possible crash when using trilinear texture with GPUs
* Reworked some condition in hybrid rendering light tracing to solve the problem of flashing caustics (issue #441)
* Fixed a problem with Blender Translation language preference option and scene export on file
* Fixed a self-shadow problem in BIRCPU render engine
* Fixed a Mix material problem when using solid and transparent materials (issue #461)

===Known Problems===

* accelerator.bvh.builder.type = EMBREE_MORTON doesn't work with the latest Embree
* Python crashes when calling sys.exit()
* TILEPATHOCL (and RTPATHOCL) count the layers of transparent surfaces as an iteration of the rendering finite state machine so they require to increase the max. path depth to avoid black regions.
* Light emitted by motion blurred triangle lights is approximated using the triangle area of time 0.0 (computing triangle area at runtime would be expansive) so it may be not totally accurate if the motion blur transformation include a scale.

= BlendLuxCore =

''(LOL = LuxCore Online Library)''

===New Features===

* Add twosided material node
* New light group editor, now in the compositor for improved workflow: https://youtu.be/vqigKhwWxIs
* Warn if subdiv modifier is enabled in viewport, but disabled in final render, or if the subdiv level in viewport is higher than in final render
* Add support for non-uniform chromatic aberration
* Add support for sinc and catmullrom filter
* Move film device selection to properties, couple to GPU backend
* Add support for OptiX denoiser for viewport renders
* Add support for non-uniform bokeh and custom bokeh images
* Show a more helpful error message for Windows 7 users missing the update needed for AddDllDirectory
* Add stop button, to stop a render and run compositing
* Add support for holdout material option (in material output node)
* Add support for wireframe texture
* Use the new eye/light halt spp conditions (this means that samples from light tracing are now separate, which makes it much easier to set halt spp correctly with light tracing enabled)
* Improve volume node warning about incompatible (2D) texture nodes
* Allow to set the volume ID
* Add distort texture
* Add support for new AOVs (separate reflect/transmit variants of diffuse/glossy/specular direct/indirect light AOVs, caustic AOV)
* Cycles node reader: add support for the Normal input on material nodes, and basic support for the Bump node
* Cycles node reader: add support for holdout shader
* Add support for randomized tiling
* Add support for "reverse" option of white balance imagepipeline plugin
* Add support for temperature property of lights
* Make it possible again to use different devices for viewport and final renders (default for viewport: CPU), because users might prefer the lower latency of CPU preview renders even when using the GPU for final rendering
* Use sensible min value for Blender texture noise size
* Add support for texture bombing node
* Show a warning if an unsupported image source like Movie or UDIM Tiles is selected
* Rename AOV panel from "LuxCore Arbitrary Output Variables (AOVs)" to "LuxCore AOVs"
* LOL: Add support for local material assets and thumbnail rendering
* LOL: Automatically copy and downscale full preview images placed in preview directory (e.g. by manual download)

''v2.5beta1 released''

* Expose bump sampling distance because it requires adjustment in some rare cases (e.g. in very large or very small scenes, when procedural textures with extreme frequencies of detail are used)
* Add notes to tooltips that caches are only used during final render
* Show warning if a material combines volumes with opacity < 1, as this can lead to artifacts
* Add support for hiding planar edges in wireframe node
* Add slower fallback for custom normals if they aren't supported through C++ for a Blender version (a warning is shown if this adds more than 0.3 seconds to the export time of a mesh, so the user can disable custom normals for the mesh if they are not needed and drive up export time too much)
* Pixel filtering is now disabled by default, and forced disabled if light tracing is used together with denoising

===Fixed Bugs===

* Fix message about env. light cache building showing in viewport render, even when the cache is not built
* Fix NodeTreeUndefined being returned as node_tree.bl_idname in some cases
* Fix wrong function return values on hair export failure
* Fix NVRTC DLL loading on Linux
* Hide non-functional camera stereoscopy panel
* Cycles node reader: Fix bug with nested node groups
* Brick texture: remove unused bevel option, rename sockets, add support for modulation bias property
* Fix wrong sampler property being used when engine is Bidir and device is OCL
* Set glossytranclucent backface props regardless if double sided is checked or not
* Change Cauchy naming convention in Glass Material
* Fix out of core being used for CPU if enabled for GPU
* LOL: Fix wrong category asset selection
* LOL: Fix bug with assetbar when asset count is smaller than max row count
* LOL: Change colorspace of preview images from linear to default
* LOL: Use low resolution thumbnails in assetbar
* LOL: fix thumbnail download
* LOL: Fix thread handling (start thread twice error) if an error occurs during execution
* LOL: Fix bug in library deactivation in preferences which keep the LOL tab visible

''v2.5beta1 released''

* Fix crash on trying to replace a pinned node tree
* Fix no viewport update being triggered when toggling the advanced options of velvet material
* Fix dimension, lacunarity, octaves and intensity parameters of musgrave texture not working
* Fix noise depth not working in blender marble texture
* Fix RGB color and temperature not working for sun light and its sub-types (sun, distant, hemi)
* Ensure that noisedepth aka oct is in range 0..25 to avoid visual artifacts
* Fix a panel being shown even when the renderengine is not LuxCore
* Implement a workaround for viewport sessions not being deleted after viewport window resize or render configuration change, which led to a memory leak
* LOL: Fix problem of material assets if material name doesn't match asset name

===Known Problems===

* [https://github.com/LuxCoreRender/BlendLuxCore/issues/167 Inserted keyframes in material node graph don't show up in graph editor or anywhere else]
* LuxCore node parameters can not be animated in Blender 2.82. This bug is fixed in Blender 2.83 and later
* Rendering with caches (e.g. PhotonGI, DLSC, Env. light cache) can lead to problems '''if border rendering is enabled'''. A workaround is to disable automatic radius estimation and setting the radius manually instead when using border rendering

LuxCoreRender Release Notes v2.5

2021-02-02T17:05:01Z

Byob: /* BlendLuxCore */

__TOC__

=LuxCore=

===New Features===

* Added the support for Optix/RTX acceleration
* Added the support for Optix denoiser imagepipeline plugin
* GPU imagepipeline now allocated buffers for only the used AOVs by each plugin
* batch.haltspp now supports 2 parameters too in order to have separate halt conditions for eye and light tracing
* Added the support for camera not uniform and anamorphic bokeh (issue #409)
* Added the support for camera bokeh with custom distribution
* Variance clamping is now applied separately to each radiance group (issue #414)
* Added the support for lateral and longitudinal chromatic aberration (issue #409)
* Added the support for SINC pixel filter (issue #415)
* Added the support for CATMULLROM pixel filter (issue #415)
* It is now possible to disable Optix (with property context.cuda.optix.enable) even if it is detected and available
* Any mesh UV map can now be used for displacement (issue #416)
* Subdiv shape now supports multiple vertex UVs, colors, alphas and AOVs (issue #416)
* Added the support for holdout (issue #423)
* Added the support for wireframe texture
* Variance clamping is applied applied to DIRECT_DIFFUSE, DIRECT_GLOSSY, EMISSION, INDIRECT_DIFFUSE, INDIRECT_GLOSSY and INDIRECT_SPECULAR AOVs too
* GetPlatformDesc() now returns compile.LUXRAYS_ENABLE_OPTIX property to check if Optix is available
* Removed the limit of max. 32 AOV types
* Added the support for new AOVs (issue #429): DIRECT_DIFFUSE_REFLECT, DIRECT_DIFFUSE_TRANSMIT, DIRECT_GLOSSY_REFLECT, DIRECT_GLOSSY_TRANSMIT, INDIRECT_DIFFUSE_REFLECT, INDIRECT_DIFFUSE_TRANSMIT, INDIRECT_GLOSSY_REFLECT, INDIRECT_GLOSSY_TRANSMIT, INDIRECT_SPECULAR_REFLECT and INDIRECT_SPECULAR_TRANSMIT
* Added a fast evaluation path in GPU code for constant and image map textures
* Added the support for Distort texture
* Now individual bricks, in brick texture, have a pseudo-random mix between two colors by default
* Added the support for Randomized Texture Tiling (#228)
* Added the support for UVRandomMapping2D
* Added the support for LocalRandomMapping3D
* Added the support for Caustic AOV when using hybrid rendering
* Added the support for TwoSided material
* Reworked WhiteBalance plugin and light groups white balance support to be coherent with usual photographic white balance process (note: this change breaks the compatibility with past scene settings)
* Added a cap (25% and 75%) to Glass transmission/reflection sampling to not under sample some case
* Added the support to all light sources of ".temperature" and ".temperature.normalize" properties to set light temperature
* Added the support for texture bombing
* Added the support for Caustic AOV to OutputSwitcherPlugin
* LuxCore API has new log system
* Added the support for 180 (or any other amount of degrees) view to Environment camera
* Added the support for 180 (horizontal stacked) and 360 degree (vertical stacked) stereo camera (issue #451)

===Fixed Bugs===

* Added the support for pixel filtering to light tracing (issue #413)
* Now LuxCore works even if OpenCL is available but not a valid OpenCL ICD platform has been found (issue #422)
* Fixed a problem with cloth material when using CUDA and Windows (issue #417)
* Fixed a problem in glossy coating albedo evaluation on GPUs
* Fixed a difference between CPU and GPU rendering when using a roughglass with a shadow transparency color
* Fixed the support in .ply files for triangle AOVs
* Fixed a memory leak when rendering with OpenCL (noticeable when rendering animations)
* Fixed text export of brick texture HERRINGBONE and BASKET
* Fixed scale problem in GPU code for brick texture HERRINGBONE and BASKET (issue #438)
* Fixed a possible crash when using trilinear texture with GPUs
* Reworked some condition in hybrid rendering light tracing to solve the problem of flashing caustics (issue #441)
* Fixed a problem with Blender Translation language preference option and scene export on file
* Fixed a self-shadow problem in BIRCPU render engine
* Fixed a Mix material problem when using solid and transparent materials (issue #461)

===Known Problems===

* accelerator.bvh.builder.type = EMBREE_MORTON doesn't work with the latest Embree
* Python crashes when calling sys.exit()
* TILEPATHOCL (and RTPATHOCL) count the layers of transparent surfaces as an iteration of the rendering finite state machine so they require to increase the max. path depth to avoid black regions.
* Light emitted by motion blurred triangle lights is approximated using the triangle area of time 0.0 (computing triangle area at runtime would be expansive) so it may be not totally accurate if the motion blur transformation include a scale.

= BlendLuxCore =

''(LOL = LuxCore Online Library)''

===New Features===

* Add twosided material node
* New light group editor, now in the compositor for improved workflow: https://youtu.be/vqigKhwWxIs
* Warn if subdiv modifier is enabled in viewport, but disabled in final render, or if the subdiv level in viewport is higher than in final render
* Add support for non-uniform chromatic aberration
* Add support for sinc and catmullrom filter
* Move film device selection to properties, couple to GPU backend
* Add support for OptiX denoiser for viewport renders
* Add support for non-uniform bokeh and custom bokeh images
* Show a more helpful error message for Windows 7 users missing the update needed for AddDllDirectory
* Add stop button, to stop a render and run compositing
* Add support for holdout material option (in material output node)
* Add support for wireframe texture
* Use the new eye/light halt spp conditions (this means that samples from light tracing are now separate, which makes it much easier to set halt spp correctly with light tracing enabled)
* Improve volume node warning about incompatible (2D) texture nodes
* Allow to set the volume ID
* Add distort texture
* Add support for new AOVs (separate reflect/transmit variants of diffuse/glossy/specular direct/indirect light AOVs, caustic AOV)
* Cycles node reader: add support for the Normal input on material nodes, and basic support for the Bump node
* Cycles node reader: add support for holdout shader
* Add support for randomized tiling
* Add support for "reverse" option of white balance imagepipeline plugin
* Add support for temperature property of lights
* Make it possible again to use different devices for viewport and final renders (default for viewport: CPU), because users might prefer the lower latency of CPU preview renders even when using the GPU for final rendering
* Use sensible min value for Blender texture noise size
* Add support for texture bombing node
* Show a warning if an unsupported image source like Movie or UDIM Tiles is selected
* Rename AOV panel from "LuxCore Arbitrary Output Variables (AOVs)" to "LuxCore AOVs"
* LOL: Add support for local material assets and thumbnail rendering
* LOL: Automatically copy and downscale full preview images placed in preview directory (e.g. by manual download)

''v2.5beta1 released''

* Expose bump sampling distance because it requires adjustment in some rare cases (e.g. in very large or very small scenes, when procedural textures with extreme frequencies of detail are used)
* Add notes to tooltips that caches are only used during final render
* Show warning if a material combines volumes with opacity < 1, as this can lead to artifacts
* Add support for hiding planar edges in wireframe node
* Add slower fallback for custom normals if they aren't supported through C++ for a Blender version (a warning is shown if this adds more than 0.3 seconds to the export time of a mesh, so the user can disable custom normals for the mesh if they are not needed and drive up export time too much)

===Fixed Bugs===

* Fix message about env. light cache building showing in viewport render, even when the cache is not built
* Fix NodeTreeUndefined being returned as node_tree.bl_idname in some cases
* Fix wrong function return values on hair export failure
* Fix NVRTC DLL loading on Linux
* Hide non-functional camera stereoscopy panel
* Cycles node reader: Fix bug with nested node groups
* Brick texture: remove unused bevel option, rename sockets, add support for modulation bias property
* Fix wrong sampler property being used when engine is Bidir and device is OCL
* Set glossytranclucent backface props regardless if double sided is checked or not
* Change Cauchy naming convention in Glass Material
* Fix out of core being used for CPU if enabled for GPU
* LOL: Fix wrong category asset selection
* LOL: Fix bug with assetbar when asset count is smaller than max row count
* LOL: Change colorspace of preview images from linear to default
* LOL: Use low resolution thumbnails in assetbar
* LOL: fix thumbnail download
* LOL: Fix thread handling (start thread twice error) if an error occurs during execution
* LOL: Fix bug in library deactivation in preferences which keep the LOL tab visible

''v2.5beta1 released''

* Fix crash on trying to replace a pinned node tree
* Fix no viewport update being triggered when toggling the advanced options of velvet material
* Fix dimension, lacunarity, octaves and intensity parameters of musgrave texture not working
* Fix noise depth not working in blender marble texture
* Fix RGB color and temperature not working for sun light and its sub-types (sun, distant, hemi)
* Ensure that noisedepth aka oct is in range 0..25 to avoid visual artifacts
* Fix a panel being shown even when the renderengine is not LuxCore
* Implement a workaround for viewport sessions not being deleted after viewport window resize or render configuration change, which led to a memory leak
* LOL: Fix problem of material assets if material name doesn't match asset name

===Known Problems===

* [https://github.com/LuxCoreRender/BlendLuxCore/issues/167 Inserted keyframes in material node graph don't show up in graph editor or anywhere else]
* LuxCore node parameters can not be animated in Blender 2.82. This bug is fixed in Blender 2.83 and later
* Rendering with caches (e.g. PhotonGI, DLSC, Env. light cache) can lead to problems '''if border rendering is enabled'''. A workaround is to disable automatic radius estimation and setting the radius manually instead when using border rendering

LuxCoreRender Release Notes v2.5

2021-02-02T17:04:18Z

Byob: /* Fixed Bugs */

__TOC__

=LuxCore=

===New Features===

* Added the support for Optix/RTX acceleration
* Added the support for Optix denoiser imagepipeline plugin
* GPU imagepipeline now allocated buffers for only the used AOVs by each plugin
* batch.haltspp now supports 2 parameters too in order to have separate halt conditions for eye and light tracing
* Added the support for camera not uniform and anamorphic bokeh (issue #409)
* Added the support for camera bokeh with custom distribution
* Variance clamping is now applied separately to each radiance group (issue #414)
* Added the support for lateral and longitudinal chromatic aberration (issue #409)
* Added the support for SINC pixel filter (issue #415)
* Added the support for CATMULLROM pixel filter (issue #415)
* It is now possible to disable Optix (with property context.cuda.optix.enable) even if it is detected and available
* Any mesh UV map can now be used for displacement (issue #416)
* Subdiv shape now supports multiple vertex UVs, colors, alphas and AOVs (issue #416)
* Added the support for holdout (issue #423)
* Added the support for wireframe texture
* Variance clamping is applied applied to DIRECT_DIFFUSE, DIRECT_GLOSSY, EMISSION, INDIRECT_DIFFUSE, INDIRECT_GLOSSY and INDIRECT_SPECULAR AOVs too
* GetPlatformDesc() now returns compile.LUXRAYS_ENABLE_OPTIX property to check if Optix is available
* Removed the limit of max. 32 AOV types
* Added the support for new AOVs (issue #429): DIRECT_DIFFUSE_REFLECT, DIRECT_DIFFUSE_TRANSMIT, DIRECT_GLOSSY_REFLECT, DIRECT_GLOSSY_TRANSMIT, INDIRECT_DIFFUSE_REFLECT, INDIRECT_DIFFUSE_TRANSMIT, INDIRECT_GLOSSY_REFLECT, INDIRECT_GLOSSY_TRANSMIT, INDIRECT_SPECULAR_REFLECT and INDIRECT_SPECULAR_TRANSMIT
* Added a fast evaluation path in GPU code for constant and image map textures
* Added the support for Distort texture
* Now individual bricks, in brick texture, have a pseudo-random mix between two colors by default
* Added the support for Randomized Texture Tiling (#228)
* Added the support for UVRandomMapping2D
* Added the support for LocalRandomMapping3D
* Added the support for Caustic AOV when using hybrid rendering
* Added the support for TwoSided material
* Reworked WhiteBalance plugin and light groups white balance support to be coherent with usual photographic white balance process (note: this change breaks the compatibility with past scene settings)
* Added a cap (25% and 75%) to Glass transmission/reflection sampling to not under sample some case
* Added the support to all light sources of ".temperature" and ".temperature.normalize" properties to set light temperature
* Added the support for texture bombing
* Added the support for Caustic AOV to OutputSwitcherPlugin
* LuxCore API has new log system
* Added the support for 180 (or any other amount of degrees) view to Environment camera
* Added the support for 180 (horizontal stacked) and 360 degree (vertical stacked) stereo camera (issue #451)

===Fixed Bugs===

* Added the support for pixel filtering to light tracing (issue #413)
* Now LuxCore works even if OpenCL is available but not a valid OpenCL ICD platform has been found (issue #422)
* Fixed a problem with cloth material when using CUDA and Windows (issue #417)
* Fixed a problem in glossy coating albedo evaluation on GPUs
* Fixed a difference between CPU and GPU rendering when using a roughglass with a shadow transparency color
* Fixed the support in .ply files for triangle AOVs
* Fixed a memory leak when rendering with OpenCL (noticeable when rendering animations)
* Fixed text export of brick texture HERRINGBONE and BASKET
* Fixed scale problem in GPU code for brick texture HERRINGBONE and BASKET (issue #438)
* Fixed a possible crash when using trilinear texture with GPUs
* Reworked some condition in hybrid rendering light tracing to solve the problem of flashing caustics (issue #441)
* Fixed a problem with Blender Translation language preference option and scene export on file
* Fixed a self-shadow problem in BIRCPU render engine
* Fixed a Mix material problem when using solid and transparent materials (issue #461)

===Known Problems===

* accelerator.bvh.builder.type = EMBREE_MORTON doesn't work with the latest Embree
* Python crashes when calling sys.exit()
* TILEPATHOCL (and RTPATHOCL) count the layers of transparent surfaces as an iteration of the rendering finite state machine so they require to increase the max. path depth to avoid black regions.
* Light emitted by motion blurred triangle lights is approximated using the triangle area of time 0.0 (computing triangle area at runtime would be expansive) so it may be not totally accurate if the motion blur transformation include a scale.

= BlendLuxCore =

*(LOL = LuxCore Online Library)*

===New Features===

* Add twosided material node
* New light group editor, now in the compositor for improved workflow: https://youtu.be/vqigKhwWxIs
* Warn if subdiv modifier is enabled in viewport, but disabled in final render, or if the subdiv level in viewport is higher than in final render
* Add support for non-uniform chromatic aberration
* Add support for sinc and catmullrom filter
* Move film device selection to properties, couple to GPU backend
* Add support for OptiX denoiser for viewport renders
* Add support for non-uniform bokeh and custom bokeh images
* Show a more helpful error message for Windows 7 users missing the update needed for AddDllDirectory
* Add stop button, to stop a render and run compositing
* Add support for holdout material option (in material output node)
* Add support for wireframe texture
* Use the new eye/light halt spp conditions (this means that samples from light tracing are now separate, which makes it much easier to set halt spp correctly with light tracing enabled)
* Improve volume node warning about incompatible (2D) texture nodes
* Allow to set the volume ID
* Add distort texture
* Add support for new AOVs (separate reflect/transmit variants of diffuse/glossy/specular direct/indirect light AOVs, caustic AOV)
* Cycles node reader: add support for the Normal input on material nodes, and basic support for the Bump node
* Cycles node reader: add support for holdout shader
* Add support for randomized tiling
* Add support for "reverse" option of white balance imagepipeline plugin
* Add support for temperature property of lights
* Make it possible again to use different devices for viewport and final renders (default for viewport: CPU), because users might prefer the lower latency of CPU preview renders even when using the GPU for final rendering
* Use sensible min value for Blender texture noise size
* Add support for texture bombing node
* Show a warning if an unsupported image source like Movie or UDIM Tiles is selected
* Rename AOV panel from "LuxCore Arbitrary Output Variables (AOVs)" to "LuxCore AOVs"
* LOL: Add support for local material assets and thumbnail rendering
* LOL: Automatically copy and downscale full preview images placed in preview directory (e.g. by manual download)

*v2.5beta1 released*

* Expose bump sampling distance because it requires adjustment in some rare cases (e.g. in very large or very small scenes, when procedural textures with extreme frequencies of detail are used)
* Add notes to tooltips that caches are only used during final render
* Show warning if a material combines volumes with opacity < 1, as this can lead to artifacts
* Add support for hiding planar edges in wireframe node
* Add slower fallback for custom normals if they aren't supported through C++ for a Blender version (a warning is shown if this adds more than 0.3 seconds to the export time of a mesh, so the user can disable custom normals for the mesh if they are not needed and drive up export time too much)

===Fixed Bugs===

* Fix message about env. light cache building showing in viewport render, even when the cache is not built
* Fix NodeTreeUndefined being returned as node_tree.bl_idname in some cases
* Fix wrong function return values on hair export failure
* Fix NVRTC DLL loading on Linux
* Hide non-functional camera stereoscopy panel
* Cycles node reader: Fix bug with nested node groups
* Brick texture: remove unused bevel option, rename sockets, add support for modulation bias property
* Fix wrong sampler property being used when engine is Bidir and device is OCL
* Set glossytranclucent backface props regardless if double sided is checked or not
* Change Cauchy naming convention in Glass Material
* Fix out of core being used for CPU if enabled for GPU
* LOL: Fix wrong category asset selection
* LOL: Fix bug with assetbar when asset count is smaller than max row count
* LOL: Change colorspace of preview images from linear to default
* LOL: Use low resolution thumbnails in assetbar
* LOL: fix thumbnail download
* LOL: Fix thread handling (start thread twice error) if an error occurs during execution
* LOL: Fix bug in library deactivation in preferences which keep the LOL tab visible

*v2.5beta1 released*

* Fix crash on trying to replace a pinned node tree
* Fix no viewport update being triggered when toggling the advanced options of velvet material
* Fix dimension, lacunarity, octaves and intensity parameters of musgrave texture not working
* Fix noise depth not working in blender marble texture
* Fix RGB color and temperature not working for sun light and its sub-types (sun, distant, hemi)
* Ensure that noisedepth aka oct is in range 0..25 to avoid visual artifacts
* Fix a panel being shown even when the renderengine is not LuxCore
* Implement a workaround for viewport sessions not being deleted after viewport window resize or render configuration change, which led to a memory leak
* LOL: Fix problem of material assets if material name doesn't match asset name

===Known Problems===

* [https://github.com/LuxCoreRender/BlendLuxCore/issues/167 Inserted keyframes in material node graph don't show up in graph editor or anywhere else]
* LuxCore node parameters can not be animated in Blender 2.82. This bug is fixed in Blender 2.83 and later
* Rendering with caches (e.g. PhotonGI, DLSC, Env. light cache) can lead to problems '''if border rendering is enabled'''. A workaround is to disable automatic radius estimation and setting the radius manually instead when using border rendering

LuxCoreRender Release Notes v2.5

2021-02-02T17:03:26Z

Byob: /* BlendLuxCore */

__TOC__

=LuxCore=

===New Features===

* Added the support for Optix/RTX acceleration
* Added the support for Optix denoiser imagepipeline plugin
* GPU imagepipeline now allocated buffers for only the used AOVs by each plugin
* batch.haltspp now supports 2 parameters too in order to have separate halt conditions for eye and light tracing
* Added the support for camera not uniform and anamorphic bokeh (issue #409)
* Added the support for camera bokeh with custom distribution
* Variance clamping is now applied separately to each radiance group (issue #414)
* Added the support for lateral and longitudinal chromatic aberration (issue #409)
* Added the support for SINC pixel filter (issue #415)
* Added the support for CATMULLROM pixel filter (issue #415)
* It is now possible to disable Optix (with property context.cuda.optix.enable) even if it is detected and available
* Any mesh UV map can now be used for displacement (issue #416)
* Subdiv shape now supports multiple vertex UVs, colors, alphas and AOVs (issue #416)
* Added the support for holdout (issue #423)
* Added the support for wireframe texture
* Variance clamping is applied applied to DIRECT_DIFFUSE, DIRECT_GLOSSY, EMISSION, INDIRECT_DIFFUSE, INDIRECT_GLOSSY and INDIRECT_SPECULAR AOVs too
* GetPlatformDesc() now returns compile.LUXRAYS_ENABLE_OPTIX property to check if Optix is available
* Removed the limit of max. 32 AOV types
* Added the support for new AOVs (issue #429): DIRECT_DIFFUSE_REFLECT, DIRECT_DIFFUSE_TRANSMIT, DIRECT_GLOSSY_REFLECT, DIRECT_GLOSSY_TRANSMIT, INDIRECT_DIFFUSE_REFLECT, INDIRECT_DIFFUSE_TRANSMIT, INDIRECT_GLOSSY_REFLECT, INDIRECT_GLOSSY_TRANSMIT, INDIRECT_SPECULAR_REFLECT and INDIRECT_SPECULAR_TRANSMIT
* Added a fast evaluation path in GPU code for constant and image map textures
* Added the support for Distort texture
* Now individual bricks, in brick texture, have a pseudo-random mix between two colors by default
* Added the support for Randomized Texture Tiling (#228)
* Added the support for UVRandomMapping2D
* Added the support for LocalRandomMapping3D
* Added the support for Caustic AOV when using hybrid rendering
* Added the support for TwoSided material
* Reworked WhiteBalance plugin and light groups white balance support to be coherent with usual photographic white balance process (note: this change breaks the compatibility with past scene settings)
* Added a cap (25% and 75%) to Glass transmission/reflection sampling to not under sample some case
* Added the support to all light sources of ".temperature" and ".temperature.normalize" properties to set light temperature
* Added the support for texture bombing
* Added the support for Caustic AOV to OutputSwitcherPlugin
* LuxCore API has new log system
* Added the support for 180 (or any other amount of degrees) view to Environment camera
* Added the support for 180 (horizontal stacked) and 360 degree (vertical stacked) stereo camera (issue #451)

===Fixed Bugs===

* Added the support for pixel filtering to light tracing (issue #413)
* Now LuxCore works even if OpenCL is available but not a valid OpenCL ICD platform has been found (issue #422)
* Fixed a problem with cloth material when using CUDA and Windows (issue #417)
* Fixed a problem in glossy coating albedo evaluation on GPUs
* Fixed a difference between CPU and GPU rendering when using a roughglass with a shadow transparency color
* Fixed the support in .ply files for triangle AOVs
* Fixed a memory leak when rendering with OpenCL (noticeable when rendering animations)
* Fixed text export of brick texture HERRINGBONE and BASKET
* Fixed scale problem in GPU code for brick texture HERRINGBONE and BASKET (issue #438)
* Fixed a possible crash when using trilinear texture with GPUs
* Reworked some condition in hybrid rendering light tracing to solve the problem of flashing caustics (issue #441)
* Fixed a problem with Blender Translation language preference option and scene export on file
* Fixed a self-shadow problem in BIRCPU render engine
* Fixed a Mix material problem when using solid and transparent materials (issue #461)

===Known Problems===

* accelerator.bvh.builder.type = EMBREE_MORTON doesn't work with the latest Embree
* Python crashes when calling sys.exit()
* TILEPATHOCL (and RTPATHOCL) count the layers of transparent surfaces as an iteration of the rendering finite state machine so they require to increase the max. path depth to avoid black regions.
* Light emitted by motion blurred triangle lights is approximated using the triangle area of time 0.0 (computing triangle area at runtime would be expansive) so it may be not totally accurate if the motion blur transformation include a scale.

= BlendLuxCore =

*(LOL = LuxCore Online Library)*

===New Features===

* Add twosided material node
* New light group editor, now in the compositor for improved workflow: https://youtu.be/vqigKhwWxIs
* Warn if subdiv modifier is enabled in viewport, but disabled in final render, or if the subdiv level in viewport is higher than in final render
* Add support for non-uniform chromatic aberration
* Add support for sinc and catmullrom filter
* Move film device selection to properties, couple to GPU backend
* Add support for OptiX denoiser for viewport renders
* Add support for non-uniform bokeh and custom bokeh images
* Show a more helpful error message for Windows 7 users missing the update needed for AddDllDirectory
* Add stop button, to stop a render and run compositing
* Add support for holdout material option (in material output node)
* Add support for wireframe texture
* Use the new eye/light halt spp conditions (this means that samples from light tracing are now separate, which makes it much easier to set halt spp correctly with light tracing enabled)
* Improve volume node warning about incompatible (2D) texture nodes
* Allow to set the volume ID
* Add distort texture
* Add support for new AOVs (separate reflect/transmit variants of diffuse/glossy/specular direct/indirect light AOVs, caustic AOV)
* Cycles node reader: add support for the Normal input on material nodes, and basic support for the Bump node
* Cycles node reader: add support for holdout shader
* Add support for randomized tiling
* Add support for "reverse" option of white balance imagepipeline plugin
* Add support for temperature property of lights
* Make it possible again to use different devices for viewport and final renders (default for viewport: CPU), because users might prefer the lower latency of CPU preview renders even when using the GPU for final rendering
* Use sensible min value for Blender texture noise size
* Add support for texture bombing node
* Show a warning if an unsupported image source like Movie or UDIM Tiles is selected
* Rename AOV panel from "LuxCore Arbitrary Output Variables (AOVs)" to "LuxCore AOVs"
* LOL: Add support for local material assets and thumbnail rendering
* LOL: Automatically copy and downscale full preview images placed in preview directory (e.g. by manual download)

*v2.5beta1 released*

* Expose bump sampling distance because it requires adjustment in some rare cases (e.g. in very large or very small scenes, when procedural textures with extreme frequencies of detail are used)
* Add notes to tooltips that caches are only used during final render
* Show warning if a material combines volumes with opacity < 1, as this can lead to artifacts
* Add support for hiding planar edges in wireframe node
* Add slower fallback for custom normals if they aren't supported through C++ for a Blender version (a warning is shown if this adds more than 0.3 seconds to the export time of a mesh, so the user can disable custom normals for the mesh if they are not needed and drive up export time too much)

===Fixed Bugs===

* Fix message about env. light cache building showing in viewport render, even when the cache is not built
* Fix NodeTreeUndefined being returned as node_tree.bl_idname in some cases
* Fix wrong function return values on hair export failure
* Fix NVRTC DLL loading on Linux
* Hide non-functional camera stereoscopy panel
* Cycles node reader: Fix bug with nested node groups
* Brick texture: remove unused bevel option, rename sockets, add support for modulation bias property
* Fix wrong sampler property being used when engine is Bidir and device is OCL
* Set glossytranclucent backface props regardless if double sided is checked or not
* Change Cauchy naming convention in Glass Material
* Fix out of core being used for CPU if enabled for GPU
* LOL: Fix wrong category asset selection
* LOL: Fix bug with assetbar when asset count is smaller than max row count
* LOL: Change colorspace of preview images from linear to default
* LOL: Use low resolution thumbnails in assetbar
* LOL: fix thumbnail download
* LOL: Fix thread handling (start thread twice error) if an error occurs during execution
* LOL: Fix bug in library deactivation in preferences which keep the LOL tab visible

*v2.5beta1 released*

* Fix crash on trying to replace a pinned node tree
* Fix no viewport update being triggered when toggling the advanced options of velvet material
* Fix dimension, lacunarity, octaves and intensity parameters of musgrave texture not working
* Fix noise depth not working in blender marble texture
* Fix RGB color and temperature not working for sun light and its sub-types (sun, distant, hemi)
* Ensure that noisedepth aka oct is in range 0..25 to avoid visual artifacts
* Fix a panel being shown even when the renderengine is not LuxCore
* Implement a workaround for viewport sessions not being deleted after viewport window resize or render configuration change, which led to a memory leak
* LOL: Fix problem of material assets if material name doesn't match asset name

LuxCoreRender Release Notes v2.5

2021-02-02T17:03:11Z

Byob: add BlendLuxCore changelog

__TOC__

=LuxCore=

===New Features===

* Added the support for Optix/RTX acceleration
* Added the support for Optix denoiser imagepipeline plugin
* GPU imagepipeline now allocated buffers for only the used AOVs by each plugin
* batch.haltspp now supports 2 parameters too in order to have separate halt conditions for eye and light tracing
* Added the support for camera not uniform and anamorphic bokeh (issue #409)
* Added the support for camera bokeh with custom distribution
* Variance clamping is now applied separately to each radiance group (issue #414)
* Added the support for lateral and longitudinal chromatic aberration (issue #409)
* Added the support for SINC pixel filter (issue #415)
* Added the support for CATMULLROM pixel filter (issue #415)
* It is now possible to disable Optix (with property context.cuda.optix.enable) even if it is detected and available
* Any mesh UV map can now be used for displacement (issue #416)
* Subdiv shape now supports multiple vertex UVs, colors, alphas and AOVs (issue #416)
* Added the support for holdout (issue #423)
* Added the support for wireframe texture
* Variance clamping is applied applied to DIRECT_DIFFUSE, DIRECT_GLOSSY, EMISSION, INDIRECT_DIFFUSE, INDIRECT_GLOSSY and INDIRECT_SPECULAR AOVs too
* GetPlatformDesc() now returns compile.LUXRAYS_ENABLE_OPTIX property to check if Optix is available
* Removed the limit of max. 32 AOV types
* Added the support for new AOVs (issue #429): DIRECT_DIFFUSE_REFLECT, DIRECT_DIFFUSE_TRANSMIT, DIRECT_GLOSSY_REFLECT, DIRECT_GLOSSY_TRANSMIT, INDIRECT_DIFFUSE_REFLECT, INDIRECT_DIFFUSE_TRANSMIT, INDIRECT_GLOSSY_REFLECT, INDIRECT_GLOSSY_TRANSMIT, INDIRECT_SPECULAR_REFLECT and INDIRECT_SPECULAR_TRANSMIT
* Added a fast evaluation path in GPU code for constant and image map textures
* Added the support for Distort texture
* Now individual bricks, in brick texture, have a pseudo-random mix between two colors by default
* Added the support for Randomized Texture Tiling (#228)
* Added the support for UVRandomMapping2D
* Added the support for LocalRandomMapping3D
* Added the support for Caustic AOV when using hybrid rendering
* Added the support for TwoSided material
* Reworked WhiteBalance plugin and light groups white balance support to be coherent with usual photographic white balance process (note: this change breaks the compatibility with past scene settings)
* Added a cap (25% and 75%) to Glass transmission/reflection sampling to not under sample some case
* Added the support to all light sources of ".temperature" and ".temperature.normalize" properties to set light temperature
* Added the support for texture bombing
* Added the support for Caustic AOV to OutputSwitcherPlugin
* LuxCore API has new log system
* Added the support for 180 (or any other amount of degrees) view to Environment camera
* Added the support for 180 (horizontal stacked) and 360 degree (vertical stacked) stereo camera (issue #451)

===Fixed Bugs===

* Added the support for pixel filtering to light tracing (issue #413)
* Now LuxCore works even if OpenCL is available but not a valid OpenCL ICD platform has been found (issue #422)
* Fixed a problem with cloth material when using CUDA and Windows (issue #417)
* Fixed a problem in glossy coating albedo evaluation on GPUs
* Fixed a difference between CPU and GPU rendering when using a roughglass with a shadow transparency color
* Fixed the support in .ply files for triangle AOVs
* Fixed a memory leak when rendering with OpenCL (noticeable when rendering animations)
* Fixed text export of brick texture HERRINGBONE and BASKET
* Fixed scale problem in GPU code for brick texture HERRINGBONE and BASKET (issue #438)
* Fixed a possible crash when using trilinear texture with GPUs
* Reworked some condition in hybrid rendering light tracing to solve the problem of flashing caustics (issue #441)
* Fixed a problem with Blender Translation language preference option and scene export on file
* Fixed a self-shadow problem in BIRCPU render engine
* Fixed a Mix material problem when using solid and transparent materials (issue #461)

===Known Problems===

* accelerator.bvh.builder.type = EMBREE_MORTON doesn't work with the latest Embree
* Python crashes when calling sys.exit()
* TILEPATHOCL (and RTPATHOCL) count the layers of transparent surfaces as an iteration of the rendering finite state machine so they require to increase the max. path depth to avoid black regions.
* Light emitted by motion blurred triangle lights is approximated using the triangle area of time 0.0 (computing triangle area at runtime would be expansive) so it may be not totally accurate if the motion blur transformation include a scale.

= BlendLuxCore =

*(LOL = LuxCore Online Library)*

===New Features:===

* Add twosided material node
* New light group editor, now in the compositor for improved workflow: https://youtu.be/vqigKhwWxIs
* Warn if subdiv modifier is enabled in viewport, but disabled in final render, or if the subdiv level in viewport is higher than in final render
* Add support for non-uniform chromatic aberration
* Add support for sinc and catmullrom filter
* Move film device selection to properties, couple to GPU backend
* Add support for OptiX denoiser for viewport renders
* Add support for non-uniform bokeh and custom bokeh images
* Show a more helpful error message for Windows 7 users missing the update needed for AddDllDirectory
* Add stop button, to stop a render and run compositing
* Add support for holdout material option (in material output node)
* Add support for wireframe texture
* Use the new eye/light halt spp conditions (this means that samples from light tracing are now separate, which makes it much easier to set halt spp correctly with light tracing enabled)
* Improve volume node warning about incompatible (2D) texture nodes
* Allow to set the volume ID
* Add distort texture
* Add support for new AOVs (separate reflect/transmit variants of diffuse/glossy/specular direct/indirect light AOVs, caustic AOV)
* Cycles node reader: add support for the Normal input on material nodes, and basic support for the Bump node
* Cycles node reader: add support for holdout shader
* Add support for randomized tiling
* Add support for "reverse" option of white balance imagepipeline plugin
* Add support for temperature property of lights
* Make it possible again to use different devices for viewport and final renders (default for viewport: CPU), because users might prefer the lower latency of CPU preview renders even when using the GPU for final rendering
* Use sensible min value for Blender texture noise size
* Add support for texture bombing node
* Show a warning if an unsupported image source like Movie or UDIM Tiles is selected
* Rename AOV panel from "LuxCore Arbitrary Output Variables (AOVs)" to "LuxCore AOVs"
* LOL: Add support for local material assets and thumbnail rendering
* LOL: Automatically copy and downscale full preview images placed in preview directory (e.g. by manual download)

*v2.5beta1 released*

* Expose bump sampling distance because it requires adjustment in some rare cases (e.g. in very large or very small scenes, when procedural textures with extreme frequencies of detail are used)
* Add notes to tooltips that caches are only used during final render
* Show warning if a material combines volumes with opacity < 1, as this can lead to artifacts
* Add support for hiding planar edges in wireframe node
* Add slower fallback for custom normals if they aren't supported through C++ for a Blender version (a warning is shown if this adds more than 0.3 seconds to the export time of a mesh, so the user can disable custom normals for the mesh if they are not needed and drive up export time too much)

===Fixed Bugs:===

* Fix message about env. light cache building showing in viewport render, even when the cache is not built
* Fix NodeTreeUndefined being returned as node_tree.bl_idname in some cases
* Fix wrong function return values on hair export failure
* Fix NVRTC DLL loading on Linux
* Hide non-functional camera stereoscopy panel
* Cycles node reader: Fix bug with nested node groups
* Brick texture: remove unused bevel option, rename sockets, add support for modulation bias property
* Fix wrong sampler property being used when engine is Bidir and device is OCL
* Set glossytranclucent backface props regardless if double sided is checked or not
* Change Cauchy naming convention in Glass Material
* Fix out of core being used for CPU if enabled for GPU
* LOL: Fix wrong category asset selection
* LOL: Fix bug with assetbar when asset count is smaller than max row count
* LOL: Change colorspace of preview images from linear to default
* LOL: Use low resolution thumbnails in assetbar
* LOL: fix thumbnail download
* LOL: Fix thread handling (start thread twice error) if an error occurs during execution
* LOL: Fix bug in library deactivation in preferences which keep the LOL tab visible

*v2.5beta1 released*

* Fix crash on trying to replace a pinned node tree
* Fix no viewport update being triggered when toggling the advanced options of velvet material
* Fix dimension, lacunarity, octaves and intensity parameters of musgrave texture not working
* Fix noise depth not working in blender marble texture
* Fix RGB color and temperature not working for sun light and its sub-types (sun, distant, hemi)
* Ensure that noisedepth aka oct is in range 0..25 to avoid visual artifacts
* Fix a panel being shown even when the renderengine is not LuxCore
* Implement a workaround for viewport sessions not being deleted after viewport window resize or render configuration change, which led to a memory leak
* LOL: Fix problem of material assets if material name doesn't match asset name

BlendLuxCore FAQ

2021-02-02T13:09:41Z

Byob: /* What can be done against fireflies/hotpixels? */

= Frequently Asked Questions =

=== I can not enable the BlendLuxCore addon, it shows errors ===

Most problems in this area stem from broken graphics driver installations. Try to re-install or update your graphics driver.

'''For Windows users:'''
* Make sure that you have installed the [https://www.microsoft.com/en-US/download/details.aspx?id=40784 Visual C++ Redistributable Packages for Visual Studio 2013]
* If you use v2.1alpha0 or later, you will also need:
** [https://aka.ms/vs/15/release/vc_redist.x64.exe Microsoft Visual C++ Redistributable for Visual Studio 2017]
** [https://software.intel.com/sites/default/files/managed/59/aa/ww_icl_redist_msi_2018.3.210.zip Intel C++ redistributable]

If this does not solve the problem, browse the [https://github.com/LuxCoreRender/BlendLuxCore/issues?q=is%3Aissue+label%3Ainstallation installation issues] in the bug tracker to check if your error message was already reported.
If it was not reported yet, open a new issue and copy the error message from the Blender console (on Windows, click Window -> Toggle System Console in Blender's menu. On Linux, start Blender from a terminal and try to enable the addon, then copy the error message from the terminal).

See the [[BlendLuxCore_Installation | installation page]] for information on how to install, update and remove the BlendLuxCore addon.

=== Is there something like Cycles' Layer Weight/Fresnel/Facing node in LuxCore? ===

No, in LuxCore there is no direct equivalent to this node, because it would not work with the many algorithms in LuxCore that trace rays from lights (instead of from the camera), like the bidirectional engine, light tracing mode, or the PhotonGI cache.

Of course, all materials in LuxCore are physically based and have realistic fresnel effects built-in.

You can achieve a similar effect with the dot product node, but it will work only for one viewpoint:

[[File:Layer_weight_for_one_direction.PNG | thumb | 400px | center]]

=== Can Cycles materials be used in BlendLuxCore? ===

To an extent, yes. Many common Cycles shader nodes can be used in BlendLuxCore:

* You can enable this individually for each material with the "Use Cycles Nodes" option in the material properties.
* You can also enable it for the whole scene at once with the "Use Cycles Settings" button in the render properties. This will configure all materials, lights and the world to use Cycles settings

Not all Cycles nodes and settings are supported. Here is an overview: https://github.com/LuxCoreRender/BlendLuxCore/issues/272

=== Can 2D/3D mapping be driven by textures in LuxCore? ===

In general, no, because it would lead to much worse performance on GPUs.

However, if you only need to drive the translation part of a texture mapping, since LuxCore v2.5 you can use the distort texture for this purpose:

[[File:Distort_texture.PNG | thumb | 400px | center | A checker texture (left) is distorted by a clouds texture (right). The result can be seen in the center]]

Texturing of rotation and scale is not yet possible.

=== What can be done against fireflies/hotpixels? ===

Sometimes, pixels appear that are much brighter than the surrounding pixels. Sometimes they are singular, sometimes clumped up. The underlying reason are light paths that are correct, but very hard to find with the current rendering algorithms, and thus they take much longer to render until noise-free than all other light paths in the image.

There are multiple ways to approach this problem:

* '''Try another rendering algorithm''', it might be able to find the firefly-causing light paths much easier than the one you currently use. For example, try going to the render properties, open the Light Paths panel and enable "Light Tracing", or try the [[PhotonGI | PhotonGI caustic cache]], or try using the bidirectional engine.
* You can '''clamp the brightness of all light paths''' to a maximum value, in the render properties, Light Paths panel, "Clamping" setting. BlendLuxCore can auto-detect a value for this setting that is in the right ballpark for your scene if you render once without clamping enabled, but often this value will not be the best, so you will need a bit of trial-and-error to find a good value. Note that the clamping value depends on the lighting in your scene, so there is no one universally good clamping value, and you might need to adjust it if you add a new light source to your scene that is brighter than the others. Using a clamping value that is too low will result in a low-contrast, washed-out image, while a too high value will leave fireflies unaffected.
* Try to find out which lights or materials are responsible for the fireflies. There might be small, hard-to-find light sources that are causing them. Or a specular material is reflecting such a light source. If you are willing to alter the look of the scene, you can make such a light source more visible/larger, or lower the specularity of such a material. You can also make some light sources invisble to indirect light rays, thus eliminating fireflies (light properties, "Visibility" panel). This can be a good idea for the sun, for example, if your scene contains lots of specular materials.

=== Why is my HDRI environment black and not showing up? ===
You probably have other very bright light sources in the scene, for example a sun or a sky lamp.

'''Solution:''' raise the gain value of the area or HDRI light source that is black. The gain value might need to be very high, e.g. 100000.

=== Why is my area lamp black? ===
See [[#"Why is my HDRI environment black and not showing up?"]]

=== When I change the brightness of my lamp, nothing happens ===

You are probably using an automatic tonemapper which adjusts itself to the changed brightness, making it seem like the brightness did not change.

'''Solution:''' Use a non-automatic tonemapper (camera settings -> [[ImagePipeline]]).


=== When I make one of my lights brighter, all the other lights get darker (or vice versa) ===

Similar to [[#"When I change the brightness of my lamp, nothing happens"]]. 
You are using an automatic tonemapper which tries to keep the image at the same brightness, making it seem like the brightness of the lamps changed.

'''Solution:''' Use a non-automatic tonemapper (camera settings -> [[ImagePipeline]]).


=== A material/object appears to be flickering when I move the camera and shows artifacts in final render ===

This effect is called [https://en.wikipedia.org/wiki/Z-fighting Z-fighting] and is usually caused by mesh faces being exactly on top of each other, e.g. two planes on the same world coordinates.

'''Solution:'''
* Check if there are two objects on top of each other, e.g. because you duplicated the object, cancelled the transform and forgot about it.
* Check if the mesh has duplicate faces. Enter edit mode and use the Remove Doubles button in the Tools panel, which might solve the problem in some cases.
Duplicate faces are often caused by extruding, cancelling the transform and forgetting about it.

=== There are dark triangular artifacts on my model, and I already checked for duplicate faces ===

Floating point numbers have a limited precision. When objects are very large (kilometers) or very small (micrometers), these precision issues become visible.

'''Solution:'''
* If the object has a "normal" size (something like 1 cm to 1 km), but was scaled up/down by a huge amount, try to apply the scale (Ctrl+A -> Scale). For example, this often happens with imported CAD models.
* If applying the scale did not help and your object has to be very small or large, consider to bring it into the normal scale mentioned above, and pretend that it has a larger/smaller size. For example, if you make a model of the solar system, you will just have to make the earth something like 12.742 m in diameter, and pretend that 1 m of your model is equal to 10^6 m.
* If both options above are not usable in your case, you can raise the minimum epsilon that LuxCore uses. This setting can be found in the scene properties, Units panel, after clicking "Advanced LuxCore Settings". By default, the minimum epsilon is 0.00001. Try to raise it to 0.0001 (multiply by 10) for a start and see if the artifacts disappear. Do not set this value higher than necessary, because it will cause all sorts of hard-to-track problems. Be especially careful if you are rendering a scene with volumes.

=== An object that I set to "smooth shading" looks like it is shaded flat in shadow penumbras ===

This artifact is called "terminator problem".

'''Solution:''' Unfortunately there is no real solution. You can only try to mitigate the effect by subdividing the geometry further and/or increase the size of the light source that is causing the problem.

=== How do I setup liquid in a glass container correctly? ===

This forum thread shows an example: https://forums.luxcorerender.org/viewtopic.php?f=4&t=728#p7550

= Getting Help =

If none of the above entries helped to solve your problem, consider asking in the [https://forums.luxcorerender.org/viewforum.php?f=4 user support forum] or [https://forums.luxcorerender.org/viewtopic.php?f=4&t=2 filing a bug report].

[[Category:BlendLuxCore]]

BlendLuxCore FAQ

2021-02-02T13:07:39Z

Byob:

= Frequently Asked Questions =

=== I can not enable the BlendLuxCore addon, it shows errors ===

Most problems in this area stem from broken graphics driver installations. Try to re-install or update your graphics driver.

'''For Windows users:'''
* Make sure that you have installed the [https://www.microsoft.com/en-US/download/details.aspx?id=40784 Visual C++ Redistributable Packages for Visual Studio 2013]
* If you use v2.1alpha0 or later, you will also need:
** [https://aka.ms/vs/15/release/vc_redist.x64.exe Microsoft Visual C++ Redistributable for Visual Studio 2017]
** [https://software.intel.com/sites/default/files/managed/59/aa/ww_icl_redist_msi_2018.3.210.zip Intel C++ redistributable]

If this does not solve the problem, browse the [https://github.com/LuxCoreRender/BlendLuxCore/issues?q=is%3Aissue+label%3Ainstallation installation issues] in the bug tracker to check if your error message was already reported.
If it was not reported yet, open a new issue and copy the error message from the Blender console (on Windows, click Window -> Toggle System Console in Blender's menu. On Linux, start Blender from a terminal and try to enable the addon, then copy the error message from the terminal).

See the [[BlendLuxCore_Installation | installation page]] for information on how to install, update and remove the BlendLuxCore addon.

=== Is there something like Cycles' Layer Weight/Fresnel/Facing node in LuxCore? ===

No, in LuxCore there is no direct equivalent to this node, because it would not work with the many algorithms in LuxCore that trace rays from lights (instead of from the camera), like the bidirectional engine, light tracing mode, or the PhotonGI cache.

Of course, all materials in LuxCore are physically based and have realistic fresnel effects built-in.

You can achieve a similar effect with the dot product node, but it will work only for one viewpoint:

[[File:Layer_weight_for_one_direction.PNG | thumb | 400px | center]]

=== Can Cycles materials be used in BlendLuxCore? ===

To an extent, yes. Many common Cycles shader nodes can be used in BlendLuxCore:

* You can enable this individually for each material with the "Use Cycles Nodes" option in the material properties.
* You can also enable it for the whole scene at once with the "Use Cycles Settings" button in the render properties. This will configure all materials, lights and the world to use Cycles settings

Not all Cycles nodes and settings are supported. Here is an overview: https://github.com/LuxCoreRender/BlendLuxCore/issues/272

=== Can 2D/3D mapping be driven by textures in LuxCore? ===

In general, no, because it would lead to much worse performance on GPUs.

However, if you only need to drive the translation part of a texture mapping, since LuxCore v2.5 you can use the distort texture for this purpose:

[[File:Distort_texture.PNG | thumb | 400px | center | A checker texture (left) is distorted by a clouds texture (right). The result can be seen in the center]]

Texturing of rotation and scale is not yet possible.

=== What can be done against fireflies/hotpixels? ===

Sometimes, pixels appear that are much brighter than the surrounding pixels. Sometimes they are singular, sometimes clumped up. The underlying reason are light paths that are correct, but very hard to find with the current rendering algorithms, and thus they take much longer to render until noise-free than all other light paths in the image.

There are multiple ways to approach this problem:

* Try another rendering algorithm, it might be able to find the firefly-causing light paths much easier than the one you currently use. For example, try going to the render properties, open the Light Paths panel and enable "Light Tracing", or try the [[PhotonGI | PhotonGI caustic cache]], or try using the bidirectional engine.
* You can clamp the brightness of all light paths to a maximum value, in the render properties, Light Paths panel, "Clamping" setting. BlendLuxCore can auto-detect a value for this setting that is in the right ballpark for your scene if you render once without clamping enabled, but often this value will not be the best, so you will need a bit of trial-and-error to find a good value. Note that the clamping value depends on the lighting in your scene, so there is no one universally good clamping value, and you might need to adjust it if you add a new light source to your scene that is brighter than the others. Using a clamping value that is too low will result in a low-contrast, washed-out image, while a too high value will leave fireflies unaffected.
* Try to find out which lights or materials are responsible for the fireflies. There might be a small, hard-to-find light source that is causing them. Or a specular material is reflecting such a light source. If you are willing to alter the look of the scene, you can make such a light source more visible, or lower the specularity of such a material. You can also make some light sources invisble to indirect light rays, thus eliminating fireflies (light properties, "Visibility" panel). This can be a good idea for the sun, for example, if your scene contains lots of specular materials.

=== Why is my HDRI environment black and not showing up? ===
You probably have other very bright light sources in the scene, for example a sun or a sky lamp.

'''Solution:''' raise the gain value of the area or HDRI light source that is black. The gain value might need to be very high, e.g. 100000.

=== Why is my area lamp black? ===
See [[#"Why is my HDRI environment black and not showing up?"]]

=== When I change the brightness of my lamp, nothing happens ===

You are probably using an automatic tonemapper which adjusts itself to the changed brightness, making it seem like the brightness did not change.

'''Solution:''' Use a non-automatic tonemapper (camera settings -> [[ImagePipeline]]).


=== When I make one of my lights brighter, all the other lights get darker (or vice versa) ===

Similar to [[#"When I change the brightness of my lamp, nothing happens"]]. 
You are using an automatic tonemapper which tries to keep the image at the same brightness, making it seem like the brightness of the lamps changed.

'''Solution:''' Use a non-automatic tonemapper (camera settings -> [[ImagePipeline]]).


=== A material/object appears to be flickering when I move the camera and shows artifacts in final render ===

This effect is called [https://en.wikipedia.org/wiki/Z-fighting Z-fighting] and is usually caused by mesh faces being exactly on top of each other, e.g. two planes on the same world coordinates.

'''Solution:'''
* Check if there are two objects on top of each other, e.g. because you duplicated the object, cancelled the transform and forgot about it.
* Check if the mesh has duplicate faces. Enter edit mode and use the Remove Doubles button in the Tools panel, which might solve the problem in some cases.
Duplicate faces are often caused by extruding, cancelling the transform and forgetting about it.

=== There are dark triangular artifacts on my model, and I already checked for duplicate faces ===

Floating point numbers have a limited precision. When objects are very large (kilometers) or very small (micrometers), these precision issues become visible.

'''Solution:'''
* If the object has a "normal" size (something like 1 cm to 1 km), but was scaled up/down by a huge amount, try to apply the scale (Ctrl+A -> Scale). For example, this often happens with imported CAD models.
* If applying the scale did not help and your object has to be very small or large, consider to bring it into the normal scale mentioned above, and pretend that it has a larger/smaller size. For example, if you make a model of the solar system, you will just have to make the earth something like 12.742 m in diameter, and pretend that 1 m of your model is equal to 10^6 m.
* If both options above are not usable in your case, you can raise the minimum epsilon that LuxCore uses. This setting can be found in the scene properties, Units panel, after clicking "Advanced LuxCore Settings". By default, the minimum epsilon is 0.00001. Try to raise it to 0.0001 (multiply by 10) for a start and see if the artifacts disappear. Do not set this value higher than necessary, because it will cause all sorts of hard-to-track problems. Be especially careful if you are rendering a scene with volumes.

=== An object that I set to "smooth shading" looks like it is shaded flat in shadow penumbras ===

This artifact is called "terminator problem".

'''Solution:''' Unfortunately there is no real solution. You can only try to mitigate the effect by subdividing the geometry further and/or increase the size of the light source that is causing the problem.

=== How do I setup liquid in a glass container correctly? ===

This forum thread shows an example: https://forums.luxcorerender.org/viewtopic.php?f=4&t=728#p7550

= Getting Help =

If none of the above entries helped to solve your problem, consider asking in the [https://forums.luxcorerender.org/viewforum.php?f=4 user support forum] or [https://forums.luxcorerender.org/viewtopic.php?f=4&t=2 filing a bug report].

[[Category:BlendLuxCore]]

BlendLuxCore FAQ

2021-02-02T12:49:21Z

Byob: /* Frequently Asked Questions */

= Frequently Asked Questions =

=== I can not enable the BlendLuxCore addon, it shows errors ===

Most problems in this area stem from broken graphics driver installations. Try to re-install or update your graphics driver.

'''For Windows users:'''
* Make sure that you have installed the [https://www.microsoft.com/en-US/download/details.aspx?id=40784 Visual C++ Redistributable Packages for Visual Studio 2013]
* If you use v2.1alpha0 or later, you will also need:
** [https://aka.ms/vs/15/release/vc_redist.x64.exe Microsoft Visual C++ Redistributable for Visual Studio 2017]
** [https://software.intel.com/sites/default/files/managed/59/aa/ww_icl_redist_msi_2018.3.210.zip Intel C++ redistributable]

If this does not solve the problem, browse the [https://github.com/LuxCoreRender/BlendLuxCore/issues?q=is%3Aissue+label%3Ainstallation installation issues] in the bug tracker to check if your error message was already reported.
If it was not reported yet, open a new issue and copy the error message from the Blender console (on Windows, click Window -> Toggle System Console in Blender's menu. On Linux, start Blender from a terminal and try to enable the addon, then copy the error message from the terminal).

See the [[BlendLuxCore_Installation | installation page]] for information on how to install, update and remove the BlendLuxCore addon.

=== Is there something like Cycles' Layer Weight/Fresnel/Facing node in LuxCore? ===

No, in LuxCore there is no direct equivalent to this node, because it would not work with the many algorithms in LuxCore that trace rays from lights (instead of from the camera), like the bidirectional engine, light tracing mode, or the PhotonGI cache.

Of course, all materials in LuxCore are physically based and have realistic fresnel effects built-in.

You can achieve a similar effect with the dot product node, but it will work only for one viewpoint:

[[File:Layer_weight_for_one_direction.PNG | thumb | 400px | center]]

=== Can Cycles materials be used in BlendLuxCore? ===

To an extent, yes. Many common Cycles shader nodes can be used in BlendLuxCore:

* You can enable this individually for each material with the "Use Cycles Nodes" option in the material properties.
* You can also enable it for the whole scene at once with the "Use Cycles Settings" button in the render properties. This will configure all materials, lights and the world to use Cycles settings

Not all Cycles nodes and settings are supported. Here is an overview: https://github.com/LuxCoreRender/BlendLuxCore/issues/272

=== Can 2D/3D mapping be driven by textures in LuxCore? ===

In general, no, because it would lead to much worse performance on GPUs.

However, if you only need to drive the translation part of a texture mapping, since LuxCore v2.5 you can use the distort texture for this purpose:

[[File:Distort_texture.PNG | thumb | 400px | center | A checker texture (left) is distorted by a clouds texture (right). The result can be seen in the center]]

Texturing of rotation and scale is not yet possible.

=== Why is my HDRI environment black and not showing up? ===
You probably have other very bright light sources in the scene, for example a sun or a sky lamp.

'''Solution:''' raise the gain value of the area or HDRI light source that is black. The gain value might need to be very high, e.g. 100000.

=== Why is my area lamp black? ===
See [[#"Why is my HDRI environment black and not showing up?"]]

=== When I change the brightness of my lamp, nothing happens ===

You are probably using an automatic tonemapper which adjusts itself to the changed brightness, making it seem like the brightness did not change.

'''Solution:''' Use a non-automatic tonemapper (camera settings -> [[ImagePipeline]]).


=== When I make one of my lights brighter, all the other lights get darker (or vice versa) ===

Similar to [[#"When I change the brightness of my lamp, nothing happens"]]. 
You are using an automatic tonemapper which tries to keep the image at the same brightness, making it seem like the brightness of the lamps changed.

'''Solution:''' Use a non-automatic tonemapper (camera settings -> [[ImagePipeline]]).


=== A material/object appears to be flickering when I move the camera and shows artifacts in final render ===

This effect is called [https://en.wikipedia.org/wiki/Z-fighting Z-fighting] and is usually caused by mesh faces being exactly on top of each other, e.g. two planes on the same world coordinates.

'''Solution:'''
* Check if there are two objects on top of each other, e.g. because you duplicated the object, cancelled the transform and forgot about it.
* Check if the mesh has duplicate faces. Enter edit mode and use the Remove Doubles button in the Tools panel, which might solve the problem in some cases.
Duplicate faces are often caused by extruding, cancelling the transform and forgetting about it.

=== There are dark triangular artifacts on my model, and I already checked for duplicate faces ===

Floating point numbers have a limited precision. When objects are very large (kilometers) or very small (micrometers), these precision issues become visible.

'''Solution:'''
* If the object has a "normal" size (something like 1 cm to 1 km), but was scaled up/down by a huge amount, try to apply the scale (Ctrl+A -> Scale). For example, this often happens with imported CAD models.
* If applying the scale did not help and your object has to be very small or large, consider to bring it into the normal scale mentioned above, and pretend that it has a larger/smaller size. For example, if you make a model of the solar system, you will just have to make the earth something like 12.742 m in diameter, and pretend that 1 m of your model is equal to 10^6 m.
* If both options above are not usable in your case, you can raise the minimum epsilon that LuxCore uses. This setting can be found in the scene properties, Units panel, after clicking "Advanced LuxCore Settings". By default, the minimum epsilon is 0.00001. Try to raise it to 0.0001 (multiply by 10) for a start and see if the artifacts disappear. Do not set this value higher than necessary, because it will cause all sorts of hard-to-track problems. Be especially careful if you are rendering a scene with volumes.

=== An object that I set to "smooth shading" looks like it is shaded flat in shadow penumbras ===

This artifact is called "terminator problem".

'''Solution:''' Unfortunately there is no real solution. You can only try to mitigate the effect by subdividing the geometry further and/or increase the size of the light source that is causing the problem.

=== How do I setup liquid in a glass container correctly? ===

This forum thread shows an example: https://forums.luxcorerender.org/viewtopic.php?f=4&t=728#p7550

= Getting Help =

If none of the above entries helped to solve your problem, consider asking in the [https://forums.luxcorerender.org/viewforum.php?f=4 user support forum] or [https://forums.luxcorerender.org/viewtopic.php?f=4&t=2 filing a bug report].

[[Category:BlendLuxCore]]

File:Distort texture.PNG

2021-02-02T12:46:57Z

Byob:

BlendLuxCore FAQ

2021-02-02T12:33:09Z

Byob: /* Frequently Asked Questions */

= Frequently Asked Questions =

=== I can not enable the BlendLuxCore addon, it shows errors ===

Most problems in this area stem from broken graphics driver installations. Try to re-install or update your graphics driver.

'''For Windows users:'''
* Make sure that you have installed the [https://www.microsoft.com/en-US/download/details.aspx?id=40784 Visual C++ Redistributable Packages for Visual Studio 2013]
* If you use v2.1alpha0 or later, you will also need:
** [https://aka.ms/vs/15/release/vc_redist.x64.exe Microsoft Visual C++ Redistributable for Visual Studio 2017]
** [https://software.intel.com/sites/default/files/managed/59/aa/ww_icl_redist_msi_2018.3.210.zip Intel C++ redistributable]

If this does not solve the problem, browse the [https://github.com/LuxCoreRender/BlendLuxCore/issues?q=is%3Aissue+label%3Ainstallation installation issues] in the bug tracker to check if your error message was already reported.
If it was not reported yet, open a new issue and copy the error message from the Blender console (on Windows, click Window -> Toggle System Console in Blender's menu. On Linux, start Blender from a terminal and try to enable the addon, then copy the error message from the terminal).

See the [[BlendLuxCore_Installation | installation page]] for information on how to install, update and remove the BlendLuxCore addon.

=== Is there something like Cycles' Layer Weight/Fresnel/Facing node in LuxCore? ===

No, in LuxCore there is no direct equivalent to this node, because it would not work with the many algorithms in LuxCore that trace rays from lights (instead of from the camera), like the bidirectional engine, light tracing mode, or the PhotonGI cache.

Of course, all materials in LuxCore are physically based and have realistic fresnel effects built-in.

You can achieve a similar effect with the dot product node, but it will work only for one viewpoint:

[[File:Layer_weight_for_one_direction.PNG | thumb | 400px | center]]

=== Can Cycles materials be used in BlendLuxCore? ===

To an extent, yes. Many common Cycles shader nodes can be used in BlendLuxCore:

* You can enable this individually for each material with the "Use Cycles Nodes" option in the material properties.
* You can also enable it for the whole scene at once with the "Use Cycles Settings" button in the render properties. This will configure all materials, lights and the world to use Cycles settings

Not all Cycles nodes and settings are supported. Here is an overview: https://github.com/LuxCoreRender/BlendLuxCore/issues/272

=== Why is my HDRI environment black and not showing up? ===
You probably have other very bright light sources in the scene, for example a sun or a sky lamp.

'''Solution:''' raise the gain value of the area or HDRI light source that is black. The gain value might need to be very high, e.g. 100000.

=== Why is my area lamp black? ===
See [[#"Why is my HDRI environment black and not showing up?"]]

=== When I change the brightness of my lamp, nothing happens ===

You are probably using an automatic tonemapper which adjusts itself to the changed brightness, making it seem like the brightness did not change.

'''Solution:''' Use a non-automatic tonemapper (camera settings -> [[ImagePipeline]]).


=== When I make one of my lights brighter, all the other lights get darker (or vice versa) ===

Similar to [[#"When I change the brightness of my lamp, nothing happens"]]. 
You are using an automatic tonemapper which tries to keep the image at the same brightness, making it seem like the brightness of the lamps changed.

'''Solution:''' Use a non-automatic tonemapper (camera settings -> [[ImagePipeline]]).


=== A material/object appears to be flickering when I move the camera and shows artifacts in final render ===

This effect is called [https://en.wikipedia.org/wiki/Z-fighting Z-fighting] and is usually caused by mesh faces being exactly on top of each other, e.g. two planes on the same world coordinates.

'''Solution:'''
* Check if there are two objects on top of each other, e.g. because you duplicated the object, cancelled the transform and forgot about it.
* Check if the mesh has duplicate faces. Enter edit mode and use the Remove Doubles button in the Tools panel, which might solve the problem in some cases.
Duplicate faces are often caused by extruding, cancelling the transform and forgetting about it.

=== There are dark triangular artifacts on my model, and I already checked for duplicate faces ===

Floating point numbers have a limited precision. When objects are very large (kilometers) or very small (micrometers), these precision issues become visible.

'''Solution:'''
* If the object has a "normal" size (something like 1 cm to 1 km), but was scaled up/down by a huge amount, try to apply the scale (Ctrl+A -> Scale). For example, this often happens with imported CAD models.
* If applying the scale did not help and your object has to be very small or large, consider to bring it into the normal scale mentioned above, and pretend that it has a larger/smaller size. For example, if you make a model of the solar system, you will just have to make the earth something like 12.742 m in diameter, and pretend that 1 m of your model is equal to 10^6 m.
* If both options above are not usable in your case, you can raise the minimum epsilon that LuxCore uses. This setting can be found in the scene properties, Units panel, after clicking "Advanced LuxCore Settings". By default, the minimum epsilon is 0.00001. Try to raise it to 0.0001 (multiply by 10) for a start and see if the artifacts disappear. Do not set this value higher than necessary, because it will cause all sorts of hard-to-track problems. Be especially careful if you are rendering a scene with volumes.

=== An object that I set to "smooth shading" looks like it is shaded flat in shadow penumbras ===

This artifact is called "terminator problem".

'''Solution:''' Unfortunately there is no real solution. You can only try to mitigate the effect by subdividing the geometry further and/or increase the size of the light source that is causing the problem.

=== How do I setup liquid in a glass container correctly? ===

This forum thread shows an example: https://forums.luxcorerender.org/viewtopic.php?f=4&t=728#p7550

= Getting Help =

If none of the above entries helped to solve your problem, consider asking in the [https://forums.luxcorerender.org/viewforum.php?f=4 user support forum] or [https://forums.luxcorerender.org/viewtopic.php?f=4&t=2 filing a bug report].

[[Category:BlendLuxCore]]

File:Layer weight for one direction.PNG

2021-02-02T12:30:24Z

Byob:

BlendLuxCore FAQ

2021-02-02T12:08:23Z

Byob: /* I can not enable the BlendLuxCore addon, it shows errors */

LuxCore SDL Reference Manual v2.5

2021-01-28T18:28:55Z

Byob:

The scene description language (SDL) is used to configure the renderer and to define objects, materials, textures etc. in the scene. 
The file ending of the render configuration file is ".cfg", for the scene file it's ".scn".

These files are usually created by exporter plugins, e.g. BlendLuxCore. 
This wiki page is primarily a reference for exporter developers, normal end-users should not need to edit cfg/scn files by hand.

Sometimes the API is updated faster than the wiki, in this case you can look at the code directly: https://github.com/LuxCoreRender/LuxCore/tree/master/src/slg/scene

Note that matrices are passed as flat lists in column-major form.

=Render configuration file=

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''resumerendering.filesafe''' || bool || 1 || enable/disable "safe save" mode for resume rendering file. A backup of the output is always valid even in the case of a system failure
|}

==Seed==

The global seed value that is used to generate random numbers. 
Two images rendered with the same seed will have the same noise pattern.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''renderengine.seed''' || unsigned int || 1 || min 1
|}

==Periodic save==

Options related to periodic save operations.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''periodicsave.resumerendering.period''' || float || 0 || save the resume rendering file every specified amount of time (value in seconds). A value <= 0.0 disable the saving
|-
|'''periodicsave.resumerendering.filename''' || string || "resume.rsm" || the name to use to save the rendering resume information periodically
|-
|'''periodicsave.film.period''' || float || 0 || save the Film every specified amount of time (value in seconds). A value <= 0.0 disable the saving
|-
|'''periodicsave.film.filename''' || string || "film.flm" || the name to use to save the film periodically
|-
|'''periodicsave.film.outputs.period''' || float || 600 || save all Film outputs every specified amount of time (value in seconds). A value <= 0.0 disable the saving
|}

==Render Engine==

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''renderengine.type''' || string || "PATHCPU" || engine type
|}

=== CPU Render Engines ===

CPU render engines are written in C++ and don't require OpenCL. All CPU render engines accept the following parameters:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''native.threads.count''' || int || CPU core count || > 0 || > 0 || The number of threads will be used for the rendering
|}

'''The following CPU engines are available:'''

===="PATHCPU"====

A path tracer with full image plane rendering (i.e. supporting Metropolis sampler).

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''path.pathdepth.total''' || int || 6 || > 0 || [1, 16] || Maximum recursion depth of a path
|-
|'''path.pathdepth.diffuse''' || int || 4 || > 0 || [1, 16] ||
|-
|'''path.pathdepth.glossy''' || int || 4 || > 0 || [1, 16] ||
|-
|'''path.pathdepth.specular''' || int || 6 || > 0 || [1, 16] ||
|-
|'''path.russianroulette.depth''' || int || 3 || > 0 || [1, path.maxdepth] || The path depth where Russian Roulette stars to be used
|-
|'''path.russianroulette.cap''' || float || 0.5 || [0.0, 1.0] || [0.0, 1.0] || The threshold over which Russian Roulette is used
|-
|'''path.clamping.variance.maxvalue''' || float || 0.0 || > 0.0 || > 0.0 || Samples brighter than this value are clamped, helps to reduce fireflies. 0.0 = disabled
|-
|'''path.forceblackbackground.enable''' || bool || 0 || 0 or 1 || 0 or 1 || Enable when rendering with transparent film and premultiplied alpha, to avoid artifacts with semi-transparent areas
|}

===="TILEPATHCPU"====
Biased path tracer with many control options and support for tile rendering. 
The sampler must be set to TILEPATHSAMPLER when using this engine.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''path.pathdepth.total''' || int || 6 || > 0 || [1, 16] || Maximum recursion depth of a path
|-
|'''path.pathdepth.diffuse''' || int || 4 || > 0 || [1, 16] ||
|-
|'''path.pathdepth.glossy''' || int || 4 || > 0 || [1, 16] ||
|-
|'''path.pathdepth.specular''' || int || 6 || > 0 || [1, 16] ||
|-
|'''path.russianroulette.depth''' || int || 3 || > 0 || [1, path.maxdepth] || The path depth where Russian Roulette stars to be used
|-
|'''path.russianroulette.cap''' || float || 0.5 || [0.0, 1.0] || [0.0, 1.0] || The threshold over which Russian Roulette is used
|-
|'''path.clamping.variance.maxvalue''' || float || 0.0 || > 0.0 || > 0.0 || Samples brighter than this value are clamped, helps to reduce fireflies. 0.0 = disabled
|-
|'''path.forceblackbackground.enable''' || bool || 0 || 0 or 1 || 0 or 1 || Enable when rendering with transparent film and premultiplied alpha, to avoid artifacts with semi-transparent areas
|-
|'''tilepath.sampling.aa.size''' || int || 3 || > 0 || [1, 13] || All diffuse/glossy/specular samples are multiplied with the squared aa size: final_samples = aa^2 * (diffuse^2 + glossy^2 + specular^2)
|-
|'''tile.size''' || int || 32 || ≥ 8 || [8, 256] || Tile size in pixels
|-
|'''tile.multipass.enable''' || bool || 1 || 0 or 1 || o or 1 || Re-render the image until a halt threshold is met or indefinitely
|-
|'''tile.multipass.convergencetest.threshold''' || float || 6.0 / 256.0 || > 0.0 || [1.0 / 256.0, 6.0 / 256.0] || Target noise level
|-
|'''tile.multipass.convergencetest.threshold.reduction''' || float || 0.0 || [0.0, 1.0] || [0.75, 0.95] || Multiply noise level with this number when all tiles have met the previous noise level. Set to 0 to disable (so rendering will stop at the noise level)
|-
|'''tile.multipass.convergencetest.warmup.count''' || int || 32 || ≥ 0 || [8, 128] || Warm up period for the convergence test expressed in samples per pixel
|}

===="BIDIRCPU"====

A Bidirectional path tracer.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''path.maxdepth''' || int || 5 || > 0 || [1, 16] || Maximum recursion depth of a eye path
|-
|'''light.maxdepth''' || int || 5 || > 0 || [1, 16] || Maximum recursion depth of a light path
|-
|'''path.russianroulette.depth''' || int || 3 || > 0 || [1, path.maxdepth] || The path depth where Russian Roulette starts to be used
|-
|'''path.russianroulette.cap''' || float || 0.5 || [0.0, 1.0] || [0.0, 1.0] || The threshold over which Russian Roulette is used
|}

===="RTPATHCPU"====
Engine optimized for interactive scene editing and camera movement. 
The sampler must be set to RTPATHCPUSAMPLER when using this engine.

Supports the same properties as [[#"PATHCPU" | "PATHCPU"]] plus the following:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''rtpathcpu.zoomphase.size''' || int || 4 || || || render scaled down film for the first few frames after a scene edit (to make interactions more fluid)
|-
|'''rtpathcpu.zoomphase.weight''' || float || 0.1 || || || description: TODO
|}

=== OpenCL Render Engines ===

OpenCL engines can run on GPUs, CPUs and other types of computing devices, they require OpenCL to run. All OpenCL render engines accept the following parameters:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''opencl.platform.index''' || int || -1 || A valid platform index || -1 || Select the OpenCL platform to use. All devices available on all platforms will be used with -1
|-
|'''opencl.cpu.use''' || bool || 1 || 0 or 1 || 0 or 1 || If to use all OpenCL CPU devices available
|-
|'''opencl.gpu.use''' || bool || 1 || 0 or 1 || 0 or 1 || If to use all OpenCL GPU devices available
|-
|'''opencl.cpu.workgroup.size''' || int || 0 || Any valid OpenCL workgroup size || 64 || Set the OpenCL workgroup size, 0 means to use the driver suggested value
|-
|'''opencl.gpu.workgroup.size''' || int || 0 || Any valid OpenCL workgroup size || 64 || Set the OpenCL workgroup size, 0 means to use the driver suggested value
|-
|'''opencl.devices.select''' || string || "" || Any valid selection string || Any valid selection string || Select each OpenCL device to use. It is a string of "0" and "1". "1" means use the device, "0" do not
|}

'''The following OpenCL engines are available:'''

===="PATHOCL"====
OpenCL version of PATHCPU. Supports the same settings as [[#"PATHCPU" | PATHCPU]] plus the following:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''pathocl.pixelatomics.enable''' || bool || 0 || 0 or 1 || 0 or 1 || Enable pixel atomic operation
|-
|'''opencl.task.count''' || int || "AUTO" || "AUTO" or > 0 || [64K, 1024K] || The number of tasks sent to the OpenCL device in one kernel call
|}

===="RTPATHOCL"====

A PATHOCL version optimized for real-time rendering with fixed frame-rate and variable quality. 
The sampler must be set to TILEPATHSAMPLER when using this engine.

Supports the same settings as [[#"PATHOCL" | PATHOCL]] plus the following:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''rtpath.resolutionreduction.preview''' || int || 4 || > 0 || [1, 32] || Render a sample every n x n pixels in the first passes. For instance 4x4 than 2x2 and than always 1x1
|-
|'''rtpath.resolutionreduction.preview.step''' || int || 8 || > 0 || [1, 32] || Each preview step is rendered for n frames
|-
|'''rtpath.resolutionreduction''' || int || 4 || > 0 || [1, 32] || Render a sample every n x n pixels, outside the preview phase, in order to reduce the per frame rendering time
|}

===="TILEPATHOCL"====

OpenCL version of TILEPATHCPU. 
The sampler must be set to TILEPATHSAMPLER when using this engine.

Supports the same settings as [[#"TILEPATHCPU" | TILEPATHCPU]] plus the following:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''tilepathocl.devices.maxtiles''' || int || 16 || ≥ 1 || [1, 32] || Maximum number of tiles to send in a single call to each OpenCL device
|}

==="FILESAVER"===

Saves everything needed to render the scene to the output path, including textures and meshes.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''filesaver.format''' || string || "TXT" || "TXT" for a text SDL format and "BIN" for a single file binary format
|-
|'''filesaver.filename''' || string || "luxcore-exported-scene.bcf" || file name for "BIN" format
|-
|'''filesaver.directory''' || string || "luxcore-exported-scene" || output path for "TXT" format
|-
|'''filesaver.renderengine.type''' || string || "PATHCPU" || render engine to use when rendering the scene after it was saved with FILESAVER. Any engine string from above can be used here.
|}

===Experimental and debugging engines===

'''These engines are experimental, deprecated or are only intended for very specific purposes:'''

===="BIDIRVMCPU"====

Bidir with vertex merging, currently experimental. 
Supports the same settings as [[#"BIDIRCPU" | BIDIRCPU]] plus the following:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''bidirvm.lightpath.count''' || int || 16 * 1024 || > 0 || || Number of lightpaths per pass
|-
|'''bidirvm.startradius.scale''' || float || 0.003 || > 0 || || Photon radius of the first pass
|-
|'''bidirvm.alpha''' || float || 3 || > 0 || [0.0, 1.0] || Photon radius is multiplied with this value after every pass to reduce the radius
|}

===="LIGHTCPU"====

For testing.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''light.maxdepth''' || int || 5 || > 0 || [1, 16] || Maximum recursion depth of a light path
|-
|'''light.russianroulette.depth''' || int || 3 || > 0 || [1, path.maxdepth] || The path depth where Russian Roulette starts to be used
|-
|'''light.russianroulette.cap''' || float || 0.5 || [0.0, 1.0] || [0.0, 1.0] || The threshold over which Russian Roulette is used
|}

==Sampler==

Samplers are used by following render engines:

* LIGHTCPU
* PATHCPU
* BIDIRCPU
* BIDIRVMCPU
* PATHOCL

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''sampler.type''' || string || "SOBOL" || sampler type
|}

The following samplers are available:

==="SOBOL"===

Sampler with sobol pattern.
Parameters:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''sampler.sobol.adaptive.strength''' || float || 0.7 || 0 ≤ x < 0.95 || 0.5 - 0.9 || it sets if the sampler should be more or less adaptive
|}

==="METROPOLIS"===

Metropolis sampler.
Parameters:
{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''sampler.metropolis.largesteprate''' || float || 0.4 || 0 ≤ x ≤ 1 || 0 - 1 || Probability of generating a large sample mutation
|-
|'''sampler.metropolis.maxconsecutivereject''' || int || 512 || x ≥ 0 || 0 - 32768 || Number of consecutive rejects before a next mutation is forced. Low values can cause bias
|-
|'''sampler.metropolis.imagemutationrate''' || float || 0.1 || 0 ≤ x ≤ 1 || 0 - 1 || Maximum distance over the image plane for a small mutation
|}

==="RANDOM"===

Fully random sampler. This sampler is mostly intended for testing purpose.
Parameters:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''sampler.random.adaptive.strength''' || float || 0.7 || 0 ≤ x < 0.95 || 0.5 - 0.9 || it sets if the sampler should be more or less adaptive
|}

==Filter==

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''film.filter.type''' || string || "BLACKMANHARRIS" || || || Type of pixel filter.
|-
|'''film.filter.width''' || float || 2.0 || x > 0.0 || 0.1 - 3.0 || Filter radius in pixels. Does not have an effect on the NONE filter
|-
|'''film.filter.xwidth''' || float || 2.0 || x > 0.0 || 0.1 - 3.0 || Width in pixels. Overwrite '''film.filter.width''' value
|-
|'''film.filter.ywidth''' || float || 2.0 || x > 0.0 || 0.1 - 3.0 || Width in pixels. Overwrite '''film.filter.width''' value
|}

Available filters are:

==="NONE"===

Disable pixel filtering.

==="BOX"===

Box pixel filter. No parameters.

==="GAUSSIAN"===

Gaussian pixel filter.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''film.filter.gaussian.alpha''' || float || 2.0 || x > 0.0 || 0.1 - 10.0 || Gaussian rate of falloff. Lower values give blurrier images.
|}

==="MITCHELL"===

Mitchel pixel filter.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
| '''film.filter.mitchell.b''' || float || 1.0/3.0 || 0.0 ≤ x ≤ 1.0 || 0.0 - 1.0 || B parameter for the mitchell filter in the range
|-
| '''film.filter.mitchell.c''' || float || 1.0/3.0 || 0.0 ≤ x ≤ 1.0 || 0.0 - 1.0 || C parameter for the mitchell filter in the range 0..1
|}

==="MITCHELL_SS"===

Mitchel pixel filter with super-sampling (i.e. image will be filtered first with a grid of 4 pixels for each pixel).

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
| '''film.filter.mitchellss.b''' || float || 1.0/3.0 || 0.0 ≤ x ≤ 1.0 || 0.0 - 1.0 || B parameter for the mitchell filter in the range
|-
| '''film.filter.mitchellss.c''' || float || 1.0/3.0 || 0.0 ≤ x ≤ 1.0 || 0.0 - 1.0 || C parameter for the mitchell filter in the range 0..1
|}

==="BLACKMANHARRIS"===

Blcakman-Harris pixel filter. No parameters.

==Light Strategy==

The direct light sampling strategy is defined by the following property:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''lightstrategy.type''' || string || "LOG_POWER" || "UNIFORM", "POWER", "LOG_POWER" or "DLS_CACHE" || N/A || Direct light sampling strategy
|}

==="UNIFORM"===

"UNIFORM" light strategy samples evenly all light sources.

==="POWER"===

"POWER" light strategy samples the light sources based on their power.

==="LOG_POWER"===

"LOG_POWER" light strategy samples the light sources based on logarithm of their power.

==="DLS_CACHE"===

Build direct light sampling cache to optimize many-lights rendering, beneficial in scenes with multiple light sources with few overlap between their influence areas (e.g. a building with many disconnected rooms and interior lights).

Options for the DLS cache:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''lightstrategy.entry.radius''' || float || 0.0 || || N/A || Entry radius in meters, automatic radius estimation is used if the radius is set to 0
|-
|'''lightstrategy.entry.normalangle''' || float || 25.0 || || N/A ||
|-
|'''lightstrategy.entry.maxpasses''' || int || 1024 || || N/A ||
|-
|'''lightstrategy.entry.convergencethreshold''' || float || 0.05 || || N/A ||
|-
|'''lightstrategy.entry.warmupsamples''' || int || 24 || || N/A ||
|-
|'''lightstrategy.targetcachehitratio''' || float || 0.995 || || N/A ||
|-
|'''lightstrategy.maxdepth''' || int || 4 || || N/A ||
|-
|'''lightstrategy.maxsamplescount''' || int || 10000000 || || N/A ||
|-
|'''lightstrategy.persistent.file''' || string || "" || || N/A ||
|-
|'''lightstrategy.persistent.safesave''' || bool || 1 || || N/A ||

|}

==Accelerator==

The ray/triangle intersection accelerator to use for the rendering is defined by the following properties:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''accelerator.type''' || string || "AUTO" || "AUTO", "BVH", "MBVH", "EMBREE" || "AUTO" || The intersection accelerator. "AUTO" will select the best one available for the current [[LuxRays]] intersection device. "EMBREE" is currently usable only on CPU render engines
|-
|'''accelerator.instances.enable''' || bool || 1 || 0 or 1 || 0 or 1 || Enable instance support (or disable in order to slightly increase rendering speed)
|}

==Epsilon==

Minimum and maximum allowed value for scene epsilon can be define by the following properties:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''scene.epsilon.min''' || float || 1e-5f || Any float value || 1e-6f ≤ x ≤ 1e-1f || Minimum allowed value for scene epsilon
|-
|'''scene.epsilon.max''' || float || 1e-1f || Any float value || 1e-3f ≤ x ≤ 1e+2f || Maximum allowed value for scene epsilon
|}

==Film==

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.safesave''' || bool || 1 || enable "safe save" of Film serialization. A backup of the output is always valid even in the case of a system failure.
|}

===Film OpenCL Options===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.opencl.enable''' || bool || 1 || enable OpenCL film operations
|-
|'''film.opencl.platform''' || unsigned int || -1 || choose which platform will be used by the film operations. (0 is first platform, 1 second and so on. -1 for all)
|-
|'''film.opencl.device''' || unsigned int || -1 || choose which device will be used by the film operations. (0 is first device, 1 second and so on. -1 for first GPU device)
|}

===Film Outputs (aka AOVs)===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.outputs.safesave''' || bool || 1 || enable "safe save" for Film outputs. A backup of the output is always valid even in the case of a system failure
|}

The film object supports many types of outputs (aka AOVs). The complete list of supported output types:

{| class="wikitable" cellspacing="2"
!Name
!Type
|-
|'''RGB''' || HDR
|-
|'''RGBA''' || HDR
|-
|'''RGB_IMAGEPIPELINE''' || HDR/LDR
|-
|'''RGBA_IMAGEPIPELINE''' || HDR/LDR
|-
|'''ALPHA''' || HDR/LDR
|-
|'''DEPTH''' || HDR
|-
|'''POSITION''' || HDR
|-
|'''GEOMETRY_NORMAL''' || HDR
|-
|'''SHADING_NORMAL''' || HDR
|-
|'''MATERIAL_ID''' || LDR
|-
|'''DIRECT_DIFFUSE''' || HDR
|-
|'''DIRECT_GLOSSY''' || HDR
|-
|'''EMISSION''' || HDR
|-
|'''INDIRECT_DIFFUSE''' || HDR
|-
|'''INDIRECT_GLOSSY''' || HDR
|-
|'''INDIRECT_SPECULAR''' || HDR
|-
|'''MATERIAL_ID_MASK''' || HDR/LDR
|-
|'''DIRECT_SHADOW_MASK''' || HDR/LDR
|-
|'''INDIRECT_SHADOW_MASK''' || HDR/LDR
|-
|'''RADIANCE_GROUP''' || HDR/LDR
|-
|'''UV''' || HDR/LDR
|-
|'''RAYCOUNT''' || HDR/LDR
|-
|'''BY_MATERIAL_ID''' || HDR/LDR
|-
|'''IRRADIANCE''' || HDR
|-
|'''OBJECT_ID''' || LDR
|-
|'''OBJECT_ID_MASK''' || HDR/LDR
|-
|'''BY_OBJECT_ID''' || HDR/LDR
|-
|'''SAMPLECOUNT''' || HDR/LDR
|-
|'''CONVERGENCE''' || HDR/LDR
|-
|'''NOISE''' || HDR/LDR
|-
|'''SERIALIZED_FILM''' || N/A
|-
|'''MATERIAL_ID_COLOR''' || HDR/LDR
|}

Outputs are enabled with the following properties:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.outputs.<index>.type''' || string || || Type of output, e.g. "RGBA" or "ALPHA" (see the list above for the available types)
|-
|'''film.outputs.<index>.filename''' || string || || Filename to use when saving the output. The filename should use ".exr" as extension for HDR outputs and ".png" for LDR outputs (see list above for which output is HDR and which LDR)
|-
|'''film.outputs.<index>.id''' || int || || Specify for the following outputs: '''MATERIAL_ID_MASK''', '''RADIANCE_GROUP''', '''BY_MATERIAL_ID''', '''OBJECT_ID_MASK''', '''BY_OBJECT_ID''' (to choose the object ID, material ID or radiance group ID of the output)
|-
|'''film.outputs.<index>.index''' || int || || Specify for an imagepipeline output (RGB_IMAGEPIPELINE or RGBA_IMAGEPIPELINE) to select the imagepipeline of the output. For example, if you have 3 imagepipelines defined, and you want to specify the output of the third imagepipeline, use 2 for the ".index" property of the output
|}

Note that the Bidir engine does not support all AOVs.
Not supported by Bidir are: EMISSION, DIRECT_DIFFUSE, DIRECT_GLOSSY, INDIRECT_DIFFUSE, INDIRECT_GLOSSY, INDIRECT_SPECULAR, DIRECT_SHADOW_MASK, INDIRECT_SHADOW_MASK, IRRADIANCE, RAYCOUNT.

This is the list of output channel data types and sizes:

{| class="wikitable" cellspacing="2"
!Output type
!Data type
!Size
!Description
|-
|RGB||float||film width x film height x 3||R, G, B
|-
|RGB_IMAGEPIPELINE||float||film width x film height x 3||R, G, B
|-
|RGBA||float||film width x film height x 4||R, G, B, A
|-
|ALPHA||float||film width x film height x 1||Alpha value [0, 1]
|-
|DEPTH||float||film width x film height x 1||Camera distance
|-
|POSITION||float||film width x film height x 3||World X, Y, Z
|-
|GEOMETRY_NORMAL||float||film width x film height x 3||Normal vector X, Y, Z
|-
|SHADING_NORMAL||float||film width x film height x 3||Normal vector X, Y, Z
|-
|DIRECT_DIFFUSE||float||film width x film height x 3||Diffuse R, G, B
|-
|DIRECT_GLOSSY||float||film width x film height x 3||Glossy R, G, B
|-
|EMISSION||float||film width x film height x 3||Emission R, G, B
|-
|INDIRECT_DIFFUSE||float||film width x film height x 3||Indirect diffuse R, G, B
|-
|INDIRECT_GLOSSY||float||film width x film height x 3||Indirect glossy R, G, B
|-
|INDIRECT_SPECULAR||float||film width x film height x 3||Indirect specular R, G, B
|-
|MATERIAL_ID_MASK||float||film width x film height x 1||Material mask [0, 1]
|-
|DIRECT_SHADOW_MASK||float||film width x film height x 1||Shadow mask [0, 1]
|-
|INDIRECT_SHADOW_MASK||float||film width x film height x 1||Shadow mask [0, 1]
|-
|RADIANCE_GROUP||float||film width x film height x 3||R, G, B
|-
|UV||float||film width x film height x 2||Texture coordinates U, V
|-
|RAYCOUNT||float||film width x film height x 1||Ray count
|-
|BY_MATERIAL_ID||float||film width x film height x 3||By material ID
|-
|MATERIAL_ID||uint||film width x film height x 1||Material ID
|-
|IRRADIANCE||float||film width x film height x 3||R, G, B
|-
|OBJECT_ID_MASK||float||film width x film height x 1||Object mask [0, 1]
|-
|BY_OBJECT_ID||float||film width x film height x 3||By object ID
|-
|OBJECT_ID||uint||film width x film height x 1||Object ID
|-
|SAMPLECOUNT||uint||film width x film height x 1||Sample count
|-
|CONVERGENCE||float||film width x film height x 1||The distance of each pixel from the convergence threshold
|-
|NOISE||float||film width x film height x 1||The noise estimated for each pixel
|-
|SERIALIZED_FILM||N/A||N/A||The complete Film serialized in binary format
|-
|MATERIAL_ID_COLOR||float||film width x film height x 3||Material ID converted to colors (with anti-aliasing)
|}

===Film Channels===

Film channels are implicitly enabled by declaring film outputs (even if the output is never used). For instance, declaring a "RGBA" output will automatically enable "RADIANCE_PER_PIXEL_NORMALIZED" (and "RADIANCE_PER_SCREEN_NORMALIZED" for BIDIRCPU) and "ALPHA".
The supported channels are:

{| class="wikitable" cellspacing="2"
!Channel type
!Data type
!Size
!Last element is weight ?
!Note
|-
|CHANNEL_RADIANCE_PER_PIXEL_NORMALIZED||float||film width x film height x 4||Yes||One for each radiance group. Eye paths radiance.
|-
|CHANNEL_RADIANCE_PER_SCREEN_NORMALIZED||float||film width x film height x 3||No||One for each radiance group. Light paths radiance. Used only by LIGHTCPU and BIDIRCPU.
|-
|CHANNEL_ALPHA||float||film width x film height x 2||Yes||
|-
|CHANNEL_RGB_IMAGEPIPELINE||float||film width x film height x 3||No||
|-
|CHANNEL_DEPTH||float||film width x film height x 1||No||
|-
|CHANNEL_POSITION||float||film width x film height x 3||No||
|-
|CHANNEL_GEOMETRY_NORMAL||float||film width x film height x 3||No||
|-
|CHANNEL_SHADING_NORMAL||float||film width x film height x 3||No||
|-
|CHANNEL_MATERIAL_ID||u_int||film width x film height x 1||No||
|-
|CHANNEL_DIRECT_DIFFUSE||float||film width x film height x 4||Yes||
|-
|CHANNEL_DIRECT_GLOSSY||float||film width x film height x 4||Yes||
|-
|CHANNEL_EMISSION||float||film width x film height x 4||Yes||
|-
|CHANNEL_INDIRECT_DIFFUSE||float||film width x film height x 4||Yes||
|-
|CHANNEL_INDIRECT_SPECULAR||float||film width x film height x 4||Yes||
|-
|CHANNEL_MATERIAL_ID_MASK||float||film width x film height x 2||Yes||
|-
|CHANNEL_DIRECT_SHADOW_MASK||float||film width x film height x 2||Yes||
|-
|CHANNEL_INDIRECT_SHADOW_MASK||float||film width x film height x 2||Yes||
|-
|CHANNEL_UV||float||film width x film height x 2||No||
|-
|CHANNEL_RAYCOUNT||float||film width x film height||No||
|-
|CHANNEL_BY_MATERIAL_ID||float||film width x film height x 4||Yes||
|-
|CHANNEL_IRRADIANCE||float||film width x film height x 4||Yes||
|-
|CHANNEL_OBJECT_ID||u_int||film width x film height x 1||No||
|-
|CHANNEL_OBJECT_ID_MASK||float||film width x film height x 2||Yes||
|-
|CHANNEL_BY_OBJECT_ID||float||film width x film height x 4||Yes||
|}

This is the list of channels enabled by each output:

{| class="wikitable" cellspacing="2"
!Output
!Enabled channels
|-
|'''RGB''' || CHANNEL_RADIANCE_PER_PIXEL_NORMALIZED, CHANNEL_RADIANCE_PER_SCREEN_NORMALIZED (only for LIGHTCPU and BIDIRCPU)
|-
|'''RGBA''' || CHANNEL_RADIANCE_PER_PIXEL_NORMALIZED, CHANNEL_RADIANCE_PER_SCREEN_NORMALIZED (only for LIGHTCPU and BIDIRCPU), ALPHA
|-
|'''RGB_IMAGEPIPELINE''' || CHANNEL_RADIANCE_PER_PIXEL_NORMALIZED, CHANNEL_RADIANCE_PER_SCREEN_NORMALIZED (only for LIGHTCPU and BIDIRCPU)
|-
|'''RGBA_IMAGEPIPELINE''' || CHANNEL_RADIANCE_PER_PIXEL_NORMALIZED, CHANNEL_RADIANCE_PER_SCREEN_NORMALIZED (only for LIGHTCPU and BIDIRCPU), ALPHA
|-
|'''ALPHA''' || ALPHA
|-
|'''DEPTH''' || DEPTH
|-
|'''POSITION''' || DEPTH, POSITION
|-
|'''GEOMETRY_NORMAL''' || DEPTH, GEOMETRY_NORMAL
|-
|'''SHADING_NORMAL''' || DEPTH, SHADING_NORMAL
|-
|'''MATERIAL_ID''' || DEPTH, MATERIAL_ID
|-
|'''DIRECT_DIFFUSE''' || DIRECT_DIFFUSE
|-
|'''DIRECT_GLOSSY''' || DIRECT_GLOSSY
|-
|'''EMISSION''' || EMISSION
|-
|'''INDIRECT_DIFFUSE''' || INDIRECT_DIFFUSE
|-
|'''INDIRECT_GLOSSY''' || INDIRECT_GLOSSY
|-
|'''INDIRECT_SPECULAR''' || INDIRECT_SPECULAR
|-
|'''MATERIAL_ID_MASK''' || MATERIAL_ID, MATERIAL_ID_MASK
|-
|'''DIRECT_SHADOW_MASK''' || DIRECT_SHADOW_MASK
|-
|'''INDIRECT_SHADOW_MASK''' || INDIRECT_SHADOW_MASK
|-
|'''RADIANCE_GROUP''' || CHANNEL_RADIANCE_PER_PIXEL_NORMALIZED, CHANNEL_RADIANCE_PER_SCREEN_NORMALIZED (only for LIGHTCPU and BIDIRCPU)
|-
|'''UV''' || DEPTH, UV
|-
|'''RAYCOUNT''' || DEPTH, RAYCOUNT
|-
|'''BY_MATERIAL_ID''' || BY_MATERIAL_ID
|-
|'''IRRADIANCE''' || IRRADIANCE
|-
|'''OBJECT_ID''' || DEPTH, OBJECT_ID
|-
|'''OBJECT_ID_MASK''' || OBJECT_ID, OBJECT_ID_MASK
|-
|'''BY_OBJECT_ID''' || BY_OBJECT_ID
|}

Note: CHANNEL_RGB_IMAGEPIPELINE is always enable and the result of running the image pipeline.

===Image pipeline===

It is possible to [http://www.luxrender.net/forum/viewtopic.php?f=8&p=120169#p120169 define multiple image pipelines at the same time]

====Radiance Group====

Radiance groups are used to get only the contribution of a group of lights in the scene. 
Lights can be grouped by setting their [[#Common_parameters | '''.id''']] property to the same number, on materials this is done with the [[#Light_emission | '''.emission.id''']] property. 

Note that the OpenCL engines only support up to 8 radiance groups (one of them is the default group).

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.radiancescales.<id>.globalscale''' || float|| 1 || global weighting of radiance group
|-
|'''film.imagepipelines.<pipeline #>.radiancescales.<id>.temperature ''' || float || 6500.0 || light temperature
|-
|'''film.imagepipelines.<pipeline #>.radiancescales.<id>.rgbscale''' || vector || 1.0 1.0 1.0 || light color
|-
|'''film.imagepipelines.<pipeline #>.radiancescales.radiancescales.<id>.enabled''' || bool || 1 || enable radiance group
|}

====Image pipeline plug-ins====

=====Type: TONEMAP_LINEAR=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "TONEMAP_LINEAR" || linear tonemapping
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.scale''' || float || 1.0 || tonemapping scale
|}

=====Type: TONEMAP_REINHARD02=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "TONEMAP_REINHARD02" || reinhard tonemapping
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.prescale''' || float || 1.0 || reinhard prescale
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.postscale''' || float || 1.2 || reinhard postscale
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.burn''' || float || 3.75 || reinhard burn
|}

=====Type: TONEMAP_AUTOLINEAR=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "TONEMAP_AUTOLINEAR" || automatic linear tonemapping
|}

=====Type: TONEMAP_LUXLINEAR=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "TONEMAP_LUXLINEAR" || linear tonemapping with real camera settings
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.sensitivity''' || float || 100.0 || ISO sensitivity
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.exposure''' || float || 0.001 || exposure time
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.fstop''' || float || 2.8 || f/aperture
|}

=====Type: NOP=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipeline.<pipeline #>.<plugin #>.type''' || string || "NOP" || no parameters tonemapper
|}

=====Type: GAMMA_CORRECTION=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "TONEMAP_LINEAR" || gamma correction
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.value''' || float || 2.2 || gamma value
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.table.size''' || unsigned int || 4096 || resolution
|}

=====Type: OUTPUT_SWITCHER=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "OUTPUT_SWITCHER" || overwrite output
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.channel''' || string || "DEPTH" || channel whose values are used to overwrite
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.index''' || unsigned int || 0 || index
|}

=====Type: GAUSSIANFILTER_3x3=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "GAUSSIANFILTER_3x3" || gaussian filter
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.weight''' || float || 0.15 || blurring weight
|}

=====Type: CAMERA_RESPONSE_FUNC=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || CAMERA_RESPONSE_FUNC || analog camera film simulation
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.name''' || string || "Advantix_100CD" || film type
|}

=====Type: BACKGROUND_IMG=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || BACKGROUND_IMG || show the background image where alpha < 1 (simple compositing)
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.file''' || string || ... || background image path (e.g scenes/simple-mat/sky.exr)
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.gamma''' || float || 2.2 || background image gamma
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.storage ''' || string || auto || background image storage type
|}
Note: When the size of the background image differs from the film size, it will be stretched to fit the film size.

=====Type: BLOOM=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "BLOOM" || bloom effect
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.radius''' || float || 0.07 || how large the bloom effect is in % of the image size (i.e. 1.0 = all image)
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.weight''' || float || 0.25 || how strong the effect is (i.e. 0.0 = nothing, 1.0 = max. strength)
|}

=====Type: VIGNETTING=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "VIGNETTING" || vignetting effect
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.scale''' || float || 0.4 || vignetting strength
|}

=====Type: COLOR_ABERRATION=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "COLOR_ABERRATION" || color aberration effect
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.amount''' || float || 0.005 || color aberration amount
|}

=====Type: MIST=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "MIST" || aerial perspective effect (fake fog)
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.color''' || spectrum|| [1, 1, 1] || mist color
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.amount''' || float || 0.005 || mist amount
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.startdistance''' || float || 0 || distance from camera until where the mist effect has zero effect
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.enddistance''' || float || 10000 || distance from camera from where the mist effect has maximum effect
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.excludebackground''' || bool || false || Do not apply mist effect on pixels with infinite distance to the camera
|}

=====Type: CONTOUR_LINES=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "CONTOUR_LINES" || contour lines for IRRADIANCE AOV
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.range''' || float|| ? || ?
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.scale''' || float || ? || ?
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.steps''' || int || ? || ?
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.zerogridsize''' || int || ? || ?
|}

=====Type: WHITE_BALANCE =====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "WHITE_BALANCE" || White temperature correction
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.temperature''' || unsigned int|| 6500 || Target image temperature in Kelvin
|-
|}

=====Type: COLOR_LUT =====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "COLOR_LUT" || Applies .cube LUT (look-up-table) to the input
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.file''' || string || "lut.cube" || Filepath to a [https://wwwimages2.adobe.com/content/dam/acom/en/products/speedgrade/cc/pdfs/cube-lut-specification-1.0.pdf .cube LUT file]
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.strength''' || float || 1.0 || Linear interpolation between input (0.0) and output (1.0) of the plugin
|-
|}

=====Type: INTEL_OIDN =====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "INTEL_OIDN" || Denoises the image using [https://github.com/OpenImageDenoise/oidn Intel OIDN]
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.filter.type''' || string || "RT" ||
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.oidnmemory''' || int || 6000 || Approximate maximum amount of memory to use in megabytes (actual memory usage may be higher). Limiting memory usage may cause slower denoising due to internally splitting the image into overlapping tiles
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.sharpness''' || float || 0.1 || Linear interpolation between the denoised result (0.0) and the noisy input (1.0)
|-
|}

=====Type: OPTIX_DENOISER =====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "OPTIX_DENOISER" || Denoises the image using the Nvidia OptiX denoiser
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.minspp''' || unsigned int || 0 || Minimum amount of samples to be rendered before the plugin is run (at lower sample numbers, it does not modify the input)
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.sharpness''' || float || 0.1 || Linear interpolation between the denoised result (0.0) and the noisy input (1.0)
|-
|}

===Film Subregion===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.subregion''' || vector || ... || <xstart> <xstop> <ystart> <ystop>
|}

===Rendering halt conditions===

By default, a LuxCore rendering will never stop however you can enable one or multiple halt conditions:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''batch.haltnoisethreshold''' || float || -1.0 || enable image convergence test and stops when the error is under the defined value. Use a value like "n / 256.0" where n is the level of error you are looking for. It may be hard to achieve a level of error smaller than 3.0 / 256.0. -1.0 disables the halt condition.
|-
|'''batch.haltnoisethreshold.warmup''' || unsigned int || 64 || number of average samples per pixel before to start the convergence test
|-
|'''batch.haltnoisethreshold.step''' || unsigned int || 64 || number of average samples per pixel between two tests
|-
|'''batch.haltnoisethreshold.filter.enable''' || bool || 1 || if the CONVERGENCE AOV (generated by the batch.haltnoisethreshold) should be filtered or not with a 3x3 box filter
|-
|'''batch.haltnoisethreshold.stoprendering.enable''' || bool || 1 || Set this to 0 (false) if you only want to use the haltnoisethreshold settings for adaptive sampling in an endless render
|-
|'''batch.haltnoisethreshold.index''' || unsigned int || 0 || Film pipeline index used to estimate noise for stopping
|-
|'''batch.halttime''' || float || 0.0 || number of seconds before stopping the rendering
|-
|'''batch.haltspp''' || unsigned int || 0 || number of average samples per pixel before stopping the rendering
|}

===Noise estimation===

Image noise can be estimated and its result can be used to drive the Sobol and Random samplers to focus its sampling in the noisier regions.
Setting any of these properties will enable the noise estimation.
The adaptiveness strength is a Sampler property.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.noiseestimation.warmup''' || unsigned int || 32 || number of average samples per pixel before to start the convergence test
|-
|'''film.noiseestimation.step''' || unsigned int || 32 || number of average samples per pixel between two tests
|-
|'''film.noiseestimation.filter.scale''' || unsigned int || 4 || Box filter scale used to filter the NOISE AOV (generated by the noise estimation). Set to 0 to disable.
|-
|'''film.noiseestimation.index''' || unsigned int || 0 || Film pipeline index used to estimate noise for adaptive sampling
|-
|}

=Scene file=

==Camera==

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.camera.type''' || string || "perspective" || "perspective", "orthographic" or "environment" (360° panorama mapped in latlong format)
|-
|'''scene.camera.lookat.orig''' || point (float float float) || 0.0 10.0 0.0 || camera location
|-
|'''scene.camera.lookat.target''' || point (float float float) || 0.0 0.0 0.0 || camera target
|-
|'''scene.camera.up''' || vector (float float float) || (0.0, 0.0, 1.0) || camera up vector
|-
|'''scene.camera.fieldofview''' || float || 45.0 || field of view
|-
|'''scene.camera.screenwindow''' || vector || 0.0 1.0 0.0 1.0 || <xstart> <xstop> <ystart> <ystop>
|-
|'''scene.camera.shutteropen''' || float || 0.0 || camera shutter open time (used for motion blur)
|-
|'''scene.camera.shutterclose''' || float || 0.0 || camera shutter close time (used for motion blur)
|-
|'''scene.camera.autovolume.enable''' || bool || true || try automatically to discover scene.camera.volume
|-
|'''scene.camera.volume''' || string || || the initial volume rays will travel in
|}

The camera supports motion blur. See [[ LuxCore_SDL_Reference_Manual_v2.0#Object_Motion_Blur | Object Motion Blur ]]. 
(Only difference being that instead of the prefix '''scene.objects.<object name>''', the prefix '''scene.camera''' is used when setting motion properties of the camera)

==Textures==

Check [[LuxCoreRender_Textures|LuxCoreRender Textures]] for a high level description and examples of the textures.

===Mapping===

Some texture (mostly procedural textures) supports 2D or 3D mapping parameters:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.mapping.type''' || string || "uvmapping2d" || type of mapping
|-
|'''scene.textures.<texture name>.mapping.rotation''' || float || 0.0 || UV rotation (in degrees)
|-
|'''scene.textures.<texture name>.mapping.uvscale''' || UV || 1.0 1.0 || UV scale
|-
|'''scene.textures.<texture name>.mapping.uvdelta''' || UV || 0.0 0.0 || UV translation
|}

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.mapping.type''' || string || "uvmapping3d" || type of mapping
|-
|'''scene.textures.<texture name>.mapping.transformation''' || Matrix4x4 || 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0|| transformation matrix
|}

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.mapping.type''' || string || "globalmapping3d" || type of mapping
|-
|'''scene.textures.<texture name>.mapping.transformation''' || Matrix4x4 || 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0|| transformation matrix
|}

===Type: add===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "add" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant
|}

===Type: subtract===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "subtract" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant
|}

===Type: band===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "band" || type of texture
|-
|'''scene.textures.<texture name>.amount''' || texture || 0.5|| texture name or constant
|-
|'''scene.textures.<texture name>.interpolation''' || string || "linear"|| "linear", "cubic" or "none"
|-
|'''scene.textures.<texture name>.offset[0..n]''' || float || 0.0 || multiple offsets in the range of [0.0, 1.0]
|-
|'''scene.textures.<texture name>.value[0..n]''' || spectrum || 1.0 1.0 1.0 || a value for each offset
|}

===Type: blender_blend===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_blend" || type of texture
|-
|'''scene.textures.<texture name>.progressiontype''' || string || "linear" || linear, quadratic, easing, diagonal, spherical, quadratic_spherical, halo or radial
|-
|'''scene.textures.<texture name>.direction''' || string || "horizontal" || horizontal or vertical
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_clouds===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_clouds" || type of texture
|-
|'''scene.textures.<texture name>.noisetype''' || string || "soft_noise" || hard_noise or soft_noise
|-
|'''scene.textures.<texture name>.noisebasis''' || string || "blender_original" || blender_original, original_perlin, improved_perlin, voronoi_f1, voronoi_f2, voronoi_f3, voronoi_f4, voronoi_f2_f1, voronoi_crackle or cell_noise
|-
|'''scene.textures.<texture name>.noisesize''' || float || 0.25 ||
|-
|'''scene.textures.<texture name>.noisedepth''' || int || 2 || min 0, max 25
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_distortednoise===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_distortednoise" || type of texture
|-
|'''scene.textures.<texture name>.noise_distortion''' || string || "blender_original" || blender_original, original_perlin, improved_perlin, voronoi_f1, voronoi_f2, voronoi_f3, voronoi_f4, voronoi_f2_f1, voronoi_crackle or cell_noise
|-
|'''scene.textures.<texture name>.noisebasis''' || string || "blender_original" || blender_original, original_perlin, improved_perlin, voronoi_f1, voronoi_f2, voronoi_f3, voronoi_f4, voronoi_f2_f1, voronoi_crackle or cell_noise
|-
|'''scene.textures.<texture name>.noisesize''' || float || 0.25 ||
|-
|'''scene.textures.<texture name>.distortion''' || float || 1 ||
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_magic===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_magic" || type of texture
|-
|'''scene.textures.<texture name>.noisedepth''' || int || 2 || min 0, max 25
|-
|'''scene.textures.<texture name>.turbulence''' || float || 5.0 ||
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_marble===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_marble" || type of texture
|-
|'''scene.textures.<texture name>.marbletype''' || string || "soft" || soft, sharp or sharper
|-
|'''scene.textures.<texture name>.turbulence''' || float || 5.0 ||
|-
|'''scene.textures.<texture name>.noisebasis''' || string || "blender_original" || blender_original, original_perlin, improved_perlin, voronoi_f1, voronoi_f2, voronoi_f3, voronoi_f4, voronoi_f2_f1, voronoi_crackle or cell_noise
|-
|'''scene.textures.<texture name>.noisebasis2''' || string || "sin" || sin, saw or tri
|-
|'''scene.textures.<texture name>.noisedepth''' || int || 2 || min 0, max 25
|-
|'''scene.textures.<texture name>.noisesize''' || float || 0.25 ||
|-
|'''scene.textures.<texture name>.noisetype''' || string || "soft_noise" || soft_noise or hard_noise
|-
|'''scene.textures.<texture name>.turbulence''' || float || 5.0 ||
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_musgrave===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_musgrave" || type of texture
|-
|'''scene.textures.<texture name>.musgravetype''' || string || "multifractal" || multifractal, ridged_multifractal, hybrid_multifractal, fBM or hetero_terrain
|-
|'''scene.textures.<texture name>.noisebasis''' || string || "blender_original" || blender_original, original_perlin, improved_perlin, voronoi_f1, voronoi_f2, voronoi_f3, voronoi_f4, voronoi_f2_f1, voronoi_crackle or cell_noise
|-
|'''scene.textures.<texture name>.dimension''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.intensity''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.lacunarity''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.offset''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.gain''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.octaves''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.gain''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.noisesize''' || float || 0.25 ||
|-
|'''scene.textures.<texture name>.noisetype''' || string || "soft_noise" || soft_noise or hard_noise
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_noise===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_noise" || type of texture
|-
|'''scene.textures.<texture name>.noisedepth''' || int || 2 || min 0, max 25
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_stucci===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_stucci" || type of texture
|-
|'''scene.textures.<texture name>.stuccitype''' || string || "plastic" || plastic, wall_in or wall_out
|-
|'''scene.textures.<texture name>.noisebasis''' || string || "blender_original" || blender_original, original_perlin, improved_perlin, voronoi_f1, voronoi_f2, voronoi_f3, voronoi_f4, voronoi_f2_f1, voronoi_crackle or cell_noise
|-
|'''scene.textures.<texture name>.noisetype''' || string || "soft_noise" || soft_noise or hard_noise
|-
|'''scene.textures.<texture name>.noisesize''' || float || 0.25 ||
|-
|'''scene.textures.<texture name>.turbulence''' || float || 5.0 ||
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_wood===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_wood" || type of texture
|-
|'''scene.textures.<texture name>.woodtype''' || string || "bands" || bands, rings, bandnoise or ringnoise
|-
|'''scene.textures.<texture name>.noisebasis''' || string || "blender_original" || blender_original, original_perlin, improved_perlin, voronoi_f1, voronoi_f2, voronoi_f3, voronoi_f4, voronoi_f2_f1, voronoi_crackle or cell_noise
|-
|'''scene.textures.<texture name>.noisebasis2''' || string || "sin" || sin, saw or tri
|-
|'''scene.textures.<texture name>.noisetype''' || string || "soft_noise" || soft_noise or hard_noise
|-
|'''scene.textures.<texture name>.noisesize''' || float || 0.25 ||
|-
|'''scene.textures.<texture name>.turbulence''' || float || 5.0 ||
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_voronoi===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_voronoi" || type of texture
|-
|'''scene.textures.<texture name>.intensity''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.distmetric''' || string || "actual_distance" || actual_distance, distance_squared, manhattan, chebychev, minkowski_half, minkowski_four or minkowski
|-
|'''scene.textures.<texture name>.w1''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.w2''' || float || 0.0 ||
|-
|'''scene.textures.<texture name>.w3''' || float || 0.0 ||
|-
|'''scene.textures.<texture name>.w4''' || float || 0.0 ||
|-
|'''scene.textures.<texture name>.noisesize''' || float || 0.25 ||
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: brick===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "brick" || type of texture
|-
|'''scene.textures.<texture name>.bricktex''' || texture || 1.0 1.0 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.mortartex''' || texture || 0.2 0.2 0.2 || texture name or constant
|-
|'''scene.textures.<texture name>.brickmodtex''' || texture || 1.0 1.0 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.brickmodbias''' || float || 0.0 || With bias = -1, only the bricktex is used for the brick color. With bias between -1 and 1, a pseudo-random interpolation between bricktex and brickmodtex is used as brick color. With bias = 1, only the brickmodtex is used for the brick color.
|-
|'''scene.textures.<texture name>.brickbond''' || string || "running" || "flemish", "english", "herringbone", "basket" or "chain link"
|-
|'''scene.textures.<texture name>.brickwidth''' || float || 0.3 || brick width
|-
|'''scene.textures.<texture name>.brickheight''' || float || 0.1 || brick height
|-
|'''scene.textures.<texture name>.brickdepth''' || float || 0.15 || brick depth
|-
|'''scene.textures.<texture name>.mortarsize''' || float || 0.01 ||mortar size
|-
|'''scene.textures.<texture name>.brickrun''' || float || 0.75 || brick run
|}

This texture supports 3D mapping.

===Type: checkerboard3d===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "checkerboard3d" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 0.0 || texture name or constant
|}

This texture supports 3D mapping.

===Type: checkerboard2d===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "checkerboard2d" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 0.0 || texture name or constant
|}

This texture supports 2D mapping.

===Type: constfloat1===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "constfloat1" || type of texture
|-
|'''scene.textures.<texture name>.value''' || float || 1.0 || constant value
|}

===Type: constfloat3===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "constfloat3" || type of texture
|-
|'''scene.textures.<texture name>.value''' || spectrum || (1.0, 1.0, 1.0) || RGB constant value
|}

===Type: densitygrid===

You can use ".data", ".data3" or ".openvdb.file" to define the 3D grid values.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "densitygrid" || type of texture
|-
|'''scene.textures.<texture name>.nx''' || unsigned int || || grid x size
|-
|'''scene.textures.<texture name>.ny''' || unsigned int || || grid y size
|-
|'''scene.textures.<texture name>.nz''' || unsigned int || || grid z size
|-
|'''scene.textures.<texture name>.wrap''' || string || "repeat" || select the type of grid wrapping mode: "repeat", "black", "white", "clamp"
|-
|'''scene.textures.<texture name>.wrap''' || string || "repeat" || select the type of grid wrapping mode: "repeat", "black", "white", "clamp"
|-
|'''scene.textures.<texture name>.storage''' || string || "half" || select the type of memory storage: "auto", "byte", "half", "float"
|-
|'''scene.textures.<texture name>.data''' || float || || vector grid values (total count: nx * ny * nz)
|-
|'''scene.textures.<texture name>.data3''' || float || || vector grid values (total count: nx * ny * nz * 3)
|-
|'''scene.textures.<texture name>.openvdb.file''' || string || || OpenVDB file name
|-
|'''scene.textures.<texture name>.openvdb.grid''' || string || || OpenVDB grid name to read from the file
|}

===Type: dots===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "dots" || type of texture
|-
|'''scene.textures.<texture name>.inside''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.outside''' || texture || 0.0 || texture name or constant
|}

This texture supports 2D mapping.

===Type: fbm===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "fbm" || type of texture
|-
|'''scene.textures.<texture name>.octaves''' || int || 8 || noise octaves
|-
|'''scene.textures.<texture name>.roughness''' || float || 0.5 || noise roughness
|}

This texture supports 3D mapping.

===Type: fresnelapproxk===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "fresnelapproxk" || type of texture
|-
|'''scene.textures.<texture name>.texture''' || texture || (0.5, 0.5, 0.5) || texture name or constant
|}

===Type: fresnelapproxn===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "fresnelapproxn" || type of texture
|-
|'''scene.textures.<texture name>.texture''' || texture || (0.5, 0.5, 0.5) || texture name or constant
|}

===Type: hitpointalpha===

Use the value obtained by interpolating triangle vertices alphas.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "hitpointalpha" || type of texture
|}

===Type: hitpointcolor===

Use the color obtained by interpolating triangle vertices colors.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "hitpointcolor" || type of texture
|}

===Type: hitpointgrey===

Use the value obtained by interpolating triangle vertices colors, mapped to a float value (RGB converted into greyscale).

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "hitpointgrey" || type of texture
|-
|'''scene.textures.<texture name>.channel''' || int || -1 || the index of the RGB channel to use. -1 means the luminance of the RGB value
|}

===Type: hsv===

Hue saturation value manipulation.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "hsv" || type of texture
|-
|'''scene.textures.<texture name>.texture''' || texture || 0 0 0 || input color that will be manipulated
|-
|'''scene.textures.<texture name>.hue''' || texture || 0.5 || shift in hue (range: 0..1)
|-
|'''scene.textures.<texture name>.saturation''' || texture || 1.0 || saturation (range: 0..inf)
|-
|'''scene.textures.<texture name>.value''' || texture || 1.0 || brightness multiplier (range: 0..inf)
|}

===Type: imagemap===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "imagemap" || type of texture
|-
|'''scene.textures.<texture name>.file''' || string || "image.png" || name of the image file
|-
|'''scene.textures.<texture name>.gamma''' || float || 2.2 || gamma correction value used in the image
|-
|'''scene.textures.<texture name>.gain''' || float || 1.0 || image values are multiplied by gain value
|-
|'''scene.textures.<texture name>.storage''' || string || "auto" || select the type of memory storage: "auto", "byte", "half", "float"
|-
|'''scene.textures.<texture name>.wrap''' || string || "repeat" || select the type of image map wrapping mode: "repeat", "black", "white", "clamp"
|-
|'''scene.textures.<texture name>.channel''' || string || "default" || extract from the image only the selected channels: "default", "red", "green", "blue", "alpha", "mean", "colored_mean", "rgb"
|}

===Type: normalmap===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "normalmap" || type of texture
|-
|'''scene.textures.<texture name>.texture''' || texture || 0 0 0 || input. Is treated as an XYZ vector in tangent space.
|-
|'''scene.textures.<texture name>.scale''' || float || 1.0 || multiplier for adjusting normalmap height
|}

===Type: marble===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "marble" || type of texture
|-
|'''scene.textures.<texture name>.octaves''' || int || 8 || noise octaves
|-
|'''scene.textures.<texture name>.roughness''' || float || 0.5 || noise roughness
|-
|'''scene.textures.<texture name>.scale''' || float || 1.0 || marble scale
|-
|'''scene.textures.<texture name>.variation''' || float || 0.2 || marble variation
|}

This texture supports 3D mapping.

===Type: mix===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "mix" || type of texture
|-
|'''scene.textures.<texture name>.amount''' || texture || 0.5 || texture name or constant
|-
|'''scene.textures.<texture name>.texture1''' || texture || 0.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant
|}

===Type: scale===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "scale" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant
|}

===Type: uv===

This procedural texture has no parameters aside from the support of 2D mapping.

===Type: windy===

This procedural texture has no parameters aside from the support of 3D mapping.

===Type: wood===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "wood" || type of texture
|-
|'''scene.textures.<texture name>.woodtype''' || string || "bands" || "bands", "rings", "bandnoise" or "ringnoise"
|-
|'''scene.textures.<texture name>.noisebasis2''' || string || "sin" || "sin", "saw" or "tri"
|-
|'''scene.textures.<texture name>.noisetype''' || string || "soft_noise" || "soft_noise" or "hard_noise"
|-
|'''scene.textures.<texture name>.noisesize''' || float || 0.25 || noise size
|-
|'''scene.textures.<texture name>.turbulence''' || float || 5.0 || noise turbulence
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 || bright
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 || contrast
|}

This texture supports 3D mapping.

===Type: wrinkled===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "wrinkled" || type of texture
|-
|'''scene.textures.<texture name>.octaves''' || int || 8 || noise octaves
|-
|'''scene.textures.<texture name>.roughness''' || float || 0.5 || noise roughness
|}

This texture supports 3D mapping.

===Type: abs===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "abs" || type of texture
|-
|'''scene.textures.<texture name>.texture''' || texture || 1.0 || texture name or constant
|}

===Type: clamp===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "clamp" || type of texture
|-
|'''scene.textures.<texture name>.texture''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.min''' || float || 0.0 || lower boundary of the clamping
|-
|'''scene.textures.<texture name>.max''' || float || 1.0 || upper boundary of the clamping
|}

===Type: divide===

Note: If texture2 (the divisor) is 0, 0 is returned.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "divide" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant (dividend)
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant (divisor)
|}

===Type: remap===

This texture brings the value from the source range into the target range.

Note: The value is clamped into source range before performing the remap operation, and the resulting number is also clamped into the target range.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "remap" || type of texture
|-
|'''scene.textures.<texture name>.value''' || texture || 0.5 || texture name or constant
|-
|'''scene.textures.<texture name>.sourcemin''' || texture || 0.0 || texture name or constant
|-
|'''scene.textures.<texture name>.sourcemax''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.targetmin''' || texture || 0.0 || texture name or constant
|-
|'''scene.textures.<texture name>.targetmax''' || texture || 1.0 || texture name or constant
|}

===Type: objectid===

Raw object ID (range 0 to 0xfffffffe).

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "objectid" || type of texture
|}

===Type: objectidcolor===

Object ID interpreted as color. 
The object ID is a 4 byte unsigned int. To convert to color, the lower three bytes are interpreted as r, g, b values (each range 0 to 255). The highest byte is ignored.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "objectidcolor" || type of texture
|}

===Type: objectidnormalized===

Normalized object ID (range 0 to 1).

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "objectidnormalized" || type of texture
|}

===Type: dotproduct ===

Dot product of the two input vectors.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "dotproduct" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant
|}

===Type: power ===

pow(base, exponent)

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "power" || type of texture
|-
|'''scene.textures.<texture name>.base''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.exponent''' || texture || 1.0 || texture name or constant
|}

===Type: lessthan ===

returns 1 if texture1 < texture2, 0 if otherwise.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "lessthan" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant
|}

===Type: greaterthan ===

returns 1 if texture1 > texture2, 0 if otherwise.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "greaterthan" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant
|}

===Type: shadingnormal ===

Returns the shading normal of the mesh at the hitpoint.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "shadingnormal" || type of texture
|}

===Type: position ===

Returns the position of the hitpoint.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "position" || type of texture
|}

===Type: splitfloat3 ===

Extract a channel from a float3 texture. Can for example be used to get the R, G or B channel of a color texture, or to get the X, Y or Z components of a vector texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "splitfloat3" || type of texture
|-
|'''scene.textures.<texture name>.texture''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.channel''' || int || 0 || the channel to get from the input texture. 0 for first channel, 1 for second, 2 for third channel
|}

===Type: makefloat3 ===

Combine three float textures into one float3 texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "makefloat3" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture3''' || texture || 1.0 || texture name or constant
|}

===Type: blackbody===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blackbody" || type of texture
|-
|'''scene.textures.<texture name>.temperature''' || float || 6500 || emission temperature
|-
|'''scene.textures.<texture name>.normalize''' || bool || false || normalize the output
|}

===Type: irregulardata===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "irregulardata" || type of texture
|-
|'''scene.textures.<texture name>.wavelengths''' || vector || 580.0 620.0 660.0|| wavelenghts
|-
|'''scene.textures.<texture name>.data''' || vector || 0.0 0.000015 0.0|| data (length should match wavelength's length)
|}

===Type: lampspectrum===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "lampspectrum" || type of texture
|-
|'''scene.textures.<texture name>.name''' || string || "Daylight" || lamp light spectrum
|}

===Type: Fresnel Textures===

Textures for loading optical data

====Type: fresnelcolor====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || fresnelcolor || type of texture
|-
|'''scene.textures.<texture name>.kr''' || vector || 0.5 0.0 0.0 || reflection color
|}

====Type: fresnelpreset====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || fresnelpreset || type of texture
|-
|'''scene.textures.<texture name>.name''' || string || aluminium || fresnel preset ("aluminium", "silver", "copper", "gold" or "amorphous carbon")
|}

====Type: fresnelsopra====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || fresnelpreset || type of texture
|-
|'''scene.textures.<texture name>.file''' || string || ... || nk file path (e.g scenes/luxball/Au.nk)
|}

====Type: fresnelluxpop====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || fresnelpreset || type of texture
|-
|'''scene.textures.<texture name>.file''' || string || ... || nk file path (e.g scenes/luxball/Cr.nk)
|}

====Type: distort====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || distort || type of texture
|-
|'''scene.textures.<texture name>.texture''' || texture || 0.0 || texture name or constant; input texture
|-
|'''scene.textures.<texture name>.offset''' || texture || 0.0 || texture name or constant; offset to add to the hitpoint coordinates and UV values before evaluating the input texture
|-
|'''scene.textures.<texture name>.strength''' || float || 1.0 || strength multiplier, is multiplied with the offset
|}

==Volumes==

Check [[LuxCoreRender_Volumes|LuxCoreRender Volumes]] for a high level description and examples of the volumes.

All volumes share these properties

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.volumes.<volume name>.type''' || string || clear || volume type
|-
|'''scene.volumes.<volume name>.priority''' || unsigned int|| 0|| volume priority (when volumes overlap, the one with highest priority overrides the others)
|-
|'''scene.volumes.<volume name>.ior''' || texture|| ... || index of refraction
|-
|'''scene.volumes.<volume name>.absorption''' || texture || ... || absorption texture
|-
|'''scene.volumes.<volume name>.emission ''' || texture || ... || emission
|-
|'''scene.volumes.<volume name>.emission.id ''' || unsigned int || ... || emission ID
|}

===Volume: Clear===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.volumes.<volume name>.type''' || string || clear || volume type
|}

===Volume: Homogeneous===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.volumes.<volume name>.type''' || string || homogeneous|| volume type
|-
|'''scene.volumes.<volume name>.scattering''' || texture || ... || scattering texture
|-
|'''scene.volumes.<volume name>.asymmetry''' || texture || ... || asymmetry texture
|-
|'''scene.volumes.<volume name>.multiscattering''' || bool || ... || multiscattering
|}

===Volume: Heterogeneous===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.volumes.<volume name>.type''' || string || heterogeneous || volume type
|-
|'''scene.volumes.<volume name>.scattering''' || texture || ... || scattering texture
|-
|'''scene.volumes.<volume name>.asymmetry''' || texture || ... || asymmetry texture
|-
|'''scene.volumes.<volume name>.multiscattering''' || bool || ... || multiscattering
|-
|'''scene.volumes.<volume name>.steps.size''' || float || ... || step size
|-
|'''scene.volumes.<volume name>.steps.maxcount''' || unsigned int || ... || step maximum count
|}

==Materials==

Check [[LuxCoreRender_Materials|LuxCoreRender Materials]] for a high level description and examples of the materials.

===Common properties===

Common material properties:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.bumptex''' || texture || || texture to use for the bump mapping
|-
|'''scene.materials.<material name>.normaltex''' || texture || || texture to use for the normal mapping
|-
|'''scene.materials.<material name>.samples''' || int || -1 || number of rays used to sample this material. -1 means use the default global value. This property is an hint and the render engine can ignore this information.
|-
|'''scene.materials.<material name>.visibility.indirect.diffuse.enable''' || bool || true || if this material is visible in indirect rays. This property is an hint and the render engine can ignore this information.
|-
|'''scene.materials.<material name>.visibility.indirect.glossy.enable''' || bool || true || if this material is visible in indirect rays. This property is an hint and the render engine can ignore this information.
|-
|'''scene.materials.<material name>.visibility.indirect.specular.enable''' || bool || true || if this material is visible in indirect rays. This property is an hint and the render engine can ignore this information.
|-
|'''scene.materials.<material name>.bumpsamplingdistance''' || float || 0.001 || set the offset used to sample bump/normal mapping.
|-
|'''scene.materials.<material name>.volume.interior''' || string || vol1 || name of interior volume (for volume rendering)
|-
|'''scene.materials.<material name>.volume.exterior''' || string || vol2 || name of exterior volume (for volume rendering)
|-
|'''scene.materials.<material name>.id''' || int|| ... || material id
|-
|'''scene.materials.<material name>.transparency''' || texture || 1.0 || transparency of the material. 1 for opaque, 0 for fully transparent
|-
|'''scene.materials.<material name>.shadowcatcher.enable''' || bool || false || If true, the material will be transparent where hit by direct light and opaque otherwise (alpha transparency). Used for compositing.
|}

====Normal maps====
Normal maps are set first as a texture type and then assigned to the material. For example:

<blockquote><pre>
scene.textures.normmap.type = imagemap
scene.textures.normmap.file = scenes/bump/normal.png
scene.textures.normmap.gamma = 1

scene.materials.mat_white.type = matte
scene.materials.mat_white.kd = 0.8 0.8 0.8
scene.materials.mat_white.normaltex = normmap
</pre></blockquote>

====Light emission====

All materials can emit light:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.emission''' || texture || 0.0 0.0 0.0 || color of the emitted light
|-
|'''scene.materials.<material name>.emission.gain''' || spectrum || 1.0 1.0 1.0 || multiplier for lamp brigthness
|-
|'''scene.materials.<material name>.emission.power''' || float || 0.0 || lamp output power in watts. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.materials.<material name>.emission.efficency''' || float || 0.0 || luminous efficacy in lumens/watt. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.materials.<material name>.emission.mapfile''' || string || || the name of an optional image map that can be used to scale the emitted light
|-
|'''scene.materials.<material name>.emission.gamma''' || float || 2.2 || gamma value of the image map defined with .mapfile property
|-
|'''scene.materials.<material name>.emission.iesfile''' || string || || a [http://en.wikipedia.org/wiki/Illuminating_Engineering_Society_of_North_America IES] profile of emitted light
|-
|'''scene.materials.<material name>.emission.iesblob''' || blob || || a [http://en.wikipedia.org/wiki/Illuminating_Engineering_Society_of_North_America IES] profile of emitted light embedded in a blob
|-
|'''scene.materials.<material name>.emission.flipz''' || bool || false || flip the IES profile along the Z axis
|-
|'''scene.materials.<material name>.emission.samples''' || int || -1 || the number of shadow ray to trace to compute direct light from this material. This property is an hint and the render engine can ignore this information. -1 means use the default global value.
|-
|'''scene.materials.<material name>.emission.map.width''' || unsigned int || 0 || scale the image or IES map to the specified width. 0 means use the original size
|-
|'''scene.materials.<material name>.emission.map.height''' || unsigned int || 0 || scale the image or IES map to the specified height. 0 means use the original size
|-
|'''scene.materials.<material name>.emission.id''' || int || 0 || the radiance group the light emitted from this material is assigned to.
|-
|'''scene.materials.<material name>.emission.theta''' || float || 90.0 || How directional the light is emitted, set as the half-angle of the light source. Default is 90°. Smaller values mean that more light is emitted in the direction of the face normals and less to the sides.
|-
|'''scene.materials.<material name>.emission.importance''' || float || 1.0 || A hint how often to sample this light source compared to other lights
|}

===Type: archglass===

This material should be used to replace glass material of windows when rendering architectural interiors. It allows direct light to pass trough.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "archglass" || type of material
|-
|'''scene.materials.<material name>.kr''' || texture || 1.0 1.0 1.0 || texture or constant reflected color of the material
|-
|'''scene.materials.<material name>.kt''' || texture || 1.0 1.0 1.0 || texture or constant transmitted color of the material
|-
|'''scene.materials.<material name>.interiorior''' || texture || 1.5 || inside texture or constant index of refraction (only for volume-less rendering)
|-
|'''scene.materials.<material name>.exteriorior''' || texture || 1.0 || outside texture or constant index of refraction (only for volume-less rendering)
|-
|'''scene.materials.<material name>.filmthickness''' || texture || none || thickness (in nanometers) of a [https://en.wikipedia.org/wiki/Thin-film_interference thin-film coating] on the surface. This property is optional, if it is not defined, the coating is disabled.
|-
|'''scene.materials.<material name>.filmior''' || texture || none || Refractive index of the thin-film coating. This property is optional, if it is not defined, the coating is disabled.
|}

===Type: carpaint===

Car Paint is an advanced glossy material, simulating a diffuse surface with mutliple reflective coatings.

The available presets for the carpaint material are:

*"ford f8"
*"polaris silber"
*"opel titan"
*"bmw339"
*"2k acrylack"
*"white"
*"blue"
*"blue matte"

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "carpaint" || type of material
|-
|'''scene.materials.<material name>.preset''' || string || "ford f8" || one of the avilable presets
|-
|'''scene.materials.<material name>.ka''' || texture || 0.0 0.0 0.0 || absorption color
|-
|'''scene.materials.<material name>.d''' || texture || 0.0 || absorption depth
|-
|'''scene.materials.<material name>.kd''' || texture || 0.0 0.0 0.0 || diffuse color
|-
|'''scene.materials.<material name>.ks1''' || texture || 0.0 0.0 0.0 || specular color - layer 1
|-
|'''scene.materials.<material name>.ks2''' || texture || 0.0 0.0 0.0 || specular color - layer 2
|-
|'''scene.materials.<material name>.ks3''' || texture || 0.0 0.0 0.0 || specular color - layer 3
|-
|'''scene.materials.<material name>.r1''' || texture || 0.0 0.0 0.0 || fresnel effect strength - layer 1
|-
|'''scene.materials.<material name>.r2''' || texture || 0.0 0.0 0.0 || fresnel effect strength - layer 2
|-
|'''scene.materials.<material name>.r3''' || texture || 0.0 0.0 0.0 || fresnel effect strength - layer 3
|-
|'''scene.materials.<material name>.m1''' || texture || 0.0 0.0 0.0 || roughness - layer 1
|-
|'''scene.materials.<material name>.m2''' || texture || 0.0 0.0 0.0 || roughness - layer 2
|-
|'''scene.materials.<material name>.m3''' || texture || 0.0 0.0 0.0 || roughness - layer 3
|}

===Type: cloth===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "cloth" || type of material
|-
|'''scene.materials.<material name>.preset''' || string || "denim" || denim, silk_charmeuse, silk_shantung, cotton_twill, wool_garbardine or polyester_lining_cloth
|-
|'''scene.materials.<material name>.weft_kd''' || texture || 0.5 0.5 0.5 || coefficient of diffuse reflection in one weave direction
|-
|'''scene.materials.<material name>.weft_ks''' || texture || 0.5 0.5 0.5 || coefficient of specular reflection in one weave direction
|-
|'''scene.materials.<material name>.warp_kd''' || texture || 0.5 0.5 0.5 || coefficient of diffuse reflection in the opposite weave direction
|-
|'''scene.materials.<material name>.warp_ks''' || texture || 0.5 0.5 0.5 || coefficient of specular reflection in the opposite weave direction
|-
|'''scene.materials.<material name>.repeat_u''' || float || 100.0 || thread count in the u direction
|-
|'''scene.materials.<material name>.repeat_v''' || float || 100.0 || thread count in the v direction
|}

===Type: disney===

For more details, refer to the [https://disney-animation.s3.amazonaws.com/library/s2012_pbs_disney_brdf_notes_v2.pdf original paper].

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "disney" || type of material
|-
|'''scene.materials.<material name>.basecolor''' || texture || 0.5 0.5 0.5 || Base color
|-
|'''scene.materials.<material name>.subsurface''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.roughness''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.metallic''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.specular''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.speculartint''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.clearcoat''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.clearcoatgloss''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.anisotropic''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.sheen''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.sheentint''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.filmamount''' || texture || none || Linear interpolation between no film (0) and full film effect (1) for artistic control. This property is optional, if it is not defined, the coating is disabled.
|-
|'''scene.materials.<material name>.filmthickness''' || texture || none || thickness (in nanometers) of a [https://en.wikipedia.org/wiki/Thin-film_interference thin-film coating] on the surface. This property is optional, if it is not defined, the coating is disabled.
|-
|'''scene.materials.<material name>.filmior''' || texture || none || Refractive index of the thin-film coating. This property is optional, if it is not defined, the coating is disabled.
|}

===Type: glass===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "glass" || type of material
|-
|'''scene.materials.<material name>.kr''' || texture || 1.0 || texture or constant reflected color of the material
|-
|'''scene.materials.<material name>.kt''' || texture || 1.0 || texture or constant transmitted color of the material
|-
|'''scene.materials.<material name>.interiorior''' || texture || 1.5 || inside texture or constant index of refraction (only for volume-less rendering)
|-
|'''scene.materials.<material name>.exteriorior''' || texture || 1.0 || outside texture or constant index of refraction (only for volume-less rendering)
|-
|'''scene.materials.<material name>.cauchyb''' || texture || 0.0 || if defined and > 0.0, enable dispersion. The value is the B term of the [https://en.wikipedia.org/wiki/Cauchy%27s_equation Cauchy's equation]
|-
|'''scene.materials.<material name>.filmthickness''' || texture || none || thickness (in nanometers) of a [https://en.wikipedia.org/wiki/Thin-film_interference thin-film coating] on the surface. This property is optional, if it is not defined, the coating is disabled.
|-
|'''scene.materials.<material name>.filmior''' || texture || none || Refractive index of the thin-film coating. This property is optional, if it is not defined, the coating is disabled.
|}

===Type: glossy2===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "glossy2" || type of material
|-
|'''scene.materials.<material name>.kd''' || texture || 0.5 0.5 0.5 || texture or constant diffuse color of the material
|-
|'''scene.materials.<material name>.ks''' || texture || 0.5 0.5 0.5 || texture or constant specular color of the material
|-
|'''scene.materials.<material name>.uroughness''' || texture || 0.1 || texture or constant roughness value along u coordinate of the material
|-
|'''scene.materials.<material name>.vroughness''' || texture || 0.1 || texture or constant roughness value along v coordinate of the material
|-
|'''scene.materials.<material name>.ka''' || texture || 0.0 0.0 0.0 || texture or constant value of coefficient of absorption of the coating layer
|-
|'''scene.materials.<material name>.d''' || texture || 0.0 || texture or constant value of the depth (thickness) of the coating layer for absorption effects. (0 = disables)
|-
|'''scene.materials.<material name>.index''' || texture || 0.0 0.0 0.0 || IOR of the coating. IOR overrides color Ks if both are specified
|-
|'''scene.materials.<material name>.multibounce''' || bool || false || simulation of asperity (velvet-like reflection) on the glossy surface
|}

===Type: glossytranslucent===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "glossytranslucent" || type of material
|-
|'''scene.materials.<material name>.kd''' || texture || 0.5 0.5 0.5 || texture or constant diffuse color of the material
|-
|'''scene.materials.<material name>.kt''' || texture || 0.5 0.5 0.5 || texture or constant transmission color of the material
|-
|'''scene.materials.<material name>.ks''' || texture || 0.5 0.5 0.5 || texture or constant specular color of the material
|-
|'''scene.materials.<material name>.ks_bf''' || texture || 0.5 0.5 0.5 || texture or constant backface specular color of the material
|-
|'''scene.materials.<material name>.uroughness''' || texture || 0.1 || texture or constant roughness value along u coordinate of the material
|-
|'''scene.materials.<material name>.uroughness_bf''' || texture || 0.1 || texture or constant backface roughness value along u coordinate of the material
|-
|'''scene.materials.<material name>.vroughness''' || texture || 0.1 || texture or constant roughness value along v coordinate of the material
|-
|'''scene.materials.<material name>.vroughness_bf''' || texture || 0.1 || texture or constant backface roughness value along v coordinate of the material
|-
|'''scene.materials.<material name>.ka''' || texture || 0.0 0.0 0.0 || texture or constant value of coefficient of absorption of the coating layer
|-
|'''scene.materials.<material name>.ka_bf''' || texture || 0.0 0.0 0.0 || texture or constant value of backface coefficient of absorption of the coating layer
|-
|'''scene.materials.<material name>.d''' || texture || 0.0 || texture or constant value of the depth (thickness) of the coating layer for absorption effects. (0 = disables)
|-
|'''scene.materials.<material name>.d_bf''' || texture || 0.0 || texture or constant value of the backface depth (thickness) of the coating layer for absorption effects. (0 = disables)
|-
|'''scene.materials.<material name>.index''' || texture || 0.0 0.0 0.0 || IOR of the coating. IOR overrides color Ks if both are specified
|-
|'''scene.materials.<material name>.index_bf''' || texture || 0.0 0.0 0.0 || IOR of the backface coating. IOR overrides color Ks if both are specified
|-
|'''scene.materials.<material name>.multibounce''' || bool || false || simulation of asperity (velvet-like reflection) on the glossy surface
|-
|'''scene.materials.<material name>.multibounce_bf''' || bool || false || backface simulation of asperity (velvet-like reflection) on the glossy surface
|}

===Type: glossycoating===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "glossycoating" || type of material
|-
|'''scene.materials.<material name>.base''' || string || || name of base material, the coating layer is added on top of this material
|-
|'''scene.materials.<material name>.ks''' || texture || 0.5 0.5 0.5 || texture or constant specular color of the material
|-
|'''scene.materials.<material name>.uroughness''' || texture || 0.1 || texture or constant roughness value along u coordinate of the material
|-
|'''scene.materials.<material name>.vroughness''' || texture || 0.1 || texture or constant roughness value along v coordinate of the material
|-
|'''scene.materials.<material name>.ka''' || texture || 0.0 0.0 0.0 || texture or constant value of coefficient of absorption of the coating layer
|-
|'''scene.materials.<material name>.d''' || texture || 0.0 || texture or constant value of the depth (thickness) of the coating layer for absorption effects. (0 = disables)
|-
|'''scene.materials.<material name>.index''' || texture || 0.0 0.0 0.0 || IOR of the coating. IOR overrides color Ks if both are specified
|-
|'''scene.materials.<material name>.multibounce''' || bool || false || simulation of asperity (velvet-like reflection) on the glossy surface
|}

===Type: matte===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "matte" || type of material
|-
|'''scene.materials.<material name>.kd''' || texture || 0.75 0.75 0.75 || texture or constant color of the matte material
|}

===Type: mattetranslucent===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "mattetranslucent" || type of material
|-
|'''scene.materials.<material name>.kr''' || texture || 0.5 0.5 0.5 || texture or constant reflected color of the material
|-
|'''scene.materials.<material name>.kt''' || texture || 0.5 0.5 0.5 || texture or constant transmitted color of the material
|}

===Type: metal2===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "metal2" || type of material
|-
|'''scene.materials.<material name>.fresnel''' || fresnel texture || ... || [[#Type:_Fresnel_Textures | fresnel texture]]
|-
|'''scene.materials.<material name>.uroughness''' || texture || 0.1 || texture or constant roughness value along u coordinate of the material
|-
|'''scene.materials.<material name>.vroughness''' || texture || 0.1 || texture or constant roughness value along v coordinate of the material
|-
|'''scene.materials.<material name>.preset''' || string || "aluminium" || (DEPRECATED) "aluminium", "silver", "copper", "gold" or "amorphous carbon"
|-
|'''scene.materials.<material name>.n''' || texture || 0.5 0.5 0.5 || (DEPRECATED) texture or constant value. It can be used to directly define a fresnelapproxn texture on overwrite the .preset property
|-
|'''scene.materials.<material name>.k''' || texture || 0.5 0.5 0.5 || (DEPRECATED) texture or constant value. It can be used to directly define a fresnelapproxk texture on overwrite the .preset property
|}

===Type: mirror===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "mirror" || type of material
|-
|'''scene.materials.<material name>.kr''' || texture || 1.0 1.0 1.0 || texture or constant reflected color of the material
|}

===Type: mix===

This material can be used to mix 2 other materials.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "mix" || type of material
|-
|'''scene.materials.<material name>.material1''' || string || mat1 || name of another material
|-
|'''scene.materials.<material name>.material2''' || string || mat2 || name of another material
|-
|'''scene.materials.<material name>.amount''' || texture || 0.5 || texture or constant value used to mix the materials
|}

===Type: null===

This is empty, not visible material. It can be combined by using mix material with others. It is often used in combination with the alpha channel of an image map to render leafs, etc.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "null" || type of material
|}

===Type: roughglass===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "roughglass" || type of material
|-
|'''scene.materials.<material name>.kr''' || texture || 1.0 1.0 1.0 || texture or constant reflected color of the material
|-
|'''scene.materials.<material name>.kt''' || texture || 1.0 1.0 1.0 || texture or constant transmitted color of the material
|-
|'''scene.materials.<material name>.interiorior''' || texture || 1.5 || inside texture or constant index of refraction
|-
|'''scene.materials.<material name>.exteriorior''' || texture || 1.0 || outside texture or constant index of refraction
|-
|'''scene.materials.<material name>.uroughness''' || texture || 0.1 || texture or constant roughness value along u coordinate of the material
|-
|'''scene.materials.<material name>.vroughness''' || texture || 0.1 || texture or constant roughness value along v coordinate of the material
|-
|'''scene.materials.<material name>.filmthickness''' || texture || none || thickness (in nanometers) of a [https://en.wikipedia.org/wiki/Thin-film_interference thin-film coating] on the surface. This property is optional, if it is not defined, the coating is disabled.
|-
|'''scene.materials.<material name>.filmior''' || texture || none || Refractive index of the thin-film coating. This property is optional, if it is not defined, the coating is disabled.
|}

===Type: roughmatte===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "roughmatte" || type of material
|-
|'''scene.materials.<material name>.kd''' || texture || 0.75 0.75 0.75 || texture or constant color of the roughmatte material
|-
|'''scene.materials.<material name>.sigma''' || texture || 0.0 || the sigma parameter in the Oren-Nayer shader in degrees. Zero for pure Lambertian reflection
|}

===Type: velvet===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "velvet" || type of material
|-
|'''scene.materials.<material name>.kd''' || texture || 0.5 0.5 0.5 || color of the material's fuzz
|-
|'''scene.materials.<material name>.p1''' || texture || -2.0 || polynomial that influences the fuzz
|-
|'''scene.materials.<material name>.p2''' || texture || 20.0 || polynomial that influences the fuzz
|-
|'''scene.materials.<material name>.p3''' || texture || 2.0 || polynomial that influences the fuzz
|-
|'''scene.materials.<material name>.thickness''' || texture || 0.1 || height of the fuzz
|}

==Objects==

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.objects.<object name>.material''' || string || || type of object material
|-
|'''scene.objects.<object name>.shape''' || string || || name of [[#Shapes | shape]] with the triangle mesh description.Memory required to store the triangle mesh information is allocated only once if 2 or more different objects share the same shape, use .transformation property and true instancing is enabled.
|-
|'''scene.objects.<object name>.ply''' || string || || '''(Deprecated, use .shape instead)''' name of [http://en.wikipedia.org/wiki/PLY_(file_format) PLY] file with the triangle mesh description. Memory required to store the triangle mesh information is allocated only once if 2 or more different objects share the same file, use .transformation property and true instancing is enabled.
|-
|'''scene.objects.<object name>.transformation''' || matrix 4x4 || 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 || transformation matrix
|-
|'''scene.objects.<object name>.vertices''' || float || || This is an alternative syntax to using PLY file. It is an in-lined definition of the triangle mesh. It is a list of float values defining the vertices of the mesh (i.e. 3 coordinates for each vertex).
|-
|'''scene.objects.<object name>.faces''' || unsigned int || || This is an alternative syntax to using PLY file. It is an in-lined definition of the triangle mesh. It is a list of unsigned int values defining the triangles of the mesh (i.e. 3 index of vertices for each triangle).
|-
|'''scene.objects.<object name>.id''' || unsigned int || || object ID
|-
|'''scene.objects.<object name>.camerainvisible''' || bool || false || toggle visibility for camera rays. If set to true, the object will not show up in camera rays, but it will still be visible in reflections, refractions, shadows, indirect light etc.
|}

===Object Motion Blur===

LuxCore supports transformation motion blur for objects.
Motion blur is enabled if an object has a motion system defined as described below.

A motion system consists of steps (at least 2). Each step has a time (in seconds) and a transformation matrix of the object at this point in time.
Step indices start at 0. The times have to be monotonic (each greater than the last).

Note that the embree accelerator only supports a maximum of 129 time steps.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.objects.<object name>.motion.<step>.time''' || float || || time (in seconds) of the step
|-
|'''scene.objects.<object name>.motion.<step>.transformation''' || matrix 4x4 || 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 || transformation matrix of the object at the given step
|-
|}

==Shapes==

===Type: mesh===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.shapes.<shape name>.type''' || string || "mesh" || mesh shape
|-
|'''scene.shapes.<shape name>.ply''' || string || ... || mesh path (e.g ''scenes/luxball/luxball-shell.ply'')
|-
|'''scene.shapes.<shape name>.appliedtransformation''' || Matrix4x4 || 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0|| transformation matrix applied to the mesh vertices. Used to define the local object reference space.
|}

===Type: inlinedmesh===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.shapes.<shape name>.type''' || string || "inlinedmesh" || inlinedmesh shape
|-
|'''scene.shapes.<shape name>.vertices''' || vector || ... || inlinedmesh vertices (e.g 0.0 0.0 0.0 1.0 0.0 0.0 0.0 1.0 0.0)
|-
|'''scene.shapes.<shape name>.faces''' || vector || ... || inlinedmesh faces (e.g 0 1 2)
|-
|'''scene.shapes.<shape name>.appliedtransformation''' || Matrix4x4 || 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0|| transformation matrix applied to the mesh vertices. Used to define the local object reference space.
|}

===Type: pointiness===

Contains surface curvature information in vertex alpha channel. 
You can access this information in materials via a hitpointalpha texture. 
The values range from -1 to 1 (float). 
Values from -1 to 0 are concave, while values from 0 to 1 are convex.

[[ Shape:_Pointiness | Examples ]]

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.shapes.<shape name>.type''' || string || "pointiness" || pointiness shape
|-
|'''scene.shapes.<shape name>.source''' || string || ... || pointiness source (a mesh shape)
|}

===Type: strands===

Can be used for hair, fur, grass etc. 
Note that you need to define the camera before defining any strands shapes, because the tesselation process is viewpoint-dependent.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.shapes.<shape name>.type''' || string || "strands" || strands shape
|-
|'''scene.shapes.<shape name>.file''' || string || ... || strands file (''scenes/strands/straight.hair'')
|}

====Strands tessellation methods====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.shapes.<shape name>.tessellation.type''' || string || "ribbon" || ribbon tessellation
|-
|'''scene.shapes.<shape name>.tessellation.usecameraposition''' || bool || 1 || use camera position
|}

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.shapes.<shape name>.tessellation.type''' || string || "ribbonadaptive" || ribbon adaptive tessellation method
|-
|'''scene.shapes.<shape name>.tessellation.adaptative.maxdepth''' || unsigned int || 12 || max tessellation depth
|-
|'''scene.shapes.<shape name>.tessellation.adaptative.error ''' || float || 0.0075 || max tessellation error
|}

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.shapes.<shape name>.tessellation.type''' || string || "solid" || solid tessellation method
|-
|'''scene.shapes.<shape name>.tessellation.solid.sidecount ''' || unsigned int || 12 || tessellation's side count
|}

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.shapes.<shape name>.tessellation.type''' || string || "solidadaptive" || solidadaptive tessellation method
|-
|'''scene.shapes.<shape name>.tessellation.solidadaptive.sidecount ''' || unsigned int || 8 || tessellation's side count
|-
|'''scene.shapes.<shape name>.tessellation.solidadaptive.maxdepth''' || unsigned int || 16 || tessellation's max depth
|-
|'''scene.shapes.<shape name>.tessellation.solidadaptive.error''' || float || 0.05 || tessellation's max error
|}

===Type: group===

Todo.

===Type: displacement===

Todo.

===Type: subdiv===

Todo.

===Type: harlequin===

Todo.

===Type: simplify===

Todo.

===Type: islandaov===

Todo.

===Type: randomtriangleaov===

Todo.

==Light sources==

Check [[Lighting|LuxCoreRender Lighting]] for an high level description and example of the light sources.

===Common parameters===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.gain''' || spectrum || 1.0 1.0 1.0 || intensity of the light
|-
|'''scene.lights.<light name>.transformation''' || matrix 4x4 || 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 || transformation matrix
|-
|'''scene.lights.<light name>.samples''' || int || -1 || the number of shadow ray to trace to compute direct light for this light source. This property is an hint and the render engine can ignore this information. -1 means use the default global value.
|-
|'''scene.lights.<light name>.id''' || int || 0 || the radiance group the light emitted from this material is assigned to.

|-
|'''scene.lights.<light name>.importance''' || float || 1.0 || A hint how often to sample this light compared to other lights
|}

===Type: sun===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "sun" || type of light
|-
|'''scene.lights.<light name>.turbidity''' || float || 2.2 || turbidity can go from 1.0 to 30+. 2-6 are most useful for clear days
|-
|'''scene.lights.<light name>.relsize''' || float || 1.0 || relative size to the sun
|-
|'''scene.lights.<light name>.dir''' || vector || 0.0 0.0 1.0 || direction vector of the sun
|-
|'''scene.lights.<light name>.visibility.indirect.diffuse.enable''' || bool || true || if the light source is visible by indirect rays on diffuse surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.visibility.indirect.glossy.enable''' || bool || true || if the light source is visible by indirect rays on glossy surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.visibility.indirect.specular.enable''' || bool || true || if the light source is visible by indirect rays on specular surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|}

===Type: sky2===

Hosek-Wilkie sky model.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "sky2" || type of light
|-
|'''scene.lights.<light name>.turbidity''' || float || 2.2 || turbidity can go from 1.0 to 30+. 2-6 are most useful for clear days
|-
|'''scene.lights.<light name>.dir''' || vector || 0.0 0.0 1.0 || direction vector of the sun
|-
|'''scene.lights.<light name>.gain''' || vector || ... || gain
|-
|'''scene.lights.<light name>.groundalbedo''' || vector || 0.5 0.5 0.5 || ground albedo
|-
|'''scene.lights.<light name>.visibility.indirect.diffuse.enable''' || bool || true || if the light source is visible by indirect rays on diffuse surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.visibility.indirect.glossy.enable''' || bool || true || if the light source is visible by indirect rays on glossy surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.visibility.indirect.specular.enable''' || bool || true || if the light source is visible by indirect rays on specular surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.ground.enable''' || bool || 1 || enable ground color
|-
|'''scene.lights.<light name>.ground.color''' || vector|| ... || RGB ground color
|}

===Type: infinite===

Spherical lightsource surrounding the scene at infinite distance. 
Used for image based lighting (IBL) and HDR environment lighting if the file is a high dynamic range image.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "infinite" || type of light
|-
|'''scene.lights.<light name>.file''' || string || "image.png" || filename of the environment map
|-
|'''scene.lights.<light name>.gamma''' || float || 2.2 || gamma correction used by the image map
|-
|'''scene.lights.<light name>.storage''' || string || "auto" || environment map storage type ("auto", "byte", "half" or "float")
|-
|'''scene.lights.<light name>.visibility.indirect.diffuse.enable''' || bool || true || if the light source is visible by indirect rays on diffuse surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.visibility.indirect.glossy.enable''' || bool || true || if the light source is visible by indirect rays on glossy surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.visibility.indirect.specular.enable''' || bool || true || if the light source is visible by indirect rays on specular surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.sampleupperhemisphereonly''' || bool || false || an option set to black the lower hemisphere. Mostly useful for shadow catchers.
|}

===Type: point===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "point" || type of light
|-
|'''scene.lights.<light name>.position''' || point || 0.0 0.0 0.0 || position
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.power''' || float || 0.0 || lamp output power in watts. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.efficency''' || float || 0.0 || luminous efficacy in lumens/watt. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|}

===Type: mappoint===

Point light with support for IES files or image maps controlling the strength of light emitted.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "mappoint" || type of light
|-
|'''scene.lights.<light name>.position''' || point || 0.0 0.0 0.0 || position
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.power''' || float || 0.0 || lamp output power in watts. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.efficency''' || float || 0.0 || luminous efficacy in lumens/watt. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.mapfile''' || string || || the name of an optional image map that can be used to scale the emitted light
|-
|'''scene.lights.<light name>.gamma''' || float || 2.2 || gamma value of the image map defined with .mapfile property
|-
|'''scene.lights.<light name>.iesfile''' || string || || a [http://en.wikipedia.org/wiki/Illuminating_Engineering_Society_of_North_America IES] profile of emitted light and the render engine can ignore this information. -1 means use the default global value.
|-
|'''scene.lights.<light name>.iesblob''' || string || || a [http://en.wikipedia.org/wiki/Illuminating_Engineering_Society_of_North_America IES] profile of emitted light embedded in a blob
|-
|'''scene.lights.<light name>.flipz''' || bool || false || flip the IES profile along the Z axis
|-
|'''scene.lights.<light name>.map.width''' || unsigned int || 0 || scale the image or IES map to the specified width. 0 means use the original size
|-
|'''scene.lights.<light name>.map.height''' || unsigned int || 0 || scale the image or IES map to the specified height. 0 means use the original size
|}

===Type: sphere===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "sphere" || type of light
|-
|'''scene.lights.<light name>.position''' || point || 0.0 0.0 0.0 || position
|-
|'''scene.lights.<light name>.radius''' || float || 1.0 || position
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.power''' || float || 0.0 || lamp output power in watts. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.efficency''' || float || 0.0 || luminous efficacy in lumens/watt. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|}

===Type: mapsphere===

Sphere light with support for IES files or image maps controlling the strength of light emitted.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "mapsphere" || type of light
|-
|'''scene.lights.<light name>.position''' || point || 0.0 0.0 0.0 || position
|-
|'''scene.lights.<light name>.radius''' || float || 1.0 || position
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.power''' || float || 0.0 || lamp output power in watts. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.efficency''' || float || 0.0 || luminous efficacy in lumens/watt. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.mapfile''' || string || || the name of an optional image map that can be used to scale the emitted light
|-
|'''scene.lights.<light name>.gamma''' || float || 2.2 || gamma value of the image map defined with .mapfile property
|-
|'''scene.lights.<light name>.iesfile''' || string || || a [http://en.wikipedia.org/wiki/Illuminating_Engineering_Society_of_North_America IES] profile of emitted light and the render engine can ignore this information. -1 means use the default global value.
|-
|'''scene.lights.<light name>.iesblob''' || string || || a [http://en.wikipedia.org/wiki/Illuminating_Engineering_Society_of_North_America IES] profile of emitted light embedded in a blob
|-
|'''scene.lights.<light name>.flipz''' || bool || false || flip the IES profile along the Z axis
|-
|'''scene.lights.<light name>.map.width''' || unsigned int || 0 || scale the image or IES map to the specified width. 0 means use the original size
|-
|'''scene.lights.<light name>.map.height''' || unsigned int || 0 || scale the image or IES map to the specified height. 0 means use the original size
|}

===Type: spot===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "spot" || type of light
|-
|'''scene.lights.<light name>.position''' || point || 0.0 0.0 0.0 || position
|-
|'''scene.lights.<light name>.target''' || point || 0.0 0.0 1.0 || target
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.power''' || float || 0.0 || lamp output power in watts. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.efficency''' || float || 0.0 || luminous efficacy in lumens/watt. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.coneangle''' || float || 30.0 || angle in degrees of the spotlight cone
|-
|'''scene.lights.<light name>.conedeltaangle''' || float || 5.0 || angle at which the spotlight intensity starts to fade from the edge
|}

===Type: projection===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "projection" || type of light
|-
|'''scene.lights.<light name>.position''' || point || 0.0 0.0 0.0 || position
|-
|'''scene.lights.<light name>.target''' || point || 0.0 0.0 1.0 || target
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.power''' || float || 0.0 || lamp output power in watts. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.efficency''' || float || 0.0 || luminous efficacy in lumens/watt. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.fov''' || float || 45.0 || field of view in terms of angular spread along the shorter image axis
|-
|'''scene.lights.<light name>.mapfile''' || string || || filename of the image to project. If not specified, a constat light color will be used.
|-
|'''scene.lights.<light name>.gamma''' || float || 2.2 || gamma value of the image map defined with .mapfile property
|}

===Type: constantinfinite===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "constantinfinite" || type of light
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.visibility.indirect.diffuse.enable''' || bool || true || if the light source is visible by indirect rays on diffuse surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.visibility.indirect.glossy.enable''' || bool || true || if the light source is visible by indirect rays on glossy surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.visibility.indirect.specular.enable''' || bool || true || if the light source is visible by indirect rays on specular surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|}

===Type: sharpdistant===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "sharpdistant" || type of light
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.direction''' || vector || 0.0 0.0 1.0 || direction
|}

===Type: distant===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "distant" || type of light
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.direction''' || vector || 0.0 0.0 1.0 || direction
|-
|'''scene.lights.<light name>.theta''' || float || 10.0 || half angle of the light source in degree. Must be > 0 for soft shadows
|}

===Type: laser===

A light source emitting parallel light rays (like sharpdistant light, but starting inside the scene instead of infinitely far away).

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "laser" || type of light
|-
|'''scene.lights.<light name>.position''' || point || 0.0 0.0 0.0 || position
|-
|'''scene.lights.<light name>.target''' || point || 0.0 0.0 1.0 || target
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.power''' || float || 0.0 || lamp output power in watts. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.efficency''' || float || 0.0 || luminous efficacy in lumens/watt. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.radius''' || float || 0.01 || radius of the laser beam
|}

LuxCore SDL Reference Manual v2.5

2020-11-03T17:52:19Z

Byob: /* Image pipeline */ add OIDN and OptiX denoiser plugins

The scene description language (SDL) is used to configure the renderer and to define objects, materials, textures etc. in the scene. 
The file ending of the render configuration file is ".cfg", for the scene file it's ".scn".

These files are usually created by exporter plugins, e.g. BlendLuxCore. 
This wiki page is primarily a reference for exporter developers, normal end-users should not need to edit cfg/scn files by hand.

Sometimes the API is updated faster than the wiki, in this case you can look at the code directly: https://github.com/LuxCoreRender/LuxCore/tree/master/src/slg/scene

Note that matrices are passed as flat lists in column-major form.

=Render configuration file=

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''resumerendering.filesafe''' || bool || 1 || enable/disable "safe save" mode for resume rendering file. A backup of the output is always valid even in the case of a system failure
|}

==Seed==

The global seed value that is used to generate random numbers. 
Two images rendered with the same seed will have the same noise pattern.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''renderengine.seed''' || unsigned int || 1 || min 1
|}

==Periodic save==

Options related to periodic save operations.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''periodicsave.resumerendering.period''' || float || 0 || save the resume rendering file every specified amount of time (value in seconds). A value <= 0.0 disable the saving
|-
|'''periodicsave.resumerendering.filename''' || string || "resume.rsm" || the name to use to save the rendering resume information periodically
|-
|'''periodicsave.film.period''' || float || 0 || save the Film every specified amount of time (value in seconds). A value <= 0.0 disable the saving
|-
|'''periodicsave.film.filename''' || string || "film.flm" || the name to use to save the film periodically
|-
|'''periodicsave.film.outputs.period''' || float || 600 || save all Film outputs every specified amount of time (value in seconds). A value <= 0.0 disable the saving
|}

==Render Engine==

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''renderengine.type''' || string || "PATHCPU" || engine type
|}

=== CPU Render Engines ===

CPU render engines are written in C++ and don't require OpenCL. All CPU render engines accept the following parameters:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''native.threads.count''' || int || CPU core count || > 0 || > 0 || The number of threads will be used for the rendering
|}

'''The following CPU engines are available:'''

===="PATHCPU"====

A path tracer with full image plane rendering (i.e. supporting Metropolis sampler).

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''path.pathdepth.total''' || int || 6 || > 0 || [1, 16] || Maximum recursion depth of a path
|-
|'''path.pathdepth.diffuse''' || int || 4 || > 0 || [1, 16] ||
|-
|'''path.pathdepth.glossy''' || int || 4 || > 0 || [1, 16] ||
|-
|'''path.pathdepth.specular''' || int || 6 || > 0 || [1, 16] ||
|-
|'''path.russianroulette.depth''' || int || 3 || > 0 || [1, path.maxdepth] || The path depth where Russian Roulette stars to be used
|-
|'''path.russianroulette.cap''' || float || 0.5 || [0.0, 1.0] || [0.0, 1.0] || The threshold over which Russian Roulette is used
|-
|'''path.clamping.variance.maxvalue''' || float || 0.0 || > 0.0 || > 0.0 || Samples brighter than this value are clamped, helps to reduce fireflies. 0.0 = disabled
|-
|'''path.forceblackbackground.enable''' || bool || 0 || 0 or 1 || 0 or 1 || Enable when rendering with transparent film and premultiplied alpha, to avoid artifacts with semi-transparent areas
|}

===="TILEPATHCPU"====
Biased path tracer with many control options and support for tile rendering. 
The sampler must be set to TILEPATHSAMPLER when using this engine.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''path.pathdepth.total''' || int || 6 || > 0 || [1, 16] || Maximum recursion depth of a path
|-
|'''path.pathdepth.diffuse''' || int || 4 || > 0 || [1, 16] ||
|-
|'''path.pathdepth.glossy''' || int || 4 || > 0 || [1, 16] ||
|-
|'''path.pathdepth.specular''' || int || 6 || > 0 || [1, 16] ||
|-
|'''path.russianroulette.depth''' || int || 3 || > 0 || [1, path.maxdepth] || The path depth where Russian Roulette stars to be used
|-
|'''path.russianroulette.cap''' || float || 0.5 || [0.0, 1.0] || [0.0, 1.0] || The threshold over which Russian Roulette is used
|-
|'''path.clamping.variance.maxvalue''' || float || 0.0 || > 0.0 || > 0.0 || Samples brighter than this value are clamped, helps to reduce fireflies. 0.0 = disabled
|-
|'''path.forceblackbackground.enable''' || bool || 0 || 0 or 1 || 0 or 1 || Enable when rendering with transparent film and premultiplied alpha, to avoid artifacts with semi-transparent areas
|-
|'''tilepath.sampling.aa.size''' || int || 3 || > 0 || [1, 13] || All diffuse/glossy/specular samples are multiplied with the squared aa size: final_samples = aa^2 * (diffuse^2 + glossy^2 + specular^2)
|-
|'''tile.size''' || int || 32 || ≥ 8 || [8, 256] || Tile size in pixels
|-
|'''tile.multipass.enable''' || bool || 1 || 0 or 1 || o or 1 || Re-render the image until a halt threshold is met or indefinitely
|-
|'''tile.multipass.convergencetest.threshold''' || float || 6.0 / 256.0 || > 0.0 || [1.0 / 256.0, 6.0 / 256.0] || Target noise level
|-
|'''tile.multipass.convergencetest.threshold.reduction''' || float || 0.0 || [0.0, 1.0] || [0.75, 0.95] || Multiply noise level with this number when all tiles have met the previous noise level. Set to 0 to disable (so rendering will stop at the noise level)
|-
|'''tile.multipass.convergencetest.warmup.count''' || int || 32 || ≥ 0 || [8, 128] || Warm up period for the convergence test expressed in samples per pixel
|}

===="BIDIRCPU"====

A Bidirectional path tracer.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''path.maxdepth''' || int || 5 || > 0 || [1, 16] || Maximum recursion depth of a eye path
|-
|'''light.maxdepth''' || int || 5 || > 0 || [1, 16] || Maximum recursion depth of a light path
|-
|'''path.russianroulette.depth''' || int || 3 || > 0 || [1, path.maxdepth] || The path depth where Russian Roulette starts to be used
|-
|'''path.russianroulette.cap''' || float || 0.5 || [0.0, 1.0] || [0.0, 1.0] || The threshold over which Russian Roulette is used
|}

===="RTPATHCPU"====
Engine optimized for interactive scene editing and camera movement. 
The sampler must be set to RTPATHCPUSAMPLER when using this engine.

Supports the same properties as [[#"PATHCPU" | "PATHCPU"]] plus the following:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''rtpathcpu.zoomphase.size''' || int || 4 || || || render scaled down film for the first few frames after a scene edit (to make interactions more fluid)
|-
|'''rtpathcpu.zoomphase.weight''' || float || 0.1 || || || description: TODO
|}

=== OpenCL Render Engines ===

OpenCL engines can run on GPUs, CPUs and other types of computing devices, they require OpenCL to run. All OpenCL render engines accept the following parameters:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''opencl.platform.index''' || int || -1 || A valid platform index || -1 || Select the OpenCL platform to use. All devices available on all platforms will be used with -1
|-
|'''opencl.cpu.use''' || bool || 1 || 0 or 1 || 0 or 1 || If to use all OpenCL CPU devices available
|-
|'''opencl.gpu.use''' || bool || 1 || 0 or 1 || 0 or 1 || If to use all OpenCL GPU devices available
|-
|'''opencl.cpu.workgroup.size''' || int || 0 || Any valid OpenCL workgroup size || 64 || Set the OpenCL workgroup size, 0 means to use the driver suggested value
|-
|'''opencl.gpu.workgroup.size''' || int || 0 || Any valid OpenCL workgroup size || 64 || Set the OpenCL workgroup size, 0 means to use the driver suggested value
|-
|'''opencl.devices.select''' || string || "" || Any valid selection string || Any valid selection string || Select each OpenCL device to use. It is a string of "0" and "1". "1" means use the device, "0" do not
|}

'''The following OpenCL engines are available:'''

===="PATHOCL"====
OpenCL version of PATHCPU. Supports the same settings as [[#"PATHCPU" | PATHCPU]] plus the following:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''pathocl.pixelatomics.enable''' || bool || 0 || 0 or 1 || 0 or 1 || Enable pixel atomic operation
|-
|'''opencl.task.count''' || int || "AUTO" || "AUTO" or > 0 || [64K, 1024K] || The number of tasks sent to the OpenCL device in one kernel call
|}

===="RTPATHOCL"====

A PATHOCL version optimized for real-time rendering with fixed frame-rate and variable quality. 
The sampler must be set to TILEPATHSAMPLER when using this engine.

Supports the same settings as [[#"PATHOCL" | PATHOCL]] plus the following:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''rtpath.resolutionreduction.preview''' || int || 4 || > 0 || [1, 32] || Render a sample every n x n pixels in the first passes. For instance 4x4 than 2x2 and than always 1x1
|-
|'''rtpath.resolutionreduction.preview.step''' || int || 8 || > 0 || [1, 32] || Each preview step is rendered for n frames
|-
|'''rtpath.resolutionreduction''' || int || 4 || > 0 || [1, 32] || Render a sample every n x n pixels, outside the preview phase, in order to reduce the per frame rendering time
|}

===="TILEPATHOCL"====

OpenCL version of TILEPATHCPU. 
The sampler must be set to TILEPATHSAMPLER when using this engine.

Supports the same settings as [[#"TILEPATHCPU" | TILEPATHCPU]] plus the following:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''tilepathocl.devices.maxtiles''' || int || 16 || ≥ 1 || [1, 32] || Maximum number of tiles to send in a single call to each OpenCL device
|}

==="FILESAVER"===

Saves everything needed to render the scene to the output path, including textures and meshes.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''filesaver.format''' || string || "TXT" || "TXT" for a text SDL format and "BIN" for a single file binary format
|-
|'''filesaver.filename''' || string || "luxcore-exported-scene.bcf" || file name for "BIN" format
|-
|'''filesaver.directory''' || string || "luxcore-exported-scene" || output path for "TXT" format
|-
|'''filesaver.renderengine.type''' || string || "PATHCPU" || render engine to use when rendering the scene after it was saved with FILESAVER. Any engine string from above can be used here.
|}

===Experimental and debugging engines===

'''These engines are experimental, deprecated or are only intended for very specific purposes:'''

===="BIDIRVMCPU"====

Bidir with vertex merging, currently experimental. 
Supports the same settings as [[#"BIDIRCPU" | BIDIRCPU]] plus the following:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''bidirvm.lightpath.count''' || int || 16 * 1024 || > 0 || || Number of lightpaths per pass
|-
|'''bidirvm.startradius.scale''' || float || 0.003 || > 0 || || Photon radius of the first pass
|-
|'''bidirvm.alpha''' || float || 3 || > 0 || [0.0, 1.0] || Photon radius is multiplied with this value after every pass to reduce the radius
|}

===="LIGHTCPU"====

For testing.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''light.maxdepth''' || int || 5 || > 0 || [1, 16] || Maximum recursion depth of a light path
|-
|'''light.russianroulette.depth''' || int || 3 || > 0 || [1, path.maxdepth] || The path depth where Russian Roulette starts to be used
|-
|'''light.russianroulette.cap''' || float || 0.5 || [0.0, 1.0] || [0.0, 1.0] || The threshold over which Russian Roulette is used
|}

==Sampler==

Samplers are used by following render engines:

* LIGHTCPU
* PATHCPU
* BIDIRCPU
* BIDIRVMCPU
* PATHOCL

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''sampler.type''' || string || "SOBOL" || sampler type
|}

The following samplers are available:

==="SOBOL"===

Sampler with sobol pattern.
Parameters:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''sampler.sobol.adaptive.strength''' || float || 0.7 || 0 ≤ x < 0.95 || 0.5 - 0.9 || it sets if the sampler should be more or less adaptive
|}

==="METROPOLIS"===

Metropolis sampler.
Parameters:
{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''sampler.metropolis.largesteprate''' || float || 0.4 || 0 ≤ x ≤ 1 || 0 - 1 || Probability of generating a large sample mutation
|-
|'''sampler.metropolis.maxconsecutivereject''' || int || 512 || x ≥ 0 || 0 - 32768 || Number of consecutive rejects before a next mutation is forced. Low values can cause bias
|-
|'''sampler.metropolis.imagemutationrate''' || float || 0.1 || 0 ≤ x ≤ 1 || 0 - 1 || Maximum distance over the image plane for a small mutation
|}

==="RANDOM"===

Fully random sampler. This sampler is mostly intended for testing purpose.
Parameters:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''sampler.random.adaptive.strength''' || float || 0.7 || 0 ≤ x < 0.95 || 0.5 - 0.9 || it sets if the sampler should be more or less adaptive
|}

==Filter==

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''film.filter.type''' || string || "BLACKMANHARRIS" || || || Type of pixel filter.
|-
|'''film.filter.width''' || float || 2.0 || x > 0.0 || 0.1 - 3.0 || Filter radius in pixels. Does not have an effect on the NONE filter
|-
|'''film.filter.xwidth''' || float || 2.0 || x > 0.0 || 0.1 - 3.0 || Width in pixels. Overwrite '''film.filter.width''' value
|-
|'''film.filter.ywidth''' || float || 2.0 || x > 0.0 || 0.1 - 3.0 || Width in pixels. Overwrite '''film.filter.width''' value
|}

Available filters are:

==="NONE"===

Disable pixel filtering.

==="BOX"===

Box pixel filter. No parameters.

==="GAUSSIAN"===

Gaussian pixel filter.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''film.filter.gaussian.alpha''' || float || 2.0 || x > 0.0 || 0.1 - 10.0 || Gaussian rate of falloff. Lower values give blurrier images.
|}

==="MITCHELL"===

Mitchel pixel filter.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
| '''film.filter.mitchell.b''' || float || 1.0/3.0 || 0.0 ≤ x ≤ 1.0 || 0.0 - 1.0 || B parameter for the mitchell filter in the range
|-
| '''film.filter.mitchell.c''' || float || 1.0/3.0 || 0.0 ≤ x ≤ 1.0 || 0.0 - 1.0 || C parameter for the mitchell filter in the range 0..1
|}

==="MITCHELL_SS"===

Mitchel pixel filter with super-sampling (i.e. image will be filtered first with a grid of 4 pixels for each pixel).

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
| '''film.filter.mitchellss.b''' || float || 1.0/3.0 || 0.0 ≤ x ≤ 1.0 || 0.0 - 1.0 || B parameter for the mitchell filter in the range
|-
| '''film.filter.mitchellss.c''' || float || 1.0/3.0 || 0.0 ≤ x ≤ 1.0 || 0.0 - 1.0 || C parameter for the mitchell filter in the range 0..1
|}

==="BLACKMANHARRIS"===

Blcakman-Harris pixel filter. No parameters.

==Light Strategy==

The direct light sampling strategy is defined by the following property:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''lightstrategy.type''' || string || "LOG_POWER" || "UNIFORM", "POWER", "LOG_POWER" or "DLS_CACHE" || N/A || Direct light sampling strategy
|}

==="UNIFORM"===

"UNIFORM" light strategy samples evenly all light sources.

==="POWER"===

"POWER" light strategy samples the light sources based on their power.

==="LOG_POWER"===

"LOG_POWER" light strategy samples the light sources based on logarithm of their power.

==="DLS_CACHE"===

Build direct light sampling cache to optimize many-lights rendering, beneficial in scenes with multiple light sources with few overlap between their influence areas (e.g. a building with many disconnected rooms and interior lights).

Options for the DLS cache:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''lightstrategy.entry.radius''' || float || 0.0 || || N/A || Entry radius in meters, automatic radius estimation is used if the radius is set to 0
|-
|'''lightstrategy.entry.normalangle''' || float || 25.0 || || N/A ||
|-
|'''lightstrategy.entry.maxpasses''' || int || 1024 || || N/A ||
|-
|'''lightstrategy.entry.convergencethreshold''' || float || 0.05 || || N/A ||
|-
|'''lightstrategy.entry.warmupsamples''' || int || 24 || || N/A ||
|-
|'''lightstrategy.targetcachehitratio''' || float || 0.995 || || N/A ||
|-
|'''lightstrategy.maxdepth''' || int || 4 || || N/A ||
|-
|'''lightstrategy.maxsamplescount''' || int || 10000000 || || N/A ||
|-
|'''lightstrategy.persistent.file''' || string || "" || || N/A ||
|-
|'''lightstrategy.persistent.safesave''' || bool || 1 || || N/A ||

|}

==Accelerator==

The ray/triangle intersection accelerator to use for the rendering is defined by the following properties:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''accelerator.type''' || string || "AUTO" || "AUTO", "BVH", "MBVH", "EMBREE" || "AUTO" || The intersection accelerator. "AUTO" will select the best one available for the current [[LuxRays]] intersection device. "EMBREE" is currently usable only on CPU render engines
|-
|'''accelerator.instances.enable''' || bool || 1 || 0 or 1 || 0 or 1 || Enable instance support (or disable in order to slightly increase rendering speed)
|}

==Epsilon==

Minimum and maximum allowed value for scene epsilon can be define by the following properties:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''scene.epsilon.min''' || float || 1e-5f || Any float value || 1e-6f ≤ x ≤ 1e-1f || Minimum allowed value for scene epsilon
|-
|'''scene.epsilon.max''' || float || 1e-1f || Any float value || 1e-3f ≤ x ≤ 1e+2f || Maximum allowed value for scene epsilon
|}

==Film==

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.safesave''' || bool || 1 || enable "safe save" of Film serialization. A backup of the output is always valid even in the case of a system failure.
|}

===Film OpenCL Options===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.opencl.enable''' || bool || 1 || enable OpenCL film operations
|-
|'''film.opencl.platform''' || unsigned int || -1 || choose which platform will be used by the film operations. (0 is first platform, 1 second and so on. -1 for all)
|-
|'''film.opencl.device''' || unsigned int || -1 || choose which device will be used by the film operations. (0 is first device, 1 second and so on. -1 for first GPU device)
|}

===Film Outputs (aka AOVs)===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.outputs.safesave''' || bool || 1 || enable "safe save" for Film outputs. A backup of the output is always valid even in the case of a system failure
|}

The film object supports many types of outputs (aka AOVs). The complete list of supported output types:

{| class="wikitable" cellspacing="2"
!Name
!Type
|-
|'''RGB''' || HDR
|-
|'''RGBA''' || HDR
|-
|'''RGB_IMAGEPIPELINE''' || HDR/LDR
|-
|'''RGBA_IMAGEPIPELINE''' || HDR/LDR
|-
|'''ALPHA''' || HDR/LDR
|-
|'''DEPTH''' || HDR
|-
|'''POSITION''' || HDR
|-
|'''GEOMETRY_NORMAL''' || HDR
|-
|'''SHADING_NORMAL''' || HDR
|-
|'''MATERIAL_ID''' || LDR
|-
|'''DIRECT_DIFFUSE''' || HDR
|-
|'''DIRECT_GLOSSY''' || HDR
|-
|'''EMISSION''' || HDR
|-
|'''INDIRECT_DIFFUSE''' || HDR
|-
|'''INDIRECT_GLOSSY''' || HDR
|-
|'''INDIRECT_SPECULAR''' || HDR
|-
|'''MATERIAL_ID_MASK''' || HDR/LDR
|-
|'''DIRECT_SHADOW_MASK''' || HDR/LDR
|-
|'''INDIRECT_SHADOW_MASK''' || HDR/LDR
|-
|'''RADIANCE_GROUP''' || HDR/LDR
|-
|'''UV''' || HDR/LDR
|-
|'''RAYCOUNT''' || HDR/LDR
|-
|'''BY_MATERIAL_ID''' || HDR/LDR
|-
|'''IRRADIANCE''' || HDR
|-
|'''OBJECT_ID''' || LDR
|-
|'''OBJECT_ID_MASK''' || HDR/LDR
|-
|'''BY_OBJECT_ID''' || HDR/LDR
|-
|'''SAMPLECOUNT''' || HDR/LDR
|-
|'''CONVERGENCE''' || HDR/LDR
|-
|'''NOISE''' || HDR/LDR
|-
|'''SERIALIZED_FILM''' || N/A
|-
|'''MATERIAL_ID_COLOR''' || HDR/LDR
|}

Outputs are enabled with the following properties:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.outputs.<index>.type''' || string || || Type of output, e.g. "RGBA" or "ALPHA" (see the list above for the available types)
|-
|'''film.outputs.<index>.filename''' || string || || Filename to use when saving the output. The filename should use ".exr" as extension for HDR outputs and ".png" for LDR outputs (see list above for which output is HDR and which LDR)
|-
|'''film.outputs.<index>.id''' || int || || Specify for the following outputs: '''MATERIAL_ID_MASK''', '''RADIANCE_GROUP''', '''BY_MATERIAL_ID''', '''OBJECT_ID_MASK''', '''BY_OBJECT_ID''' (to choose the object ID, material ID or radiance group ID of the output)
|-
|'''film.outputs.<index>.index''' || int || || Specify for an imagepipeline output (RGB_IMAGEPIPELINE or RGBA_IMAGEPIPELINE) to select the imagepipeline of the output. For example, if you have 3 imagepipelines defined, and you want to specify the output of the third imagepipeline, use 2 for the ".index" property of the output
|}

Note that the Bidir engine does not support all AOVs.
Not supported by Bidir are: EMISSION, DIRECT_DIFFUSE, DIRECT_GLOSSY, INDIRECT_DIFFUSE, INDIRECT_GLOSSY, INDIRECT_SPECULAR, DIRECT_SHADOW_MASK, INDIRECT_SHADOW_MASK, IRRADIANCE, RAYCOUNT.

This is the list of output channel data types and sizes:

{| class="wikitable" cellspacing="2"
!Output type
!Data type
!Size
!Description
|-
|RGB||float||film width x film height x 3||R, G, B
|-
|RGB_IMAGEPIPELINE||float||film width x film height x 3||R, G, B
|-
|RGBA||float||film width x film height x 4||R, G, B, A
|-
|ALPHA||float||film width x film height x 1||Alpha value [0, 1]
|-
|DEPTH||float||film width x film height x 1||Camera distance
|-
|POSITION||float||film width x film height x 3||World X, Y, Z
|-
|GEOMETRY_NORMAL||float||film width x film height x 3||Normal vector X, Y, Z
|-
|SHADING_NORMAL||float||film width x film height x 3||Normal vector X, Y, Z
|-
|DIRECT_DIFFUSE||float||film width x film height x 3||Diffuse R, G, B
|-
|DIRECT_GLOSSY||float||film width x film height x 3||Glossy R, G, B
|-
|EMISSION||float||film width x film height x 3||Emission R, G, B
|-
|INDIRECT_DIFFUSE||float||film width x film height x 3||Indirect diffuse R, G, B
|-
|INDIRECT_GLOSSY||float||film width x film height x 3||Indirect glossy R, G, B
|-
|INDIRECT_SPECULAR||float||film width x film height x 3||Indirect specular R, G, B
|-
|MATERIAL_ID_MASK||float||film width x film height x 1||Material mask [0, 1]
|-
|DIRECT_SHADOW_MASK||float||film width x film height x 1||Shadow mask [0, 1]
|-
|INDIRECT_SHADOW_MASK||float||film width x film height x 1||Shadow mask [0, 1]
|-
|RADIANCE_GROUP||float||film width x film height x 3||R, G, B
|-
|UV||float||film width x film height x 2||Texture coordinates U, V
|-
|RAYCOUNT||float||film width x film height x 1||Ray count
|-
|BY_MATERIAL_ID||float||film width x film height x 3||By material ID
|-
|MATERIAL_ID||uint||film width x film height x 1||Material ID
|-
|IRRADIANCE||float||film width x film height x 3||R, G, B
|-
|OBJECT_ID_MASK||float||film width x film height x 1||Object mask [0, 1]
|-
|BY_OBJECT_ID||float||film width x film height x 3||By object ID
|-
|OBJECT_ID||uint||film width x film height x 1||Object ID
|-
|SAMPLECOUNT||uint||film width x film height x 1||Sample count
|-
|CONVERGENCE||float||film width x film height x 1||The distance of each pixel from the convergence threshold
|-
|NOISE||float||film width x film height x 1||The noise estimated for each pixel
|-
|SERIALIZED_FILM||N/A||N/A||The complete Film serialized in binary format
|-
|MATERIAL_ID_COLOR||float||film width x film height x 3||Material ID converted to colors (with anti-aliasing)
|}

===Film Channels===

Film channels are implicitly enabled by declaring film outputs (even if the output is never used). For instance, declaring a "RGBA" output will automatically enable "RADIANCE_PER_PIXEL_NORMALIZED" (and "RADIANCE_PER_SCREEN_NORMALIZED" for BIDIRCPU) and "ALPHA".
The supported channels are:

{| class="wikitable" cellspacing="2"
!Channel type
!Data type
!Size
!Last element is weight ?
!Note
|-
|CHANNEL_RADIANCE_PER_PIXEL_NORMALIZED||float||film width x film height x 4||Yes||One for each radiance group. Eye paths radiance.
|-
|CHANNEL_RADIANCE_PER_SCREEN_NORMALIZED||float||film width x film height x 3||No||One for each radiance group. Light paths radiance. Used only by LIGHTCPU and BIDIRCPU.
|-
|CHANNEL_ALPHA||float||film width x film height x 2||Yes||
|-
|CHANNEL_RGB_IMAGEPIPELINE||float||film width x film height x 3||No||
|-
|CHANNEL_DEPTH||float||film width x film height x 1||No||
|-
|CHANNEL_POSITION||float||film width x film height x 3||No||
|-
|CHANNEL_GEOMETRY_NORMAL||float||film width x film height x 3||No||
|-
|CHANNEL_SHADING_NORMAL||float||film width x film height x 3||No||
|-
|CHANNEL_MATERIAL_ID||u_int||film width x film height x 1||No||
|-
|CHANNEL_DIRECT_DIFFUSE||float||film width x film height x 4||Yes||
|-
|CHANNEL_DIRECT_GLOSSY||float||film width x film height x 4||Yes||
|-
|CHANNEL_EMISSION||float||film width x film height x 4||Yes||
|-
|CHANNEL_INDIRECT_DIFFUSE||float||film width x film height x 4||Yes||
|-
|CHANNEL_INDIRECT_SPECULAR||float||film width x film height x 4||Yes||
|-
|CHANNEL_MATERIAL_ID_MASK||float||film width x film height x 2||Yes||
|-
|CHANNEL_DIRECT_SHADOW_MASK||float||film width x film height x 2||Yes||
|-
|CHANNEL_INDIRECT_SHADOW_MASK||float||film width x film height x 2||Yes||
|-
|CHANNEL_UV||float||film width x film height x 2||No||
|-
|CHANNEL_RAYCOUNT||float||film width x film height||No||
|-
|CHANNEL_BY_MATERIAL_ID||float||film width x film height x 4||Yes||
|-
|CHANNEL_IRRADIANCE||float||film width x film height x 4||Yes||
|-
|CHANNEL_OBJECT_ID||u_int||film width x film height x 1||No||
|-
|CHANNEL_OBJECT_ID_MASK||float||film width x film height x 2||Yes||
|-
|CHANNEL_BY_OBJECT_ID||float||film width x film height x 4||Yes||
|}

This is the list of channels enabled by each output:

{| class="wikitable" cellspacing="2"
!Output
!Enabled channels
|-
|'''RGB''' || CHANNEL_RADIANCE_PER_PIXEL_NORMALIZED, CHANNEL_RADIANCE_PER_SCREEN_NORMALIZED (only for LIGHTCPU and BIDIRCPU)
|-
|'''RGBA''' || CHANNEL_RADIANCE_PER_PIXEL_NORMALIZED, CHANNEL_RADIANCE_PER_SCREEN_NORMALIZED (only for LIGHTCPU and BIDIRCPU), ALPHA
|-
|'''RGB_IMAGEPIPELINE''' || CHANNEL_RADIANCE_PER_PIXEL_NORMALIZED, CHANNEL_RADIANCE_PER_SCREEN_NORMALIZED (only for LIGHTCPU and BIDIRCPU)
|-
|'''RGBA_IMAGEPIPELINE''' || CHANNEL_RADIANCE_PER_PIXEL_NORMALIZED, CHANNEL_RADIANCE_PER_SCREEN_NORMALIZED (only for LIGHTCPU and BIDIRCPU), ALPHA
|-
|'''ALPHA''' || ALPHA
|-
|'''DEPTH''' || DEPTH
|-
|'''POSITION''' || DEPTH, POSITION
|-
|'''GEOMETRY_NORMAL''' || DEPTH, GEOMETRY_NORMAL
|-
|'''SHADING_NORMAL''' || DEPTH, SHADING_NORMAL
|-
|'''MATERIAL_ID''' || DEPTH, MATERIAL_ID
|-
|'''DIRECT_DIFFUSE''' || DIRECT_DIFFUSE
|-
|'''DIRECT_GLOSSY''' || DIRECT_GLOSSY
|-
|'''EMISSION''' || EMISSION
|-
|'''INDIRECT_DIFFUSE''' || INDIRECT_DIFFUSE
|-
|'''INDIRECT_GLOSSY''' || INDIRECT_GLOSSY
|-
|'''INDIRECT_SPECULAR''' || INDIRECT_SPECULAR
|-
|'''MATERIAL_ID_MASK''' || MATERIAL_ID, MATERIAL_ID_MASK
|-
|'''DIRECT_SHADOW_MASK''' || DIRECT_SHADOW_MASK
|-
|'''INDIRECT_SHADOW_MASK''' || INDIRECT_SHADOW_MASK
|-
|'''RADIANCE_GROUP''' || CHANNEL_RADIANCE_PER_PIXEL_NORMALIZED, CHANNEL_RADIANCE_PER_SCREEN_NORMALIZED (only for LIGHTCPU and BIDIRCPU)
|-
|'''UV''' || DEPTH, UV
|-
|'''RAYCOUNT''' || DEPTH, RAYCOUNT
|-
|'''BY_MATERIAL_ID''' || BY_MATERIAL_ID
|-
|'''IRRADIANCE''' || IRRADIANCE
|-
|'''OBJECT_ID''' || DEPTH, OBJECT_ID
|-
|'''OBJECT_ID_MASK''' || OBJECT_ID, OBJECT_ID_MASK
|-
|'''BY_OBJECT_ID''' || BY_OBJECT_ID
|}

Note: CHANNEL_RGB_IMAGEPIPELINE is always enable and the result of running the image pipeline.

===Image pipeline===

It is possible to [http://www.luxrender.net/forum/viewtopic.php?f=8&p=120169#p120169 define multiple image pipelines at the same time]

====Radiance Group====

Radiance groups are used to get only the contribution of a group of lights in the scene. 
Lights can be grouped by setting their [[#Common_parameters | '''.id''']] property to the same number, on materials this is done with the [[#Light_emission | '''.emission.id''']] property. 

Note that the OpenCL engines only support up to 8 radiance groups (one of them is the default group).

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.radiancescales.<id>.globalscale''' || float|| 1 || global weighting of radiance group
|-
|'''film.imagepipelines.<pipeline #>.radiancescales.<id>.temperature ''' || float || 6500.0 || light temperature
|-
|'''film.imagepipelines.<pipeline #>.radiancescales.<id>.rgbscale''' || vector || 1.0 1.0 1.0 || light color
|-
|'''film.imagepipelines.<pipeline #>.radiancescales.radiancescales.<id>.enabled''' || bool || 1 || enable radiance group
|}

====Image pipeline plug-ins====

=====Type: TONEMAP_LINEAR=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "TONEMAP_LINEAR" || linear tonemapping
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.scale''' || float || 1.0 || tonemapping scale
|}

=====Type: TONEMAP_REINHARD02=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "TONEMAP_REINHARD02" || reinhard tonemapping
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.prescale''' || float || 1.0 || reinhard prescale
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.postscale''' || float || 1.2 || reinhard postscale
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.burn''' || float || 3.75 || reinhard burn
|}

=====Type: TONEMAP_AUTOLINEAR=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "TONEMAP_AUTOLINEAR" || automatic linear tonemapping
|}

=====Type: TONEMAP_LUXLINEAR=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "TONEMAP_LUXLINEAR" || linear tonemapping with real camera settings
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.sensitivity''' || float || 100.0 || ISO sensitivity
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.exposure''' || float || 0.001 || exposure time
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.fstop''' || float || 2.8 || f/aperture
|}

=====Type: NOP=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipeline.<pipeline #>.<plugin #>.type''' || string || "NOP" || no parameters tonemapper
|}

=====Type: GAMMA_CORRECTION=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "TONEMAP_LINEAR" || gamma correction
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.value''' || float || 2.2 || gamma value
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.table.size''' || unsigned int || 4096 || resolution
|}

=====Type: OUTPUT_SWITCHER=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "OUTPUT_SWITCHER" || overwrite output
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.channel''' || string || "DEPTH" || channel whose values are used to overwrite
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.index''' || unsigned int || 0 || index
|}

=====Type: GAUSSIANFILTER_3x3=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "GAUSSIANFILTER_3x3" || gaussian filter
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.weight''' || float || 0.15 || blurring weight
|}

=====Type: CAMERA_RESPONSE_FUNC=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || CAMERA_RESPONSE_FUNC || analog camera film simulation
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.name''' || string || "Advantix_100CD" || film type
|}

=====Type: BACKGROUND_IMG=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || BACKGROUND_IMG || show the background image where alpha < 1 (simple compositing)
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.file''' || string || ... || background image path (e.g scenes/simple-mat/sky.exr)
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.gamma''' || float || 2.2 || background image gamma
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.storage ''' || string || auto || background image storage type
|}
Note: When the size of the background image differs from the film size, it will be stretched to fit the film size.

=====Type: BLOOM=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "BLOOM" || bloom effect
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.radius''' || float || 0.07 || how large the bloom effect is in % of the image size (i.e. 1.0 = all image)
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.weight''' || float || 0.25 || how strong the effect is (i.e. 0.0 = nothing, 1.0 = max. strength)
|}

=====Type: VIGNETTING=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "VIGNETTING" || vignetting effect
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.scale''' || float || 0.4 || vignetting strength
|}

=====Type: COLOR_ABERRATION=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "COLOR_ABERRATION" || color aberration effect
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.amount''' || float || 0.005 || color aberration amount
|}

=====Type: MIST=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "MIST" || aerial perspective effect (fake fog)
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.color''' || spectrum|| [1, 1, 1] || mist color
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.amount''' || float || 0.005 || mist amount
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.startdistance''' || float || 0 || distance from camera until where the mist effect has zero effect
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.enddistance''' || float || 10000 || distance from camera from where the mist effect has maximum effect
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.excludebackground''' || bool || false || Do not apply mist effect on pixels with infinite distance to the camera
|}

=====Type: CONTOUR_LINES=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "CONTOUR_LINES" || contour lines for IRRADIANCE AOV
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.range''' || float|| ? || ?
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.scale''' || float || ? || ?
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.steps''' || int || ? || ?
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.zerogridsize''' || int || ? || ?
|}

=====Type: WHITE_BALANCE =====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "WHITE_BALANCE" || White temperature correction
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.temperature''' || unsigned int|| 6500 || Target image temperature in Kelvin
|-
|}

=====Type: COLOR_LUT =====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "COLOR_LUT" || Applies .cube LUT (look-up-table) to the input
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.file''' || string || "lut.cube" || Filepath to a [https://wwwimages2.adobe.com/content/dam/acom/en/products/speedgrade/cc/pdfs/cube-lut-specification-1.0.pdf .cube LUT file]
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.strength''' || float || 1.0 || Linear interpolation between input (0.0) and output (1.0) of the plugin
|-
|}

=====Type: INTEL_OIDN =====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "INTEL_OIDN" || Denoises the image using [https://github.com/OpenImageDenoise/oidn Intel OIDN]
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.filter.type''' || string || "RT" ||
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.oidnmemory''' || int || 6000 || Approximate maximum amount of memory to use in megabytes (actual memory usage may be higher). Limiting memory usage may cause slower denoising due to internally splitting the image into overlapping tiles
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.sharpness''' || float || 0.1 || Linear interpolation between the denoised result (0.0) and the noisy input (1.0)
|-
|}

=====Type: OPTIX_DENOISER =====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "OPTIX_DENOISER" || Denoises the image using the Nvidia OptiX denoiser
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.minspp''' || unsigned int || 0 || Minimum amount of samples to be rendered before the plugin is run (at lower sample numbers, it does not modify the input)
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.sharpness''' || float || 0.1 || Linear interpolation between the denoised result (0.0) and the noisy input (1.0)
|-
|}

===Film Subregion===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.subregion''' || vector || ... || <xstart> <xstop> <ystart> <ystop>
|}

===Rendering halt conditions===

By default, a LuxCore rendering will never stop however you can enable one or multiple halt conditions:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''batch.haltnoisethreshold''' || float || -1.0 || enable image convergence test and stops when the error is under the defined value. Use a value like "n / 256.0" where n is the level of error you are looking for. It may be hard to achieve a level of error smaller than 3.0 / 256.0. -1.0 disables the halt condition.
|-
|'''batch.haltnoisethreshold.warmup''' || unsigned int || 64 || number of average samples per pixel before to start the convergence test
|-
|'''batch.haltnoisethreshold.step''' || unsigned int || 64 || number of average samples per pixel between two tests
|-
|'''batch.haltnoisethreshold.filter.enable''' || bool || 1 || if the CONVERGENCE AOV (generated by the batch.haltnoisethreshold) should be filtered or not with a 3x3 box filter
|-
|'''batch.haltnoisethreshold.stoprendering.enable''' || bool || 1 || Set this to 0 (false) if you only want to use the haltnoisethreshold settings for adaptive sampling in an endless render
|-
|'''batch.haltnoisethreshold.index''' || unsigned int || 0 || Film pipeline index used to estimate noise for stopping
|-
|'''batch.halttime''' || float || 0.0 || number of seconds before stopping the rendering
|-
|'''batch.haltspp''' || unsigned int || 0 || number of average samples per pixel before stopping the rendering
|}

===Noise estimation===

Image noise can be estimated and its result can be used to drive the Sobol and Random samplers to focus its sampling in the noisier regions.
Setting any of these properties will enable the noise estimation.
The adaptiveness strength is a Sampler property.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.noiseestimation.warmup''' || unsigned int || 32 || number of average samples per pixel before to start the convergence test
|-
|'''film.noiseestimation.step''' || unsigned int || 32 || number of average samples per pixel between two tests
|-
|'''film.noiseestimation.filter.scale''' || unsigned int || 4 || Box filter scale used to filter the NOISE AOV (generated by the noise estimation). Set to 0 to disable.
|-
|'''film.noiseestimation.index''' || unsigned int || 0 || Film pipeline index used to estimate noise for adaptive sampling
|-
|}

=Scene file=

==Camera==

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.camera.type''' || string || "perspective" || "perspective", "orthographic" or "environment" (360° panorama mapped in latlong format)
|-
|'''scene.camera.lookat.orig''' || point (float float float) || 0.0 10.0 0.0 || camera location
|-
|'''scene.camera.lookat.target''' || point (float float float) || 0.0 0.0 0.0 || camera target
|-
|'''scene.camera.up''' || vector (float float float) || (0.0, 0.0, 1.0) || camera up vector
|-
|'''scene.camera.fieldofview''' || float || 45.0 || field of view
|-
|'''scene.camera.screenwindow''' || vector || 0.0 1.0 0.0 1.0 || <xstart> <xstop> <ystart> <ystop>
|-
|'''scene.camera.shutteropen''' || float || 0.0 || camera shutter open time (used for motion blur)
|-
|'''scene.camera.shutterclose''' || float || 0.0 || camera shutter close time (used for motion blur)
|-
|'''scene.camera.autovolume.enable''' || bool || true || try automatically to discover scene.camera.volume
|-
|'''scene.camera.volume''' || string || || the initial volume rays will travel in
|}

The camera supports motion blur. See [[ LuxCore_SDL_Reference_Manual_v2.0#Object_Motion_Blur | Object Motion Blur ]]. 
(Only difference being that instead of the prefix '''scene.objects.<object name>''', the prefix '''scene.camera''' is used when setting motion properties of the camera)

==Textures==

Check [[LuxCoreRender_Textures|LuxCoreRender Textures]] for a high level description and examples of the textures.

===Mapping===

Some texture (mostly procedural textures) supports 2D or 3D mapping parameters:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.mapping.type''' || string || "uvmapping2d" || type of mapping
|-
|'''scene.textures.<texture name>.mapping.rotation''' || float || 0.0 || UV rotation (in degrees)
|-
|'''scene.textures.<texture name>.mapping.uvscale''' || UV || 1.0 1.0 || UV scale
|-
|'''scene.textures.<texture name>.mapping.uvdelta''' || UV || 0.0 0.0 || UV translation
|}

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.mapping.type''' || string || "uvmapping3d" || type of mapping
|-
|'''scene.textures.<texture name>.mapping.transformation''' || Matrix4x4 || 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0|| transformation matrix
|}

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.mapping.type''' || string || "globalmapping3d" || type of mapping
|-
|'''scene.textures.<texture name>.mapping.transformation''' || Matrix4x4 || 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0|| transformation matrix
|}

===Type: add===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "add" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant
|}

===Type: subtract===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "subtract" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant
|}

===Type: band===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "band" || type of texture
|-
|'''scene.textures.<texture name>.amount''' || texture || 0.5|| texture name or constant
|-
|'''scene.textures.<texture name>.interpolation''' || string || "linear"|| "linear", "cubic" or "none"
|-
|'''scene.textures.<texture name>.offset[0..n]''' || float || 0.0 || multiple offsets in the range of [0.0, 1.0]
|-
|'''scene.textures.<texture name>.value[0..n]''' || spectrum || 1.0 1.0 1.0 || a value for each offset
|}

===Type: blender_blend===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_blend" || type of texture
|-
|'''scene.textures.<texture name>.progressiontype''' || string || "linear" || linear, quadratic, easing, diagonal, spherical, quadratic_spherical, halo or radial
|-
|'''scene.textures.<texture name>.direction''' || string || "horizontal" || horizontal or vertical
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_clouds===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_clouds" || type of texture
|-
|'''scene.textures.<texture name>.noisetype''' || string || "soft_noise" || hard_noise or soft_noise
|-
|'''scene.textures.<texture name>.noisebasis''' || string || "blender_original" || blender_original, original_perlin, improved_perlin, voronoi_f1, voronoi_f2, voronoi_f3, voronoi_f4, voronoi_f2_f1, voronoi_crackle or cell_noise
|-
|'''scene.textures.<texture name>.noisesize''' || float || 0.25 ||
|-
|'''scene.textures.<texture name>.noisedepth''' || int || 2 ||
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_distortednoise===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_distortednoise" || type of texture
|-
|'''scene.textures.<texture name>.noise_distortion''' || string || "blender_original" || blender_original, original_perlin, improved_perlin, voronoi_f1, voronoi_f2, voronoi_f3, voronoi_f4, voronoi_f2_f1, voronoi_crackle or cell_noise
|-
|'''scene.textures.<texture name>.noisebasis''' || string || "blender_original" || blender_original, original_perlin, improved_perlin, voronoi_f1, voronoi_f2, voronoi_f3, voronoi_f4, voronoi_f2_f1, voronoi_crackle or cell_noise
|-
|'''scene.textures.<texture name>.noisesize''' || float || 0.25 ||
|-
|'''scene.textures.<texture name>.distortion''' || float || 1 ||
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_magic===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_magic" || type of texture
|-
|'''scene.textures.<texture name>.noisedepth''' || int || 2 ||
|-
|'''scene.textures.<texture name>.turbulence''' || float || 5.0 ||
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_marble===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_marble" || type of texture
|-
|'''scene.textures.<texture name>.marbletype''' || string || "soft" || soft, sharp or sharper
|-
|'''scene.textures.<texture name>.turbulence''' || float || 5.0 ||
|-
|'''scene.textures.<texture name>.noisebasis''' || string || "blender_original" || blender_original, original_perlin, improved_perlin, voronoi_f1, voronoi_f2, voronoi_f3, voronoi_f4, voronoi_f2_f1, voronoi_crackle or cell_noise
|-
|'''scene.textures.<texture name>.noisebasis2''' || string || "sin" || sin, saw or tri
|-
|'''scene.textures.<texture name>.noisedepth''' || int || 2 ||
|-
|'''scene.textures.<texture name>.noisesize''' || float || 0.25 ||
|-
|'''scene.textures.<texture name>.noisetype''' || string || "soft_noise" || soft_noise or hard_noise
|-
|'''scene.textures.<texture name>.turbulence''' || float || 5.0 ||
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_musgrave===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_musgrave" || type of texture
|-
|'''scene.textures.<texture name>.musgravetype''' || string || "multifractal" || multifractal, ridged_multifractal, hybrid_multifractal, fBM or hetero_terrain
|-
|'''scene.textures.<texture name>.noisebasis''' || string || "blender_original" || blender_original, original_perlin, improved_perlin, voronoi_f1, voronoi_f2, voronoi_f3, voronoi_f4, voronoi_f2_f1, voronoi_crackle or cell_noise
|-
|'''scene.textures.<texture name>.dimension''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.intensity''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.lacunarity''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.offset''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.gain''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.octaves''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.gain''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.noisesize''' || float || 0.25 ||
|-
|'''scene.textures.<texture name>.noisetype''' || string || "soft_noise" || soft_noise or hard_noise
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_noise===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_noise" || type of texture
|-
|'''scene.textures.<texture name>.noisedepth''' || int || 2 ||
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_stucci===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_stucci" || type of texture
|-
|'''scene.textures.<texture name>.stuccitype''' || string || "plastic" || plastic, wall_in or wall_out
|-
|'''scene.textures.<texture name>.noisebasis''' || string || "blender_original" || blender_original, original_perlin, improved_perlin, voronoi_f1, voronoi_f2, voronoi_f3, voronoi_f4, voronoi_f2_f1, voronoi_crackle or cell_noise
|-
|'''scene.textures.<texture name>.noisetype''' || string || "soft_noise" || soft_noise or hard_noise
|-
|'''scene.textures.<texture name>.noisesize''' || float || 0.25 ||
|-
|'''scene.textures.<texture name>.turbulence''' || float || 5.0 ||
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_wood===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_wood" || type of texture
|-
|'''scene.textures.<texture name>.woodtype''' || string || "bands" || bands, rings, bandnoise or ringnoise
|-
|'''scene.textures.<texture name>.noisebasis''' || string || "blender_original" || blender_original, original_perlin, improved_perlin, voronoi_f1, voronoi_f2, voronoi_f3, voronoi_f4, voronoi_f2_f1, voronoi_crackle or cell_noise
|-
|'''scene.textures.<texture name>.noisebasis2''' || string || "sin" || sin, saw or tri
|-
|'''scene.textures.<texture name>.noisetype''' || string || "soft_noise" || soft_noise or hard_noise
|-
|'''scene.textures.<texture name>.noisesize''' || float || 0.25 ||
|-
|'''scene.textures.<texture name>.turbulence''' || float || 5.0 ||
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_voronoi===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_voronoi" || type of texture
|-
|'''scene.textures.<texture name>.intensity''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.distmetric''' || string || "actual_distance" || actual_distance, distance_squared, manhattan, chebychev, minkowski_half, minkowski_four or minkowski
|-
|'''scene.textures.<texture name>.w1''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.w2''' || float || 0.0 ||
|-
|'''scene.textures.<texture name>.w3''' || float || 0.0 ||
|-
|'''scene.textures.<texture name>.w4''' || float || 0.0 ||
|-
|'''scene.textures.<texture name>.noisesize''' || float || 0.25 ||
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: brick===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "brick" || type of texture
|-
|'''scene.textures.<texture name>.bricktex''' || texture || 1.0 1.0 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.mortartex''' || texture || 0.2 0.2 0.2 || texture name or constant
|-
|'''scene.textures.<texture name>.brickmodtex''' || texture || 1.0 1.0 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.brickmodbias''' || float || 0.0 || With bias = -1, only the bricktex is used for the brick color. With bias between -1 and 1, a pseudo-random interpolation between bricktex and brickmodtex is used as brick color. With bias = 1, only the brickmodtex is used for the brick color.
|-
|'''scene.textures.<texture name>.brickbond''' || string || "running" || "flemish", "english", "herringbone", "basket" or "chain link"
|-
|'''scene.textures.<texture name>.brickwidth''' || float || 0.3 || brick width
|-
|'''scene.textures.<texture name>.brickheight''' || float || 0.1 || brick height
|-
|'''scene.textures.<texture name>.brickdepth''' || float || 0.15 || brick depth
|-
|'''scene.textures.<texture name>.mortarsize''' || float || 0.01 ||mortar size
|-
|'''scene.textures.<texture name>.brickrun''' || float || 0.75 || brick run
|}

This texture supports 3D mapping.

===Type: checkerboard3d===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "checkerboard3d" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 0.0 || texture name or constant
|}

This texture supports 3D mapping.

===Type: checkerboard2d===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "checkerboard2d" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 0.0 || texture name or constant
|}

This texture supports 2D mapping.

===Type: constfloat1===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "constfloat1" || type of texture
|-
|'''scene.textures.<texture name>.value''' || float || 1.0 || constant value
|}

===Type: constfloat3===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "constfloat3" || type of texture
|-
|'''scene.textures.<texture name>.value''' || spectrum || (1.0, 1.0, 1.0) || RGB constant value
|}

===Type: densitygrid===

You can use ".data", ".data3" or ".openvdb.file" to define the 3D grid values.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "densitygrid" || type of texture
|-
|'''scene.textures.<texture name>.nx''' || unsigned int || || grid x size
|-
|'''scene.textures.<texture name>.ny''' || unsigned int || || grid y size
|-
|'''scene.textures.<texture name>.nz''' || unsigned int || || grid z size
|-
|'''scene.textures.<texture name>.wrap''' || string || "repeat" || select the type of grid wrapping mode: "repeat", "black", "white", "clamp"
|-
|'''scene.textures.<texture name>.wrap''' || string || "repeat" || select the type of grid wrapping mode: "repeat", "black", "white", "clamp"
|-
|'''scene.textures.<texture name>.storage''' || string || "half" || select the type of memory storage: "auto", "byte", "half", "float"
|-
|'''scene.textures.<texture name>.data''' || float || || vector grid values (total count: nx * ny * nz)
|-
|'''scene.textures.<texture name>.data3''' || float || || vector grid values (total count: nx * ny * nz * 3)
|-
|'''scene.textures.<texture name>.openvdb.file''' || string || || OpenVDB file name
|-
|'''scene.textures.<texture name>.openvdb.grid''' || string || || OpenVDB grid name to read from the file
|}

===Type: dots===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "dots" || type of texture
|-
|'''scene.textures.<texture name>.inside''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.outside''' || texture || 0.0 || texture name or constant
|}

This texture supports 2D mapping.

===Type: fbm===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "fbm" || type of texture
|-
|'''scene.textures.<texture name>.octaves''' || int || 8 || noise octaves
|-
|'''scene.textures.<texture name>.roughness''' || float || 0.5 || noise roughness
|}

This texture supports 3D mapping.

===Type: fresnelapproxk===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "fresnelapproxk" || type of texture
|-
|'''scene.textures.<texture name>.texture''' || texture || (0.5, 0.5, 0.5) || texture name or constant
|}

===Type: fresnelapproxn===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "fresnelapproxn" || type of texture
|-
|'''scene.textures.<texture name>.texture''' || texture || (0.5, 0.5, 0.5) || texture name or constant
|}

===Type: hitpointalpha===

Use the value obtained by interpolating triangle vertices alphas.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "hitpointalpha" || type of texture
|}

===Type: hitpointcolor===

Use the color obtained by interpolating triangle vertices colors.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "hitpointcolor" || type of texture
|}

===Type: hitpointgrey===

Use the value obtained by interpolating triangle vertices colors, mapped to a float value (RGB converted into greyscale).

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "hitpointgrey" || type of texture
|-
|'''scene.textures.<texture name>.channel''' || int || -1 || the index of the RGB channel to use. -1 means the luminance of the RGB value
|}

===Type: hsv===

Hue saturation value manipulation.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "hsv" || type of texture
|-
|'''scene.textures.<texture name>.texture''' || texture || 0 0 0 || input color that will be manipulated
|-
|'''scene.textures.<texture name>.hue''' || texture || 0.5 || shift in hue (range: 0..1)
|-
|'''scene.textures.<texture name>.saturation''' || texture || 1.0 || saturation (range: 0..inf)
|-
|'''scene.textures.<texture name>.value''' || texture || 1.0 || brightness multiplier (range: 0..inf)
|}

===Type: imagemap===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "imagemap" || type of texture
|-
|'''scene.textures.<texture name>.file''' || string || "image.png" || name of the image file
|-
|'''scene.textures.<texture name>.gamma''' || float || 2.2 || gamma correction value used in the image
|-
|'''scene.textures.<texture name>.gain''' || float || 1.0 || image values are multiplied by gain value
|-
|'''scene.textures.<texture name>.storage''' || string || "auto" || select the type of memory storage: "auto", "byte", "half", "float"
|-
|'''scene.textures.<texture name>.wrap''' || string || "repeat" || select the type of image map wrapping mode: "repeat", "black", "white", "clamp"
|-
|'''scene.textures.<texture name>.channel''' || string || "default" || extract from the image only the selected channels: "default", "red", "green", "blue", "alpha", "mean", "colored_mean", "rgb"
|}

===Type: normalmap===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "normalmap" || type of texture
|-
|'''scene.textures.<texture name>.texture''' || texture || 0 0 0 || input. Is treated as an XYZ vector in tangent space.
|-
|'''scene.textures.<texture name>.scale''' || float || 1.0 || multiplier for adjusting normalmap height
|}

===Type: marble===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "marble" || type of texture
|-
|'''scene.textures.<texture name>.octaves''' || int || 8 || noise octaves
|-
|'''scene.textures.<texture name>.roughness''' || float || 0.5 || noise roughness
|-
|'''scene.textures.<texture name>.scale''' || float || 1.0 || marble scale
|-
|'''scene.textures.<texture name>.variation''' || float || 0.2 || marble variation
|}

This texture supports 3D mapping.

===Type: mix===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "mix" || type of texture
|-
|'''scene.textures.<texture name>.amount''' || texture || 0.5 || texture name or constant
|-
|'''scene.textures.<texture name>.texture1''' || texture || 0.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant
|}

===Type: scale===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "scale" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant
|}

===Type: uv===

This procedural texture has no parameters aside from the support of 2D mapping.

===Type: windy===

This procedural texture has no parameters aside from the support of 3D mapping.

===Type: wood===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "wood" || type of texture
|-
|'''scene.textures.<texture name>.woodtype''' || string || "bands" || "bands", "rings", "bandnoise" or "ringnoise"
|-
|'''scene.textures.<texture name>.noisebasis2''' || string || "sin" || "sin", "saw" or "tri"
|-
|'''scene.textures.<texture name>.noisetype''' || string || "soft_noise" || "soft_noise" or "hard_noise"
|-
|'''scene.textures.<texture name>.noisesize''' || float || 0.25 || noise size
|-
|'''scene.textures.<texture name>.turbulence''' || float || 5.0 || noise turbulence
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 || bright
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 || contrast
|}

This texture supports 3D mapping.

===Type: wrinkled===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "wrinkled" || type of texture
|-
|'''scene.textures.<texture name>.octaves''' || int || 8 || noise octaves
|-
|'''scene.textures.<texture name>.roughness''' || float || 0.5 || noise roughness
|}

This texture supports 3D mapping.

===Type: abs===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "abs" || type of texture
|-
|'''scene.textures.<texture name>.texture''' || texture || 1.0 || texture name or constant
|}

===Type: clamp===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "clamp" || type of texture
|-
|'''scene.textures.<texture name>.texture''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.min''' || float || 0.0 || lower boundary of the clamping
|-
|'''scene.textures.<texture name>.max''' || float || 1.0 || upper boundary of the clamping
|}

===Type: divide===

Note: If texture2 (the divisor) is 0, 0 is returned.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "divide" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant (dividend)
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant (divisor)
|}

===Type: remap===

This texture brings the value from the source range into the target range.

Note: The value is clamped into source range before performing the remap operation, and the resulting number is also clamped into the target range.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "remap" || type of texture
|-
|'''scene.textures.<texture name>.value''' || texture || 0.5 || texture name or constant
|-
|'''scene.textures.<texture name>.sourcemin''' || texture || 0.0 || texture name or constant
|-
|'''scene.textures.<texture name>.sourcemax''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.targetmin''' || texture || 0.0 || texture name or constant
|-
|'''scene.textures.<texture name>.targetmax''' || texture || 1.0 || texture name or constant
|}

===Type: objectid===

Raw object ID (range 0 to 0xfffffffe).

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "objectid" || type of texture
|}

===Type: objectidcolor===

Object ID interpreted as color. 
The object ID is a 4 byte unsigned int. To convert to color, the lower three bytes are interpreted as r, g, b values (each range 0 to 255). The highest byte is ignored.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "objectidcolor" || type of texture
|}

===Type: objectidnormalized===

Normalized object ID (range 0 to 1).

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "objectidnormalized" || type of texture
|}

===Type: dotproduct ===

Dot product of the two input vectors.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "dotproduct" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant
|}

===Type: power ===

pow(base, exponent)

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "power" || type of texture
|-
|'''scene.textures.<texture name>.base''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.exponent''' || texture || 1.0 || texture name or constant
|}

===Type: lessthan ===

returns 1 if texture1 < texture2, 0 if otherwise.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "lessthan" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant
|}

===Type: greaterthan ===

returns 1 if texture1 > texture2, 0 if otherwise.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "greaterthan" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant
|}

===Type: shadingnormal ===

Returns the shading normal of the mesh at the hitpoint.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "shadingnormal" || type of texture
|}

===Type: position ===

Returns the position of the hitpoint.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "position" || type of texture
|}

===Type: splitfloat3 ===

Extract a channel from a float3 texture. Can for example be used to get the R, G or B channel of a color texture, or to get the X, Y or Z components of a vector texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "splitfloat3" || type of texture
|-
|'''scene.textures.<texture name>.texture''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.channel''' || int || 0 || the channel to get from the input texture. 0 for first channel, 1 for second, 2 for third channel
|}

===Type: makefloat3 ===

Combine three float textures into one float3 texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "makefloat3" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture3''' || texture || 1.0 || texture name or constant
|}

===Type: blackbody===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blackbody" || type of texture
|-
|'''scene.textures.<texture name>.temperature''' || float || 6500 || emission temperature
|-
|'''scene.textures.<texture name>.normalize''' || bool || false || normalize the output
|}

===Type: irregulardata===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "irregulardata" || type of texture
|-
|'''scene.textures.<texture name>.wavelengths''' || vector || 580.0 620.0 660.0|| wavelenghts
|-
|'''scene.textures.<texture name>.data''' || vector || 0.0 0.000015 0.0|| data (length should match wavelength's length)
|}

===Type: lampspectrum===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "lampspectrum" || type of texture
|-
|'''scene.textures.<texture name>.name''' || string || "Daylight" || lamp light spectrum
|}

===Type: Fresnel Textures===

Textures for loading optical data

====Type: fresnelcolor====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || fresnelcolor || type of texture
|-
|'''scene.textures.<texture name>.kr''' || vector || 0.5 0.0 0.0 || reflection color
|}

====Type: fresnelpreset====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || fresnelpreset || type of texture
|-
|'''scene.textures.<texture name>.name''' || string || aluminium || fresnel preset ("aluminium", "silver", "copper", "gold" or "amorphous carbon")
|}

====Type: fresnelsopra====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || fresnelpreset || type of texture
|-
|'''scene.textures.<texture name>.file''' || string || ... || nk file path (e.g scenes/luxball/Au.nk)
|}

====Type: fresnelluxpop====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || fresnelpreset || type of texture
|-
|'''scene.textures.<texture name>.file''' || string || ... || nk file path (e.g scenes/luxball/Cr.nk)
|}

====Type: distort====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || distort || type of texture
|-
|'''scene.textures.<texture name>.texture''' || texture || 0.0 || texture name or constant; input texture
|-
|'''scene.textures.<texture name>.offset''' || texture || 0.0 || texture name or constant; offset to add to the hitpoint coordinates and UV values before evaluating the input texture
|-
|'''scene.textures.<texture name>.strength''' || float || 1.0 || strength multiplier, is multiplied with the offset
|}

==Volumes==

Check [[LuxCoreRender_Volumes|LuxCoreRender Volumes]] for a high level description and examples of the volumes.

All volumes share these properties

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.volumes.<volume name>.type''' || string || clear || volume type
|-
|'''scene.volumes.<volume name>.priority''' || unsigned int|| 0|| volume priority (when volumes overlap, the one with highest priority overrides the others)
|-
|'''scene.volumes.<volume name>.ior''' || texture|| ... || index of refraction
|-
|'''scene.volumes.<volume name>.absorption''' || texture || ... || absorption texture
|-
|'''scene.volumes.<volume name>.emission ''' || texture || ... || emission
|-
|'''scene.volumes.<volume name>.emission.id ''' || unsigned int || ... || emission ID
|}

===Volume: Clear===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.volumes.<volume name>.type''' || string || clear || volume type
|}

===Volume: Homogeneous===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.volumes.<volume name>.type''' || string || homogeneous|| volume type
|-
|'''scene.volumes.<volume name>.scattering''' || texture || ... || scattering texture
|-
|'''scene.volumes.<volume name>.asymmetry''' || texture || ... || asymmetry texture
|-
|'''scene.volumes.<volume name>.multiscattering''' || bool || ... || multiscattering
|}

===Volume: Heterogeneous===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.volumes.<volume name>.type''' || string || heterogeneous || volume type
|-
|'''scene.volumes.<volume name>.scattering''' || texture || ... || scattering texture
|-
|'''scene.volumes.<volume name>.asymmetry''' || texture || ... || asymmetry texture
|-
|'''scene.volumes.<volume name>.multiscattering''' || bool || ... || multiscattering
|-
|'''scene.volumes.<volume name>.steps.size''' || float || ... || step size
|-
|'''scene.volumes.<volume name>.steps.maxcount''' || unsigned int || ... || step maximum count
|}

==Materials==

Check [[LuxCoreRender_Materials|LuxCoreRender Materials]] for a high level description and examples of the materials.

===Common properties===

Common material properties:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.bumptex''' || texture || || texture to use for the bump mapping
|-
|'''scene.materials.<material name>.normaltex''' || texture || || texture to use for the normal mapping
|-
|'''scene.materials.<material name>.samples''' || int || -1 || number of rays used to sample this material. -1 means use the default global value. This property is an hint and the render engine can ignore this information.
|-
|'''scene.materials.<material name>.visibility.indirect.diffuse.enable''' || bool || true || if this material is visible in indirect rays. This property is an hint and the render engine can ignore this information.
|-
|'''scene.materials.<material name>.visibility.indirect.glossy.enable''' || bool || true || if this material is visible in indirect rays. This property is an hint and the render engine can ignore this information.
|-
|'''scene.materials.<material name>.visibility.indirect.specular.enable''' || bool || true || if this material is visible in indirect rays. This property is an hint and the render engine can ignore this information.
|-
|'''scene.materials.<material name>.bumpsamplingdistance''' || float || 0.001 || set the offset used to sample bump/normal mapping.
|-
|'''scene.materials.<material name>.volume.interior''' || string || vol1 || name of interior volume (for volume rendering)
|-
|'''scene.materials.<material name>.volume.exterior''' || string || vol2 || name of exterior volume (for volume rendering)
|-
|'''scene.materials.<material name>.id''' || int|| ... || material id
|-
|'''scene.materials.<material name>.transparency''' || texture || 1.0 || transparency of the material. 1 for opaque, 0 for fully transparent
|-
|'''scene.materials.<material name>.shadowcatcher.enable''' || bool || false || If true, the material will be transparent where hit by direct light and opaque otherwise (alpha transparency). Used for compositing.
|}

====Normal maps====
Normal maps are set first as a texture type and then assigned to the material. For example:

<blockquote><pre>
scene.textures.normmap.type = imagemap
scene.textures.normmap.file = scenes/bump/normal.png
scene.textures.normmap.gamma = 1

scene.materials.mat_white.type = matte
scene.materials.mat_white.kd = 0.8 0.8 0.8
scene.materials.mat_white.normaltex = normmap
</pre></blockquote>

====Light emission====

All materials can emit light:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.emission''' || texture || 0.0 0.0 0.0 || color of the emitted light
|-
|'''scene.materials.<material name>.emission.gain''' || spectrum || 1.0 1.0 1.0 || multiplier for lamp brigthness
|-
|'''scene.materials.<material name>.emission.power''' || float || 0.0 || lamp output power in watts. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.materials.<material name>.emission.efficency''' || float || 0.0 || luminous efficacy in lumens/watt. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.materials.<material name>.emission.mapfile''' || string || || the name of an optional image map that can be used to scale the emitted light
|-
|'''scene.materials.<material name>.emission.gamma''' || float || 2.2 || gamma value of the image map defined with .mapfile property
|-
|'''scene.materials.<material name>.emission.iesfile''' || string || || a [http://en.wikipedia.org/wiki/Illuminating_Engineering_Society_of_North_America IES] profile of emitted light
|-
|'''scene.materials.<material name>.emission.iesblob''' || blob || || a [http://en.wikipedia.org/wiki/Illuminating_Engineering_Society_of_North_America IES] profile of emitted light embedded in a blob
|-
|'''scene.materials.<material name>.emission.flipz''' || bool || false || flip the IES profile along the Z axis
|-
|'''scene.materials.<material name>.emission.samples''' || int || -1 || the number of shadow ray to trace to compute direct light from this material. This property is an hint and the render engine can ignore this information. -1 means use the default global value.
|-
|'''scene.materials.<material name>.emission.map.width''' || unsigned int || 0 || scale the image or IES map to the specified width. 0 means use the original size
|-
|'''scene.materials.<material name>.emission.map.height''' || unsigned int || 0 || scale the image or IES map to the specified height. 0 means use the original size
|-
|'''scene.materials.<material name>.emission.id''' || int || 0 || the radiance group the light emitted from this material is assigned to.
|-
|'''scene.materials.<material name>.emission.theta''' || float || 90.0 || How directional the light is emitted, set as the half-angle of the light source. Default is 90°. Smaller values mean that more light is emitted in the direction of the face normals and less to the sides.
|-
|'''scene.materials.<material name>.emission.importance''' || float || 1.0 || A hint how often to sample this light source compared to other lights
|}

===Type: archglass===

This material should be used to replace glass material of windows when rendering architectural interiors. It allows direct light to pass trough.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "archglass" || type of material
|-
|'''scene.materials.<material name>.kr''' || texture || 1.0 1.0 1.0 || texture or constant reflected color of the material
|-
|'''scene.materials.<material name>.kt''' || texture || 1.0 1.0 1.0 || texture or constant transmitted color of the material
|-
|'''scene.materials.<material name>.interiorior''' || texture || 1.5 || inside texture or constant index of refraction (only for volume-less rendering)
|-
|'''scene.materials.<material name>.exteriorior''' || texture || 1.0 || outside texture or constant index of refraction (only for volume-less rendering)
|-
|'''scene.materials.<material name>.filmthickness''' || texture || none || thickness (in nanometers) of a [https://en.wikipedia.org/wiki/Thin-film_interference thin-film coating] on the surface. This property is optional, if it is not defined, the coating is disabled.
|-
|'''scene.materials.<material name>.filmior''' || texture || none || Refractive index of the thin-film coating. This property is optional, if it is not defined, the coating is disabled.
|}

===Type: carpaint===

Car Paint is an advanced glossy material, simulating a diffuse surface with mutliple reflective coatings.

The available presets for the carpaint material are:

*"ford f8"
*"polaris silber"
*"opel titan"
*"bmw339"
*"2k acrylack"
*"white"
*"blue"
*"blue matte"

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "carpaint" || type of material
|-
|'''scene.materials.<material name>.preset''' || string || "ford f8" || one of the avilable presets
|-
|'''scene.materials.<material name>.ka''' || texture || 0.0 0.0 0.0 || absorption color
|-
|'''scene.materials.<material name>.d''' || texture || 0.0 || absorption depth
|-
|'''scene.materials.<material name>.kd''' || texture || 0.0 0.0 0.0 || diffuse color
|-
|'''scene.materials.<material name>.ks1''' || texture || 0.0 0.0 0.0 || specular color - layer 1
|-
|'''scene.materials.<material name>.ks2''' || texture || 0.0 0.0 0.0 || specular color - layer 2
|-
|'''scene.materials.<material name>.ks3''' || texture || 0.0 0.0 0.0 || specular color - layer 3
|-
|'''scene.materials.<material name>.r1''' || texture || 0.0 0.0 0.0 || fresnel effect strength - layer 1
|-
|'''scene.materials.<material name>.r2''' || texture || 0.0 0.0 0.0 || fresnel effect strength - layer 2
|-
|'''scene.materials.<material name>.r3''' || texture || 0.0 0.0 0.0 || fresnel effect strength - layer 3
|-
|'''scene.materials.<material name>.m1''' || texture || 0.0 0.0 0.0 || roughness - layer 1
|-
|'''scene.materials.<material name>.m2''' || texture || 0.0 0.0 0.0 || roughness - layer 2
|-
|'''scene.materials.<material name>.m3''' || texture || 0.0 0.0 0.0 || roughness - layer 3
|}

===Type: cloth===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "cloth" || type of material
|-
|'''scene.materials.<material name>.preset''' || string || "denim" || denim, silk_charmeuse, silk_shantung, cotton_twill, wool_garbardine or polyester_lining_cloth
|-
|'''scene.materials.<material name>.weft_kd''' || texture || 0.5 0.5 0.5 || coefficient of diffuse reflection in one weave direction
|-
|'''scene.materials.<material name>.weft_ks''' || texture || 0.5 0.5 0.5 || coefficient of specular reflection in one weave direction
|-
|'''scene.materials.<material name>.warp_kd''' || texture || 0.5 0.5 0.5 || coefficient of diffuse reflection in the opposite weave direction
|-
|'''scene.materials.<material name>.warp_ks''' || texture || 0.5 0.5 0.5 || coefficient of specular reflection in the opposite weave direction
|-
|'''scene.materials.<material name>.repeat_u''' || float || 100.0 || thread count in the u direction
|-
|'''scene.materials.<material name>.repeat_v''' || float || 100.0 || thread count in the v direction
|}

===Type: disney===

For more details, refer to the [https://disney-animation.s3.amazonaws.com/library/s2012_pbs_disney_brdf_notes_v2.pdf original paper].

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "disney" || type of material
|-
|'''scene.materials.<material name>.basecolor''' || texture || 0.5 0.5 0.5 || Base color
|-
|'''scene.materials.<material name>.subsurface''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.roughness''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.metallic''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.specular''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.speculartint''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.clearcoat''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.clearcoatgloss''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.anisotropic''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.sheen''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.sheentint''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.filmamount''' || texture || none || Linear interpolation between no film (0) and full film effect (1) for artistic control. This property is optional, if it is not defined, the coating is disabled.
|-
|'''scene.materials.<material name>.filmthickness''' || texture || none || thickness (in nanometers) of a [https://en.wikipedia.org/wiki/Thin-film_interference thin-film coating] on the surface. This property is optional, if it is not defined, the coating is disabled.
|-
|'''scene.materials.<material name>.filmior''' || texture || none || Refractive index of the thin-film coating. This property is optional, if it is not defined, the coating is disabled.
|}

===Type: glass===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "glass" || type of material
|-
|'''scene.materials.<material name>.kr''' || texture || 1.0 || texture or constant reflected color of the material
|-
|'''scene.materials.<material name>.kt''' || texture || 1.0 || texture or constant transmitted color of the material
|-
|'''scene.materials.<material name>.interiorior''' || texture || 1.5 || inside texture or constant index of refraction (only for volume-less rendering)
|-
|'''scene.materials.<material name>.exteriorior''' || texture || 1.0 || outside texture or constant index of refraction (only for volume-less rendering)
|-
|'''scene.materials.<material name>.cauchyb''' || texture || 0.0 || if defined and > 0.0, enable dispersion. The value is the B term of the [https://en.wikipedia.org/wiki/Cauchy%27s_equation Cauchy's equation]
|-
|'''scene.materials.<material name>.filmthickness''' || texture || none || thickness (in nanometers) of a [https://en.wikipedia.org/wiki/Thin-film_interference thin-film coating] on the surface. This property is optional, if it is not defined, the coating is disabled.
|-
|'''scene.materials.<material name>.filmior''' || texture || none || Refractive index of the thin-film coating. This property is optional, if it is not defined, the coating is disabled.
|}

===Type: glossy2===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "glossy2" || type of material
|-
|'''scene.materials.<material name>.kd''' || texture || 0.5 0.5 0.5 || texture or constant diffuse color of the material
|-
|'''scene.materials.<material name>.ks''' || texture || 0.5 0.5 0.5 || texture or constant specular color of the material
|-
|'''scene.materials.<material name>.uroughness''' || texture || 0.1 || texture or constant roughness value along u coordinate of the material
|-
|'''scene.materials.<material name>.vroughness''' || texture || 0.1 || texture or constant roughness value along v coordinate of the material
|-
|'''scene.materials.<material name>.ka''' || texture || 0.0 0.0 0.0 || texture or constant value of coefficient of absorption of the coating layer
|-
|'''scene.materials.<material name>.d''' || texture || 0.0 || texture or constant value of the depth (thickness) of the coating layer for absorption effects. (0 = disables)
|-
|'''scene.materials.<material name>.index''' || texture || 0.0 0.0 0.0 || IOR of the coating. IOR overrides color Ks if both are specified
|-
|'''scene.materials.<material name>.multibounce''' || bool || false || simulation of asperity (velvet-like reflection) on the glossy surface
|}

===Type: glossytranslucent===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "glossytranslucent" || type of material
|-
|'''scene.materials.<material name>.kd''' || texture || 0.5 0.5 0.5 || texture or constant diffuse color of the material
|-
|'''scene.materials.<material name>.kt''' || texture || 0.5 0.5 0.5 || texture or constant transmission color of the material
|-
|'''scene.materials.<material name>.ks''' || texture || 0.5 0.5 0.5 || texture or constant specular color of the material
|-
|'''scene.materials.<material name>.ks_bf''' || texture || 0.5 0.5 0.5 || texture or constant backface specular color of the material
|-
|'''scene.materials.<material name>.uroughness''' || texture || 0.1 || texture or constant roughness value along u coordinate of the material
|-
|'''scene.materials.<material name>.uroughness_bf''' || texture || 0.1 || texture or constant backface roughness value along u coordinate of the material
|-
|'''scene.materials.<material name>.vroughness''' || texture || 0.1 || texture or constant roughness value along v coordinate of the material
|-
|'''scene.materials.<material name>.vroughness_bf''' || texture || 0.1 || texture or constant backface roughness value along v coordinate of the material
|-
|'''scene.materials.<material name>.ka''' || texture || 0.0 0.0 0.0 || texture or constant value of coefficient of absorption of the coating layer
|-
|'''scene.materials.<material name>.ka_bf''' || texture || 0.0 0.0 0.0 || texture or constant value of backface coefficient of absorption of the coating layer
|-
|'''scene.materials.<material name>.d''' || texture || 0.0 || texture or constant value of the depth (thickness) of the coating layer for absorption effects. (0 = disables)
|-
|'''scene.materials.<material name>.d_bf''' || texture || 0.0 || texture or constant value of the backface depth (thickness) of the coating layer for absorption effects. (0 = disables)
|-
|'''scene.materials.<material name>.index''' || texture || 0.0 0.0 0.0 || IOR of the coating. IOR overrides color Ks if both are specified
|-
|'''scene.materials.<material name>.index_bf''' || texture || 0.0 0.0 0.0 || IOR of the backface coating. IOR overrides color Ks if both are specified
|-
|'''scene.materials.<material name>.multibounce''' || bool || false || simulation of asperity (velvet-like reflection) on the glossy surface
|-
|'''scene.materials.<material name>.multibounce_bf''' || bool || false || backface simulation of asperity (velvet-like reflection) on the glossy surface
|}

===Type: glossycoating===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "glossycoating" || type of material
|-
|'''scene.materials.<material name>.base''' || string || || name of base material, the coating layer is added on top of this material
|-
|'''scene.materials.<material name>.ks''' || texture || 0.5 0.5 0.5 || texture or constant specular color of the material
|-
|'''scene.materials.<material name>.uroughness''' || texture || 0.1 || texture or constant roughness value along u coordinate of the material
|-
|'''scene.materials.<material name>.vroughness''' || texture || 0.1 || texture or constant roughness value along v coordinate of the material
|-
|'''scene.materials.<material name>.ka''' || texture || 0.0 0.0 0.0 || texture or constant value of coefficient of absorption of the coating layer
|-
|'''scene.materials.<material name>.d''' || texture || 0.0 || texture or constant value of the depth (thickness) of the coating layer for absorption effects. (0 = disables)
|-
|'''scene.materials.<material name>.index''' || texture || 0.0 0.0 0.0 || IOR of the coating. IOR overrides color Ks if both are specified
|-
|'''scene.materials.<material name>.multibounce''' || bool || false || simulation of asperity (velvet-like reflection) on the glossy surface
|}

===Type: matte===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "matte" || type of material
|-
|'''scene.materials.<material name>.kd''' || texture || 0.75 0.75 0.75 || texture or constant color of the matte material
|}

===Type: mattetranslucent===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "mattetranslucent" || type of material
|-
|'''scene.materials.<material name>.kr''' || texture || 0.5 0.5 0.5 || texture or constant reflected color of the material
|-
|'''scene.materials.<material name>.kt''' || texture || 0.5 0.5 0.5 || texture or constant transmitted color of the material
|}

===Type: metal2===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "metal2" || type of material
|-
|'''scene.materials.<material name>.fresnel''' || fresnel texture || ... || [[#Type:_Fresnel_Textures | fresnel texture]]
|-
|'''scene.materials.<material name>.uroughness''' || texture || 0.1 || texture or constant roughness value along u coordinate of the material
|-
|'''scene.materials.<material name>.vroughness''' || texture || 0.1 || texture or constant roughness value along v coordinate of the material
|-
|'''scene.materials.<material name>.preset''' || string || "aluminium" || (DEPRECATED) "aluminium", "silver", "copper", "gold" or "amorphous carbon"
|-
|'''scene.materials.<material name>.n''' || texture || 0.5 0.5 0.5 || (DEPRECATED) texture or constant value. It can be used to directly define a fresnelapproxn texture on overwrite the .preset property
|-
|'''scene.materials.<material name>.k''' || texture || 0.5 0.5 0.5 || (DEPRECATED) texture or constant value. It can be used to directly define a fresnelapproxk texture on overwrite the .preset property
|}

===Type: mirror===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "mirror" || type of material
|-
|'''scene.materials.<material name>.kr''' || texture || 1.0 1.0 1.0 || texture or constant reflected color of the material
|}

===Type: mix===

This material can be used to mix 2 other materials.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "mix" || type of material
|-
|'''scene.materials.<material name>.material1''' || string || mat1 || name of another material
|-
|'''scene.materials.<material name>.material2''' || string || mat2 || name of another material
|-
|'''scene.materials.<material name>.amount''' || texture || 0.5 || texture or constant value used to mix the materials
|}

===Type: null===

This is empty, not visible material. It can be combined by using mix material with others. It is often used in combination with the alpha channel of an image map to render leafs, etc.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "null" || type of material
|}

===Type: roughglass===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "roughglass" || type of material
|-
|'''scene.materials.<material name>.kr''' || texture || 1.0 1.0 1.0 || texture or constant reflected color of the material
|-
|'''scene.materials.<material name>.kt''' || texture || 1.0 1.0 1.0 || texture or constant transmitted color of the material
|-
|'''scene.materials.<material name>.interiorior''' || texture || 1.5 || inside texture or constant index of refraction
|-
|'''scene.materials.<material name>.exteriorior''' || texture || 1.0 || outside texture or constant index of refraction
|-
|'''scene.materials.<material name>.uroughness''' || texture || 0.1 || texture or constant roughness value along u coordinate of the material
|-
|'''scene.materials.<material name>.vroughness''' || texture || 0.1 || texture or constant roughness value along v coordinate of the material
|-
|'''scene.materials.<material name>.filmthickness''' || texture || none || thickness (in nanometers) of a [https://en.wikipedia.org/wiki/Thin-film_interference thin-film coating] on the surface. This property is optional, if it is not defined, the coating is disabled.
|-
|'''scene.materials.<material name>.filmior''' || texture || none || Refractive index of the thin-film coating. This property is optional, if it is not defined, the coating is disabled.
|}

===Type: roughmatte===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "roughmatte" || type of material
|-
|'''scene.materials.<material name>.kd''' || texture || 0.75 0.75 0.75 || texture or constant color of the roughmatte material
|-
|'''scene.materials.<material name>.sigma''' || texture || 0.0 || the sigma parameter in the Oren-Nayer shader in degrees. Zero for pure Lambertian reflection
|}

===Type: velvet===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "velvet" || type of material
|-
|'''scene.materials.<material name>.kd''' || texture || 0.5 0.5 0.5 || color of the material's fuzz
|-
|'''scene.materials.<material name>.p1''' || texture || -2.0 || polynomial that influences the fuzz
|-
|'''scene.materials.<material name>.p2''' || texture || 20.0 || polynomial that influences the fuzz
|-
|'''scene.materials.<material name>.p3''' || texture || 2.0 || polynomial that influences the fuzz
|-
|'''scene.materials.<material name>.thickness''' || texture || 0.1 || height of the fuzz
|}

==Objects==

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.objects.<object name>.material''' || string || || type of object material
|-
|'''scene.objects.<object name>.shape''' || string || || name of [[#Shapes | shape]] with the triangle mesh description.Memory required to store the triangle mesh information is allocated only once if 2 or more different objects share the same shape, use .transformation property and true instancing is enabled.
|-
|'''scene.objects.<object name>.ply''' || string || || '''(Deprecated, use .shape instead)''' name of [http://en.wikipedia.org/wiki/PLY_(file_format) PLY] file with the triangle mesh description. Memory required to store the triangle mesh information is allocated only once if 2 or more different objects share the same file, use .transformation property and true instancing is enabled.
|-
|'''scene.objects.<object name>.transformation''' || matrix 4x4 || 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 || transformation matrix
|-
|'''scene.objects.<object name>.vertices''' || float || || This is an alternative syntax to using PLY file. It is an in-lined definition of the triangle mesh. It is a list of float values defining the vertices of the mesh (i.e. 3 coordinates for each vertex).
|-
|'''scene.objects.<object name>.faces''' || unsigned int || || This is an alternative syntax to using PLY file. It is an in-lined definition of the triangle mesh. It is a list of unsigned int values defining the triangles of the mesh (i.e. 3 index of vertices for each triangle).
|-
|'''scene.objects.<object name>.id''' || unsigned int || || object ID
|-
|'''scene.objects.<object name>.camerainvisible''' || bool || false || toggle visibility for camera rays. If set to true, the object will not show up in camera rays, but it will still be visible in reflections, refractions, shadows, indirect light etc.
|}

===Object Motion Blur===

LuxCore supports transformation motion blur for objects.
Motion blur is enabled if an object has a motion system defined as described below.

A motion system consists of steps (at least 2). Each step has a time (in seconds) and a transformation matrix of the object at this point in time.
Step indices start at 0. The times have to be monotonic (each greater than the last).

Note that the embree accelerator only supports a maximum of 129 time steps.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.objects.<object name>.motion.<step>.time''' || float || || time (in seconds) of the step
|-
|'''scene.objects.<object name>.motion.<step>.transformation''' || matrix 4x4 || 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 || transformation matrix of the object at the given step
|-
|}

==Shapes==

===Type: mesh===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.shapes.<shape name>.type''' || string || "mesh" || mesh shape
|-
|'''scene.shapes.<shape name>.ply''' || string || ... || mesh path (e.g ''scenes/luxball/luxball-shell.ply'')
|-
|'''scene.shapes.<shape name>.appliedtransformation''' || Matrix4x4 || 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0|| transformation matrix applied to the mesh vertices. Used to define the local object reference space.
|}

===Type: inlinedmesh===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.shapes.<shape name>.type''' || string || "inlinedmesh" || inlinedmesh shape
|-
|'''scene.shapes.<shape name>.vertices''' || vector || ... || inlinedmesh vertices (e.g 0.0 0.0 0.0 1.0 0.0 0.0 0.0 1.0 0.0)
|-
|'''scene.shapes.<shape name>.faces''' || vector || ... || inlinedmesh faces (e.g 0 1 2)
|-
|'''scene.shapes.<shape name>.appliedtransformation''' || Matrix4x4 || 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0|| transformation matrix applied to the mesh vertices. Used to define the local object reference space.
|}

===Type: pointiness===

Contains surface curvature information in vertex alpha channel. 
You can access this information in materials via a hitpointalpha texture. 
The values range from -1 to 1 (float). 
Values from -1 to 0 are concave, while values from 0 to 1 are convex.

[[ Shape:_Pointiness | Examples ]]

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.shapes.<shape name>.type''' || string || "pointiness" || pointiness shape
|-
|'''scene.shapes.<shape name>.source''' || string || ... || pointiness source (a mesh shape)
|}

===Type: strands===

Can be used for hair, fur, grass etc. 
Note that you need to define the camera before defining any strands shapes, because the tesselation process is viewpoint-dependent.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.shapes.<shape name>.type''' || string || "strands" || strands shape
|-
|'''scene.shapes.<shape name>.file''' || string || ... || strands file (''scenes/strands/straight.hair'')
|}

====Strands tessellation methods====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.shapes.<shape name>.tessellation.type''' || string || "ribbon" || ribbon tessellation
|-
|'''scene.shapes.<shape name>.tessellation.usecameraposition''' || bool || 1 || use camera position
|}

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.shapes.<shape name>.tessellation.type''' || string || "ribbonadaptive" || ribbon adaptive tessellation method
|-
|'''scene.shapes.<shape name>.tessellation.adaptative.maxdepth''' || unsigned int || 12 || max tessellation depth
|-
|'''scene.shapes.<shape name>.tessellation.adaptative.error ''' || float || 0.0075 || max tessellation error
|}

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.shapes.<shape name>.tessellation.type''' || string || "solid" || solid tessellation method
|-
|'''scene.shapes.<shape name>.tessellation.solid.sidecount ''' || unsigned int || 12 || tessellation's side count
|}

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.shapes.<shape name>.tessellation.type''' || string || "solidadaptive" || solidadaptive tessellation method
|-
|'''scene.shapes.<shape name>.tessellation.solidadaptive.sidecount ''' || unsigned int || 8 || tessellation's side count
|-
|'''scene.shapes.<shape name>.tessellation.solidadaptive.maxdepth''' || unsigned int || 16 || tessellation's max depth
|-
|'''scene.shapes.<shape name>.tessellation.solidadaptive.error''' || float || 0.05 || tessellation's max error
|}

===Type: group===

Todo.

===Type: displacement===

Todo.

===Type: subdiv===

Todo.

===Type: harlequin===

Todo.

===Type: simplify===

Todo.

===Type: islandaov===

Todo.

===Type: randomtriangleaov===

Todo.

==Light sources==

Check [[Lighting|LuxCoreRender Lighting]] for an high level description and example of the light sources.

===Common parameters===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.gain''' || spectrum || 1.0 1.0 1.0 || intensity of the light
|-
|'''scene.lights.<light name>.transformation''' || matrix 4x4 || 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 || transformation matrix
|-
|'''scene.lights.<light name>.samples''' || int || -1 || the number of shadow ray to trace to compute direct light for this light source. This property is an hint and the render engine can ignore this information. -1 means use the default global value.
|-
|'''scene.lights.<light name>.id''' || int || 0 || the radiance group the light emitted from this material is assigned to.

|-
|'''scene.lights.<light name>.importance''' || float || 1.0 || A hint how often to sample this light compared to other lights
|}

===Type: sun===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "sun" || type of light
|-
|'''scene.lights.<light name>.turbidity''' || float || 2.2 || turbidity can go from 1.0 to 30+. 2-6 are most useful for clear days
|-
|'''scene.lights.<light name>.relsize''' || float || 1.0 || relative size to the sun
|-
|'''scene.lights.<light name>.dir''' || vector || 0.0 0.0 1.0 || direction vector of the sun
|-
|'''scene.lights.<light name>.visibility.indirect.diffuse.enable''' || bool || true || if the light source is visible by indirect rays on diffuse surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.visibility.indirect.glossy.enable''' || bool || true || if the light source is visible by indirect rays on glossy surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.visibility.indirect.specular.enable''' || bool || true || if the light source is visible by indirect rays on specular surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|}

===Type: sky2===

Hosek-Wilkie sky model.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "sky2" || type of light
|-
|'''scene.lights.<light name>.turbidity''' || float || 2.2 || turbidity can go from 1.0 to 30+. 2-6 are most useful for clear days
|-
|'''scene.lights.<light name>.dir''' || vector || 0.0 0.0 1.0 || direction vector of the sun
|-
|'''scene.lights.<light name>.gain''' || vector || ... || gain
|-
|'''scene.lights.<light name>.groundalbedo''' || vector || 0.5 0.5 0.5 || ground albedo
|-
|'''scene.lights.<light name>.visibility.indirect.diffuse.enable''' || bool || true || if the light source is visible by indirect rays on diffuse surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.visibility.indirect.glossy.enable''' || bool || true || if the light source is visible by indirect rays on glossy surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.visibility.indirect.specular.enable''' || bool || true || if the light source is visible by indirect rays on specular surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.ground.enable''' || bool || 1 || enable ground color
|-
|'''scene.lights.<light name>.ground.color''' || vector|| ... || RGB ground color
|}

===Type: infinite===

Spherical lightsource surrounding the scene at infinite distance. 
Used for image based lighting (IBL) and HDR environment lighting if the file is a high dynamic range image.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "infinite" || type of light
|-
|'''scene.lights.<light name>.file''' || string || "image.png" || filename of the environment map
|-
|'''scene.lights.<light name>.gamma''' || float || 2.2 || gamma correction used by the image map
|-
|'''scene.lights.<light name>.storage''' || string || "auto" || environment map storage type ("auto", "byte", "half" or "float")
|-
|'''scene.lights.<light name>.visibility.indirect.diffuse.enable''' || bool || true || if the light source is visible by indirect rays on diffuse surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.visibility.indirect.glossy.enable''' || bool || true || if the light source is visible by indirect rays on glossy surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.visibility.indirect.specular.enable''' || bool || true || if the light source is visible by indirect rays on specular surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.sampleupperhemisphereonly''' || bool || false || an option set to black the lower hemisphere. Mostly useful for shadow catchers.
|}

===Type: point===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "point" || type of light
|-
|'''scene.lights.<light name>.position''' || point || 0.0 0.0 0.0 || position
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.power''' || float || 0.0 || lamp output power in watts. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.efficency''' || float || 0.0 || luminous efficacy in lumens/watt. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|}

===Type: mappoint===

Point light with support for IES files or image maps controlling the strength of light emitted.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "mappoint" || type of light
|-
|'''scene.lights.<light name>.position''' || point || 0.0 0.0 0.0 || position
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.power''' || float || 0.0 || lamp output power in watts. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.efficency''' || float || 0.0 || luminous efficacy in lumens/watt. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.mapfile''' || string || || the name of an optional image map that can be used to scale the emitted light
|-
|'''scene.lights.<light name>.gamma''' || float || 2.2 || gamma value of the image map defined with .mapfile property
|-
|'''scene.lights.<light name>.iesfile''' || string || || a [http://en.wikipedia.org/wiki/Illuminating_Engineering_Society_of_North_America IES] profile of emitted light and the render engine can ignore this information. -1 means use the default global value.
|-
|'''scene.lights.<light name>.iesblob''' || string || || a [http://en.wikipedia.org/wiki/Illuminating_Engineering_Society_of_North_America IES] profile of emitted light embedded in a blob
|-
|'''scene.lights.<light name>.flipz''' || bool || false || flip the IES profile along the Z axis
|-
|'''scene.lights.<light name>.map.width''' || unsigned int || 0 || scale the image or IES map to the specified width. 0 means use the original size
|-
|'''scene.lights.<light name>.map.height''' || unsigned int || 0 || scale the image or IES map to the specified height. 0 means use the original size
|}

===Type: sphere===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "sphere" || type of light
|-
|'''scene.lights.<light name>.position''' || point || 0.0 0.0 0.0 || position
|-
|'''scene.lights.<light name>.radius''' || float || 1.0 || position
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.power''' || float || 0.0 || lamp output power in watts. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.efficency''' || float || 0.0 || luminous efficacy in lumens/watt. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|}

===Type: mapsphere===

Sphere light with support for IES files or image maps controlling the strength of light emitted.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "mapsphere" || type of light
|-
|'''scene.lights.<light name>.position''' || point || 0.0 0.0 0.0 || position
|-
|'''scene.lights.<light name>.radius''' || float || 1.0 || position
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.power''' || float || 0.0 || lamp output power in watts. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.efficency''' || float || 0.0 || luminous efficacy in lumens/watt. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.mapfile''' || string || || the name of an optional image map that can be used to scale the emitted light
|-
|'''scene.lights.<light name>.gamma''' || float || 2.2 || gamma value of the image map defined with .mapfile property
|-
|'''scene.lights.<light name>.iesfile''' || string || || a [http://en.wikipedia.org/wiki/Illuminating_Engineering_Society_of_North_America IES] profile of emitted light and the render engine can ignore this information. -1 means use the default global value.
|-
|'''scene.lights.<light name>.iesblob''' || string || || a [http://en.wikipedia.org/wiki/Illuminating_Engineering_Society_of_North_America IES] profile of emitted light embedded in a blob
|-
|'''scene.lights.<light name>.flipz''' || bool || false || flip the IES profile along the Z axis
|-
|'''scene.lights.<light name>.map.width''' || unsigned int || 0 || scale the image or IES map to the specified width. 0 means use the original size
|-
|'''scene.lights.<light name>.map.height''' || unsigned int || 0 || scale the image or IES map to the specified height. 0 means use the original size
|}

===Type: spot===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "spot" || type of light
|-
|'''scene.lights.<light name>.position''' || point || 0.0 0.0 0.0 || position
|-
|'''scene.lights.<light name>.target''' || point || 0.0 0.0 1.0 || target
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.power''' || float || 0.0 || lamp output power in watts. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.efficency''' || float || 0.0 || luminous efficacy in lumens/watt. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.coneangle''' || float || 30.0 || angle in degrees of the spotlight cone
|-
|'''scene.lights.<light name>.conedeltaangle''' || float || 5.0 || angle at which the spotlight intensity starts to fade from the edge
|}

===Type: projection===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "projection" || type of light
|-
|'''scene.lights.<light name>.position''' || point || 0.0 0.0 0.0 || position
|-
|'''scene.lights.<light name>.target''' || point || 0.0 0.0 1.0 || target
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.power''' || float || 0.0 || lamp output power in watts. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.efficency''' || float || 0.0 || luminous efficacy in lumens/watt. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.fov''' || float || 45.0 || field of view in terms of angular spread along the shorter image axis
|-
|'''scene.lights.<light name>.mapfile''' || string || || filename of the image to project. If not specified, a constat light color will be used.
|-
|'''scene.lights.<light name>.gamma''' || float || 2.2 || gamma value of the image map defined with .mapfile property
|}

===Type: constantinfinite===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "constantinfinite" || type of light
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.visibility.indirect.diffuse.enable''' || bool || true || if the light source is visible by indirect rays on diffuse surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.visibility.indirect.glossy.enable''' || bool || true || if the light source is visible by indirect rays on glossy surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.visibility.indirect.specular.enable''' || bool || true || if the light source is visible by indirect rays on specular surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|}

===Type: sharpdistant===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "sharpdistant" || type of light
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.direction''' || vector || 0.0 0.0 1.0 || direction
|}

===Type: distant===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "distant" || type of light
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.direction''' || vector || 0.0 0.0 1.0 || direction
|-
|'''scene.lights.<light name>.theta''' || float || 10.0 || half angle of the light source in degree. Must be > 0 for soft shadows
|}

===Type: laser===

A light source emitting parallel light rays (like sharpdistant light, but starting inside the scene instead of infinitely far away).

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "laser" || type of light
|-
|'''scene.lights.<light name>.position''' || point || 0.0 0.0 0.0 || position
|-
|'''scene.lights.<light name>.target''' || point || 0.0 0.0 1.0 || target
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.power''' || float || 0.0 || lamp output power in watts. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.efficency''' || float || 0.0 || luminous efficacy in lumens/watt. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.radius''' || float || 0.01 || radius of the laser beam
|}

LuxCore SDL Reference Manual v2.5

2020-11-03T17:43:05Z

Byob: /* Image pipeline */ add COLOR_LUT plugin

The scene description language (SDL) is used to configure the renderer and to define objects, materials, textures etc. in the scene. 
The file ending of the render configuration file is ".cfg", for the scene file it's ".scn".

These files are usually created by exporter plugins, e.g. BlendLuxCore. 
This wiki page is primarily a reference for exporter developers, normal end-users should not need to edit cfg/scn files by hand.

Sometimes the API is updated faster than the wiki, in this case you can look at the code directly: https://github.com/LuxCoreRender/LuxCore/tree/master/src/slg/scene

Note that matrices are passed as flat lists in column-major form.

=Render configuration file=

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''resumerendering.filesafe''' || bool || 1 || enable/disable "safe save" mode for resume rendering file. A backup of the output is always valid even in the case of a system failure
|}

==Seed==

The global seed value that is used to generate random numbers. 
Two images rendered with the same seed will have the same noise pattern.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''renderengine.seed''' || unsigned int || 1 || min 1
|}

==Periodic save==

Options related to periodic save operations.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''periodicsave.resumerendering.period''' || float || 0 || save the resume rendering file every specified amount of time (value in seconds). A value <= 0.0 disable the saving
|-
|'''periodicsave.resumerendering.filename''' || string || "resume.rsm" || the name to use to save the rendering resume information periodically
|-
|'''periodicsave.film.period''' || float || 0 || save the Film every specified amount of time (value in seconds). A value <= 0.0 disable the saving
|-
|'''periodicsave.film.filename''' || string || "film.flm" || the name to use to save the film periodically
|-
|'''periodicsave.film.outputs.period''' || float || 600 || save all Film outputs every specified amount of time (value in seconds). A value <= 0.0 disable the saving
|}

==Render Engine==

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''renderengine.type''' || string || "PATHCPU" || engine type
|}

=== CPU Render Engines ===

CPU render engines are written in C++ and don't require OpenCL. All CPU render engines accept the following parameters:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''native.threads.count''' || int || CPU core count || > 0 || > 0 || The number of threads will be used for the rendering
|}

'''The following CPU engines are available:'''

===="PATHCPU"====

A path tracer with full image plane rendering (i.e. supporting Metropolis sampler).

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''path.pathdepth.total''' || int || 6 || > 0 || [1, 16] || Maximum recursion depth of a path
|-
|'''path.pathdepth.diffuse''' || int || 4 || > 0 || [1, 16] ||
|-
|'''path.pathdepth.glossy''' || int || 4 || > 0 || [1, 16] ||
|-
|'''path.pathdepth.specular''' || int || 6 || > 0 || [1, 16] ||
|-
|'''path.russianroulette.depth''' || int || 3 || > 0 || [1, path.maxdepth] || The path depth where Russian Roulette stars to be used
|-
|'''path.russianroulette.cap''' || float || 0.5 || [0.0, 1.0] || [0.0, 1.0] || The threshold over which Russian Roulette is used
|-
|'''path.clamping.variance.maxvalue''' || float || 0.0 || > 0.0 || > 0.0 || Samples brighter than this value are clamped, helps to reduce fireflies. 0.0 = disabled
|-
|'''path.forceblackbackground.enable''' || bool || 0 || 0 or 1 || 0 or 1 || Enable when rendering with transparent film and premultiplied alpha, to avoid artifacts with semi-transparent areas
|}

===="TILEPATHCPU"====
Biased path tracer with many control options and support for tile rendering. 
The sampler must be set to TILEPATHSAMPLER when using this engine.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''path.pathdepth.total''' || int || 6 || > 0 || [1, 16] || Maximum recursion depth of a path
|-
|'''path.pathdepth.diffuse''' || int || 4 || > 0 || [1, 16] ||
|-
|'''path.pathdepth.glossy''' || int || 4 || > 0 || [1, 16] ||
|-
|'''path.pathdepth.specular''' || int || 6 || > 0 || [1, 16] ||
|-
|'''path.russianroulette.depth''' || int || 3 || > 0 || [1, path.maxdepth] || The path depth where Russian Roulette stars to be used
|-
|'''path.russianroulette.cap''' || float || 0.5 || [0.0, 1.0] || [0.0, 1.0] || The threshold over which Russian Roulette is used
|-
|'''path.clamping.variance.maxvalue''' || float || 0.0 || > 0.0 || > 0.0 || Samples brighter than this value are clamped, helps to reduce fireflies. 0.0 = disabled
|-
|'''path.forceblackbackground.enable''' || bool || 0 || 0 or 1 || 0 or 1 || Enable when rendering with transparent film and premultiplied alpha, to avoid artifacts with semi-transparent areas
|-
|'''tilepath.sampling.aa.size''' || int || 3 || > 0 || [1, 13] || All diffuse/glossy/specular samples are multiplied with the squared aa size: final_samples = aa^2 * (diffuse^2 + glossy^2 + specular^2)
|-
|'''tile.size''' || int || 32 || ≥ 8 || [8, 256] || Tile size in pixels
|-
|'''tile.multipass.enable''' || bool || 1 || 0 or 1 || o or 1 || Re-render the image until a halt threshold is met or indefinitely
|-
|'''tile.multipass.convergencetest.threshold''' || float || 6.0 / 256.0 || > 0.0 || [1.0 / 256.0, 6.0 / 256.0] || Target noise level
|-
|'''tile.multipass.convergencetest.threshold.reduction''' || float || 0.0 || [0.0, 1.0] || [0.75, 0.95] || Multiply noise level with this number when all tiles have met the previous noise level. Set to 0 to disable (so rendering will stop at the noise level)
|-
|'''tile.multipass.convergencetest.warmup.count''' || int || 32 || ≥ 0 || [8, 128] || Warm up period for the convergence test expressed in samples per pixel
|}

===="BIDIRCPU"====

A Bidirectional path tracer.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''path.maxdepth''' || int || 5 || > 0 || [1, 16] || Maximum recursion depth of a eye path
|-
|'''light.maxdepth''' || int || 5 || > 0 || [1, 16] || Maximum recursion depth of a light path
|-
|'''path.russianroulette.depth''' || int || 3 || > 0 || [1, path.maxdepth] || The path depth where Russian Roulette starts to be used
|-
|'''path.russianroulette.cap''' || float || 0.5 || [0.0, 1.0] || [0.0, 1.0] || The threshold over which Russian Roulette is used
|}

===="RTPATHCPU"====
Engine optimized for interactive scene editing and camera movement. 
The sampler must be set to RTPATHCPUSAMPLER when using this engine.

Supports the same properties as [[#"PATHCPU" | "PATHCPU"]] plus the following:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''rtpathcpu.zoomphase.size''' || int || 4 || || || render scaled down film for the first few frames after a scene edit (to make interactions more fluid)
|-
|'''rtpathcpu.zoomphase.weight''' || float || 0.1 || || || description: TODO
|}

=== OpenCL Render Engines ===

OpenCL engines can run on GPUs, CPUs and other types of computing devices, they require OpenCL to run. All OpenCL render engines accept the following parameters:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''opencl.platform.index''' || int || -1 || A valid platform index || -1 || Select the OpenCL platform to use. All devices available on all platforms will be used with -1
|-
|'''opencl.cpu.use''' || bool || 1 || 0 or 1 || 0 or 1 || If to use all OpenCL CPU devices available
|-
|'''opencl.gpu.use''' || bool || 1 || 0 or 1 || 0 or 1 || If to use all OpenCL GPU devices available
|-
|'''opencl.cpu.workgroup.size''' || int || 0 || Any valid OpenCL workgroup size || 64 || Set the OpenCL workgroup size, 0 means to use the driver suggested value
|-
|'''opencl.gpu.workgroup.size''' || int || 0 || Any valid OpenCL workgroup size || 64 || Set the OpenCL workgroup size, 0 means to use the driver suggested value
|-
|'''opencl.devices.select''' || string || "" || Any valid selection string || Any valid selection string || Select each OpenCL device to use. It is a string of "0" and "1". "1" means use the device, "0" do not
|}

'''The following OpenCL engines are available:'''

===="PATHOCL"====
OpenCL version of PATHCPU. Supports the same settings as [[#"PATHCPU" | PATHCPU]] plus the following:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''pathocl.pixelatomics.enable''' || bool || 0 || 0 or 1 || 0 or 1 || Enable pixel atomic operation
|-
|'''opencl.task.count''' || int || "AUTO" || "AUTO" or > 0 || [64K, 1024K] || The number of tasks sent to the OpenCL device in one kernel call
|}

===="RTPATHOCL"====

A PATHOCL version optimized for real-time rendering with fixed frame-rate and variable quality. 
The sampler must be set to TILEPATHSAMPLER when using this engine.

Supports the same settings as [[#"PATHOCL" | PATHOCL]] plus the following:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''rtpath.resolutionreduction.preview''' || int || 4 || > 0 || [1, 32] || Render a sample every n x n pixels in the first passes. For instance 4x4 than 2x2 and than always 1x1
|-
|'''rtpath.resolutionreduction.preview.step''' || int || 8 || > 0 || [1, 32] || Each preview step is rendered for n frames
|-
|'''rtpath.resolutionreduction''' || int || 4 || > 0 || [1, 32] || Render a sample every n x n pixels, outside the preview phase, in order to reduce the per frame rendering time
|}

===="TILEPATHOCL"====

OpenCL version of TILEPATHCPU. 
The sampler must be set to TILEPATHSAMPLER when using this engine.

Supports the same settings as [[#"TILEPATHCPU" | TILEPATHCPU]] plus the following:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''tilepathocl.devices.maxtiles''' || int || 16 || ≥ 1 || [1, 32] || Maximum number of tiles to send in a single call to each OpenCL device
|}

==="FILESAVER"===

Saves everything needed to render the scene to the output path, including textures and meshes.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''filesaver.format''' || string || "TXT" || "TXT" for a text SDL format and "BIN" for a single file binary format
|-
|'''filesaver.filename''' || string || "luxcore-exported-scene.bcf" || file name for "BIN" format
|-
|'''filesaver.directory''' || string || "luxcore-exported-scene" || output path for "TXT" format
|-
|'''filesaver.renderengine.type''' || string || "PATHCPU" || render engine to use when rendering the scene after it was saved with FILESAVER. Any engine string from above can be used here.
|}

===Experimental and debugging engines===

'''These engines are experimental, deprecated or are only intended for very specific purposes:'''

===="BIDIRVMCPU"====

Bidir with vertex merging, currently experimental. 
Supports the same settings as [[#"BIDIRCPU" | BIDIRCPU]] plus the following:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''bidirvm.lightpath.count''' || int || 16 * 1024 || > 0 || || Number of lightpaths per pass
|-
|'''bidirvm.startradius.scale''' || float || 0.003 || > 0 || || Photon radius of the first pass
|-
|'''bidirvm.alpha''' || float || 3 || > 0 || [0.0, 1.0] || Photon radius is multiplied with this value after every pass to reduce the radius
|}

===="LIGHTCPU"====

For testing.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''light.maxdepth''' || int || 5 || > 0 || [1, 16] || Maximum recursion depth of a light path
|-
|'''light.russianroulette.depth''' || int || 3 || > 0 || [1, path.maxdepth] || The path depth where Russian Roulette starts to be used
|-
|'''light.russianroulette.cap''' || float || 0.5 || [0.0, 1.0] || [0.0, 1.0] || The threshold over which Russian Roulette is used
|}

==Sampler==

Samplers are used by following render engines:

* LIGHTCPU
* PATHCPU
* BIDIRCPU
* BIDIRVMCPU
* PATHOCL

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''sampler.type''' || string || "SOBOL" || sampler type
|}

The following samplers are available:

==="SOBOL"===

Sampler with sobol pattern.
Parameters:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''sampler.sobol.adaptive.strength''' || float || 0.7 || 0 ≤ x < 0.95 || 0.5 - 0.9 || it sets if the sampler should be more or less adaptive
|}

==="METROPOLIS"===

Metropolis sampler.
Parameters:
{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''sampler.metropolis.largesteprate''' || float || 0.4 || 0 ≤ x ≤ 1 || 0 - 1 || Probability of generating a large sample mutation
|-
|'''sampler.metropolis.maxconsecutivereject''' || int || 512 || x ≥ 0 || 0 - 32768 || Number of consecutive rejects before a next mutation is forced. Low values can cause bias
|-
|'''sampler.metropolis.imagemutationrate''' || float || 0.1 || 0 ≤ x ≤ 1 || 0 - 1 || Maximum distance over the image plane for a small mutation
|}

==="RANDOM"===

Fully random sampler. This sampler is mostly intended for testing purpose.
Parameters:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''sampler.random.adaptive.strength''' || float || 0.7 || 0 ≤ x < 0.95 || 0.5 - 0.9 || it sets if the sampler should be more or less adaptive
|}

==Filter==

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''film.filter.type''' || string || "BLACKMANHARRIS" || || || Type of pixel filter.
|-
|'''film.filter.width''' || float || 2.0 || x > 0.0 || 0.1 - 3.0 || Filter radius in pixels. Does not have an effect on the NONE filter
|-
|'''film.filter.xwidth''' || float || 2.0 || x > 0.0 || 0.1 - 3.0 || Width in pixels. Overwrite '''film.filter.width''' value
|-
|'''film.filter.ywidth''' || float || 2.0 || x > 0.0 || 0.1 - 3.0 || Width in pixels. Overwrite '''film.filter.width''' value
|}

Available filters are:

==="NONE"===

Disable pixel filtering.

==="BOX"===

Box pixel filter. No parameters.

==="GAUSSIAN"===

Gaussian pixel filter.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''film.filter.gaussian.alpha''' || float || 2.0 || x > 0.0 || 0.1 - 10.0 || Gaussian rate of falloff. Lower values give blurrier images.
|}

==="MITCHELL"===

Mitchel pixel filter.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
| '''film.filter.mitchell.b''' || float || 1.0/3.0 || 0.0 ≤ x ≤ 1.0 || 0.0 - 1.0 || B parameter for the mitchell filter in the range
|-
| '''film.filter.mitchell.c''' || float || 1.0/3.0 || 0.0 ≤ x ≤ 1.0 || 0.0 - 1.0 || C parameter for the mitchell filter in the range 0..1
|}

==="MITCHELL_SS"===

Mitchel pixel filter with super-sampling (i.e. image will be filtered first with a grid of 4 pixels for each pixel).

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
| '''film.filter.mitchellss.b''' || float || 1.0/3.0 || 0.0 ≤ x ≤ 1.0 || 0.0 - 1.0 || B parameter for the mitchell filter in the range
|-
| '''film.filter.mitchellss.c''' || float || 1.0/3.0 || 0.0 ≤ x ≤ 1.0 || 0.0 - 1.0 || C parameter for the mitchell filter in the range 0..1
|}

==="BLACKMANHARRIS"===

Blcakman-Harris pixel filter. No parameters.

==Light Strategy==

The direct light sampling strategy is defined by the following property:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''lightstrategy.type''' || string || "LOG_POWER" || "UNIFORM", "POWER", "LOG_POWER" or "DLS_CACHE" || N/A || Direct light sampling strategy
|}

==="UNIFORM"===

"UNIFORM" light strategy samples evenly all light sources.

==="POWER"===

"POWER" light strategy samples the light sources based on their power.

==="LOG_POWER"===

"LOG_POWER" light strategy samples the light sources based on logarithm of their power.

==="DLS_CACHE"===

Build direct light sampling cache to optimize many-lights rendering, beneficial in scenes with multiple light sources with few overlap between their influence areas (e.g. a building with many disconnected rooms and interior lights).

Options for the DLS cache:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''lightstrategy.entry.radius''' || float || 0.0 || || N/A || Entry radius in meters, automatic radius estimation is used if the radius is set to 0
|-
|'''lightstrategy.entry.normalangle''' || float || 25.0 || || N/A ||
|-
|'''lightstrategy.entry.maxpasses''' || int || 1024 || || N/A ||
|-
|'''lightstrategy.entry.convergencethreshold''' || float || 0.05 || || N/A ||
|-
|'''lightstrategy.entry.warmupsamples''' || int || 24 || || N/A ||
|-
|'''lightstrategy.targetcachehitratio''' || float || 0.995 || || N/A ||
|-
|'''lightstrategy.maxdepth''' || int || 4 || || N/A ||
|-
|'''lightstrategy.maxsamplescount''' || int || 10000000 || || N/A ||
|-
|'''lightstrategy.persistent.file''' || string || "" || || N/A ||
|-
|'''lightstrategy.persistent.safesave''' || bool || 1 || || N/A ||

|}

==Accelerator==

The ray/triangle intersection accelerator to use for the rendering is defined by the following properties:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''accelerator.type''' || string || "AUTO" || "AUTO", "BVH", "MBVH", "EMBREE" || "AUTO" || The intersection accelerator. "AUTO" will select the best one available for the current [[LuxRays]] intersection device. "EMBREE" is currently usable only on CPU render engines
|-
|'''accelerator.instances.enable''' || bool || 1 || 0 or 1 || 0 or 1 || Enable instance support (or disable in order to slightly increase rendering speed)
|}

==Epsilon==

Minimum and maximum allowed value for scene epsilon can be define by the following properties:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''scene.epsilon.min''' || float || 1e-5f || Any float value || 1e-6f ≤ x ≤ 1e-1f || Minimum allowed value for scene epsilon
|-
|'''scene.epsilon.max''' || float || 1e-1f || Any float value || 1e-3f ≤ x ≤ 1e+2f || Maximum allowed value for scene epsilon
|}

==Film==

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.safesave''' || bool || 1 || enable "safe save" of Film serialization. A backup of the output is always valid even in the case of a system failure.
|}

===Film OpenCL Options===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.opencl.enable''' || bool || 1 || enable OpenCL film operations
|-
|'''film.opencl.platform''' || unsigned int || -1 || choose which platform will be used by the film operations. (0 is first platform, 1 second and so on. -1 for all)
|-
|'''film.opencl.device''' || unsigned int || -1 || choose which device will be used by the film operations. (0 is first device, 1 second and so on. -1 for first GPU device)
|}

===Film Outputs (aka AOVs)===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.outputs.safesave''' || bool || 1 || enable "safe save" for Film outputs. A backup of the output is always valid even in the case of a system failure
|}

The film object supports many types of outputs (aka AOVs). The complete list of supported output types:

{| class="wikitable" cellspacing="2"
!Name
!Type
|-
|'''RGB''' || HDR
|-
|'''RGBA''' || HDR
|-
|'''RGB_IMAGEPIPELINE''' || HDR/LDR
|-
|'''RGBA_IMAGEPIPELINE''' || HDR/LDR
|-
|'''ALPHA''' || HDR/LDR
|-
|'''DEPTH''' || HDR
|-
|'''POSITION''' || HDR
|-
|'''GEOMETRY_NORMAL''' || HDR
|-
|'''SHADING_NORMAL''' || HDR
|-
|'''MATERIAL_ID''' || LDR
|-
|'''DIRECT_DIFFUSE''' || HDR
|-
|'''DIRECT_GLOSSY''' || HDR
|-
|'''EMISSION''' || HDR
|-
|'''INDIRECT_DIFFUSE''' || HDR
|-
|'''INDIRECT_GLOSSY''' || HDR
|-
|'''INDIRECT_SPECULAR''' || HDR
|-
|'''MATERIAL_ID_MASK''' || HDR/LDR
|-
|'''DIRECT_SHADOW_MASK''' || HDR/LDR
|-
|'''INDIRECT_SHADOW_MASK''' || HDR/LDR
|-
|'''RADIANCE_GROUP''' || HDR/LDR
|-
|'''UV''' || HDR/LDR
|-
|'''RAYCOUNT''' || HDR/LDR
|-
|'''BY_MATERIAL_ID''' || HDR/LDR
|-
|'''IRRADIANCE''' || HDR
|-
|'''OBJECT_ID''' || LDR
|-
|'''OBJECT_ID_MASK''' || HDR/LDR
|-
|'''BY_OBJECT_ID''' || HDR/LDR
|-
|'''SAMPLECOUNT''' || HDR/LDR
|-
|'''CONVERGENCE''' || HDR/LDR
|-
|'''NOISE''' || HDR/LDR
|-
|'''SERIALIZED_FILM''' || N/A
|-
|'''MATERIAL_ID_COLOR''' || HDR/LDR
|}

Outputs are enabled with the following properties:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.outputs.<index>.type''' || string || || Type of output, e.g. "RGBA" or "ALPHA" (see the list above for the available types)
|-
|'''film.outputs.<index>.filename''' || string || || Filename to use when saving the output. The filename should use ".exr" as extension for HDR outputs and ".png" for LDR outputs (see list above for which output is HDR and which LDR)
|-
|'''film.outputs.<index>.id''' || int || || Specify for the following outputs: '''MATERIAL_ID_MASK''', '''RADIANCE_GROUP''', '''BY_MATERIAL_ID''', '''OBJECT_ID_MASK''', '''BY_OBJECT_ID''' (to choose the object ID, material ID or radiance group ID of the output)
|-
|'''film.outputs.<index>.index''' || int || || Specify for an imagepipeline output (RGB_IMAGEPIPELINE or RGBA_IMAGEPIPELINE) to select the imagepipeline of the output. For example, if you have 3 imagepipelines defined, and you want to specify the output of the third imagepipeline, use 2 for the ".index" property of the output
|}

Note that the Bidir engine does not support all AOVs.
Not supported by Bidir are: EMISSION, DIRECT_DIFFUSE, DIRECT_GLOSSY, INDIRECT_DIFFUSE, INDIRECT_GLOSSY, INDIRECT_SPECULAR, DIRECT_SHADOW_MASK, INDIRECT_SHADOW_MASK, IRRADIANCE, RAYCOUNT.

This is the list of output channel data types and sizes:

{| class="wikitable" cellspacing="2"
!Output type
!Data type
!Size
!Description
|-
|RGB||float||film width x film height x 3||R, G, B
|-
|RGB_IMAGEPIPELINE||float||film width x film height x 3||R, G, B
|-
|RGBA||float||film width x film height x 4||R, G, B, A
|-
|ALPHA||float||film width x film height x 1||Alpha value [0, 1]
|-
|DEPTH||float||film width x film height x 1||Camera distance
|-
|POSITION||float||film width x film height x 3||World X, Y, Z
|-
|GEOMETRY_NORMAL||float||film width x film height x 3||Normal vector X, Y, Z
|-
|SHADING_NORMAL||float||film width x film height x 3||Normal vector X, Y, Z
|-
|DIRECT_DIFFUSE||float||film width x film height x 3||Diffuse R, G, B
|-
|DIRECT_GLOSSY||float||film width x film height x 3||Glossy R, G, B
|-
|EMISSION||float||film width x film height x 3||Emission R, G, B
|-
|INDIRECT_DIFFUSE||float||film width x film height x 3||Indirect diffuse R, G, B
|-
|INDIRECT_GLOSSY||float||film width x film height x 3||Indirect glossy R, G, B
|-
|INDIRECT_SPECULAR||float||film width x film height x 3||Indirect specular R, G, B
|-
|MATERIAL_ID_MASK||float||film width x film height x 1||Material mask [0, 1]
|-
|DIRECT_SHADOW_MASK||float||film width x film height x 1||Shadow mask [0, 1]
|-
|INDIRECT_SHADOW_MASK||float||film width x film height x 1||Shadow mask [0, 1]
|-
|RADIANCE_GROUP||float||film width x film height x 3||R, G, B
|-
|UV||float||film width x film height x 2||Texture coordinates U, V
|-
|RAYCOUNT||float||film width x film height x 1||Ray count
|-
|BY_MATERIAL_ID||float||film width x film height x 3||By material ID
|-
|MATERIAL_ID||uint||film width x film height x 1||Material ID
|-
|IRRADIANCE||float||film width x film height x 3||R, G, B
|-
|OBJECT_ID_MASK||float||film width x film height x 1||Object mask [0, 1]
|-
|BY_OBJECT_ID||float||film width x film height x 3||By object ID
|-
|OBJECT_ID||uint||film width x film height x 1||Object ID
|-
|SAMPLECOUNT||uint||film width x film height x 1||Sample count
|-
|CONVERGENCE||float||film width x film height x 1||The distance of each pixel from the convergence threshold
|-
|NOISE||float||film width x film height x 1||The noise estimated for each pixel
|-
|SERIALIZED_FILM||N/A||N/A||The complete Film serialized in binary format
|-
|MATERIAL_ID_COLOR||float||film width x film height x 3||Material ID converted to colors (with anti-aliasing)
|}

===Film Channels===

Film channels are implicitly enabled by declaring film outputs (even if the output is never used). For instance, declaring a "RGBA" output will automatically enable "RADIANCE_PER_PIXEL_NORMALIZED" (and "RADIANCE_PER_SCREEN_NORMALIZED" for BIDIRCPU) and "ALPHA".
The supported channels are:

{| class="wikitable" cellspacing="2"
!Channel type
!Data type
!Size
!Last element is weight ?
!Note
|-
|CHANNEL_RADIANCE_PER_PIXEL_NORMALIZED||float||film width x film height x 4||Yes||One for each radiance group. Eye paths radiance.
|-
|CHANNEL_RADIANCE_PER_SCREEN_NORMALIZED||float||film width x film height x 3||No||One for each radiance group. Light paths radiance. Used only by LIGHTCPU and BIDIRCPU.
|-
|CHANNEL_ALPHA||float||film width x film height x 2||Yes||
|-
|CHANNEL_RGB_IMAGEPIPELINE||float||film width x film height x 3||No||
|-
|CHANNEL_DEPTH||float||film width x film height x 1||No||
|-
|CHANNEL_POSITION||float||film width x film height x 3||No||
|-
|CHANNEL_GEOMETRY_NORMAL||float||film width x film height x 3||No||
|-
|CHANNEL_SHADING_NORMAL||float||film width x film height x 3||No||
|-
|CHANNEL_MATERIAL_ID||u_int||film width x film height x 1||No||
|-
|CHANNEL_DIRECT_DIFFUSE||float||film width x film height x 4||Yes||
|-
|CHANNEL_DIRECT_GLOSSY||float||film width x film height x 4||Yes||
|-
|CHANNEL_EMISSION||float||film width x film height x 4||Yes||
|-
|CHANNEL_INDIRECT_DIFFUSE||float||film width x film height x 4||Yes||
|-
|CHANNEL_INDIRECT_SPECULAR||float||film width x film height x 4||Yes||
|-
|CHANNEL_MATERIAL_ID_MASK||float||film width x film height x 2||Yes||
|-
|CHANNEL_DIRECT_SHADOW_MASK||float||film width x film height x 2||Yes||
|-
|CHANNEL_INDIRECT_SHADOW_MASK||float||film width x film height x 2||Yes||
|-
|CHANNEL_UV||float||film width x film height x 2||No||
|-
|CHANNEL_RAYCOUNT||float||film width x film height||No||
|-
|CHANNEL_BY_MATERIAL_ID||float||film width x film height x 4||Yes||
|-
|CHANNEL_IRRADIANCE||float||film width x film height x 4||Yes||
|-
|CHANNEL_OBJECT_ID||u_int||film width x film height x 1||No||
|-
|CHANNEL_OBJECT_ID_MASK||float||film width x film height x 2||Yes||
|-
|CHANNEL_BY_OBJECT_ID||float||film width x film height x 4||Yes||
|}

This is the list of channels enabled by each output:

{| class="wikitable" cellspacing="2"
!Output
!Enabled channels
|-
|'''RGB''' || CHANNEL_RADIANCE_PER_PIXEL_NORMALIZED, CHANNEL_RADIANCE_PER_SCREEN_NORMALIZED (only for LIGHTCPU and BIDIRCPU)
|-
|'''RGBA''' || CHANNEL_RADIANCE_PER_PIXEL_NORMALIZED, CHANNEL_RADIANCE_PER_SCREEN_NORMALIZED (only for LIGHTCPU and BIDIRCPU), ALPHA
|-
|'''RGB_IMAGEPIPELINE''' || CHANNEL_RADIANCE_PER_PIXEL_NORMALIZED, CHANNEL_RADIANCE_PER_SCREEN_NORMALIZED (only for LIGHTCPU and BIDIRCPU)
|-
|'''RGBA_IMAGEPIPELINE''' || CHANNEL_RADIANCE_PER_PIXEL_NORMALIZED, CHANNEL_RADIANCE_PER_SCREEN_NORMALIZED (only for LIGHTCPU and BIDIRCPU), ALPHA
|-
|'''ALPHA''' || ALPHA
|-
|'''DEPTH''' || DEPTH
|-
|'''POSITION''' || DEPTH, POSITION
|-
|'''GEOMETRY_NORMAL''' || DEPTH, GEOMETRY_NORMAL
|-
|'''SHADING_NORMAL''' || DEPTH, SHADING_NORMAL
|-
|'''MATERIAL_ID''' || DEPTH, MATERIAL_ID
|-
|'''DIRECT_DIFFUSE''' || DIRECT_DIFFUSE
|-
|'''DIRECT_GLOSSY''' || DIRECT_GLOSSY
|-
|'''EMISSION''' || EMISSION
|-
|'''INDIRECT_DIFFUSE''' || INDIRECT_DIFFUSE
|-
|'''INDIRECT_GLOSSY''' || INDIRECT_GLOSSY
|-
|'''INDIRECT_SPECULAR''' || INDIRECT_SPECULAR
|-
|'''MATERIAL_ID_MASK''' || MATERIAL_ID, MATERIAL_ID_MASK
|-
|'''DIRECT_SHADOW_MASK''' || DIRECT_SHADOW_MASK
|-
|'''INDIRECT_SHADOW_MASK''' || INDIRECT_SHADOW_MASK
|-
|'''RADIANCE_GROUP''' || CHANNEL_RADIANCE_PER_PIXEL_NORMALIZED, CHANNEL_RADIANCE_PER_SCREEN_NORMALIZED (only for LIGHTCPU and BIDIRCPU)
|-
|'''UV''' || DEPTH, UV
|-
|'''RAYCOUNT''' || DEPTH, RAYCOUNT
|-
|'''BY_MATERIAL_ID''' || BY_MATERIAL_ID
|-
|'''IRRADIANCE''' || IRRADIANCE
|-
|'''OBJECT_ID''' || DEPTH, OBJECT_ID
|-
|'''OBJECT_ID_MASK''' || OBJECT_ID, OBJECT_ID_MASK
|-
|'''BY_OBJECT_ID''' || BY_OBJECT_ID
|}

Note: CHANNEL_RGB_IMAGEPIPELINE is always enable and the result of running the image pipeline.

===Image pipeline===

It is possible to [http://www.luxrender.net/forum/viewtopic.php?f=8&p=120169#p120169 define multiple image pipelines at the same time]

====Radiance Group====

Radiance groups are used to get only the contribution of a group of lights in the scene. 
Lights can be grouped by setting their [[#Common_parameters | '''.id''']] property to the same number, on materials this is done with the [[#Light_emission | '''.emission.id''']] property. 

Note that the OpenCL engines only support up to 8 radiance groups (one of them is the default group).

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.radiancescales.<id>.globalscale''' || float|| 1 || global weighting of radiance group
|-
|'''film.imagepipelines.<pipeline #>.radiancescales.<id>.temperature ''' || float || 6500.0 || light temperature
|-
|'''film.imagepipelines.<pipeline #>.radiancescales.<id>.rgbscale''' || vector || 1.0 1.0 1.0 || light color
|-
|'''film.imagepipelines.<pipeline #>.radiancescales.radiancescales.<id>.enabled''' || bool || 1 || enable radiance group
|}

====Image pipeline plug-ins====

=====Type: TONEMAP_LINEAR=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "TONEMAP_LINEAR" || linear tonemapping
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.scale''' || float || 1.0 || tonemapping scale
|}

=====Type: TONEMAP_REINHARD02=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "TONEMAP_REINHARD02" || reinhard tonemapping
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.prescale''' || float || 1.0 || reinhard prescale
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.postscale''' || float || 1.2 || reinhard postscale
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.burn''' || float || 3.75 || reinhard burn
|}

=====Type: TONEMAP_AUTOLINEAR=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "TONEMAP_AUTOLINEAR" || automatic linear tonemapping
|}

=====Type: TONEMAP_LUXLINEAR=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "TONEMAP_LUXLINEAR" || linear tonemapping with real camera settings
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.sensitivity''' || float || 100.0 || ISO sensitivity
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.exposure''' || float || 0.001 || exposure time
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.fstop''' || float || 2.8 || f/aperture
|}

=====Type: NOP=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipeline.<pipeline #>.<plugin #>.type''' || string || "NOP" || no parameters tonemapper
|}

=====Type: GAMMA_CORRECTION=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "TONEMAP_LINEAR" || gamma correction
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.value''' || float || 2.2 || gamma value
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.table.size''' || unsigned int || 4096 || resolution
|}

=====Type: OUTPUT_SWITCHER=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "OUTPUT_SWITCHER" || overwrite output
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.channel''' || string || "DEPTH" || channel whose values are used to overwrite
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.index''' || unsigned int || 0 || index
|}

=====Type: GAUSSIANFILTER_3x3=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "GAUSSIANFILTER_3x3" || gaussian filter
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.weight''' || float || 0.15 || blurring weight
|}

=====Type: CAMERA_RESPONSE_FUNC=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || CAMERA_RESPONSE_FUNC || analog camera film simulation
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.name''' || string || "Advantix_100CD" || film type
|}

=====Type: BACKGROUND_IMG=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || BACKGROUND_IMG || show the background image where alpha < 1 (simple compositing)
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.file''' || string || ... || background image path (e.g scenes/simple-mat/sky.exr)
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.gamma''' || float || 2.2 || background image gamma
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.storage ''' || string || auto || background image storage type
|}
Note: When the size of the background image differs from the film size, it will be stretched to fit the film size.

=====Type: BLOOM=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "BLOOM" || bloom effect
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.radius''' || float || 0.07 || how large the bloom effect is in % of the image size (i.e. 1.0 = all image)
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.weight''' || float || 0.25 || how strong the effect is (i.e. 0.0 = nothing, 1.0 = max. strength)
|}

=====Type: VIGNETTING=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "VIGNETTING" || vignetting effect
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.scale''' || float || 0.4 || vignetting strength
|}

=====Type: COLOR_ABERRATION=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "COLOR_ABERRATION" || color aberration effect
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.amount''' || float || 0.005 || color aberration amount
|}

=====Type: MIST=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "MIST" || aerial perspective effect (fake fog)
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.color''' || spectrum|| [1, 1, 1] || mist color
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.amount''' || float || 0.005 || mist amount
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.startdistance''' || float || 0 || distance from camera until where the mist effect has zero effect
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.enddistance''' || float || 10000 || distance from camera from where the mist effect has maximum effect
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.excludebackground''' || bool || false || Do not apply mist effect on pixels with infinite distance to the camera
|}

=====Type: CONTOUR_LINES=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "CONTOUR_LINES" || contour lines for IRRADIANCE AOV
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.range''' || float|| ? || ?
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.scale''' || float || ? || ?
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.steps''' || int || ? || ?
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.zerogridsize''' || int || ? || ?
|}

=====Type: WHITE_BALANCE =====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "WHITE_BALANCE" || White temperature correction
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.temperature''' || unsigned int|| 6500 || Target image temperature in Kelvin
|-
|}

=====Type: COLOR_LUT =====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "WHITE_BALANCE" || White temperature correction
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.file''' || string || "lut.cube" || Filepath to a [https://wwwimages2.adobe.com/content/dam/acom/en/products/speedgrade/cc/pdfs/cube-lut-specification-1.0.pdf .cube LUT file]
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.strength''' || float || 1.0 || Linear interpolation between input (0.0) and output (1.0) of the plugin
|-
|}

===Film Subregion===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.subregion''' || vector || ... || <xstart> <xstop> <ystart> <ystop>
|}

===Rendering halt conditions===

By default, a LuxCore rendering will never stop however you can enable one or multiple halt conditions:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''batch.haltnoisethreshold''' || float || -1.0 || enable image convergence test and stops when the error is under the defined value. Use a value like "n / 256.0" where n is the level of error you are looking for. It may be hard to achieve a level of error smaller than 3.0 / 256.0. -1.0 disables the halt condition.
|-
|'''batch.haltnoisethreshold.warmup''' || unsigned int || 64 || number of average samples per pixel before to start the convergence test
|-
|'''batch.haltnoisethreshold.step''' || unsigned int || 64 || number of average samples per pixel between two tests
|-
|'''batch.haltnoisethreshold.filter.enable''' || bool || 1 || if the CONVERGENCE AOV (generated by the batch.haltnoisethreshold) should be filtered or not with a 3x3 box filter
|-
|'''batch.haltnoisethreshold.stoprendering.enable''' || bool || 1 || Set this to 0 (false) if you only want to use the haltnoisethreshold settings for adaptive sampling in an endless render
|-
|'''batch.haltnoisethreshold.index''' || unsigned int || 0 || Film pipeline index used to estimate noise for stopping
|-
|'''batch.halttime''' || float || 0.0 || number of seconds before stopping the rendering
|-
|'''batch.haltspp''' || unsigned int || 0 || number of average samples per pixel before stopping the rendering
|}

===Noise estimation===

Image noise can be estimated and its result can be used to drive the Sobol and Random samplers to focus its sampling in the noisier regions.
Setting any of these properties will enable the noise estimation.
The adaptiveness strength is a Sampler property.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.noiseestimation.warmup''' || unsigned int || 32 || number of average samples per pixel before to start the convergence test
|-
|'''film.noiseestimation.step''' || unsigned int || 32 || number of average samples per pixel between two tests
|-
|'''film.noiseestimation.filter.scale''' || unsigned int || 4 || Box filter scale used to filter the NOISE AOV (generated by the noise estimation). Set to 0 to disable.
|-
|'''film.noiseestimation.index''' || unsigned int || 0 || Film pipeline index used to estimate noise for adaptive sampling
|-
|}

=Scene file=

==Camera==

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.camera.type''' || string || "perspective" || "perspective", "orthographic" or "environment" (360° panorama mapped in latlong format)
|-
|'''scene.camera.lookat.orig''' || point (float float float) || 0.0 10.0 0.0 || camera location
|-
|'''scene.camera.lookat.target''' || point (float float float) || 0.0 0.0 0.0 || camera target
|-
|'''scene.camera.up''' || vector (float float float) || (0.0, 0.0, 1.0) || camera up vector
|-
|'''scene.camera.fieldofview''' || float || 45.0 || field of view
|-
|'''scene.camera.screenwindow''' || vector || 0.0 1.0 0.0 1.0 || <xstart> <xstop> <ystart> <ystop>
|-
|'''scene.camera.shutteropen''' || float || 0.0 || camera shutter open time (used for motion blur)
|-
|'''scene.camera.shutterclose''' || float || 0.0 || camera shutter close time (used for motion blur)
|-
|'''scene.camera.autovolume.enable''' || bool || true || try automatically to discover scene.camera.volume
|-
|'''scene.camera.volume''' || string || || the initial volume rays will travel in
|}

The camera supports motion blur. See [[ LuxCore_SDL_Reference_Manual_v2.0#Object_Motion_Blur | Object Motion Blur ]]. 
(Only difference being that instead of the prefix '''scene.objects.<object name>''', the prefix '''scene.camera''' is used when setting motion properties of the camera)

==Textures==

Check [[LuxCoreRender_Textures|LuxCoreRender Textures]] for a high level description and examples of the textures.

===Mapping===

Some texture (mostly procedural textures) supports 2D or 3D mapping parameters:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.mapping.type''' || string || "uvmapping2d" || type of mapping
|-
|'''scene.textures.<texture name>.mapping.rotation''' || float || 0.0 || UV rotation (in degrees)
|-
|'''scene.textures.<texture name>.mapping.uvscale''' || UV || 1.0 1.0 || UV scale
|-
|'''scene.textures.<texture name>.mapping.uvdelta''' || UV || 0.0 0.0 || UV translation
|}

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.mapping.type''' || string || "uvmapping3d" || type of mapping
|-
|'''scene.textures.<texture name>.mapping.transformation''' || Matrix4x4 || 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0|| transformation matrix
|}

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.mapping.type''' || string || "globalmapping3d" || type of mapping
|-
|'''scene.textures.<texture name>.mapping.transformation''' || Matrix4x4 || 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0|| transformation matrix
|}

===Type: add===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "add" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant
|}

===Type: subtract===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "subtract" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant
|}

===Type: band===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "band" || type of texture
|-
|'''scene.textures.<texture name>.amount''' || texture || 0.5|| texture name or constant
|-
|'''scene.textures.<texture name>.interpolation''' || string || "linear"|| "linear", "cubic" or "none"
|-
|'''scene.textures.<texture name>.offset[0..n]''' || float || 0.0 || multiple offsets in the range of [0.0, 1.0]
|-
|'''scene.textures.<texture name>.value[0..n]''' || spectrum || 1.0 1.0 1.0 || a value for each offset
|}

===Type: blender_blend===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_blend" || type of texture
|-
|'''scene.textures.<texture name>.progressiontype''' || string || "linear" || linear, quadratic, easing, diagonal, spherical, quadratic_spherical, halo or radial
|-
|'''scene.textures.<texture name>.direction''' || string || "horizontal" || horizontal or vertical
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_clouds===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_clouds" || type of texture
|-
|'''scene.textures.<texture name>.noisetype''' || string || "soft_noise" || hard_noise or soft_noise
|-
|'''scene.textures.<texture name>.noisebasis''' || string || "blender_original" || blender_original, original_perlin, improved_perlin, voronoi_f1, voronoi_f2, voronoi_f3, voronoi_f4, voronoi_f2_f1, voronoi_crackle or cell_noise
|-
|'''scene.textures.<texture name>.noisesize''' || float || 0.25 ||
|-
|'''scene.textures.<texture name>.noisedepth''' || int || 2 ||
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_distortednoise===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_distortednoise" || type of texture
|-
|'''scene.textures.<texture name>.noise_distortion''' || string || "blender_original" || blender_original, original_perlin, improved_perlin, voronoi_f1, voronoi_f2, voronoi_f3, voronoi_f4, voronoi_f2_f1, voronoi_crackle or cell_noise
|-
|'''scene.textures.<texture name>.noisebasis''' || string || "blender_original" || blender_original, original_perlin, improved_perlin, voronoi_f1, voronoi_f2, voronoi_f3, voronoi_f4, voronoi_f2_f1, voronoi_crackle or cell_noise
|-
|'''scene.textures.<texture name>.noisesize''' || float || 0.25 ||
|-
|'''scene.textures.<texture name>.distortion''' || float || 1 ||
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_magic===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_magic" || type of texture
|-
|'''scene.textures.<texture name>.noisedepth''' || int || 2 ||
|-
|'''scene.textures.<texture name>.turbulence''' || float || 5.0 ||
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_marble===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_marble" || type of texture
|-
|'''scene.textures.<texture name>.marbletype''' || string || "soft" || soft, sharp or sharper
|-
|'''scene.textures.<texture name>.turbulence''' || float || 5.0 ||
|-
|'''scene.textures.<texture name>.noisebasis''' || string || "blender_original" || blender_original, original_perlin, improved_perlin, voronoi_f1, voronoi_f2, voronoi_f3, voronoi_f4, voronoi_f2_f1, voronoi_crackle or cell_noise
|-
|'''scene.textures.<texture name>.noisebasis2''' || string || "sin" || sin, saw or tri
|-
|'''scene.textures.<texture name>.noisedepth''' || int || 2 ||
|-
|'''scene.textures.<texture name>.noisesize''' || float || 0.25 ||
|-
|'''scene.textures.<texture name>.noisetype''' || string || "soft_noise" || soft_noise or hard_noise
|-
|'''scene.textures.<texture name>.turbulence''' || float || 5.0 ||
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_musgrave===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_musgrave" || type of texture
|-
|'''scene.textures.<texture name>.musgravetype''' || string || "multifractal" || multifractal, ridged_multifractal, hybrid_multifractal, fBM or hetero_terrain
|-
|'''scene.textures.<texture name>.noisebasis''' || string || "blender_original" || blender_original, original_perlin, improved_perlin, voronoi_f1, voronoi_f2, voronoi_f3, voronoi_f4, voronoi_f2_f1, voronoi_crackle or cell_noise
|-
|'''scene.textures.<texture name>.dimension''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.intensity''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.lacunarity''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.offset''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.gain''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.octaves''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.gain''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.noisesize''' || float || 0.25 ||
|-
|'''scene.textures.<texture name>.noisetype''' || string || "soft_noise" || soft_noise or hard_noise
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_noise===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_noise" || type of texture
|-
|'''scene.textures.<texture name>.noisedepth''' || int || 2 ||
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_stucci===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_stucci" || type of texture
|-
|'''scene.textures.<texture name>.stuccitype''' || string || "plastic" || plastic, wall_in or wall_out
|-
|'''scene.textures.<texture name>.noisebasis''' || string || "blender_original" || blender_original, original_perlin, improved_perlin, voronoi_f1, voronoi_f2, voronoi_f3, voronoi_f4, voronoi_f2_f1, voronoi_crackle or cell_noise
|-
|'''scene.textures.<texture name>.noisetype''' || string || "soft_noise" || soft_noise or hard_noise
|-
|'''scene.textures.<texture name>.noisesize''' || float || 0.25 ||
|-
|'''scene.textures.<texture name>.turbulence''' || float || 5.0 ||
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_wood===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_wood" || type of texture
|-
|'''scene.textures.<texture name>.woodtype''' || string || "bands" || bands, rings, bandnoise or ringnoise
|-
|'''scene.textures.<texture name>.noisebasis''' || string || "blender_original" || blender_original, original_perlin, improved_perlin, voronoi_f1, voronoi_f2, voronoi_f3, voronoi_f4, voronoi_f2_f1, voronoi_crackle or cell_noise
|-
|'''scene.textures.<texture name>.noisebasis2''' || string || "sin" || sin, saw or tri
|-
|'''scene.textures.<texture name>.noisetype''' || string || "soft_noise" || soft_noise or hard_noise
|-
|'''scene.textures.<texture name>.noisesize''' || float || 0.25 ||
|-
|'''scene.textures.<texture name>.turbulence''' || float || 5.0 ||
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_voronoi===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_voronoi" || type of texture
|-
|'''scene.textures.<texture name>.intensity''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.distmetric''' || string || "actual_distance" || actual_distance, distance_squared, manhattan, chebychev, minkowski_half, minkowski_four or minkowski
|-
|'''scene.textures.<texture name>.w1''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.w2''' || float || 0.0 ||
|-
|'''scene.textures.<texture name>.w3''' || float || 0.0 ||
|-
|'''scene.textures.<texture name>.w4''' || float || 0.0 ||
|-
|'''scene.textures.<texture name>.noisesize''' || float || 0.25 ||
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: brick===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "brick" || type of texture
|-
|'''scene.textures.<texture name>.bricktex''' || texture || 1.0 1.0 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.mortartex''' || texture || 0.2 0.2 0.2 || texture name or constant
|-
|'''scene.textures.<texture name>.brickmodtex''' || texture || 1.0 1.0 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.brickmodbias''' || float || 0.0 || With bias = -1, only the bricktex is used for the brick color. With bias between -1 and 1, a pseudo-random interpolation between bricktex and brickmodtex is used as brick color. With bias = 1, only the brickmodtex is used for the brick color.
|-
|'''scene.textures.<texture name>.brickbond''' || string || "running" || "flemish", "english", "herringbone", "basket" or "chain link"
|-
|'''scene.textures.<texture name>.brickwidth''' || float || 0.3 || brick width
|-
|'''scene.textures.<texture name>.brickheight''' || float || 0.1 || brick height
|-
|'''scene.textures.<texture name>.brickdepth''' || float || 0.15 || brick depth
|-
|'''scene.textures.<texture name>.mortarsize''' || float || 0.01 ||mortar size
|-
|'''scene.textures.<texture name>.brickrun''' || float || 0.75 || brick run
|}

This texture supports 3D mapping.

===Type: checkerboard3d===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "checkerboard3d" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 0.0 || texture name or constant
|}

This texture supports 3D mapping.

===Type: checkerboard2d===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "checkerboard2d" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 0.0 || texture name or constant
|}

This texture supports 2D mapping.

===Type: constfloat1===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "constfloat1" || type of texture
|-
|'''scene.textures.<texture name>.value''' || float || 1.0 || constant value
|}

===Type: constfloat3===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "constfloat3" || type of texture
|-
|'''scene.textures.<texture name>.value''' || spectrum || (1.0, 1.0, 1.0) || RGB constant value
|}

===Type: densitygrid===

You can use ".data", ".data3" or ".openvdb.file" to define the 3D grid values.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "densitygrid" || type of texture
|-
|'''scene.textures.<texture name>.nx''' || unsigned int || || grid x size
|-
|'''scene.textures.<texture name>.ny''' || unsigned int || || grid y size
|-
|'''scene.textures.<texture name>.nz''' || unsigned int || || grid z size
|-
|'''scene.textures.<texture name>.wrap''' || string || "repeat" || select the type of grid wrapping mode: "repeat", "black", "white", "clamp"
|-
|'''scene.textures.<texture name>.wrap''' || string || "repeat" || select the type of grid wrapping mode: "repeat", "black", "white", "clamp"
|-
|'''scene.textures.<texture name>.storage''' || string || "half" || select the type of memory storage: "auto", "byte", "half", "float"
|-
|'''scene.textures.<texture name>.data''' || float || || vector grid values (total count: nx * ny * nz)
|-
|'''scene.textures.<texture name>.data3''' || float || || vector grid values (total count: nx * ny * nz * 3)
|-
|'''scene.textures.<texture name>.openvdb.file''' || string || || OpenVDB file name
|-
|'''scene.textures.<texture name>.openvdb.grid''' || string || || OpenVDB grid name to read from the file
|}

===Type: dots===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "dots" || type of texture
|-
|'''scene.textures.<texture name>.inside''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.outside''' || texture || 0.0 || texture name or constant
|}

This texture supports 2D mapping.

===Type: fbm===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "fbm" || type of texture
|-
|'''scene.textures.<texture name>.octaves''' || int || 8 || noise octaves
|-
|'''scene.textures.<texture name>.roughness''' || float || 0.5 || noise roughness
|}

This texture supports 3D mapping.

===Type: fresnelapproxk===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "fresnelapproxk" || type of texture
|-
|'''scene.textures.<texture name>.texture''' || texture || (0.5, 0.5, 0.5) || texture name or constant
|}

===Type: fresnelapproxn===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "fresnelapproxn" || type of texture
|-
|'''scene.textures.<texture name>.texture''' || texture || (0.5, 0.5, 0.5) || texture name or constant
|}

===Type: hitpointalpha===

Use the value obtained by interpolating triangle vertices alphas.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "hitpointalpha" || type of texture
|}

===Type: hitpointcolor===

Use the color obtained by interpolating triangle vertices colors.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "hitpointcolor" || type of texture
|}

===Type: hitpointgrey===

Use the value obtained by interpolating triangle vertices colors, mapped to a float value (RGB converted into greyscale).

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "hitpointgrey" || type of texture
|-
|'''scene.textures.<texture name>.channel''' || int || -1 || the index of the RGB channel to use. -1 means the luminance of the RGB value
|}

===Type: hsv===

Hue saturation value manipulation.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "hsv" || type of texture
|-
|'''scene.textures.<texture name>.texture''' || texture || 0 0 0 || input color that will be manipulated
|-
|'''scene.textures.<texture name>.hue''' || texture || 0.5 || shift in hue (range: 0..1)
|-
|'''scene.textures.<texture name>.saturation''' || texture || 1.0 || saturation (range: 0..inf)
|-
|'''scene.textures.<texture name>.value''' || texture || 1.0 || brightness multiplier (range: 0..inf)
|}

===Type: imagemap===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "imagemap" || type of texture
|-
|'''scene.textures.<texture name>.file''' || string || "image.png" || name of the image file
|-
|'''scene.textures.<texture name>.gamma''' || float || 2.2 || gamma correction value used in the image
|-
|'''scene.textures.<texture name>.gain''' || float || 1.0 || image values are multiplied by gain value
|-
|'''scene.textures.<texture name>.storage''' || string || "auto" || select the type of memory storage: "auto", "byte", "half", "float"
|-
|'''scene.textures.<texture name>.wrap''' || string || "repeat" || select the type of image map wrapping mode: "repeat", "black", "white", "clamp"
|-
|'''scene.textures.<texture name>.channel''' || string || "default" || extract from the image only the selected channels: "default", "red", "green", "blue", "alpha", "mean", "colored_mean", "rgb"
|}

===Type: normalmap===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "normalmap" || type of texture
|-
|'''scene.textures.<texture name>.texture''' || texture || 0 0 0 || input. Is treated as an XYZ vector in tangent space.
|-
|'''scene.textures.<texture name>.scale''' || float || 1.0 || multiplier for adjusting normalmap height
|}

===Type: marble===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "marble" || type of texture
|-
|'''scene.textures.<texture name>.octaves''' || int || 8 || noise octaves
|-
|'''scene.textures.<texture name>.roughness''' || float || 0.5 || noise roughness
|-
|'''scene.textures.<texture name>.scale''' || float || 1.0 || marble scale
|-
|'''scene.textures.<texture name>.variation''' || float || 0.2 || marble variation
|}

This texture supports 3D mapping.

===Type: mix===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "mix" || type of texture
|-
|'''scene.textures.<texture name>.amount''' || texture || 0.5 || texture name or constant
|-
|'''scene.textures.<texture name>.texture1''' || texture || 0.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant
|}

===Type: scale===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "scale" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant
|}

===Type: uv===

This procedural texture has no parameters aside from the support of 2D mapping.

===Type: windy===

This procedural texture has no parameters aside from the support of 3D mapping.

===Type: wood===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "wood" || type of texture
|-
|'''scene.textures.<texture name>.woodtype''' || string || "bands" || "bands", "rings", "bandnoise" or "ringnoise"
|-
|'''scene.textures.<texture name>.noisebasis2''' || string || "sin" || "sin", "saw" or "tri"
|-
|'''scene.textures.<texture name>.noisetype''' || string || "soft_noise" || "soft_noise" or "hard_noise"
|-
|'''scene.textures.<texture name>.noisesize''' || float || 0.25 || noise size
|-
|'''scene.textures.<texture name>.turbulence''' || float || 5.0 || noise turbulence
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 || bright
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 || contrast
|}

This texture supports 3D mapping.

===Type: wrinkled===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "wrinkled" || type of texture
|-
|'''scene.textures.<texture name>.octaves''' || int || 8 || noise octaves
|-
|'''scene.textures.<texture name>.roughness''' || float || 0.5 || noise roughness
|}

This texture supports 3D mapping.

===Type: abs===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "abs" || type of texture
|-
|'''scene.textures.<texture name>.texture''' || texture || 1.0 || texture name or constant
|}

===Type: clamp===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "clamp" || type of texture
|-
|'''scene.textures.<texture name>.texture''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.min''' || float || 0.0 || lower boundary of the clamping
|-
|'''scene.textures.<texture name>.max''' || float || 1.0 || upper boundary of the clamping
|}

===Type: divide===

Note: If texture2 (the divisor) is 0, 0 is returned.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "divide" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant (dividend)
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant (divisor)
|}

===Type: remap===

This texture brings the value from the source range into the target range.

Note: The value is clamped into source range before performing the remap operation, and the resulting number is also clamped into the target range.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "remap" || type of texture
|-
|'''scene.textures.<texture name>.value''' || texture || 0.5 || texture name or constant
|-
|'''scene.textures.<texture name>.sourcemin''' || texture || 0.0 || texture name or constant
|-
|'''scene.textures.<texture name>.sourcemax''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.targetmin''' || texture || 0.0 || texture name or constant
|-
|'''scene.textures.<texture name>.targetmax''' || texture || 1.0 || texture name or constant
|}

===Type: objectid===

Raw object ID (range 0 to 0xfffffffe).

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "objectid" || type of texture
|}

===Type: objectidcolor===

Object ID interpreted as color. 
The object ID is a 4 byte unsigned int. To convert to color, the lower three bytes are interpreted as r, g, b values (each range 0 to 255). The highest byte is ignored.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "objectidcolor" || type of texture
|}

===Type: objectidnormalized===

Normalized object ID (range 0 to 1).

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "objectidnormalized" || type of texture
|}

===Type: dotproduct ===

Dot product of the two input vectors.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "dotproduct" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant
|}

===Type: power ===

pow(base, exponent)

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "power" || type of texture
|-
|'''scene.textures.<texture name>.base''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.exponent''' || texture || 1.0 || texture name or constant
|}

===Type: lessthan ===

returns 1 if texture1 < texture2, 0 if otherwise.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "lessthan" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant
|}

===Type: greaterthan ===

returns 1 if texture1 > texture2, 0 if otherwise.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "greaterthan" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant
|}

===Type: shadingnormal ===

Returns the shading normal of the mesh at the hitpoint.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "shadingnormal" || type of texture
|}

===Type: position ===

Returns the position of the hitpoint.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "position" || type of texture
|}

===Type: splitfloat3 ===

Extract a channel from a float3 texture. Can for example be used to get the R, G or B channel of a color texture, or to get the X, Y or Z components of a vector texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "splitfloat3" || type of texture
|-
|'''scene.textures.<texture name>.texture''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.channel''' || int || 0 || the channel to get from the input texture. 0 for first channel, 1 for second, 2 for third channel
|}

===Type: makefloat3 ===

Combine three float textures into one float3 texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "makefloat3" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture3''' || texture || 1.0 || texture name or constant
|}

===Type: blackbody===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blackbody" || type of texture
|-
|'''scene.textures.<texture name>.temperature''' || float || 6500 || emission temperature
|-
|'''scene.textures.<texture name>.normalize''' || bool || false || normalize the output
|}

===Type: irregulardata===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "irregulardata" || type of texture
|-
|'''scene.textures.<texture name>.wavelengths''' || vector || 580.0 620.0 660.0|| wavelenghts
|-
|'''scene.textures.<texture name>.data''' || vector || 0.0 0.000015 0.0|| data (length should match wavelength's length)
|}

===Type: lampspectrum===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "lampspectrum" || type of texture
|-
|'''scene.textures.<texture name>.name''' || string || "Daylight" || lamp light spectrum
|}

===Type: Fresnel Textures===

Textures for loading optical data

====Type: fresnelcolor====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || fresnelcolor || type of texture
|-
|'''scene.textures.<texture name>.kr''' || vector || 0.5 0.0 0.0 || reflection color
|}

====Type: fresnelpreset====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || fresnelpreset || type of texture
|-
|'''scene.textures.<texture name>.name''' || string || aluminium || fresnel preset ("aluminium", "silver", "copper", "gold" or "amorphous carbon")
|}

====Type: fresnelsopra====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || fresnelpreset || type of texture
|-
|'''scene.textures.<texture name>.file''' || string || ... || nk file path (e.g scenes/luxball/Au.nk)
|}

====Type: fresnelluxpop====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || fresnelpreset || type of texture
|-
|'''scene.textures.<texture name>.file''' || string || ... || nk file path (e.g scenes/luxball/Cr.nk)
|}

====Type: distort====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || distort || type of texture
|-
|'''scene.textures.<texture name>.texture''' || texture || 0.0 || texture name or constant; input texture
|-
|'''scene.textures.<texture name>.offset''' || texture || 0.0 || texture name or constant; offset to add to the hitpoint coordinates and UV values before evaluating the input texture
|-
|'''scene.textures.<texture name>.strength''' || float || 1.0 || strength multiplier, is multiplied with the offset
|}

==Volumes==

Check [[LuxCoreRender_Volumes|LuxCoreRender Volumes]] for a high level description and examples of the volumes.

All volumes share these properties

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.volumes.<volume name>.type''' || string || clear || volume type
|-
|'''scene.volumes.<volume name>.priority''' || unsigned int|| 0|| volume priority (when volumes overlap, the one with highest priority overrides the others)
|-
|'''scene.volumes.<volume name>.ior''' || texture|| ... || index of refraction
|-
|'''scene.volumes.<volume name>.absorption''' || texture || ... || absorption texture
|-
|'''scene.volumes.<volume name>.emission ''' || texture || ... || emission
|-
|'''scene.volumes.<volume name>.emission.id ''' || unsigned int || ... || emission ID
|}

===Volume: Clear===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.volumes.<volume name>.type''' || string || clear || volume type
|}

===Volume: Homogeneous===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.volumes.<volume name>.type''' || string || homogeneous|| volume type
|-
|'''scene.volumes.<volume name>.scattering''' || texture || ... || scattering texture
|-
|'''scene.volumes.<volume name>.asymmetry''' || texture || ... || asymmetry texture
|-
|'''scene.volumes.<volume name>.multiscattering''' || bool || ... || multiscattering
|}

===Volume: Heterogeneous===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.volumes.<volume name>.type''' || string || heterogeneous || volume type
|-
|'''scene.volumes.<volume name>.scattering''' || texture || ... || scattering texture
|-
|'''scene.volumes.<volume name>.asymmetry''' || texture || ... || asymmetry texture
|-
|'''scene.volumes.<volume name>.multiscattering''' || bool || ... || multiscattering
|-
|'''scene.volumes.<volume name>.steps.size''' || float || ... || step size
|-
|'''scene.volumes.<volume name>.steps.maxcount''' || unsigned int || ... || step maximum count
|}

==Materials==

Check [[LuxCoreRender_Materials|LuxCoreRender Materials]] for a high level description and examples of the materials.

===Common properties===

Common material properties:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.bumptex''' || texture || || texture to use for the bump mapping
|-
|'''scene.materials.<material name>.normaltex''' || texture || || texture to use for the normal mapping
|-
|'''scene.materials.<material name>.samples''' || int || -1 || number of rays used to sample this material. -1 means use the default global value. This property is an hint and the render engine can ignore this information.
|-
|'''scene.materials.<material name>.visibility.indirect.diffuse.enable''' || bool || true || if this material is visible in indirect rays. This property is an hint and the render engine can ignore this information.
|-
|'''scene.materials.<material name>.visibility.indirect.glossy.enable''' || bool || true || if this material is visible in indirect rays. This property is an hint and the render engine can ignore this information.
|-
|'''scene.materials.<material name>.visibility.indirect.specular.enable''' || bool || true || if this material is visible in indirect rays. This property is an hint and the render engine can ignore this information.
|-
|'''scene.materials.<material name>.bumpsamplingdistance''' || float || 0.001 || set the offset used to sample bump/normal mapping.
|-
|'''scene.materials.<material name>.volume.interior''' || string || vol1 || name of interior volume (for volume rendering)
|-
|'''scene.materials.<material name>.volume.exterior''' || string || vol2 || name of exterior volume (for volume rendering)
|-
|'''scene.materials.<material name>.id''' || int|| ... || material id
|-
|'''scene.materials.<material name>.transparency''' || texture || 1.0 || transparency of the material. 1 for opaque, 0 for fully transparent
|-
|'''scene.materials.<material name>.shadowcatcher.enable''' || bool || false || If true, the material will be transparent where hit by direct light and opaque otherwise (alpha transparency). Used for compositing.
|}

====Normal maps====
Normal maps are set first as a texture type and then assigned to the material. For example:

<blockquote><pre>
scene.textures.normmap.type = imagemap
scene.textures.normmap.file = scenes/bump/normal.png
scene.textures.normmap.gamma = 1

scene.materials.mat_white.type = matte
scene.materials.mat_white.kd = 0.8 0.8 0.8
scene.materials.mat_white.normaltex = normmap
</pre></blockquote>

====Light emission====

All materials can emit light:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.emission''' || texture || 0.0 0.0 0.0 || color of the emitted light
|-
|'''scene.materials.<material name>.emission.gain''' || spectrum || 1.0 1.0 1.0 || multiplier for lamp brigthness
|-
|'''scene.materials.<material name>.emission.power''' || float || 0.0 || lamp output power in watts. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.materials.<material name>.emission.efficency''' || float || 0.0 || luminous efficacy in lumens/watt. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.materials.<material name>.emission.mapfile''' || string || || the name of an optional image map that can be used to scale the emitted light
|-
|'''scene.materials.<material name>.emission.gamma''' || float || 2.2 || gamma value of the image map defined with .mapfile property
|-
|'''scene.materials.<material name>.emission.iesfile''' || string || || a [http://en.wikipedia.org/wiki/Illuminating_Engineering_Society_of_North_America IES] profile of emitted light
|-
|'''scene.materials.<material name>.emission.iesblob''' || blob || || a [http://en.wikipedia.org/wiki/Illuminating_Engineering_Society_of_North_America IES] profile of emitted light embedded in a blob
|-
|'''scene.materials.<material name>.emission.flipz''' || bool || false || flip the IES profile along the Z axis
|-
|'''scene.materials.<material name>.emission.samples''' || int || -1 || the number of shadow ray to trace to compute direct light from this material. This property is an hint and the render engine can ignore this information. -1 means use the default global value.
|-
|'''scene.materials.<material name>.emission.map.width''' || unsigned int || 0 || scale the image or IES map to the specified width. 0 means use the original size
|-
|'''scene.materials.<material name>.emission.map.height''' || unsigned int || 0 || scale the image or IES map to the specified height. 0 means use the original size
|-
|'''scene.materials.<material name>.emission.id''' || int || 0 || the radiance group the light emitted from this material is assigned to.
|-
|'''scene.materials.<material name>.emission.theta''' || float || 90.0 || How directional the light is emitted, set as the half-angle of the light source. Default is 90°. Smaller values mean that more light is emitted in the direction of the face normals and less to the sides.
|-
|'''scene.materials.<material name>.emission.importance''' || float || 1.0 || A hint how often to sample this light source compared to other lights
|}

===Type: archglass===

This material should be used to replace glass material of windows when rendering architectural interiors. It allows direct light to pass trough.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "archglass" || type of material
|-
|'''scene.materials.<material name>.kr''' || texture || 1.0 1.0 1.0 || texture or constant reflected color of the material
|-
|'''scene.materials.<material name>.kt''' || texture || 1.0 1.0 1.0 || texture or constant transmitted color of the material
|-
|'''scene.materials.<material name>.interiorior''' || texture || 1.5 || inside texture or constant index of refraction (only for volume-less rendering)
|-
|'''scene.materials.<material name>.exteriorior''' || texture || 1.0 || outside texture or constant index of refraction (only for volume-less rendering)
|-
|'''scene.materials.<material name>.filmthickness''' || texture || none || thickness (in nanometers) of a [https://en.wikipedia.org/wiki/Thin-film_interference thin-film coating] on the surface. This property is optional, if it is not defined, the coating is disabled.
|-
|'''scene.materials.<material name>.filmior''' || texture || none || Refractive index of the thin-film coating. This property is optional, if it is not defined, the coating is disabled.
|}

===Type: carpaint===

Car Paint is an advanced glossy material, simulating a diffuse surface with mutliple reflective coatings.

The available presets for the carpaint material are:

*"ford f8"
*"polaris silber"
*"opel titan"
*"bmw339"
*"2k acrylack"
*"white"
*"blue"
*"blue matte"

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "carpaint" || type of material
|-
|'''scene.materials.<material name>.preset''' || string || "ford f8" || one of the avilable presets
|-
|'''scene.materials.<material name>.ka''' || texture || 0.0 0.0 0.0 || absorption color
|-
|'''scene.materials.<material name>.d''' || texture || 0.0 || absorption depth
|-
|'''scene.materials.<material name>.kd''' || texture || 0.0 0.0 0.0 || diffuse color
|-
|'''scene.materials.<material name>.ks1''' || texture || 0.0 0.0 0.0 || specular color - layer 1
|-
|'''scene.materials.<material name>.ks2''' || texture || 0.0 0.0 0.0 || specular color - layer 2
|-
|'''scene.materials.<material name>.ks3''' || texture || 0.0 0.0 0.0 || specular color - layer 3
|-
|'''scene.materials.<material name>.r1''' || texture || 0.0 0.0 0.0 || fresnel effect strength - layer 1
|-
|'''scene.materials.<material name>.r2''' || texture || 0.0 0.0 0.0 || fresnel effect strength - layer 2
|-
|'''scene.materials.<material name>.r3''' || texture || 0.0 0.0 0.0 || fresnel effect strength - layer 3
|-
|'''scene.materials.<material name>.m1''' || texture || 0.0 0.0 0.0 || roughness - layer 1
|-
|'''scene.materials.<material name>.m2''' || texture || 0.0 0.0 0.0 || roughness - layer 2
|-
|'''scene.materials.<material name>.m3''' || texture || 0.0 0.0 0.0 || roughness - layer 3
|}

===Type: cloth===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "cloth" || type of material
|-
|'''scene.materials.<material name>.preset''' || string || "denim" || denim, silk_charmeuse, silk_shantung, cotton_twill, wool_garbardine or polyester_lining_cloth
|-
|'''scene.materials.<material name>.weft_kd''' || texture || 0.5 0.5 0.5 || coefficient of diffuse reflection in one weave direction
|-
|'''scene.materials.<material name>.weft_ks''' || texture || 0.5 0.5 0.5 || coefficient of specular reflection in one weave direction
|-
|'''scene.materials.<material name>.warp_kd''' || texture || 0.5 0.5 0.5 || coefficient of diffuse reflection in the opposite weave direction
|-
|'''scene.materials.<material name>.warp_ks''' || texture || 0.5 0.5 0.5 || coefficient of specular reflection in the opposite weave direction
|-
|'''scene.materials.<material name>.repeat_u''' || float || 100.0 || thread count in the u direction
|-
|'''scene.materials.<material name>.repeat_v''' || float || 100.0 || thread count in the v direction
|}

===Type: disney===

For more details, refer to the [https://disney-animation.s3.amazonaws.com/library/s2012_pbs_disney_brdf_notes_v2.pdf original paper].

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "disney" || type of material
|-
|'''scene.materials.<material name>.basecolor''' || texture || 0.5 0.5 0.5 || Base color
|-
|'''scene.materials.<material name>.subsurface''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.roughness''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.metallic''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.specular''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.speculartint''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.clearcoat''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.clearcoatgloss''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.anisotropic''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.sheen''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.sheentint''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.filmamount''' || texture || none || Linear interpolation between no film (0) and full film effect (1) for artistic control. This property is optional, if it is not defined, the coating is disabled.
|-
|'''scene.materials.<material name>.filmthickness''' || texture || none || thickness (in nanometers) of a [https://en.wikipedia.org/wiki/Thin-film_interference thin-film coating] on the surface. This property is optional, if it is not defined, the coating is disabled.
|-
|'''scene.materials.<material name>.filmior''' || texture || none || Refractive index of the thin-film coating. This property is optional, if it is not defined, the coating is disabled.
|}

===Type: glass===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "glass" || type of material
|-
|'''scene.materials.<material name>.kr''' || texture || 1.0 || texture or constant reflected color of the material
|-
|'''scene.materials.<material name>.kt''' || texture || 1.0 || texture or constant transmitted color of the material
|-
|'''scene.materials.<material name>.interiorior''' || texture || 1.5 || inside texture or constant index of refraction (only for volume-less rendering)
|-
|'''scene.materials.<material name>.exteriorior''' || texture || 1.0 || outside texture or constant index of refraction (only for volume-less rendering)
|-
|'''scene.materials.<material name>.cauchyb''' || texture || 0.0 || if defined and > 0.0, enable dispersion. The value is the B term of the [https://en.wikipedia.org/wiki/Cauchy%27s_equation Cauchy's equation]
|-
|'''scene.materials.<material name>.filmthickness''' || texture || none || thickness (in nanometers) of a [https://en.wikipedia.org/wiki/Thin-film_interference thin-film coating] on the surface. This property is optional, if it is not defined, the coating is disabled.
|-
|'''scene.materials.<material name>.filmior''' || texture || none || Refractive index of the thin-film coating. This property is optional, if it is not defined, the coating is disabled.
|}

===Type: glossy2===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "glossy2" || type of material
|-
|'''scene.materials.<material name>.kd''' || texture || 0.5 0.5 0.5 || texture or constant diffuse color of the material
|-
|'''scene.materials.<material name>.ks''' || texture || 0.5 0.5 0.5 || texture or constant specular color of the material
|-
|'''scene.materials.<material name>.uroughness''' || texture || 0.1 || texture or constant roughness value along u coordinate of the material
|-
|'''scene.materials.<material name>.vroughness''' || texture || 0.1 || texture or constant roughness value along v coordinate of the material
|-
|'''scene.materials.<material name>.ka''' || texture || 0.0 0.0 0.0 || texture or constant value of coefficient of absorption of the coating layer
|-
|'''scene.materials.<material name>.d''' || texture || 0.0 || texture or constant value of the depth (thickness) of the coating layer for absorption effects. (0 = disables)
|-
|'''scene.materials.<material name>.index''' || texture || 0.0 0.0 0.0 || IOR of the coating. IOR overrides color Ks if both are specified
|-
|'''scene.materials.<material name>.multibounce''' || bool || false || simulation of asperity (velvet-like reflection) on the glossy surface
|}

===Type: glossytranslucent===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "glossytranslucent" || type of material
|-
|'''scene.materials.<material name>.kd''' || texture || 0.5 0.5 0.5 || texture or constant diffuse color of the material
|-
|'''scene.materials.<material name>.kt''' || texture || 0.5 0.5 0.5 || texture or constant transmission color of the material
|-
|'''scene.materials.<material name>.ks''' || texture || 0.5 0.5 0.5 || texture or constant specular color of the material
|-
|'''scene.materials.<material name>.ks_bf''' || texture || 0.5 0.5 0.5 || texture or constant backface specular color of the material
|-
|'''scene.materials.<material name>.uroughness''' || texture || 0.1 || texture or constant roughness value along u coordinate of the material
|-
|'''scene.materials.<material name>.uroughness_bf''' || texture || 0.1 || texture or constant backface roughness value along u coordinate of the material
|-
|'''scene.materials.<material name>.vroughness''' || texture || 0.1 || texture or constant roughness value along v coordinate of the material
|-
|'''scene.materials.<material name>.vroughness_bf''' || texture || 0.1 || texture or constant backface roughness value along v coordinate of the material
|-
|'''scene.materials.<material name>.ka''' || texture || 0.0 0.0 0.0 || texture or constant value of coefficient of absorption of the coating layer
|-
|'''scene.materials.<material name>.ka_bf''' || texture || 0.0 0.0 0.0 || texture or constant value of backface coefficient of absorption of the coating layer
|-
|'''scene.materials.<material name>.d''' || texture || 0.0 || texture or constant value of the depth (thickness) of the coating layer for absorption effects. (0 = disables)
|-
|'''scene.materials.<material name>.d_bf''' || texture || 0.0 || texture or constant value of the backface depth (thickness) of the coating layer for absorption effects. (0 = disables)
|-
|'''scene.materials.<material name>.index''' || texture || 0.0 0.0 0.0 || IOR of the coating. IOR overrides color Ks if both are specified
|-
|'''scene.materials.<material name>.index_bf''' || texture || 0.0 0.0 0.0 || IOR of the backface coating. IOR overrides color Ks if both are specified
|-
|'''scene.materials.<material name>.multibounce''' || bool || false || simulation of asperity (velvet-like reflection) on the glossy surface
|-
|'''scene.materials.<material name>.multibounce_bf''' || bool || false || backface simulation of asperity (velvet-like reflection) on the glossy surface
|}

===Type: glossycoating===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "glossycoating" || type of material
|-
|'''scene.materials.<material name>.base''' || string || || name of base material, the coating layer is added on top of this material
|-
|'''scene.materials.<material name>.ks''' || texture || 0.5 0.5 0.5 || texture or constant specular color of the material
|-
|'''scene.materials.<material name>.uroughness''' || texture || 0.1 || texture or constant roughness value along u coordinate of the material
|-
|'''scene.materials.<material name>.vroughness''' || texture || 0.1 || texture or constant roughness value along v coordinate of the material
|-
|'''scene.materials.<material name>.ka''' || texture || 0.0 0.0 0.0 || texture or constant value of coefficient of absorption of the coating layer
|-
|'''scene.materials.<material name>.d''' || texture || 0.0 || texture or constant value of the depth (thickness) of the coating layer for absorption effects. (0 = disables)
|-
|'''scene.materials.<material name>.index''' || texture || 0.0 0.0 0.0 || IOR of the coating. IOR overrides color Ks if both are specified
|-
|'''scene.materials.<material name>.multibounce''' || bool || false || simulation of asperity (velvet-like reflection) on the glossy surface
|}

===Type: matte===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "matte" || type of material
|-
|'''scene.materials.<material name>.kd''' || texture || 0.75 0.75 0.75 || texture or constant color of the matte material
|}

===Type: mattetranslucent===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "mattetranslucent" || type of material
|-
|'''scene.materials.<material name>.kr''' || texture || 0.5 0.5 0.5 || texture or constant reflected color of the material
|-
|'''scene.materials.<material name>.kt''' || texture || 0.5 0.5 0.5 || texture or constant transmitted color of the material
|}

===Type: metal2===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "metal2" || type of material
|-
|'''scene.materials.<material name>.fresnel''' || fresnel texture || ... || [[#Type:_Fresnel_Textures | fresnel texture]]
|-
|'''scene.materials.<material name>.uroughness''' || texture || 0.1 || texture or constant roughness value along u coordinate of the material
|-
|'''scene.materials.<material name>.vroughness''' || texture || 0.1 || texture or constant roughness value along v coordinate of the material
|-
|'''scene.materials.<material name>.preset''' || string || "aluminium" || (DEPRECATED) "aluminium", "silver", "copper", "gold" or "amorphous carbon"
|-
|'''scene.materials.<material name>.n''' || texture || 0.5 0.5 0.5 || (DEPRECATED) texture or constant value. It can be used to directly define a fresnelapproxn texture on overwrite the .preset property
|-
|'''scene.materials.<material name>.k''' || texture || 0.5 0.5 0.5 || (DEPRECATED) texture or constant value. It can be used to directly define a fresnelapproxk texture on overwrite the .preset property
|}

===Type: mirror===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "mirror" || type of material
|-
|'''scene.materials.<material name>.kr''' || texture || 1.0 1.0 1.0 || texture or constant reflected color of the material
|}

===Type: mix===

This material can be used to mix 2 other materials.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "mix" || type of material
|-
|'''scene.materials.<material name>.material1''' || string || mat1 || name of another material
|-
|'''scene.materials.<material name>.material2''' || string || mat2 || name of another material
|-
|'''scene.materials.<material name>.amount''' || texture || 0.5 || texture or constant value used to mix the materials
|}

===Type: null===

This is empty, not visible material. It can be combined by using mix material with others. It is often used in combination with the alpha channel of an image map to render leafs, etc.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "null" || type of material
|}

===Type: roughglass===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "roughglass" || type of material
|-
|'''scene.materials.<material name>.kr''' || texture || 1.0 1.0 1.0 || texture or constant reflected color of the material
|-
|'''scene.materials.<material name>.kt''' || texture || 1.0 1.0 1.0 || texture or constant transmitted color of the material
|-
|'''scene.materials.<material name>.interiorior''' || texture || 1.5 || inside texture or constant index of refraction
|-
|'''scene.materials.<material name>.exteriorior''' || texture || 1.0 || outside texture or constant index of refraction
|-
|'''scene.materials.<material name>.uroughness''' || texture || 0.1 || texture or constant roughness value along u coordinate of the material
|-
|'''scene.materials.<material name>.vroughness''' || texture || 0.1 || texture or constant roughness value along v coordinate of the material
|-
|'''scene.materials.<material name>.filmthickness''' || texture || none || thickness (in nanometers) of a [https://en.wikipedia.org/wiki/Thin-film_interference thin-film coating] on the surface. This property is optional, if it is not defined, the coating is disabled.
|-
|'''scene.materials.<material name>.filmior''' || texture || none || Refractive index of the thin-film coating. This property is optional, if it is not defined, the coating is disabled.
|}

===Type: roughmatte===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "roughmatte" || type of material
|-
|'''scene.materials.<material name>.kd''' || texture || 0.75 0.75 0.75 || texture or constant color of the roughmatte material
|-
|'''scene.materials.<material name>.sigma''' || texture || 0.0 || the sigma parameter in the Oren-Nayer shader in degrees. Zero for pure Lambertian reflection
|}

===Type: velvet===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "velvet" || type of material
|-
|'''scene.materials.<material name>.kd''' || texture || 0.5 0.5 0.5 || color of the material's fuzz
|-
|'''scene.materials.<material name>.p1''' || texture || -2.0 || polynomial that influences the fuzz
|-
|'''scene.materials.<material name>.p2''' || texture || 20.0 || polynomial that influences the fuzz
|-
|'''scene.materials.<material name>.p3''' || texture || 2.0 || polynomial that influences the fuzz
|-
|'''scene.materials.<material name>.thickness''' || texture || 0.1 || height of the fuzz
|}

==Objects==

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.objects.<object name>.material''' || string || || type of object material
|-
|'''scene.objects.<object name>.shape''' || string || || name of [[#Shapes | shape]] with the triangle mesh description.Memory required to store the triangle mesh information is allocated only once if 2 or more different objects share the same shape, use .transformation property and true instancing is enabled.
|-
|'''scene.objects.<object name>.ply''' || string || || '''(Deprecated, use .shape instead)''' name of [http://en.wikipedia.org/wiki/PLY_(file_format) PLY] file with the triangle mesh description. Memory required to store the triangle mesh information is allocated only once if 2 or more different objects share the same file, use .transformation property and true instancing is enabled.
|-
|'''scene.objects.<object name>.transformation''' || matrix 4x4 || 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 || transformation matrix
|-
|'''scene.objects.<object name>.vertices''' || float || || This is an alternative syntax to using PLY file. It is an in-lined definition of the triangle mesh. It is a list of float values defining the vertices of the mesh (i.e. 3 coordinates for each vertex).
|-
|'''scene.objects.<object name>.faces''' || unsigned int || || This is an alternative syntax to using PLY file. It is an in-lined definition of the triangle mesh. It is a list of unsigned int values defining the triangles of the mesh (i.e. 3 index of vertices for each triangle).
|-
|'''scene.objects.<object name>.id''' || unsigned int || || object ID
|-
|'''scene.objects.<object name>.camerainvisible''' || bool || false || toggle visibility for camera rays. If set to true, the object will not show up in camera rays, but it will still be visible in reflections, refractions, shadows, indirect light etc.
|}

===Object Motion Blur===

LuxCore supports transformation motion blur for objects.
Motion blur is enabled if an object has a motion system defined as described below.

A motion system consists of steps (at least 2). Each step has a time (in seconds) and a transformation matrix of the object at this point in time.
Step indices start at 0. The times have to be monotonic (each greater than the last).

Note that the embree accelerator only supports a maximum of 129 time steps.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.objects.<object name>.motion.<step>.time''' || float || || time (in seconds) of the step
|-
|'''scene.objects.<object name>.motion.<step>.transformation''' || matrix 4x4 || 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 || transformation matrix of the object at the given step
|-
|}

==Shapes==

===Type: mesh===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.shapes.<shape name>.type''' || string || "mesh" || mesh shape
|-
|'''scene.shapes.<shape name>.ply''' || string || ... || mesh path (e.g ''scenes/luxball/luxball-shell.ply'')
|-
|'''scene.shapes.<shape name>.appliedtransformation''' || Matrix4x4 || 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0|| transformation matrix applied to the mesh vertices. Used to define the local object reference space.
|}

===Type: inlinedmesh===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.shapes.<shape name>.type''' || string || "inlinedmesh" || inlinedmesh shape
|-
|'''scene.shapes.<shape name>.vertices''' || vector || ... || inlinedmesh vertices (e.g 0.0 0.0 0.0 1.0 0.0 0.0 0.0 1.0 0.0)
|-
|'''scene.shapes.<shape name>.faces''' || vector || ... || inlinedmesh faces (e.g 0 1 2)
|-
|'''scene.shapes.<shape name>.appliedtransformation''' || Matrix4x4 || 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0|| transformation matrix applied to the mesh vertices. Used to define the local object reference space.
|}

===Type: pointiness===

Contains surface curvature information in vertex alpha channel. 
You can access this information in materials via a hitpointalpha texture. 
The values range from -1 to 1 (float). 
Values from -1 to 0 are concave, while values from 0 to 1 are convex.

[[ Shape:_Pointiness | Examples ]]

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.shapes.<shape name>.type''' || string || "pointiness" || pointiness shape
|-
|'''scene.shapes.<shape name>.source''' || string || ... || pointiness source (a mesh shape)
|}

===Type: strands===

Can be used for hair, fur, grass etc. 
Note that you need to define the camera before defining any strands shapes, because the tesselation process is viewpoint-dependent.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.shapes.<shape name>.type''' || string || "strands" || strands shape
|-
|'''scene.shapes.<shape name>.file''' || string || ... || strands file (''scenes/strands/straight.hair'')
|}

====Strands tessellation methods====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.shapes.<shape name>.tessellation.type''' || string || "ribbon" || ribbon tessellation
|-
|'''scene.shapes.<shape name>.tessellation.usecameraposition''' || bool || 1 || use camera position
|}

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.shapes.<shape name>.tessellation.type''' || string || "ribbonadaptive" || ribbon adaptive tessellation method
|-
|'''scene.shapes.<shape name>.tessellation.adaptative.maxdepth''' || unsigned int || 12 || max tessellation depth
|-
|'''scene.shapes.<shape name>.tessellation.adaptative.error ''' || float || 0.0075 || max tessellation error
|}

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.shapes.<shape name>.tessellation.type''' || string || "solid" || solid tessellation method
|-
|'''scene.shapes.<shape name>.tessellation.solid.sidecount ''' || unsigned int || 12 || tessellation's side count
|}

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.shapes.<shape name>.tessellation.type''' || string || "solidadaptive" || solidadaptive tessellation method
|-
|'''scene.shapes.<shape name>.tessellation.solidadaptive.sidecount ''' || unsigned int || 8 || tessellation's side count
|-
|'''scene.shapes.<shape name>.tessellation.solidadaptive.maxdepth''' || unsigned int || 16 || tessellation's max depth
|-
|'''scene.shapes.<shape name>.tessellation.solidadaptive.error''' || float || 0.05 || tessellation's max error
|}

===Type: group===

Todo.

===Type: displacement===

Todo.

===Type: subdiv===

Todo.

===Type: harlequin===

Todo.

===Type: simplify===

Todo.

===Type: islandaov===

Todo.

===Type: randomtriangleaov===

Todo.

==Light sources==

Check [[Lighting|LuxCoreRender Lighting]] for an high level description and example of the light sources.

===Common parameters===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.gain''' || spectrum || 1.0 1.0 1.0 || intensity of the light
|-
|'''scene.lights.<light name>.transformation''' || matrix 4x4 || 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 || transformation matrix
|-
|'''scene.lights.<light name>.samples''' || int || -1 || the number of shadow ray to trace to compute direct light for this light source. This property is an hint and the render engine can ignore this information. -1 means use the default global value.
|-
|'''scene.lights.<light name>.id''' || int || 0 || the radiance group the light emitted from this material is assigned to.

|-
|'''scene.lights.<light name>.importance''' || float || 1.0 || A hint how often to sample this light compared to other lights
|}

===Type: sun===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "sun" || type of light
|-
|'''scene.lights.<light name>.turbidity''' || float || 2.2 || turbidity can go from 1.0 to 30+. 2-6 are most useful for clear days
|-
|'''scene.lights.<light name>.relsize''' || float || 1.0 || relative size to the sun
|-
|'''scene.lights.<light name>.dir''' || vector || 0.0 0.0 1.0 || direction vector of the sun
|-
|'''scene.lights.<light name>.visibility.indirect.diffuse.enable''' || bool || true || if the light source is visible by indirect rays on diffuse surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.visibility.indirect.glossy.enable''' || bool || true || if the light source is visible by indirect rays on glossy surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.visibility.indirect.specular.enable''' || bool || true || if the light source is visible by indirect rays on specular surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|}

===Type: sky2===

Hosek-Wilkie sky model.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "sky2" || type of light
|-
|'''scene.lights.<light name>.turbidity''' || float || 2.2 || turbidity can go from 1.0 to 30+. 2-6 are most useful for clear days
|-
|'''scene.lights.<light name>.dir''' || vector || 0.0 0.0 1.0 || direction vector of the sun
|-
|'''scene.lights.<light name>.gain''' || vector || ... || gain
|-
|'''scene.lights.<light name>.groundalbedo''' || vector || 0.5 0.5 0.5 || ground albedo
|-
|'''scene.lights.<light name>.visibility.indirect.diffuse.enable''' || bool || true || if the light source is visible by indirect rays on diffuse surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.visibility.indirect.glossy.enable''' || bool || true || if the light source is visible by indirect rays on glossy surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.visibility.indirect.specular.enable''' || bool || true || if the light source is visible by indirect rays on specular surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.ground.enable''' || bool || 1 || enable ground color
|-
|'''scene.lights.<light name>.ground.color''' || vector|| ... || RGB ground color
|}

===Type: infinite===

Spherical lightsource surrounding the scene at infinite distance. 
Used for image based lighting (IBL) and HDR environment lighting if the file is a high dynamic range image.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "infinite" || type of light
|-
|'''scene.lights.<light name>.file''' || string || "image.png" || filename of the environment map
|-
|'''scene.lights.<light name>.gamma''' || float || 2.2 || gamma correction used by the image map
|-
|'''scene.lights.<light name>.storage''' || string || "auto" || environment map storage type ("auto", "byte", "half" or "float")
|-
|'''scene.lights.<light name>.visibility.indirect.diffuse.enable''' || bool || true || if the light source is visible by indirect rays on diffuse surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.visibility.indirect.glossy.enable''' || bool || true || if the light source is visible by indirect rays on glossy surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.visibility.indirect.specular.enable''' || bool || true || if the light source is visible by indirect rays on specular surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.sampleupperhemisphereonly''' || bool || false || an option set to black the lower hemisphere. Mostly useful for shadow catchers.
|}

===Type: point===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "point" || type of light
|-
|'''scene.lights.<light name>.position''' || point || 0.0 0.0 0.0 || position
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.power''' || float || 0.0 || lamp output power in watts. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.efficency''' || float || 0.0 || luminous efficacy in lumens/watt. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|}

===Type: mappoint===

Point light with support for IES files or image maps controlling the strength of light emitted.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "mappoint" || type of light
|-
|'''scene.lights.<light name>.position''' || point || 0.0 0.0 0.0 || position
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.power''' || float || 0.0 || lamp output power in watts. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.efficency''' || float || 0.0 || luminous efficacy in lumens/watt. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.mapfile''' || string || || the name of an optional image map that can be used to scale the emitted light
|-
|'''scene.lights.<light name>.gamma''' || float || 2.2 || gamma value of the image map defined with .mapfile property
|-
|'''scene.lights.<light name>.iesfile''' || string || || a [http://en.wikipedia.org/wiki/Illuminating_Engineering_Society_of_North_America IES] profile of emitted light and the render engine can ignore this information. -1 means use the default global value.
|-
|'''scene.lights.<light name>.iesblob''' || string || || a [http://en.wikipedia.org/wiki/Illuminating_Engineering_Society_of_North_America IES] profile of emitted light embedded in a blob
|-
|'''scene.lights.<light name>.flipz''' || bool || false || flip the IES profile along the Z axis
|-
|'''scene.lights.<light name>.map.width''' || unsigned int || 0 || scale the image or IES map to the specified width. 0 means use the original size
|-
|'''scene.lights.<light name>.map.height''' || unsigned int || 0 || scale the image or IES map to the specified height. 0 means use the original size
|}

===Type: sphere===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "sphere" || type of light
|-
|'''scene.lights.<light name>.position''' || point || 0.0 0.0 0.0 || position
|-
|'''scene.lights.<light name>.radius''' || float || 1.0 || position
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.power''' || float || 0.0 || lamp output power in watts. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.efficency''' || float || 0.0 || luminous efficacy in lumens/watt. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|}

===Type: mapsphere===

Sphere light with support for IES files or image maps controlling the strength of light emitted.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "mapsphere" || type of light
|-
|'''scene.lights.<light name>.position''' || point || 0.0 0.0 0.0 || position
|-
|'''scene.lights.<light name>.radius''' || float || 1.0 || position
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.power''' || float || 0.0 || lamp output power in watts. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.efficency''' || float || 0.0 || luminous efficacy in lumens/watt. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.mapfile''' || string || || the name of an optional image map that can be used to scale the emitted light
|-
|'''scene.lights.<light name>.gamma''' || float || 2.2 || gamma value of the image map defined with .mapfile property
|-
|'''scene.lights.<light name>.iesfile''' || string || || a [http://en.wikipedia.org/wiki/Illuminating_Engineering_Society_of_North_America IES] profile of emitted light and the render engine can ignore this information. -1 means use the default global value.
|-
|'''scene.lights.<light name>.iesblob''' || string || || a [http://en.wikipedia.org/wiki/Illuminating_Engineering_Society_of_North_America IES] profile of emitted light embedded in a blob
|-
|'''scene.lights.<light name>.flipz''' || bool || false || flip the IES profile along the Z axis
|-
|'''scene.lights.<light name>.map.width''' || unsigned int || 0 || scale the image or IES map to the specified width. 0 means use the original size
|-
|'''scene.lights.<light name>.map.height''' || unsigned int || 0 || scale the image or IES map to the specified height. 0 means use the original size
|}

===Type: spot===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "spot" || type of light
|-
|'''scene.lights.<light name>.position''' || point || 0.0 0.0 0.0 || position
|-
|'''scene.lights.<light name>.target''' || point || 0.0 0.0 1.0 || target
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.power''' || float || 0.0 || lamp output power in watts. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.efficency''' || float || 0.0 || luminous efficacy in lumens/watt. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.coneangle''' || float || 30.0 || angle in degrees of the spotlight cone
|-
|'''scene.lights.<light name>.conedeltaangle''' || float || 5.0 || angle at which the spotlight intensity starts to fade from the edge
|}

===Type: projection===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "projection" || type of light
|-
|'''scene.lights.<light name>.position''' || point || 0.0 0.0 0.0 || position
|-
|'''scene.lights.<light name>.target''' || point || 0.0 0.0 1.0 || target
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.power''' || float || 0.0 || lamp output power in watts. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.efficency''' || float || 0.0 || luminous efficacy in lumens/watt. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.fov''' || float || 45.0 || field of view in terms of angular spread along the shorter image axis
|-
|'''scene.lights.<light name>.mapfile''' || string || || filename of the image to project. If not specified, a constat light color will be used.
|-
|'''scene.lights.<light name>.gamma''' || float || 2.2 || gamma value of the image map defined with .mapfile property
|}

===Type: constantinfinite===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "constantinfinite" || type of light
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.visibility.indirect.diffuse.enable''' || bool || true || if the light source is visible by indirect rays on diffuse surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.visibility.indirect.glossy.enable''' || bool || true || if the light source is visible by indirect rays on glossy surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.visibility.indirect.specular.enable''' || bool || true || if the light source is visible by indirect rays on specular surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|}

===Type: sharpdistant===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "sharpdistant" || type of light
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.direction''' || vector || 0.0 0.0 1.0 || direction
|}

===Type: distant===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "distant" || type of light
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.direction''' || vector || 0.0 0.0 1.0 || direction
|-
|'''scene.lights.<light name>.theta''' || float || 10.0 || half angle of the light source in degree. Must be > 0 for soft shadows
|}

===Type: laser===

A light source emitting parallel light rays (like sharpdistant light, but starting inside the scene instead of infinitely far away).

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "laser" || type of light
|-
|'''scene.lights.<light name>.position''' || point || 0.0 0.0 0.0 || position
|-
|'''scene.lights.<light name>.target''' || point || 0.0 0.0 1.0 || target
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.power''' || float || 0.0 || lamp output power in watts. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.efficency''' || float || 0.0 || luminous efficacy in lumens/watt. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.radius''' || float || 0.01 || radius of the laser beam
|}

LuxCore SDL Reference Manual v2.5

2020-11-03T17:37:22Z

Byob: glass cauchyc -> cauchyb

The scene description language (SDL) is used to configure the renderer and to define objects, materials, textures etc. in the scene. 
The file ending of the render configuration file is ".cfg", for the scene file it's ".scn".

These files are usually created by exporter plugins, e.g. BlendLuxCore. 
This wiki page is primarily a reference for exporter developers, normal end-users should not need to edit cfg/scn files by hand.

Sometimes the API is updated faster than the wiki, in this case you can look at the code directly: https://github.com/LuxCoreRender/LuxCore/tree/master/src/slg/scene

Note that matrices are passed as flat lists in column-major form.

=Render configuration file=

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''resumerendering.filesafe''' || bool || 1 || enable/disable "safe save" mode for resume rendering file. A backup of the output is always valid even in the case of a system failure
|}

==Seed==

The global seed value that is used to generate random numbers. 
Two images rendered with the same seed will have the same noise pattern.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''renderengine.seed''' || unsigned int || 1 || min 1
|}

==Periodic save==

Options related to periodic save operations.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''periodicsave.resumerendering.period''' || float || 0 || save the resume rendering file every specified amount of time (value in seconds). A value <= 0.0 disable the saving
|-
|'''periodicsave.resumerendering.filename''' || string || "resume.rsm" || the name to use to save the rendering resume information periodically
|-
|'''periodicsave.film.period''' || float || 0 || save the Film every specified amount of time (value in seconds). A value <= 0.0 disable the saving
|-
|'''periodicsave.film.filename''' || string || "film.flm" || the name to use to save the film periodically
|-
|'''periodicsave.film.outputs.period''' || float || 600 || save all Film outputs every specified amount of time (value in seconds). A value <= 0.0 disable the saving
|}

==Render Engine==

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''renderengine.type''' || string || "PATHCPU" || engine type
|}

=== CPU Render Engines ===

CPU render engines are written in C++ and don't require OpenCL. All CPU render engines accept the following parameters:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''native.threads.count''' || int || CPU core count || > 0 || > 0 || The number of threads will be used for the rendering
|}

'''The following CPU engines are available:'''

===="PATHCPU"====

A path tracer with full image plane rendering (i.e. supporting Metropolis sampler).

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''path.pathdepth.total''' || int || 6 || > 0 || [1, 16] || Maximum recursion depth of a path
|-
|'''path.pathdepth.diffuse''' || int || 4 || > 0 || [1, 16] ||
|-
|'''path.pathdepth.glossy''' || int || 4 || > 0 || [1, 16] ||
|-
|'''path.pathdepth.specular''' || int || 6 || > 0 || [1, 16] ||
|-
|'''path.russianroulette.depth''' || int || 3 || > 0 || [1, path.maxdepth] || The path depth where Russian Roulette stars to be used
|-
|'''path.russianroulette.cap''' || float || 0.5 || [0.0, 1.0] || [0.0, 1.0] || The threshold over which Russian Roulette is used
|-
|'''path.clamping.variance.maxvalue''' || float || 0.0 || > 0.0 || > 0.0 || Samples brighter than this value are clamped, helps to reduce fireflies. 0.0 = disabled
|-
|'''path.forceblackbackground.enable''' || bool || 0 || 0 or 1 || 0 or 1 || Enable when rendering with transparent film and premultiplied alpha, to avoid artifacts with semi-transparent areas
|}

===="TILEPATHCPU"====
Biased path tracer with many control options and support for tile rendering. 
The sampler must be set to TILEPATHSAMPLER when using this engine.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''path.pathdepth.total''' || int || 6 || > 0 || [1, 16] || Maximum recursion depth of a path
|-
|'''path.pathdepth.diffuse''' || int || 4 || > 0 || [1, 16] ||
|-
|'''path.pathdepth.glossy''' || int || 4 || > 0 || [1, 16] ||
|-
|'''path.pathdepth.specular''' || int || 6 || > 0 || [1, 16] ||
|-
|'''path.russianroulette.depth''' || int || 3 || > 0 || [1, path.maxdepth] || The path depth where Russian Roulette stars to be used
|-
|'''path.russianroulette.cap''' || float || 0.5 || [0.0, 1.0] || [0.0, 1.0] || The threshold over which Russian Roulette is used
|-
|'''path.clamping.variance.maxvalue''' || float || 0.0 || > 0.0 || > 0.0 || Samples brighter than this value are clamped, helps to reduce fireflies. 0.0 = disabled
|-
|'''path.forceblackbackground.enable''' || bool || 0 || 0 or 1 || 0 or 1 || Enable when rendering with transparent film and premultiplied alpha, to avoid artifacts with semi-transparent areas
|-
|'''tilepath.sampling.aa.size''' || int || 3 || > 0 || [1, 13] || All diffuse/glossy/specular samples are multiplied with the squared aa size: final_samples = aa^2 * (diffuse^2 + glossy^2 + specular^2)
|-
|'''tile.size''' || int || 32 || ≥ 8 || [8, 256] || Tile size in pixels
|-
|'''tile.multipass.enable''' || bool || 1 || 0 or 1 || o or 1 || Re-render the image until a halt threshold is met or indefinitely
|-
|'''tile.multipass.convergencetest.threshold''' || float || 6.0 / 256.0 || > 0.0 || [1.0 / 256.0, 6.0 / 256.0] || Target noise level
|-
|'''tile.multipass.convergencetest.threshold.reduction''' || float || 0.0 || [0.0, 1.0] || [0.75, 0.95] || Multiply noise level with this number when all tiles have met the previous noise level. Set to 0 to disable (so rendering will stop at the noise level)
|-
|'''tile.multipass.convergencetest.warmup.count''' || int || 32 || ≥ 0 || [8, 128] || Warm up period for the convergence test expressed in samples per pixel
|}

===="BIDIRCPU"====

A Bidirectional path tracer.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''path.maxdepth''' || int || 5 || > 0 || [1, 16] || Maximum recursion depth of a eye path
|-
|'''light.maxdepth''' || int || 5 || > 0 || [1, 16] || Maximum recursion depth of a light path
|-
|'''path.russianroulette.depth''' || int || 3 || > 0 || [1, path.maxdepth] || The path depth where Russian Roulette starts to be used
|-
|'''path.russianroulette.cap''' || float || 0.5 || [0.0, 1.0] || [0.0, 1.0] || The threshold over which Russian Roulette is used
|}

===="RTPATHCPU"====
Engine optimized for interactive scene editing and camera movement. 
The sampler must be set to RTPATHCPUSAMPLER when using this engine.

Supports the same properties as [[#"PATHCPU" | "PATHCPU"]] plus the following:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''rtpathcpu.zoomphase.size''' || int || 4 || || || render scaled down film for the first few frames after a scene edit (to make interactions more fluid)
|-
|'''rtpathcpu.zoomphase.weight''' || float || 0.1 || || || description: TODO
|}

=== OpenCL Render Engines ===

OpenCL engines can run on GPUs, CPUs and other types of computing devices, they require OpenCL to run. All OpenCL render engines accept the following parameters:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''opencl.platform.index''' || int || -1 || A valid platform index || -1 || Select the OpenCL platform to use. All devices available on all platforms will be used with -1
|-
|'''opencl.cpu.use''' || bool || 1 || 0 or 1 || 0 or 1 || If to use all OpenCL CPU devices available
|-
|'''opencl.gpu.use''' || bool || 1 || 0 or 1 || 0 or 1 || If to use all OpenCL GPU devices available
|-
|'''opencl.cpu.workgroup.size''' || int || 0 || Any valid OpenCL workgroup size || 64 || Set the OpenCL workgroup size, 0 means to use the driver suggested value
|-
|'''opencl.gpu.workgroup.size''' || int || 0 || Any valid OpenCL workgroup size || 64 || Set the OpenCL workgroup size, 0 means to use the driver suggested value
|-
|'''opencl.devices.select''' || string || "" || Any valid selection string || Any valid selection string || Select each OpenCL device to use. It is a string of "0" and "1". "1" means use the device, "0" do not
|}

'''The following OpenCL engines are available:'''

===="PATHOCL"====
OpenCL version of PATHCPU. Supports the same settings as [[#"PATHCPU" | PATHCPU]] plus the following:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''pathocl.pixelatomics.enable''' || bool || 0 || 0 or 1 || 0 or 1 || Enable pixel atomic operation
|-
|'''opencl.task.count''' || int || "AUTO" || "AUTO" or > 0 || [64K, 1024K] || The number of tasks sent to the OpenCL device in one kernel call
|}

===="RTPATHOCL"====

A PATHOCL version optimized for real-time rendering with fixed frame-rate and variable quality. 
The sampler must be set to TILEPATHSAMPLER when using this engine.

Supports the same settings as [[#"PATHOCL" | PATHOCL]] plus the following:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''rtpath.resolutionreduction.preview''' || int || 4 || > 0 || [1, 32] || Render a sample every n x n pixels in the first passes. For instance 4x4 than 2x2 and than always 1x1
|-
|'''rtpath.resolutionreduction.preview.step''' || int || 8 || > 0 || [1, 32] || Each preview step is rendered for n frames
|-
|'''rtpath.resolutionreduction''' || int || 4 || > 0 || [1, 32] || Render a sample every n x n pixels, outside the preview phase, in order to reduce the per frame rendering time
|}

===="TILEPATHOCL"====

OpenCL version of TILEPATHCPU. 
The sampler must be set to TILEPATHSAMPLER when using this engine.

Supports the same settings as [[#"TILEPATHCPU" | TILEPATHCPU]] plus the following:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''tilepathocl.devices.maxtiles''' || int || 16 || ≥ 1 || [1, 32] || Maximum number of tiles to send in a single call to each OpenCL device
|}

==="FILESAVER"===

Saves everything needed to render the scene to the output path, including textures and meshes.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''filesaver.format''' || string || "TXT" || "TXT" for a text SDL format and "BIN" for a single file binary format
|-
|'''filesaver.filename''' || string || "luxcore-exported-scene.bcf" || file name for "BIN" format
|-
|'''filesaver.directory''' || string || "luxcore-exported-scene" || output path for "TXT" format
|-
|'''filesaver.renderengine.type''' || string || "PATHCPU" || render engine to use when rendering the scene after it was saved with FILESAVER. Any engine string from above can be used here.
|}

===Experimental and debugging engines===

'''These engines are experimental, deprecated or are only intended for very specific purposes:'''

===="BIDIRVMCPU"====

Bidir with vertex merging, currently experimental. 
Supports the same settings as [[#"BIDIRCPU" | BIDIRCPU]] plus the following:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''bidirvm.lightpath.count''' || int || 16 * 1024 || > 0 || || Number of lightpaths per pass
|-
|'''bidirvm.startradius.scale''' || float || 0.003 || > 0 || || Photon radius of the first pass
|-
|'''bidirvm.alpha''' || float || 3 || > 0 || [0.0, 1.0] || Photon radius is multiplied with this value after every pass to reduce the radius
|}

===="LIGHTCPU"====

For testing.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''light.maxdepth''' || int || 5 || > 0 || [1, 16] || Maximum recursion depth of a light path
|-
|'''light.russianroulette.depth''' || int || 3 || > 0 || [1, path.maxdepth] || The path depth where Russian Roulette starts to be used
|-
|'''light.russianroulette.cap''' || float || 0.5 || [0.0, 1.0] || [0.0, 1.0] || The threshold over which Russian Roulette is used
|}

==Sampler==

Samplers are used by following render engines:

* LIGHTCPU
* PATHCPU
* BIDIRCPU
* BIDIRVMCPU
* PATHOCL

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''sampler.type''' || string || "SOBOL" || sampler type
|}

The following samplers are available:

==="SOBOL"===

Sampler with sobol pattern.
Parameters:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''sampler.sobol.adaptive.strength''' || float || 0.7 || 0 ≤ x < 0.95 || 0.5 - 0.9 || it sets if the sampler should be more or less adaptive
|}

==="METROPOLIS"===

Metropolis sampler.
Parameters:
{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''sampler.metropolis.largesteprate''' || float || 0.4 || 0 ≤ x ≤ 1 || 0 - 1 || Probability of generating a large sample mutation
|-
|'''sampler.metropolis.maxconsecutivereject''' || int || 512 || x ≥ 0 || 0 - 32768 || Number of consecutive rejects before a next mutation is forced. Low values can cause bias
|-
|'''sampler.metropolis.imagemutationrate''' || float || 0.1 || 0 ≤ x ≤ 1 || 0 - 1 || Maximum distance over the image plane for a small mutation
|}

==="RANDOM"===

Fully random sampler. This sampler is mostly intended for testing purpose.
Parameters:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''sampler.random.adaptive.strength''' || float || 0.7 || 0 ≤ x < 0.95 || 0.5 - 0.9 || it sets if the sampler should be more or less adaptive
|}

==Filter==

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''film.filter.type''' || string || "BLACKMANHARRIS" || || || Type of pixel filter.
|-
|'''film.filter.width''' || float || 2.0 || x > 0.0 || 0.1 - 3.0 || Filter radius in pixels. Does not have an effect on the NONE filter
|-
|'''film.filter.xwidth''' || float || 2.0 || x > 0.0 || 0.1 - 3.0 || Width in pixels. Overwrite '''film.filter.width''' value
|-
|'''film.filter.ywidth''' || float || 2.0 || x > 0.0 || 0.1 - 3.0 || Width in pixels. Overwrite '''film.filter.width''' value
|}

Available filters are:

==="NONE"===

Disable pixel filtering.

==="BOX"===

Box pixel filter. No parameters.

==="GAUSSIAN"===

Gaussian pixel filter.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''film.filter.gaussian.alpha''' || float || 2.0 || x > 0.0 || 0.1 - 10.0 || Gaussian rate of falloff. Lower values give blurrier images.
|}

==="MITCHELL"===

Mitchel pixel filter.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
| '''film.filter.mitchell.b''' || float || 1.0/3.0 || 0.0 ≤ x ≤ 1.0 || 0.0 - 1.0 || B parameter for the mitchell filter in the range
|-
| '''film.filter.mitchell.c''' || float || 1.0/3.0 || 0.0 ≤ x ≤ 1.0 || 0.0 - 1.0 || C parameter for the mitchell filter in the range 0..1
|}

==="MITCHELL_SS"===

Mitchel pixel filter with super-sampling (i.e. image will be filtered first with a grid of 4 pixels for each pixel).

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
| '''film.filter.mitchellss.b''' || float || 1.0/3.0 || 0.0 ≤ x ≤ 1.0 || 0.0 - 1.0 || B parameter for the mitchell filter in the range
|-
| '''film.filter.mitchellss.c''' || float || 1.0/3.0 || 0.0 ≤ x ≤ 1.0 || 0.0 - 1.0 || C parameter for the mitchell filter in the range 0..1
|}

==="BLACKMANHARRIS"===

Blcakman-Harris pixel filter. No parameters.

==Light Strategy==

The direct light sampling strategy is defined by the following property:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''lightstrategy.type''' || string || "LOG_POWER" || "UNIFORM", "POWER", "LOG_POWER" or "DLS_CACHE" || N/A || Direct light sampling strategy
|}

==="UNIFORM"===

"UNIFORM" light strategy samples evenly all light sources.

==="POWER"===

"POWER" light strategy samples the light sources based on their power.

==="LOG_POWER"===

"LOG_POWER" light strategy samples the light sources based on logarithm of their power.

==="DLS_CACHE"===

Build direct light sampling cache to optimize many-lights rendering, beneficial in scenes with multiple light sources with few overlap between their influence areas (e.g. a building with many disconnected rooms and interior lights).

Options for the DLS cache:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''lightstrategy.entry.radius''' || float || 0.0 || || N/A || Entry radius in meters, automatic radius estimation is used if the radius is set to 0
|-
|'''lightstrategy.entry.normalangle''' || float || 25.0 || || N/A ||
|-
|'''lightstrategy.entry.maxpasses''' || int || 1024 || || N/A ||
|-
|'''lightstrategy.entry.convergencethreshold''' || float || 0.05 || || N/A ||
|-
|'''lightstrategy.entry.warmupsamples''' || int || 24 || || N/A ||
|-
|'''lightstrategy.targetcachehitratio''' || float || 0.995 || || N/A ||
|-
|'''lightstrategy.maxdepth''' || int || 4 || || N/A ||
|-
|'''lightstrategy.maxsamplescount''' || int || 10000000 || || N/A ||
|-
|'''lightstrategy.persistent.file''' || string || "" || || N/A ||
|-
|'''lightstrategy.persistent.safesave''' || bool || 1 || || N/A ||

|}

==Accelerator==

The ray/triangle intersection accelerator to use for the rendering is defined by the following properties:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''accelerator.type''' || string || "AUTO" || "AUTO", "BVH", "MBVH", "EMBREE" || "AUTO" || The intersection accelerator. "AUTO" will select the best one available for the current [[LuxRays]] intersection device. "EMBREE" is currently usable only on CPU render engines
|-
|'''accelerator.instances.enable''' || bool || 1 || 0 or 1 || 0 or 1 || Enable instance support (or disable in order to slightly increase rendering speed)
|}

==Epsilon==

Minimum and maximum allowed value for scene epsilon can be define by the following properties:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''scene.epsilon.min''' || float || 1e-5f || Any float value || 1e-6f ≤ x ≤ 1e-1f || Minimum allowed value for scene epsilon
|-
|'''scene.epsilon.max''' || float || 1e-1f || Any float value || 1e-3f ≤ x ≤ 1e+2f || Maximum allowed value for scene epsilon
|}

==Film==

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.safesave''' || bool || 1 || enable "safe save" of Film serialization. A backup of the output is always valid even in the case of a system failure.
|}

===Film OpenCL Options===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.opencl.enable''' || bool || 1 || enable OpenCL film operations
|-
|'''film.opencl.platform''' || unsigned int || -1 || choose which platform will be used by the film operations. (0 is first platform, 1 second and so on. -1 for all)
|-
|'''film.opencl.device''' || unsigned int || -1 || choose which device will be used by the film operations. (0 is first device, 1 second and so on. -1 for first GPU device)
|}

===Film Outputs (aka AOVs)===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.outputs.safesave''' || bool || 1 || enable "safe save" for Film outputs. A backup of the output is always valid even in the case of a system failure
|}

The film object supports many types of outputs (aka AOVs). The complete list of supported output types:

{| class="wikitable" cellspacing="2"
!Name
!Type
|-
|'''RGB''' || HDR
|-
|'''RGBA''' || HDR
|-
|'''RGB_IMAGEPIPELINE''' || HDR/LDR
|-
|'''RGBA_IMAGEPIPELINE''' || HDR/LDR
|-
|'''ALPHA''' || HDR/LDR
|-
|'''DEPTH''' || HDR
|-
|'''POSITION''' || HDR
|-
|'''GEOMETRY_NORMAL''' || HDR
|-
|'''SHADING_NORMAL''' || HDR
|-
|'''MATERIAL_ID''' || LDR
|-
|'''DIRECT_DIFFUSE''' || HDR
|-
|'''DIRECT_GLOSSY''' || HDR
|-
|'''EMISSION''' || HDR
|-
|'''INDIRECT_DIFFUSE''' || HDR
|-
|'''INDIRECT_GLOSSY''' || HDR
|-
|'''INDIRECT_SPECULAR''' || HDR
|-
|'''MATERIAL_ID_MASK''' || HDR/LDR
|-
|'''DIRECT_SHADOW_MASK''' || HDR/LDR
|-
|'''INDIRECT_SHADOW_MASK''' || HDR/LDR
|-
|'''RADIANCE_GROUP''' || HDR/LDR
|-
|'''UV''' || HDR/LDR
|-
|'''RAYCOUNT''' || HDR/LDR
|-
|'''BY_MATERIAL_ID''' || HDR/LDR
|-
|'''IRRADIANCE''' || HDR
|-
|'''OBJECT_ID''' || LDR
|-
|'''OBJECT_ID_MASK''' || HDR/LDR
|-
|'''BY_OBJECT_ID''' || HDR/LDR
|-
|'''SAMPLECOUNT''' || HDR/LDR
|-
|'''CONVERGENCE''' || HDR/LDR
|-
|'''NOISE''' || HDR/LDR
|-
|'''SERIALIZED_FILM''' || N/A
|-
|'''MATERIAL_ID_COLOR''' || HDR/LDR
|}

Outputs are enabled with the following properties:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.outputs.<index>.type''' || string || || Type of output, e.g. "RGBA" or "ALPHA" (see the list above for the available types)
|-
|'''film.outputs.<index>.filename''' || string || || Filename to use when saving the output. The filename should use ".exr" as extension for HDR outputs and ".png" for LDR outputs (see list above for which output is HDR and which LDR)
|-
|'''film.outputs.<index>.id''' || int || || Specify for the following outputs: '''MATERIAL_ID_MASK''', '''RADIANCE_GROUP''', '''BY_MATERIAL_ID''', '''OBJECT_ID_MASK''', '''BY_OBJECT_ID''' (to choose the object ID, material ID or radiance group ID of the output)
|-
|'''film.outputs.<index>.index''' || int || || Specify for an imagepipeline output (RGB_IMAGEPIPELINE or RGBA_IMAGEPIPELINE) to select the imagepipeline of the output. For example, if you have 3 imagepipelines defined, and you want to specify the output of the third imagepipeline, use 2 for the ".index" property of the output
|}

Note that the Bidir engine does not support all AOVs.
Not supported by Bidir are: EMISSION, DIRECT_DIFFUSE, DIRECT_GLOSSY, INDIRECT_DIFFUSE, INDIRECT_GLOSSY, INDIRECT_SPECULAR, DIRECT_SHADOW_MASK, INDIRECT_SHADOW_MASK, IRRADIANCE, RAYCOUNT.

This is the list of output channel data types and sizes:

{| class="wikitable" cellspacing="2"
!Output type
!Data type
!Size
!Description
|-
|RGB||float||film width x film height x 3||R, G, B
|-
|RGB_IMAGEPIPELINE||float||film width x film height x 3||R, G, B
|-
|RGBA||float||film width x film height x 4||R, G, B, A
|-
|ALPHA||float||film width x film height x 1||Alpha value [0, 1]
|-
|DEPTH||float||film width x film height x 1||Camera distance
|-
|POSITION||float||film width x film height x 3||World X, Y, Z
|-
|GEOMETRY_NORMAL||float||film width x film height x 3||Normal vector X, Y, Z
|-
|SHADING_NORMAL||float||film width x film height x 3||Normal vector X, Y, Z
|-
|DIRECT_DIFFUSE||float||film width x film height x 3||Diffuse R, G, B
|-
|DIRECT_GLOSSY||float||film width x film height x 3||Glossy R, G, B
|-
|EMISSION||float||film width x film height x 3||Emission R, G, B
|-
|INDIRECT_DIFFUSE||float||film width x film height x 3||Indirect diffuse R, G, B
|-
|INDIRECT_GLOSSY||float||film width x film height x 3||Indirect glossy R, G, B
|-
|INDIRECT_SPECULAR||float||film width x film height x 3||Indirect specular R, G, B
|-
|MATERIAL_ID_MASK||float||film width x film height x 1||Material mask [0, 1]
|-
|DIRECT_SHADOW_MASK||float||film width x film height x 1||Shadow mask [0, 1]
|-
|INDIRECT_SHADOW_MASK||float||film width x film height x 1||Shadow mask [0, 1]
|-
|RADIANCE_GROUP||float||film width x film height x 3||R, G, B
|-
|UV||float||film width x film height x 2||Texture coordinates U, V
|-
|RAYCOUNT||float||film width x film height x 1||Ray count
|-
|BY_MATERIAL_ID||float||film width x film height x 3||By material ID
|-
|MATERIAL_ID||uint||film width x film height x 1||Material ID
|-
|IRRADIANCE||float||film width x film height x 3||R, G, B
|-
|OBJECT_ID_MASK||float||film width x film height x 1||Object mask [0, 1]
|-
|BY_OBJECT_ID||float||film width x film height x 3||By object ID
|-
|OBJECT_ID||uint||film width x film height x 1||Object ID
|-
|SAMPLECOUNT||uint||film width x film height x 1||Sample count
|-
|CONVERGENCE||float||film width x film height x 1||The distance of each pixel from the convergence threshold
|-
|NOISE||float||film width x film height x 1||The noise estimated for each pixel
|-
|SERIALIZED_FILM||N/A||N/A||The complete Film serialized in binary format
|-
|MATERIAL_ID_COLOR||float||film width x film height x 3||Material ID converted to colors (with anti-aliasing)
|}

===Film Channels===

Film channels are implicitly enabled by declaring film outputs (even if the output is never used). For instance, declaring a "RGBA" output will automatically enable "RADIANCE_PER_PIXEL_NORMALIZED" (and "RADIANCE_PER_SCREEN_NORMALIZED" for BIDIRCPU) and "ALPHA".
The supported channels are:

{| class="wikitable" cellspacing="2"
!Channel type
!Data type
!Size
!Last element is weight ?
!Note
|-
|CHANNEL_RADIANCE_PER_PIXEL_NORMALIZED||float||film width x film height x 4||Yes||One for each radiance group. Eye paths radiance.
|-
|CHANNEL_RADIANCE_PER_SCREEN_NORMALIZED||float||film width x film height x 3||No||One for each radiance group. Light paths radiance. Used only by LIGHTCPU and BIDIRCPU.
|-
|CHANNEL_ALPHA||float||film width x film height x 2||Yes||
|-
|CHANNEL_RGB_IMAGEPIPELINE||float||film width x film height x 3||No||
|-
|CHANNEL_DEPTH||float||film width x film height x 1||No||
|-
|CHANNEL_POSITION||float||film width x film height x 3||No||
|-
|CHANNEL_GEOMETRY_NORMAL||float||film width x film height x 3||No||
|-
|CHANNEL_SHADING_NORMAL||float||film width x film height x 3||No||
|-
|CHANNEL_MATERIAL_ID||u_int||film width x film height x 1||No||
|-
|CHANNEL_DIRECT_DIFFUSE||float||film width x film height x 4||Yes||
|-
|CHANNEL_DIRECT_GLOSSY||float||film width x film height x 4||Yes||
|-
|CHANNEL_EMISSION||float||film width x film height x 4||Yes||
|-
|CHANNEL_INDIRECT_DIFFUSE||float||film width x film height x 4||Yes||
|-
|CHANNEL_INDIRECT_SPECULAR||float||film width x film height x 4||Yes||
|-
|CHANNEL_MATERIAL_ID_MASK||float||film width x film height x 2||Yes||
|-
|CHANNEL_DIRECT_SHADOW_MASK||float||film width x film height x 2||Yes||
|-
|CHANNEL_INDIRECT_SHADOW_MASK||float||film width x film height x 2||Yes||
|-
|CHANNEL_UV||float||film width x film height x 2||No||
|-
|CHANNEL_RAYCOUNT||float||film width x film height||No||
|-
|CHANNEL_BY_MATERIAL_ID||float||film width x film height x 4||Yes||
|-
|CHANNEL_IRRADIANCE||float||film width x film height x 4||Yes||
|-
|CHANNEL_OBJECT_ID||u_int||film width x film height x 1||No||
|-
|CHANNEL_OBJECT_ID_MASK||float||film width x film height x 2||Yes||
|-
|CHANNEL_BY_OBJECT_ID||float||film width x film height x 4||Yes||
|}

This is the list of channels enabled by each output:

{| class="wikitable" cellspacing="2"
!Output
!Enabled channels
|-
|'''RGB''' || CHANNEL_RADIANCE_PER_PIXEL_NORMALIZED, CHANNEL_RADIANCE_PER_SCREEN_NORMALIZED (only for LIGHTCPU and BIDIRCPU)
|-
|'''RGBA''' || CHANNEL_RADIANCE_PER_PIXEL_NORMALIZED, CHANNEL_RADIANCE_PER_SCREEN_NORMALIZED (only for LIGHTCPU and BIDIRCPU), ALPHA
|-
|'''RGB_IMAGEPIPELINE''' || CHANNEL_RADIANCE_PER_PIXEL_NORMALIZED, CHANNEL_RADIANCE_PER_SCREEN_NORMALIZED (only for LIGHTCPU and BIDIRCPU)
|-
|'''RGBA_IMAGEPIPELINE''' || CHANNEL_RADIANCE_PER_PIXEL_NORMALIZED, CHANNEL_RADIANCE_PER_SCREEN_NORMALIZED (only for LIGHTCPU and BIDIRCPU), ALPHA
|-
|'''ALPHA''' || ALPHA
|-
|'''DEPTH''' || DEPTH
|-
|'''POSITION''' || DEPTH, POSITION
|-
|'''GEOMETRY_NORMAL''' || DEPTH, GEOMETRY_NORMAL
|-
|'''SHADING_NORMAL''' || DEPTH, SHADING_NORMAL
|-
|'''MATERIAL_ID''' || DEPTH, MATERIAL_ID
|-
|'''DIRECT_DIFFUSE''' || DIRECT_DIFFUSE
|-
|'''DIRECT_GLOSSY''' || DIRECT_GLOSSY
|-
|'''EMISSION''' || EMISSION
|-
|'''INDIRECT_DIFFUSE''' || INDIRECT_DIFFUSE
|-
|'''INDIRECT_GLOSSY''' || INDIRECT_GLOSSY
|-
|'''INDIRECT_SPECULAR''' || INDIRECT_SPECULAR
|-
|'''MATERIAL_ID_MASK''' || MATERIAL_ID, MATERIAL_ID_MASK
|-
|'''DIRECT_SHADOW_MASK''' || DIRECT_SHADOW_MASK
|-
|'''INDIRECT_SHADOW_MASK''' || INDIRECT_SHADOW_MASK
|-
|'''RADIANCE_GROUP''' || CHANNEL_RADIANCE_PER_PIXEL_NORMALIZED, CHANNEL_RADIANCE_PER_SCREEN_NORMALIZED (only for LIGHTCPU and BIDIRCPU)
|-
|'''UV''' || DEPTH, UV
|-
|'''RAYCOUNT''' || DEPTH, RAYCOUNT
|-
|'''BY_MATERIAL_ID''' || BY_MATERIAL_ID
|-
|'''IRRADIANCE''' || IRRADIANCE
|-
|'''OBJECT_ID''' || DEPTH, OBJECT_ID
|-
|'''OBJECT_ID_MASK''' || OBJECT_ID, OBJECT_ID_MASK
|-
|'''BY_OBJECT_ID''' || BY_OBJECT_ID
|}

Note: CHANNEL_RGB_IMAGEPIPELINE is always enable and the result of running the image pipeline.

===Image pipeline===

It is possible to [http://www.luxrender.net/forum/viewtopic.php?f=8&p=120169#p120169 define multiple image pipelines at the same time]

====Radiance Group====

Radiance groups are used to get only the contribution of a group of lights in the scene. 
Lights can be grouped by setting their [[#Common_parameters | '''.id''']] property to the same number, on materials this is done with the [[#Light_emission | '''.emission.id''']] property. 

Note that the OpenCL engines only support up to 8 radiance groups (one of them is the default group).

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.radiancescales.<id>.globalscale''' || float|| 1 || global weighting of radiance group
|-
|'''film.imagepipelines.<pipeline #>.radiancescales.<id>.temperature ''' || float || 6500.0 || light temperature
|-
|'''film.imagepipelines.<pipeline #>.radiancescales.<id>.rgbscale''' || vector || 1.0 1.0 1.0 || light color
|-
|'''film.imagepipelines.<pipeline #>.radiancescales.radiancescales.<id>.enabled''' || bool || 1 || enable radiance group
|}

====Image pipeline plug-ins====

=====Type: TONEMAP_LINEAR=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "TONEMAP_LINEAR" || linear tonemapping
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.scale''' || float || 1.0 || tonemapping scale
|}

=====Type: TONEMAP_REINHARD02=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "TONEMAP_REINHARD02" || reinhard tonemapping
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.prescale''' || float || 1.0 || reinhard prescale
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.postscale''' || float || 1.2 || reinhard postscale
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.burn''' || float || 3.75 || reinhard burn
|}

=====Type: TONEMAP_AUTOLINEAR=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "TONEMAP_AUTOLINEAR" || automatic linear tonemapping
|}

=====Type: TONEMAP_LUXLINEAR=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "TONEMAP_LUXLINEAR" || linear tonemapping with real camera settings
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.sensitivity''' || float || 100.0 || ISO sensitivity
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.exposure''' || float || 0.001 || exposure time
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.fstop''' || float || 2.8 || f/aperture
|}

=====Type: NOP=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipeline.<pipeline #>.<plugin #>.type''' || string || "NOP" || no parameters tonemapper
|}

=====Type: GAMMA_CORRECTION=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "TONEMAP_LINEAR" || gamma correction
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.value''' || float || 2.2 || gamma value
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.table.size''' || unsigned int || 4096 || resolution
|}

=====Type: OUTPUT_SWITCHER=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "OUTPUT_SWITCHER" || overwrite output
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.channel''' || string || "DEPTH" || channel whose values are used to overwrite
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.index''' || unsigned int || 0 || index
|}

=====Type: GAUSSIANFILTER_3x3=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "GAUSSIANFILTER_3x3" || gaussian filter
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.weight''' || float || 0.15 || blurring weight
|}

=====Type: CAMERA_RESPONSE_FUNC=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || CAMERA_RESPONSE_FUNC || analog camera film simulation
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.name''' || string || "Advantix_100CD" || film type
|}

=====Type: BACKGROUND_IMG=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || BACKGROUND_IMG || show the background image where alpha < 1 (simple compositing)
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.file''' || string || ... || background image path (e.g scenes/simple-mat/sky.exr)
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.gamma''' || float || 2.2 || background image gamma
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.storage ''' || string || auto || background image storage type
|}
Note: When the size of the background image differs from the film size, it will be stretched to fit the film size.

=====Type: BLOOM=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "BLOOM" || bloom effect
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.radius''' || float || 0.07 || how large the bloom effect is in % of the image size (i.e. 1.0 = all image)
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.weight''' || float || 0.25 || how strong the effect is (i.e. 0.0 = nothing, 1.0 = max. strength)
|}

=====Type: VIGNETTING=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "VIGNETTING" || vignetting effect
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.scale''' || float || 0.4 || vignetting strength
|}

=====Type: COLOR_ABERRATION=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "COLOR_ABERRATION" || color aberration effect
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.amount''' || float || 0.005 || color aberration amount
|}

=====Type: MIST=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "MIST" || aerial perspective effect (fake fog)
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.color''' || spectrum|| [1, 1, 1] || mist color
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.amount''' || float || 0.005 || mist amount
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.startdistance''' || float || 0 || distance from camera until where the mist effect has zero effect
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.enddistance''' || float || 10000 || distance from camera from where the mist effect has maximum effect
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.excludebackground''' || bool || false || Do not apply mist effect on pixels with infinite distance to the camera
|}

=====Type: CONTOUR_LINES=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "CONTOUR_LINES" || contour lines for IRRADIANCE AOV
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.range''' || float|| ? || ?
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.scale''' || float || ? || ?
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.steps''' || int || ? || ?
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.zerogridsize''' || int || ? || ?
|}

=====Type: WHITE_BALANCE =====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "WHITE_BALANCE" || White temperature correction
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.temperature''' || unsigned int|| 6500 || Target image temperature in Kelvin
|-
|}

===Film Subregion===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.subregion''' || vector || ... || <xstart> <xstop> <ystart> <ystop>
|}

===Rendering halt conditions===

By default, a LuxCore rendering will never stop however you can enable one or multiple halt conditions:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''batch.haltnoisethreshold''' || float || -1.0 || enable image convergence test and stops when the error is under the defined value. Use a value like "n / 256.0" where n is the level of error you are looking for. It may be hard to achieve a level of error smaller than 3.0 / 256.0. -1.0 disables the halt condition.
|-
|'''batch.haltnoisethreshold.warmup''' || unsigned int || 64 || number of average samples per pixel before to start the convergence test
|-
|'''batch.haltnoisethreshold.step''' || unsigned int || 64 || number of average samples per pixel between two tests
|-
|'''batch.haltnoisethreshold.filter.enable''' || bool || 1 || if the CONVERGENCE AOV (generated by the batch.haltnoisethreshold) should be filtered or not with a 3x3 box filter
|-
|'''batch.haltnoisethreshold.stoprendering.enable''' || bool || 1 || Set this to 0 (false) if you only want to use the haltnoisethreshold settings for adaptive sampling in an endless render
|-
|'''batch.haltnoisethreshold.index''' || unsigned int || 0 || Film pipeline index used to estimate noise for stopping
|-
|'''batch.halttime''' || float || 0.0 || number of seconds before stopping the rendering
|-
|'''batch.haltspp''' || unsigned int || 0 || number of average samples per pixel before stopping the rendering
|}

===Noise estimation===

Image noise can be estimated and its result can be used to drive the Sobol and Random samplers to focus its sampling in the noisier regions.
Setting any of these properties will enable the noise estimation.
The adaptiveness strength is a Sampler property.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.noiseestimation.warmup''' || unsigned int || 32 || number of average samples per pixel before to start the convergence test
|-
|'''film.noiseestimation.step''' || unsigned int || 32 || number of average samples per pixel between two tests
|-
|'''film.noiseestimation.filter.scale''' || unsigned int || 4 || Box filter scale used to filter the NOISE AOV (generated by the noise estimation). Set to 0 to disable.
|-
|'''film.noiseestimation.index''' || unsigned int || 0 || Film pipeline index used to estimate noise for adaptive sampling
|-
|}

=Scene file=

==Camera==

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.camera.type''' || string || "perspective" || "perspective", "orthographic" or "environment" (360° panorama mapped in latlong format)
|-
|'''scene.camera.lookat.orig''' || point (float float float) || 0.0 10.0 0.0 || camera location
|-
|'''scene.camera.lookat.target''' || point (float float float) || 0.0 0.0 0.0 || camera target
|-
|'''scene.camera.up''' || vector (float float float) || (0.0, 0.0, 1.0) || camera up vector
|-
|'''scene.camera.fieldofview''' || float || 45.0 || field of view
|-
|'''scene.camera.screenwindow''' || vector || 0.0 1.0 0.0 1.0 || <xstart> <xstop> <ystart> <ystop>
|-
|'''scene.camera.shutteropen''' || float || 0.0 || camera shutter open time (used for motion blur)
|-
|'''scene.camera.shutterclose''' || float || 0.0 || camera shutter close time (used for motion blur)
|-
|'''scene.camera.autovolume.enable''' || bool || true || try automatically to discover scene.camera.volume
|-
|'''scene.camera.volume''' || string || || the initial volume rays will travel in
|}

The camera supports motion blur. See [[ LuxCore_SDL_Reference_Manual_v2.0#Object_Motion_Blur | Object Motion Blur ]]. 
(Only difference being that instead of the prefix '''scene.objects.<object name>''', the prefix '''scene.camera''' is used when setting motion properties of the camera)

==Textures==

Check [[LuxCoreRender_Textures|LuxCoreRender Textures]] for a high level description and examples of the textures.

===Mapping===

Some texture (mostly procedural textures) supports 2D or 3D mapping parameters:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.mapping.type''' || string || "uvmapping2d" || type of mapping
|-
|'''scene.textures.<texture name>.mapping.rotation''' || float || 0.0 || UV rotation (in degrees)
|-
|'''scene.textures.<texture name>.mapping.uvscale''' || UV || 1.0 1.0 || UV scale
|-
|'''scene.textures.<texture name>.mapping.uvdelta''' || UV || 0.0 0.0 || UV translation
|}

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.mapping.type''' || string || "uvmapping3d" || type of mapping
|-
|'''scene.textures.<texture name>.mapping.transformation''' || Matrix4x4 || 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0|| transformation matrix
|}

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.mapping.type''' || string || "globalmapping3d" || type of mapping
|-
|'''scene.textures.<texture name>.mapping.transformation''' || Matrix4x4 || 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0|| transformation matrix
|}

===Type: add===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "add" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant
|}

===Type: subtract===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "subtract" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant
|}

===Type: band===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "band" || type of texture
|-
|'''scene.textures.<texture name>.amount''' || texture || 0.5|| texture name or constant
|-
|'''scene.textures.<texture name>.interpolation''' || string || "linear"|| "linear", "cubic" or "none"
|-
|'''scene.textures.<texture name>.offset[0..n]''' || float || 0.0 || multiple offsets in the range of [0.0, 1.0]
|-
|'''scene.textures.<texture name>.value[0..n]''' || spectrum || 1.0 1.0 1.0 || a value for each offset
|}

===Type: blender_blend===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_blend" || type of texture
|-
|'''scene.textures.<texture name>.progressiontype''' || string || "linear" || linear, quadratic, easing, diagonal, spherical, quadratic_spherical, halo or radial
|-
|'''scene.textures.<texture name>.direction''' || string || "horizontal" || horizontal or vertical
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_clouds===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_clouds" || type of texture
|-
|'''scene.textures.<texture name>.noisetype''' || string || "soft_noise" || hard_noise or soft_noise
|-
|'''scene.textures.<texture name>.noisebasis''' || string || "blender_original" || blender_original, original_perlin, improved_perlin, voronoi_f1, voronoi_f2, voronoi_f3, voronoi_f4, voronoi_f2_f1, voronoi_crackle or cell_noise
|-
|'''scene.textures.<texture name>.noisesize''' || float || 0.25 ||
|-
|'''scene.textures.<texture name>.noisedepth''' || int || 2 ||
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_distortednoise===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_distortednoise" || type of texture
|-
|'''scene.textures.<texture name>.noise_distortion''' || string || "blender_original" || blender_original, original_perlin, improved_perlin, voronoi_f1, voronoi_f2, voronoi_f3, voronoi_f4, voronoi_f2_f1, voronoi_crackle or cell_noise
|-
|'''scene.textures.<texture name>.noisebasis''' || string || "blender_original" || blender_original, original_perlin, improved_perlin, voronoi_f1, voronoi_f2, voronoi_f3, voronoi_f4, voronoi_f2_f1, voronoi_crackle or cell_noise
|-
|'''scene.textures.<texture name>.noisesize''' || float || 0.25 ||
|-
|'''scene.textures.<texture name>.distortion''' || float || 1 ||
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_magic===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_magic" || type of texture
|-
|'''scene.textures.<texture name>.noisedepth''' || int || 2 ||
|-
|'''scene.textures.<texture name>.turbulence''' || float || 5.0 ||
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_marble===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_marble" || type of texture
|-
|'''scene.textures.<texture name>.marbletype''' || string || "soft" || soft, sharp or sharper
|-
|'''scene.textures.<texture name>.turbulence''' || float || 5.0 ||
|-
|'''scene.textures.<texture name>.noisebasis''' || string || "blender_original" || blender_original, original_perlin, improved_perlin, voronoi_f1, voronoi_f2, voronoi_f3, voronoi_f4, voronoi_f2_f1, voronoi_crackle or cell_noise
|-
|'''scene.textures.<texture name>.noisebasis2''' || string || "sin" || sin, saw or tri
|-
|'''scene.textures.<texture name>.noisedepth''' || int || 2 ||
|-
|'''scene.textures.<texture name>.noisesize''' || float || 0.25 ||
|-
|'''scene.textures.<texture name>.noisetype''' || string || "soft_noise" || soft_noise or hard_noise
|-
|'''scene.textures.<texture name>.turbulence''' || float || 5.0 ||
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_musgrave===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_musgrave" || type of texture
|-
|'''scene.textures.<texture name>.musgravetype''' || string || "multifractal" || multifractal, ridged_multifractal, hybrid_multifractal, fBM or hetero_terrain
|-
|'''scene.textures.<texture name>.noisebasis''' || string || "blender_original" || blender_original, original_perlin, improved_perlin, voronoi_f1, voronoi_f2, voronoi_f3, voronoi_f4, voronoi_f2_f1, voronoi_crackle or cell_noise
|-
|'''scene.textures.<texture name>.dimension''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.intensity''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.lacunarity''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.offset''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.gain''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.octaves''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.gain''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.noisesize''' || float || 0.25 ||
|-
|'''scene.textures.<texture name>.noisetype''' || string || "soft_noise" || soft_noise or hard_noise
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_noise===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_noise" || type of texture
|-
|'''scene.textures.<texture name>.noisedepth''' || int || 2 ||
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_stucci===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_stucci" || type of texture
|-
|'''scene.textures.<texture name>.stuccitype''' || string || "plastic" || plastic, wall_in or wall_out
|-
|'''scene.textures.<texture name>.noisebasis''' || string || "blender_original" || blender_original, original_perlin, improved_perlin, voronoi_f1, voronoi_f2, voronoi_f3, voronoi_f4, voronoi_f2_f1, voronoi_crackle or cell_noise
|-
|'''scene.textures.<texture name>.noisetype''' || string || "soft_noise" || soft_noise or hard_noise
|-
|'''scene.textures.<texture name>.noisesize''' || float || 0.25 ||
|-
|'''scene.textures.<texture name>.turbulence''' || float || 5.0 ||
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_wood===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_wood" || type of texture
|-
|'''scene.textures.<texture name>.woodtype''' || string || "bands" || bands, rings, bandnoise or ringnoise
|-
|'''scene.textures.<texture name>.noisebasis''' || string || "blender_original" || blender_original, original_perlin, improved_perlin, voronoi_f1, voronoi_f2, voronoi_f3, voronoi_f4, voronoi_f2_f1, voronoi_crackle or cell_noise
|-
|'''scene.textures.<texture name>.noisebasis2''' || string || "sin" || sin, saw or tri
|-
|'''scene.textures.<texture name>.noisetype''' || string || "soft_noise" || soft_noise or hard_noise
|-
|'''scene.textures.<texture name>.noisesize''' || float || 0.25 ||
|-
|'''scene.textures.<texture name>.turbulence''' || float || 5.0 ||
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_voronoi===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_voronoi" || type of texture
|-
|'''scene.textures.<texture name>.intensity''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.distmetric''' || string || "actual_distance" || actual_distance, distance_squared, manhattan, chebychev, minkowski_half, minkowski_four or minkowski
|-
|'''scene.textures.<texture name>.w1''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.w2''' || float || 0.0 ||
|-
|'''scene.textures.<texture name>.w3''' || float || 0.0 ||
|-
|'''scene.textures.<texture name>.w4''' || float || 0.0 ||
|-
|'''scene.textures.<texture name>.noisesize''' || float || 0.25 ||
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: brick===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "brick" || type of texture
|-
|'''scene.textures.<texture name>.bricktex''' || texture || 1.0 1.0 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.mortartex''' || texture || 0.2 0.2 0.2 || texture name or constant
|-
|'''scene.textures.<texture name>.brickmodtex''' || texture || 1.0 1.0 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.brickmodbias''' || float || 0.0 || With bias = -1, only the bricktex is used for the brick color. With bias between -1 and 1, a pseudo-random interpolation between bricktex and brickmodtex is used as brick color. With bias = 1, only the brickmodtex is used for the brick color.
|-
|'''scene.textures.<texture name>.brickbond''' || string || "running" || "flemish", "english", "herringbone", "basket" or "chain link"
|-
|'''scene.textures.<texture name>.brickwidth''' || float || 0.3 || brick width
|-
|'''scene.textures.<texture name>.brickheight''' || float || 0.1 || brick height
|-
|'''scene.textures.<texture name>.brickdepth''' || float || 0.15 || brick depth
|-
|'''scene.textures.<texture name>.mortarsize''' || float || 0.01 ||mortar size
|-
|'''scene.textures.<texture name>.brickrun''' || float || 0.75 || brick run
|}

This texture supports 3D mapping.

===Type: checkerboard3d===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "checkerboard3d" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 0.0 || texture name or constant
|}

This texture supports 3D mapping.

===Type: checkerboard2d===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "checkerboard2d" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 0.0 || texture name or constant
|}

This texture supports 2D mapping.

===Type: constfloat1===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "constfloat1" || type of texture
|-
|'''scene.textures.<texture name>.value''' || float || 1.0 || constant value
|}

===Type: constfloat3===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "constfloat3" || type of texture
|-
|'''scene.textures.<texture name>.value''' || spectrum || (1.0, 1.0, 1.0) || RGB constant value
|}

===Type: densitygrid===

You can use ".data", ".data3" or ".openvdb.file" to define the 3D grid values.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "densitygrid" || type of texture
|-
|'''scene.textures.<texture name>.nx''' || unsigned int || || grid x size
|-
|'''scene.textures.<texture name>.ny''' || unsigned int || || grid y size
|-
|'''scene.textures.<texture name>.nz''' || unsigned int || || grid z size
|-
|'''scene.textures.<texture name>.wrap''' || string || "repeat" || select the type of grid wrapping mode: "repeat", "black", "white", "clamp"
|-
|'''scene.textures.<texture name>.wrap''' || string || "repeat" || select the type of grid wrapping mode: "repeat", "black", "white", "clamp"
|-
|'''scene.textures.<texture name>.storage''' || string || "half" || select the type of memory storage: "auto", "byte", "half", "float"
|-
|'''scene.textures.<texture name>.data''' || float || || vector grid values (total count: nx * ny * nz)
|-
|'''scene.textures.<texture name>.data3''' || float || || vector grid values (total count: nx * ny * nz * 3)
|-
|'''scene.textures.<texture name>.openvdb.file''' || string || || OpenVDB file name
|-
|'''scene.textures.<texture name>.openvdb.grid''' || string || || OpenVDB grid name to read from the file
|}

===Type: dots===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "dots" || type of texture
|-
|'''scene.textures.<texture name>.inside''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.outside''' || texture || 0.0 || texture name or constant
|}

This texture supports 2D mapping.

===Type: fbm===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "fbm" || type of texture
|-
|'''scene.textures.<texture name>.octaves''' || int || 8 || noise octaves
|-
|'''scene.textures.<texture name>.roughness''' || float || 0.5 || noise roughness
|}

This texture supports 3D mapping.

===Type: fresnelapproxk===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "fresnelapproxk" || type of texture
|-
|'''scene.textures.<texture name>.texture''' || texture || (0.5, 0.5, 0.5) || texture name or constant
|}

===Type: fresnelapproxn===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "fresnelapproxn" || type of texture
|-
|'''scene.textures.<texture name>.texture''' || texture || (0.5, 0.5, 0.5) || texture name or constant
|}

===Type: hitpointalpha===

Use the value obtained by interpolating triangle vertices alphas.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "hitpointalpha" || type of texture
|}

===Type: hitpointcolor===

Use the color obtained by interpolating triangle vertices colors.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "hitpointcolor" || type of texture
|}

===Type: hitpointgrey===

Use the value obtained by interpolating triangle vertices colors, mapped to a float value (RGB converted into greyscale).

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "hitpointgrey" || type of texture
|-
|'''scene.textures.<texture name>.channel''' || int || -1 || the index of the RGB channel to use. -1 means the luminance of the RGB value
|}

===Type: hsv===

Hue saturation value manipulation.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "hsv" || type of texture
|-
|'''scene.textures.<texture name>.texture''' || texture || 0 0 0 || input color that will be manipulated
|-
|'''scene.textures.<texture name>.hue''' || texture || 0.5 || shift in hue (range: 0..1)
|-
|'''scene.textures.<texture name>.saturation''' || texture || 1.0 || saturation (range: 0..inf)
|-
|'''scene.textures.<texture name>.value''' || texture || 1.0 || brightness multiplier (range: 0..inf)
|}

===Type: imagemap===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "imagemap" || type of texture
|-
|'''scene.textures.<texture name>.file''' || string || "image.png" || name of the image file
|-
|'''scene.textures.<texture name>.gamma''' || float || 2.2 || gamma correction value used in the image
|-
|'''scene.textures.<texture name>.gain''' || float || 1.0 || image values are multiplied by gain value
|-
|'''scene.textures.<texture name>.storage''' || string || "auto" || select the type of memory storage: "auto", "byte", "half", "float"
|-
|'''scene.textures.<texture name>.wrap''' || string || "repeat" || select the type of image map wrapping mode: "repeat", "black", "white", "clamp"
|-
|'''scene.textures.<texture name>.channel''' || string || "default" || extract from the image only the selected channels: "default", "red", "green", "blue", "alpha", "mean", "colored_mean", "rgb"
|}

===Type: normalmap===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "normalmap" || type of texture
|-
|'''scene.textures.<texture name>.texture''' || texture || 0 0 0 || input. Is treated as an XYZ vector in tangent space.
|-
|'''scene.textures.<texture name>.scale''' || float || 1.0 || multiplier for adjusting normalmap height
|}

===Type: marble===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "marble" || type of texture
|-
|'''scene.textures.<texture name>.octaves''' || int || 8 || noise octaves
|-
|'''scene.textures.<texture name>.roughness''' || float || 0.5 || noise roughness
|-
|'''scene.textures.<texture name>.scale''' || float || 1.0 || marble scale
|-
|'''scene.textures.<texture name>.variation''' || float || 0.2 || marble variation
|}

This texture supports 3D mapping.

===Type: mix===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "mix" || type of texture
|-
|'''scene.textures.<texture name>.amount''' || texture || 0.5 || texture name or constant
|-
|'''scene.textures.<texture name>.texture1''' || texture || 0.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant
|}

===Type: scale===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "scale" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant
|}

===Type: uv===

This procedural texture has no parameters aside from the support of 2D mapping.

===Type: windy===

This procedural texture has no parameters aside from the support of 3D mapping.

===Type: wood===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "wood" || type of texture
|-
|'''scene.textures.<texture name>.woodtype''' || string || "bands" || "bands", "rings", "bandnoise" or "ringnoise"
|-
|'''scene.textures.<texture name>.noisebasis2''' || string || "sin" || "sin", "saw" or "tri"
|-
|'''scene.textures.<texture name>.noisetype''' || string || "soft_noise" || "soft_noise" or "hard_noise"
|-
|'''scene.textures.<texture name>.noisesize''' || float || 0.25 || noise size
|-
|'''scene.textures.<texture name>.turbulence''' || float || 5.0 || noise turbulence
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 || bright
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 || contrast
|}

This texture supports 3D mapping.

===Type: wrinkled===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "wrinkled" || type of texture
|-
|'''scene.textures.<texture name>.octaves''' || int || 8 || noise octaves
|-
|'''scene.textures.<texture name>.roughness''' || float || 0.5 || noise roughness
|}

This texture supports 3D mapping.

===Type: abs===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "abs" || type of texture
|-
|'''scene.textures.<texture name>.texture''' || texture || 1.0 || texture name or constant
|}

===Type: clamp===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "clamp" || type of texture
|-
|'''scene.textures.<texture name>.texture''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.min''' || float || 0.0 || lower boundary of the clamping
|-
|'''scene.textures.<texture name>.max''' || float || 1.0 || upper boundary of the clamping
|}

===Type: divide===

Note: If texture2 (the divisor) is 0, 0 is returned.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "divide" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant (dividend)
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant (divisor)
|}

===Type: remap===

This texture brings the value from the source range into the target range.

Note: The value is clamped into source range before performing the remap operation, and the resulting number is also clamped into the target range.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "remap" || type of texture
|-
|'''scene.textures.<texture name>.value''' || texture || 0.5 || texture name or constant
|-
|'''scene.textures.<texture name>.sourcemin''' || texture || 0.0 || texture name or constant
|-
|'''scene.textures.<texture name>.sourcemax''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.targetmin''' || texture || 0.0 || texture name or constant
|-
|'''scene.textures.<texture name>.targetmax''' || texture || 1.0 || texture name or constant
|}

===Type: objectid===

Raw object ID (range 0 to 0xfffffffe).

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "objectid" || type of texture
|}

===Type: objectidcolor===

Object ID interpreted as color. 
The object ID is a 4 byte unsigned int. To convert to color, the lower three bytes are interpreted as r, g, b values (each range 0 to 255). The highest byte is ignored.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "objectidcolor" || type of texture
|}

===Type: objectidnormalized===

Normalized object ID (range 0 to 1).

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "objectidnormalized" || type of texture
|}

===Type: dotproduct ===

Dot product of the two input vectors.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "dotproduct" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant
|}

===Type: power ===

pow(base, exponent)

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "power" || type of texture
|-
|'''scene.textures.<texture name>.base''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.exponent''' || texture || 1.0 || texture name or constant
|}

===Type: lessthan ===

returns 1 if texture1 < texture2, 0 if otherwise.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "lessthan" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant
|}

===Type: greaterthan ===

returns 1 if texture1 > texture2, 0 if otherwise.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "greaterthan" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant
|}

===Type: shadingnormal ===

Returns the shading normal of the mesh at the hitpoint.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "shadingnormal" || type of texture
|}

===Type: position ===

Returns the position of the hitpoint.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "position" || type of texture
|}

===Type: splitfloat3 ===

Extract a channel from a float3 texture. Can for example be used to get the R, G or B channel of a color texture, or to get the X, Y or Z components of a vector texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "splitfloat3" || type of texture
|-
|'''scene.textures.<texture name>.texture''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.channel''' || int || 0 || the channel to get from the input texture. 0 for first channel, 1 for second, 2 for third channel
|}

===Type: makefloat3 ===

Combine three float textures into one float3 texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "makefloat3" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture3''' || texture || 1.0 || texture name or constant
|}

===Type: blackbody===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blackbody" || type of texture
|-
|'''scene.textures.<texture name>.temperature''' || float || 6500 || emission temperature
|-
|'''scene.textures.<texture name>.normalize''' || bool || false || normalize the output
|}

===Type: irregulardata===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "irregulardata" || type of texture
|-
|'''scene.textures.<texture name>.wavelengths''' || vector || 580.0 620.0 660.0|| wavelenghts
|-
|'''scene.textures.<texture name>.data''' || vector || 0.0 0.000015 0.0|| data (length should match wavelength's length)
|}

===Type: lampspectrum===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "lampspectrum" || type of texture
|-
|'''scene.textures.<texture name>.name''' || string || "Daylight" || lamp light spectrum
|}

===Type: Fresnel Textures===

Textures for loading optical data

====Type: fresnelcolor====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || fresnelcolor || type of texture
|-
|'''scene.textures.<texture name>.kr''' || vector || 0.5 0.0 0.0 || reflection color
|}

====Type: fresnelpreset====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || fresnelpreset || type of texture
|-
|'''scene.textures.<texture name>.name''' || string || aluminium || fresnel preset ("aluminium", "silver", "copper", "gold" or "amorphous carbon")
|}

====Type: fresnelsopra====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || fresnelpreset || type of texture
|-
|'''scene.textures.<texture name>.file''' || string || ... || nk file path (e.g scenes/luxball/Au.nk)
|}

====Type: fresnelluxpop====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || fresnelpreset || type of texture
|-
|'''scene.textures.<texture name>.file''' || string || ... || nk file path (e.g scenes/luxball/Cr.nk)
|}

====Type: distort====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || distort || type of texture
|-
|'''scene.textures.<texture name>.texture''' || texture || 0.0 || texture name or constant; input texture
|-
|'''scene.textures.<texture name>.offset''' || texture || 0.0 || texture name or constant; offset to add to the hitpoint coordinates and UV values before evaluating the input texture
|-
|'''scene.textures.<texture name>.strength''' || float || 1.0 || strength multiplier, is multiplied with the offset
|}

==Volumes==

Check [[LuxCoreRender_Volumes|LuxCoreRender Volumes]] for a high level description and examples of the volumes.

All volumes share these properties

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.volumes.<volume name>.type''' || string || clear || volume type
|-
|'''scene.volumes.<volume name>.priority''' || unsigned int|| 0|| volume priority (when volumes overlap, the one with highest priority overrides the others)
|-
|'''scene.volumes.<volume name>.ior''' || texture|| ... || index of refraction
|-
|'''scene.volumes.<volume name>.absorption''' || texture || ... || absorption texture
|-
|'''scene.volumes.<volume name>.emission ''' || texture || ... || emission
|-
|'''scene.volumes.<volume name>.emission.id ''' || unsigned int || ... || emission ID
|}

===Volume: Clear===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.volumes.<volume name>.type''' || string || clear || volume type
|}

===Volume: Homogeneous===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.volumes.<volume name>.type''' || string || homogeneous|| volume type
|-
|'''scene.volumes.<volume name>.scattering''' || texture || ... || scattering texture
|-
|'''scene.volumes.<volume name>.asymmetry''' || texture || ... || asymmetry texture
|-
|'''scene.volumes.<volume name>.multiscattering''' || bool || ... || multiscattering
|}

===Volume: Heterogeneous===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.volumes.<volume name>.type''' || string || heterogeneous || volume type
|-
|'''scene.volumes.<volume name>.scattering''' || texture || ... || scattering texture
|-
|'''scene.volumes.<volume name>.asymmetry''' || texture || ... || asymmetry texture
|-
|'''scene.volumes.<volume name>.multiscattering''' || bool || ... || multiscattering
|-
|'''scene.volumes.<volume name>.steps.size''' || float || ... || step size
|-
|'''scene.volumes.<volume name>.steps.maxcount''' || unsigned int || ... || step maximum count
|}

==Materials==

Check [[LuxCoreRender_Materials|LuxCoreRender Materials]] for a high level description and examples of the materials.

===Common properties===

Common material properties:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.bumptex''' || texture || || texture to use for the bump mapping
|-
|'''scene.materials.<material name>.normaltex''' || texture || || texture to use for the normal mapping
|-
|'''scene.materials.<material name>.samples''' || int || -1 || number of rays used to sample this material. -1 means use the default global value. This property is an hint and the render engine can ignore this information.
|-
|'''scene.materials.<material name>.visibility.indirect.diffuse.enable''' || bool || true || if this material is visible in indirect rays. This property is an hint and the render engine can ignore this information.
|-
|'''scene.materials.<material name>.visibility.indirect.glossy.enable''' || bool || true || if this material is visible in indirect rays. This property is an hint and the render engine can ignore this information.
|-
|'''scene.materials.<material name>.visibility.indirect.specular.enable''' || bool || true || if this material is visible in indirect rays. This property is an hint and the render engine can ignore this information.
|-
|'''scene.materials.<material name>.bumpsamplingdistance''' || float || 0.001 || set the offset used to sample bump/normal mapping.
|-
|'''scene.materials.<material name>.volume.interior''' || string || vol1 || name of interior volume (for volume rendering)
|-
|'''scene.materials.<material name>.volume.exterior''' || string || vol2 || name of exterior volume (for volume rendering)
|-
|'''scene.materials.<material name>.id''' || int|| ... || material id
|-
|'''scene.materials.<material name>.transparency''' || texture || 1.0 || transparency of the material. 1 for opaque, 0 for fully transparent
|-
|'''scene.materials.<material name>.shadowcatcher.enable''' || bool || false || If true, the material will be transparent where hit by direct light and opaque otherwise (alpha transparency). Used for compositing.
|}

====Normal maps====
Normal maps are set first as a texture type and then assigned to the material. For example:

<blockquote><pre>
scene.textures.normmap.type = imagemap
scene.textures.normmap.file = scenes/bump/normal.png
scene.textures.normmap.gamma = 1

scene.materials.mat_white.type = matte
scene.materials.mat_white.kd = 0.8 0.8 0.8
scene.materials.mat_white.normaltex = normmap
</pre></blockquote>

====Light emission====

All materials can emit light:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.emission''' || texture || 0.0 0.0 0.0 || color of the emitted light
|-
|'''scene.materials.<material name>.emission.gain''' || spectrum || 1.0 1.0 1.0 || multiplier for lamp brigthness
|-
|'''scene.materials.<material name>.emission.power''' || float || 0.0 || lamp output power in watts. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.materials.<material name>.emission.efficency''' || float || 0.0 || luminous efficacy in lumens/watt. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.materials.<material name>.emission.mapfile''' || string || || the name of an optional image map that can be used to scale the emitted light
|-
|'''scene.materials.<material name>.emission.gamma''' || float || 2.2 || gamma value of the image map defined with .mapfile property
|-
|'''scene.materials.<material name>.emission.iesfile''' || string || || a [http://en.wikipedia.org/wiki/Illuminating_Engineering_Society_of_North_America IES] profile of emitted light
|-
|'''scene.materials.<material name>.emission.iesblob''' || blob || || a [http://en.wikipedia.org/wiki/Illuminating_Engineering_Society_of_North_America IES] profile of emitted light embedded in a blob
|-
|'''scene.materials.<material name>.emission.flipz''' || bool || false || flip the IES profile along the Z axis
|-
|'''scene.materials.<material name>.emission.samples''' || int || -1 || the number of shadow ray to trace to compute direct light from this material. This property is an hint and the render engine can ignore this information. -1 means use the default global value.
|-
|'''scene.materials.<material name>.emission.map.width''' || unsigned int || 0 || scale the image or IES map to the specified width. 0 means use the original size
|-
|'''scene.materials.<material name>.emission.map.height''' || unsigned int || 0 || scale the image or IES map to the specified height. 0 means use the original size
|-
|'''scene.materials.<material name>.emission.id''' || int || 0 || the radiance group the light emitted from this material is assigned to.
|-
|'''scene.materials.<material name>.emission.theta''' || float || 90.0 || How directional the light is emitted, set as the half-angle of the light source. Default is 90°. Smaller values mean that more light is emitted in the direction of the face normals and less to the sides.
|-
|'''scene.materials.<material name>.emission.importance''' || float || 1.0 || A hint how often to sample this light source compared to other lights
|}

===Type: archglass===

This material should be used to replace glass material of windows when rendering architectural interiors. It allows direct light to pass trough.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "archglass" || type of material
|-
|'''scene.materials.<material name>.kr''' || texture || 1.0 1.0 1.0 || texture or constant reflected color of the material
|-
|'''scene.materials.<material name>.kt''' || texture || 1.0 1.0 1.0 || texture or constant transmitted color of the material
|-
|'''scene.materials.<material name>.interiorior''' || texture || 1.5 || inside texture or constant index of refraction (only for volume-less rendering)
|-
|'''scene.materials.<material name>.exteriorior''' || texture || 1.0 || outside texture or constant index of refraction (only for volume-less rendering)
|-
|'''scene.materials.<material name>.filmthickness''' || texture || none || thickness (in nanometers) of a [https://en.wikipedia.org/wiki/Thin-film_interference thin-film coating] on the surface. This property is optional, if it is not defined, the coating is disabled.
|-
|'''scene.materials.<material name>.filmior''' || texture || none || Refractive index of the thin-film coating. This property is optional, if it is not defined, the coating is disabled.
|}

===Type: carpaint===

Car Paint is an advanced glossy material, simulating a diffuse surface with mutliple reflective coatings.

The available presets for the carpaint material are:

*"ford f8"
*"polaris silber"
*"opel titan"
*"bmw339"
*"2k acrylack"
*"white"
*"blue"
*"blue matte"

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "carpaint" || type of material
|-
|'''scene.materials.<material name>.preset''' || string || "ford f8" || one of the avilable presets
|-
|'''scene.materials.<material name>.ka''' || texture || 0.0 0.0 0.0 || absorption color
|-
|'''scene.materials.<material name>.d''' || texture || 0.0 || absorption depth
|-
|'''scene.materials.<material name>.kd''' || texture || 0.0 0.0 0.0 || diffuse color
|-
|'''scene.materials.<material name>.ks1''' || texture || 0.0 0.0 0.0 || specular color - layer 1
|-
|'''scene.materials.<material name>.ks2''' || texture || 0.0 0.0 0.0 || specular color - layer 2
|-
|'''scene.materials.<material name>.ks3''' || texture || 0.0 0.0 0.0 || specular color - layer 3
|-
|'''scene.materials.<material name>.r1''' || texture || 0.0 0.0 0.0 || fresnel effect strength - layer 1
|-
|'''scene.materials.<material name>.r2''' || texture || 0.0 0.0 0.0 || fresnel effect strength - layer 2
|-
|'''scene.materials.<material name>.r3''' || texture || 0.0 0.0 0.0 || fresnel effect strength - layer 3
|-
|'''scene.materials.<material name>.m1''' || texture || 0.0 0.0 0.0 || roughness - layer 1
|-
|'''scene.materials.<material name>.m2''' || texture || 0.0 0.0 0.0 || roughness - layer 2
|-
|'''scene.materials.<material name>.m3''' || texture || 0.0 0.0 0.0 || roughness - layer 3
|}

===Type: cloth===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "cloth" || type of material
|-
|'''scene.materials.<material name>.preset''' || string || "denim" || denim, silk_charmeuse, silk_shantung, cotton_twill, wool_garbardine or polyester_lining_cloth
|-
|'''scene.materials.<material name>.weft_kd''' || texture || 0.5 0.5 0.5 || coefficient of diffuse reflection in one weave direction
|-
|'''scene.materials.<material name>.weft_ks''' || texture || 0.5 0.5 0.5 || coefficient of specular reflection in one weave direction
|-
|'''scene.materials.<material name>.warp_kd''' || texture || 0.5 0.5 0.5 || coefficient of diffuse reflection in the opposite weave direction
|-
|'''scene.materials.<material name>.warp_ks''' || texture || 0.5 0.5 0.5 || coefficient of specular reflection in the opposite weave direction
|-
|'''scene.materials.<material name>.repeat_u''' || float || 100.0 || thread count in the u direction
|-
|'''scene.materials.<material name>.repeat_v''' || float || 100.0 || thread count in the v direction
|}

===Type: disney===

For more details, refer to the [https://disney-animation.s3.amazonaws.com/library/s2012_pbs_disney_brdf_notes_v2.pdf original paper].

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "disney" || type of material
|-
|'''scene.materials.<material name>.basecolor''' || texture || 0.5 0.5 0.5 || Base color
|-
|'''scene.materials.<material name>.subsurface''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.roughness''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.metallic''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.specular''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.speculartint''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.clearcoat''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.clearcoatgloss''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.anisotropic''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.sheen''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.sheentint''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.filmamount''' || texture || none || Linear interpolation between no film (0) and full film effect (1) for artistic control. This property is optional, if it is not defined, the coating is disabled.
|-
|'''scene.materials.<material name>.filmthickness''' || texture || none || thickness (in nanometers) of a [https://en.wikipedia.org/wiki/Thin-film_interference thin-film coating] on the surface. This property is optional, if it is not defined, the coating is disabled.
|-
|'''scene.materials.<material name>.filmior''' || texture || none || Refractive index of the thin-film coating. This property is optional, if it is not defined, the coating is disabled.
|}

===Type: glass===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "glass" || type of material
|-
|'''scene.materials.<material name>.kr''' || texture || 1.0 || texture or constant reflected color of the material
|-
|'''scene.materials.<material name>.kt''' || texture || 1.0 || texture or constant transmitted color of the material
|-
|'''scene.materials.<material name>.interiorior''' || texture || 1.5 || inside texture or constant index of refraction (only for volume-less rendering)
|-
|'''scene.materials.<material name>.exteriorior''' || texture || 1.0 || outside texture or constant index of refraction (only for volume-less rendering)
|-
|'''scene.materials.<material name>.cauchyb''' || texture || 0.0 || if defined and > 0.0, enable dispersion. The value is the B term of the [https://en.wikipedia.org/wiki/Cauchy%27s_equation Cauchy's equation]
|-
|'''scene.materials.<material name>.filmthickness''' || texture || none || thickness (in nanometers) of a [https://en.wikipedia.org/wiki/Thin-film_interference thin-film coating] on the surface. This property is optional, if it is not defined, the coating is disabled.
|-
|'''scene.materials.<material name>.filmior''' || texture || none || Refractive index of the thin-film coating. This property is optional, if it is not defined, the coating is disabled.
|}

===Type: glossy2===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "glossy2" || type of material
|-
|'''scene.materials.<material name>.kd''' || texture || 0.5 0.5 0.5 || texture or constant diffuse color of the material
|-
|'''scene.materials.<material name>.ks''' || texture || 0.5 0.5 0.5 || texture or constant specular color of the material
|-
|'''scene.materials.<material name>.uroughness''' || texture || 0.1 || texture or constant roughness value along u coordinate of the material
|-
|'''scene.materials.<material name>.vroughness''' || texture || 0.1 || texture or constant roughness value along v coordinate of the material
|-
|'''scene.materials.<material name>.ka''' || texture || 0.0 0.0 0.0 || texture or constant value of coefficient of absorption of the coating layer
|-
|'''scene.materials.<material name>.d''' || texture || 0.0 || texture or constant value of the depth (thickness) of the coating layer for absorption effects. (0 = disables)
|-
|'''scene.materials.<material name>.index''' || texture || 0.0 0.0 0.0 || IOR of the coating. IOR overrides color Ks if both are specified
|-
|'''scene.materials.<material name>.multibounce''' || bool || false || simulation of asperity (velvet-like reflection) on the glossy surface
|}

===Type: glossytranslucent===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "glossytranslucent" || type of material
|-
|'''scene.materials.<material name>.kd''' || texture || 0.5 0.5 0.5 || texture or constant diffuse color of the material
|-
|'''scene.materials.<material name>.kt''' || texture || 0.5 0.5 0.5 || texture or constant transmission color of the material
|-
|'''scene.materials.<material name>.ks''' || texture || 0.5 0.5 0.5 || texture or constant specular color of the material
|-
|'''scene.materials.<material name>.ks_bf''' || texture || 0.5 0.5 0.5 || texture or constant backface specular color of the material
|-
|'''scene.materials.<material name>.uroughness''' || texture || 0.1 || texture or constant roughness value along u coordinate of the material
|-
|'''scene.materials.<material name>.uroughness_bf''' || texture || 0.1 || texture or constant backface roughness value along u coordinate of the material
|-
|'''scene.materials.<material name>.vroughness''' || texture || 0.1 || texture or constant roughness value along v coordinate of the material
|-
|'''scene.materials.<material name>.vroughness_bf''' || texture || 0.1 || texture or constant backface roughness value along v coordinate of the material
|-
|'''scene.materials.<material name>.ka''' || texture || 0.0 0.0 0.0 || texture or constant value of coefficient of absorption of the coating layer
|-
|'''scene.materials.<material name>.ka_bf''' || texture || 0.0 0.0 0.0 || texture or constant value of backface coefficient of absorption of the coating layer
|-
|'''scene.materials.<material name>.d''' || texture || 0.0 || texture or constant value of the depth (thickness) of the coating layer for absorption effects. (0 = disables)
|-
|'''scene.materials.<material name>.d_bf''' || texture || 0.0 || texture or constant value of the backface depth (thickness) of the coating layer for absorption effects. (0 = disables)
|-
|'''scene.materials.<material name>.index''' || texture || 0.0 0.0 0.0 || IOR of the coating. IOR overrides color Ks if both are specified
|-
|'''scene.materials.<material name>.index_bf''' || texture || 0.0 0.0 0.0 || IOR of the backface coating. IOR overrides color Ks if both are specified
|-
|'''scene.materials.<material name>.multibounce''' || bool || false || simulation of asperity (velvet-like reflection) on the glossy surface
|-
|'''scene.materials.<material name>.multibounce_bf''' || bool || false || backface simulation of asperity (velvet-like reflection) on the glossy surface
|}

===Type: glossycoating===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "glossycoating" || type of material
|-
|'''scene.materials.<material name>.base''' || string || || name of base material, the coating layer is added on top of this material
|-
|'''scene.materials.<material name>.ks''' || texture || 0.5 0.5 0.5 || texture or constant specular color of the material
|-
|'''scene.materials.<material name>.uroughness''' || texture || 0.1 || texture or constant roughness value along u coordinate of the material
|-
|'''scene.materials.<material name>.vroughness''' || texture || 0.1 || texture or constant roughness value along v coordinate of the material
|-
|'''scene.materials.<material name>.ka''' || texture || 0.0 0.0 0.0 || texture or constant value of coefficient of absorption of the coating layer
|-
|'''scene.materials.<material name>.d''' || texture || 0.0 || texture or constant value of the depth (thickness) of the coating layer for absorption effects. (0 = disables)
|-
|'''scene.materials.<material name>.index''' || texture || 0.0 0.0 0.0 || IOR of the coating. IOR overrides color Ks if both are specified
|-
|'''scene.materials.<material name>.multibounce''' || bool || false || simulation of asperity (velvet-like reflection) on the glossy surface
|}

===Type: matte===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "matte" || type of material
|-
|'''scene.materials.<material name>.kd''' || texture || 0.75 0.75 0.75 || texture or constant color of the matte material
|}

===Type: mattetranslucent===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "mattetranslucent" || type of material
|-
|'''scene.materials.<material name>.kr''' || texture || 0.5 0.5 0.5 || texture or constant reflected color of the material
|-
|'''scene.materials.<material name>.kt''' || texture || 0.5 0.5 0.5 || texture or constant transmitted color of the material
|}

===Type: metal2===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "metal2" || type of material
|-
|'''scene.materials.<material name>.fresnel''' || fresnel texture || ... || [[#Type:_Fresnel_Textures | fresnel texture]]
|-
|'''scene.materials.<material name>.uroughness''' || texture || 0.1 || texture or constant roughness value along u coordinate of the material
|-
|'''scene.materials.<material name>.vroughness''' || texture || 0.1 || texture or constant roughness value along v coordinate of the material
|-
|'''scene.materials.<material name>.preset''' || string || "aluminium" || (DEPRECATED) "aluminium", "silver", "copper", "gold" or "amorphous carbon"
|-
|'''scene.materials.<material name>.n''' || texture || 0.5 0.5 0.5 || (DEPRECATED) texture or constant value. It can be used to directly define a fresnelapproxn texture on overwrite the .preset property
|-
|'''scene.materials.<material name>.k''' || texture || 0.5 0.5 0.5 || (DEPRECATED) texture or constant value. It can be used to directly define a fresnelapproxk texture on overwrite the .preset property
|}

===Type: mirror===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "mirror" || type of material
|-
|'''scene.materials.<material name>.kr''' || texture || 1.0 1.0 1.0 || texture or constant reflected color of the material
|}

===Type: mix===

This material can be used to mix 2 other materials.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "mix" || type of material
|-
|'''scene.materials.<material name>.material1''' || string || mat1 || name of another material
|-
|'''scene.materials.<material name>.material2''' || string || mat2 || name of another material
|-
|'''scene.materials.<material name>.amount''' || texture || 0.5 || texture or constant value used to mix the materials
|}

===Type: null===

This is empty, not visible material. It can be combined by using mix material with others. It is often used in combination with the alpha channel of an image map to render leafs, etc.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "null" || type of material
|}

===Type: roughglass===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "roughglass" || type of material
|-
|'''scene.materials.<material name>.kr''' || texture || 1.0 1.0 1.0 || texture or constant reflected color of the material
|-
|'''scene.materials.<material name>.kt''' || texture || 1.0 1.0 1.0 || texture or constant transmitted color of the material
|-
|'''scene.materials.<material name>.interiorior''' || texture || 1.5 || inside texture or constant index of refraction
|-
|'''scene.materials.<material name>.exteriorior''' || texture || 1.0 || outside texture or constant index of refraction
|-
|'''scene.materials.<material name>.uroughness''' || texture || 0.1 || texture or constant roughness value along u coordinate of the material
|-
|'''scene.materials.<material name>.vroughness''' || texture || 0.1 || texture or constant roughness value along v coordinate of the material
|-
|'''scene.materials.<material name>.filmthickness''' || texture || none || thickness (in nanometers) of a [https://en.wikipedia.org/wiki/Thin-film_interference thin-film coating] on the surface. This property is optional, if it is not defined, the coating is disabled.
|-
|'''scene.materials.<material name>.filmior''' || texture || none || Refractive index of the thin-film coating. This property is optional, if it is not defined, the coating is disabled.
|}

===Type: roughmatte===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "roughmatte" || type of material
|-
|'''scene.materials.<material name>.kd''' || texture || 0.75 0.75 0.75 || texture or constant color of the roughmatte material
|-
|'''scene.materials.<material name>.sigma''' || texture || 0.0 || the sigma parameter in the Oren-Nayer shader in degrees. Zero for pure Lambertian reflection
|}

===Type: velvet===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "velvet" || type of material
|-
|'''scene.materials.<material name>.kd''' || texture || 0.5 0.5 0.5 || color of the material's fuzz
|-
|'''scene.materials.<material name>.p1''' || texture || -2.0 || polynomial that influences the fuzz
|-
|'''scene.materials.<material name>.p2''' || texture || 20.0 || polynomial that influences the fuzz
|-
|'''scene.materials.<material name>.p3''' || texture || 2.0 || polynomial that influences the fuzz
|-
|'''scene.materials.<material name>.thickness''' || texture || 0.1 || height of the fuzz
|}

==Objects==

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.objects.<object name>.material''' || string || || type of object material
|-
|'''scene.objects.<object name>.shape''' || string || || name of [[#Shapes | shape]] with the triangle mesh description.Memory required to store the triangle mesh information is allocated only once if 2 or more different objects share the same shape, use .transformation property and true instancing is enabled.
|-
|'''scene.objects.<object name>.ply''' || string || || '''(Deprecated, use .shape instead)''' name of [http://en.wikipedia.org/wiki/PLY_(file_format) PLY] file with the triangle mesh description. Memory required to store the triangle mesh information is allocated only once if 2 or more different objects share the same file, use .transformation property and true instancing is enabled.
|-
|'''scene.objects.<object name>.transformation''' || matrix 4x4 || 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 || transformation matrix
|-
|'''scene.objects.<object name>.vertices''' || float || || This is an alternative syntax to using PLY file. It is an in-lined definition of the triangle mesh. It is a list of float values defining the vertices of the mesh (i.e. 3 coordinates for each vertex).
|-
|'''scene.objects.<object name>.faces''' || unsigned int || || This is an alternative syntax to using PLY file. It is an in-lined definition of the triangle mesh. It is a list of unsigned int values defining the triangles of the mesh (i.e. 3 index of vertices for each triangle).
|-
|'''scene.objects.<object name>.id''' || unsigned int || || object ID
|-
|'''scene.objects.<object name>.camerainvisible''' || bool || false || toggle visibility for camera rays. If set to true, the object will not show up in camera rays, but it will still be visible in reflections, refractions, shadows, indirect light etc.
|}

===Object Motion Blur===

LuxCore supports transformation motion blur for objects.
Motion blur is enabled if an object has a motion system defined as described below.

A motion system consists of steps (at least 2). Each step has a time (in seconds) and a transformation matrix of the object at this point in time.
Step indices start at 0. The times have to be monotonic (each greater than the last).

Note that the embree accelerator only supports a maximum of 129 time steps.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.objects.<object name>.motion.<step>.time''' || float || || time (in seconds) of the step
|-
|'''scene.objects.<object name>.motion.<step>.transformation''' || matrix 4x4 || 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 || transformation matrix of the object at the given step
|-
|}

==Shapes==

===Type: mesh===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.shapes.<shape name>.type''' || string || "mesh" || mesh shape
|-
|'''scene.shapes.<shape name>.ply''' || string || ... || mesh path (e.g ''scenes/luxball/luxball-shell.ply'')
|-
|'''scene.shapes.<shape name>.appliedtransformation''' || Matrix4x4 || 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0|| transformation matrix applied to the mesh vertices. Used to define the local object reference space.
|}

===Type: inlinedmesh===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.shapes.<shape name>.type''' || string || "inlinedmesh" || inlinedmesh shape
|-
|'''scene.shapes.<shape name>.vertices''' || vector || ... || inlinedmesh vertices (e.g 0.0 0.0 0.0 1.0 0.0 0.0 0.0 1.0 0.0)
|-
|'''scene.shapes.<shape name>.faces''' || vector || ... || inlinedmesh faces (e.g 0 1 2)
|-
|'''scene.shapes.<shape name>.appliedtransformation''' || Matrix4x4 || 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0|| transformation matrix applied to the mesh vertices. Used to define the local object reference space.
|}

===Type: pointiness===

Contains surface curvature information in vertex alpha channel. 
You can access this information in materials via a hitpointalpha texture. 
The values range from -1 to 1 (float). 
Values from -1 to 0 are concave, while values from 0 to 1 are convex.

[[ Shape:_Pointiness | Examples ]]

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.shapes.<shape name>.type''' || string || "pointiness" || pointiness shape
|-
|'''scene.shapes.<shape name>.source''' || string || ... || pointiness source (a mesh shape)
|}

===Type: strands===

Can be used for hair, fur, grass etc. 
Note that you need to define the camera before defining any strands shapes, because the tesselation process is viewpoint-dependent.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.shapes.<shape name>.type''' || string || "strands" || strands shape
|-
|'''scene.shapes.<shape name>.file''' || string || ... || strands file (''scenes/strands/straight.hair'')
|}

====Strands tessellation methods====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.shapes.<shape name>.tessellation.type''' || string || "ribbon" || ribbon tessellation
|-
|'''scene.shapes.<shape name>.tessellation.usecameraposition''' || bool || 1 || use camera position
|}

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.shapes.<shape name>.tessellation.type''' || string || "ribbonadaptive" || ribbon adaptive tessellation method
|-
|'''scene.shapes.<shape name>.tessellation.adaptative.maxdepth''' || unsigned int || 12 || max tessellation depth
|-
|'''scene.shapes.<shape name>.tessellation.adaptative.error ''' || float || 0.0075 || max tessellation error
|}

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.shapes.<shape name>.tessellation.type''' || string || "solid" || solid tessellation method
|-
|'''scene.shapes.<shape name>.tessellation.solid.sidecount ''' || unsigned int || 12 || tessellation's side count
|}

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.shapes.<shape name>.tessellation.type''' || string || "solidadaptive" || solidadaptive tessellation method
|-
|'''scene.shapes.<shape name>.tessellation.solidadaptive.sidecount ''' || unsigned int || 8 || tessellation's side count
|-
|'''scene.shapes.<shape name>.tessellation.solidadaptive.maxdepth''' || unsigned int || 16 || tessellation's max depth
|-
|'''scene.shapes.<shape name>.tessellation.solidadaptive.error''' || float || 0.05 || tessellation's max error
|}

===Type: group===

Todo.

===Type: displacement===

Todo.

===Type: subdiv===

Todo.

===Type: harlequin===

Todo.

===Type: simplify===

Todo.

===Type: islandaov===

Todo.

===Type: randomtriangleaov===

Todo.

==Light sources==

Check [[Lighting|LuxCoreRender Lighting]] for an high level description and example of the light sources.

===Common parameters===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.gain''' || spectrum || 1.0 1.0 1.0 || intensity of the light
|-
|'''scene.lights.<light name>.transformation''' || matrix 4x4 || 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 || transformation matrix
|-
|'''scene.lights.<light name>.samples''' || int || -1 || the number of shadow ray to trace to compute direct light for this light source. This property is an hint and the render engine can ignore this information. -1 means use the default global value.
|-
|'''scene.lights.<light name>.id''' || int || 0 || the radiance group the light emitted from this material is assigned to.

|-
|'''scene.lights.<light name>.importance''' || float || 1.0 || A hint how often to sample this light compared to other lights
|}

===Type: sun===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "sun" || type of light
|-
|'''scene.lights.<light name>.turbidity''' || float || 2.2 || turbidity can go from 1.0 to 30+. 2-6 are most useful for clear days
|-
|'''scene.lights.<light name>.relsize''' || float || 1.0 || relative size to the sun
|-
|'''scene.lights.<light name>.dir''' || vector || 0.0 0.0 1.0 || direction vector of the sun
|-
|'''scene.lights.<light name>.visibility.indirect.diffuse.enable''' || bool || true || if the light source is visible by indirect rays on diffuse surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.visibility.indirect.glossy.enable''' || bool || true || if the light source is visible by indirect rays on glossy surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.visibility.indirect.specular.enable''' || bool || true || if the light source is visible by indirect rays on specular surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|}

===Type: sky2===

Hosek-Wilkie sky model.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "sky2" || type of light
|-
|'''scene.lights.<light name>.turbidity''' || float || 2.2 || turbidity can go from 1.0 to 30+. 2-6 are most useful for clear days
|-
|'''scene.lights.<light name>.dir''' || vector || 0.0 0.0 1.0 || direction vector of the sun
|-
|'''scene.lights.<light name>.gain''' || vector || ... || gain
|-
|'''scene.lights.<light name>.groundalbedo''' || vector || 0.5 0.5 0.5 || ground albedo
|-
|'''scene.lights.<light name>.visibility.indirect.diffuse.enable''' || bool || true || if the light source is visible by indirect rays on diffuse surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.visibility.indirect.glossy.enable''' || bool || true || if the light source is visible by indirect rays on glossy surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.visibility.indirect.specular.enable''' || bool || true || if the light source is visible by indirect rays on specular surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.ground.enable''' || bool || 1 || enable ground color
|-
|'''scene.lights.<light name>.ground.color''' || vector|| ... || RGB ground color
|}

===Type: infinite===

Spherical lightsource surrounding the scene at infinite distance. 
Used for image based lighting (IBL) and HDR environment lighting if the file is a high dynamic range image.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "infinite" || type of light
|-
|'''scene.lights.<light name>.file''' || string || "image.png" || filename of the environment map
|-
|'''scene.lights.<light name>.gamma''' || float || 2.2 || gamma correction used by the image map
|-
|'''scene.lights.<light name>.storage''' || string || "auto" || environment map storage type ("auto", "byte", "half" or "float")
|-
|'''scene.lights.<light name>.visibility.indirect.diffuse.enable''' || bool || true || if the light source is visible by indirect rays on diffuse surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.visibility.indirect.glossy.enable''' || bool || true || if the light source is visible by indirect rays on glossy surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.visibility.indirect.specular.enable''' || bool || true || if the light source is visible by indirect rays on specular surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.sampleupperhemisphereonly''' || bool || false || an option set to black the lower hemisphere. Mostly useful for shadow catchers.
|}

===Type: point===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "point" || type of light
|-
|'''scene.lights.<light name>.position''' || point || 0.0 0.0 0.0 || position
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.power''' || float || 0.0 || lamp output power in watts. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.efficency''' || float || 0.0 || luminous efficacy in lumens/watt. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|}

===Type: mappoint===

Point light with support for IES files or image maps controlling the strength of light emitted.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "mappoint" || type of light
|-
|'''scene.lights.<light name>.position''' || point || 0.0 0.0 0.0 || position
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.power''' || float || 0.0 || lamp output power in watts. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.efficency''' || float || 0.0 || luminous efficacy in lumens/watt. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.mapfile''' || string || || the name of an optional image map that can be used to scale the emitted light
|-
|'''scene.lights.<light name>.gamma''' || float || 2.2 || gamma value of the image map defined with .mapfile property
|-
|'''scene.lights.<light name>.iesfile''' || string || || a [http://en.wikipedia.org/wiki/Illuminating_Engineering_Society_of_North_America IES] profile of emitted light and the render engine can ignore this information. -1 means use the default global value.
|-
|'''scene.lights.<light name>.iesblob''' || string || || a [http://en.wikipedia.org/wiki/Illuminating_Engineering_Society_of_North_America IES] profile of emitted light embedded in a blob
|-
|'''scene.lights.<light name>.flipz''' || bool || false || flip the IES profile along the Z axis
|-
|'''scene.lights.<light name>.map.width''' || unsigned int || 0 || scale the image or IES map to the specified width. 0 means use the original size
|-
|'''scene.lights.<light name>.map.height''' || unsigned int || 0 || scale the image or IES map to the specified height. 0 means use the original size
|}

===Type: sphere===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "sphere" || type of light
|-
|'''scene.lights.<light name>.position''' || point || 0.0 0.0 0.0 || position
|-
|'''scene.lights.<light name>.radius''' || float || 1.0 || position
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.power''' || float || 0.0 || lamp output power in watts. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.efficency''' || float || 0.0 || luminous efficacy in lumens/watt. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|}

===Type: mapsphere===

Sphere light with support for IES files or image maps controlling the strength of light emitted.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "mapsphere" || type of light
|-
|'''scene.lights.<light name>.position''' || point || 0.0 0.0 0.0 || position
|-
|'''scene.lights.<light name>.radius''' || float || 1.0 || position
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.power''' || float || 0.0 || lamp output power in watts. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.efficency''' || float || 0.0 || luminous efficacy in lumens/watt. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.mapfile''' || string || || the name of an optional image map that can be used to scale the emitted light
|-
|'''scene.lights.<light name>.gamma''' || float || 2.2 || gamma value of the image map defined with .mapfile property
|-
|'''scene.lights.<light name>.iesfile''' || string || || a [http://en.wikipedia.org/wiki/Illuminating_Engineering_Society_of_North_America IES] profile of emitted light and the render engine can ignore this information. -1 means use the default global value.
|-
|'''scene.lights.<light name>.iesblob''' || string || || a [http://en.wikipedia.org/wiki/Illuminating_Engineering_Society_of_North_America IES] profile of emitted light embedded in a blob
|-
|'''scene.lights.<light name>.flipz''' || bool || false || flip the IES profile along the Z axis
|-
|'''scene.lights.<light name>.map.width''' || unsigned int || 0 || scale the image or IES map to the specified width. 0 means use the original size
|-
|'''scene.lights.<light name>.map.height''' || unsigned int || 0 || scale the image or IES map to the specified height. 0 means use the original size
|}

===Type: spot===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "spot" || type of light
|-
|'''scene.lights.<light name>.position''' || point || 0.0 0.0 0.0 || position
|-
|'''scene.lights.<light name>.target''' || point || 0.0 0.0 1.0 || target
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.power''' || float || 0.0 || lamp output power in watts. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.efficency''' || float || 0.0 || luminous efficacy in lumens/watt. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.coneangle''' || float || 30.0 || angle in degrees of the spotlight cone
|-
|'''scene.lights.<light name>.conedeltaangle''' || float || 5.0 || angle at which the spotlight intensity starts to fade from the edge
|}

===Type: projection===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "projection" || type of light
|-
|'''scene.lights.<light name>.position''' || point || 0.0 0.0 0.0 || position
|-
|'''scene.lights.<light name>.target''' || point || 0.0 0.0 1.0 || target
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.power''' || float || 0.0 || lamp output power in watts. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.efficency''' || float || 0.0 || luminous efficacy in lumens/watt. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.fov''' || float || 45.0 || field of view in terms of angular spread along the shorter image axis
|-
|'''scene.lights.<light name>.mapfile''' || string || || filename of the image to project. If not specified, a constat light color will be used.
|-
|'''scene.lights.<light name>.gamma''' || float || 2.2 || gamma value of the image map defined with .mapfile property
|}

===Type: constantinfinite===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "constantinfinite" || type of light
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.visibility.indirect.diffuse.enable''' || bool || true || if the light source is visible by indirect rays on diffuse surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.visibility.indirect.glossy.enable''' || bool || true || if the light source is visible by indirect rays on glossy surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.visibility.indirect.specular.enable''' || bool || true || if the light source is visible by indirect rays on specular surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|}

===Type: sharpdistant===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "sharpdistant" || type of light
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.direction''' || vector || 0.0 0.0 1.0 || direction
|}

===Type: distant===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "distant" || type of light
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.direction''' || vector || 0.0 0.0 1.0 || direction
|-
|'''scene.lights.<light name>.theta''' || float || 10.0 || half angle of the light source in degree. Must be > 0 for soft shadows
|}

===Type: laser===

A light source emitting parallel light rays (like sharpdistant light, but starting inside the scene instead of infinitely far away).

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "laser" || type of light
|-
|'''scene.lights.<light name>.position''' || point || 0.0 0.0 0.0 || position
|-
|'''scene.lights.<light name>.target''' || point || 0.0 0.0 1.0 || target
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.power''' || float || 0.0 || lamp output power in watts. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.efficency''' || float || 0.0 || luminous efficacy in lumens/watt. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.radius''' || float || 0.01 || radius of the laser beam
|}

LuxCore SDL Reference Manual v2.5

2020-08-27T14:01:20Z

Byob: /* Textures */

The scene description language (SDL) is used to configure the renderer and to define objects, materials, textures etc. in the scene. 
The file ending of the render configuration file is ".cfg", for the scene file it's ".scn".

These files are usually created by exporter plugins, e.g. BlendLuxCore. 
This wiki page is primarily a reference for exporter developers, normal end-users should not need to edit cfg/scn files by hand.

Sometimes the API is updated faster than the wiki, in this case you can look at the code directly: https://github.com/LuxCoreRender/LuxCore/tree/master/src/slg/scene

Note that matrices are passed as flat lists in column-major form.

=Render configuration file=

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''resumerendering.filesafe''' || bool || 1 || enable/disable "safe save" mode for resume rendering file. A backup of the output is always valid even in the case of a system failure
|}

==Seed==

The global seed value that is used to generate random numbers. 
Two images rendered with the same seed will have the same noise pattern.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''renderengine.seed''' || unsigned int || 1 || min 1
|}

==Periodic save==

Options related to periodic save operations.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''periodicsave.resumerendering.period''' || float || 0 || save the resume rendering file every specified amount of time (value in seconds). A value <= 0.0 disable the saving
|-
|'''periodicsave.resumerendering.filename''' || string || "resume.rsm" || the name to use to save the rendering resume information periodically
|-
|'''periodicsave.film.period''' || float || 0 || save the Film every specified amount of time (value in seconds). A value <= 0.0 disable the saving
|-
|'''periodicsave.film.filename''' || string || "film.flm" || the name to use to save the film periodically
|-
|'''periodicsave.film.outputs.period''' || float || 600 || save all Film outputs every specified amount of time (value in seconds). A value <= 0.0 disable the saving
|}

==Render Engine==

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''renderengine.type''' || string || "PATHCPU" || engine type
|}

=== CPU Render Engines ===

CPU render engines are written in C++ and don't require OpenCL. All CPU render engines accept the following parameters:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''native.threads.count''' || int || CPU core count || > 0 || > 0 || The number of threads will be used for the rendering
|}

'''The following CPU engines are available:'''

===="PATHCPU"====

A path tracer with full image plane rendering (i.e. supporting Metropolis sampler).

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''path.pathdepth.total''' || int || 6 || > 0 || [1, 16] || Maximum recursion depth of a path
|-
|'''path.pathdepth.diffuse''' || int || 4 || > 0 || [1, 16] ||
|-
|'''path.pathdepth.glossy''' || int || 4 || > 0 || [1, 16] ||
|-
|'''path.pathdepth.specular''' || int || 6 || > 0 || [1, 16] ||
|-
|'''path.russianroulette.depth''' || int || 3 || > 0 || [1, path.maxdepth] || The path depth where Russian Roulette stars to be used
|-
|'''path.russianroulette.cap''' || float || 0.5 || [0.0, 1.0] || [0.0, 1.0] || The threshold over which Russian Roulette is used
|-
|'''path.clamping.variance.maxvalue''' || float || 0.0 || > 0.0 || > 0.0 || Samples brighter than this value are clamped, helps to reduce fireflies. 0.0 = disabled
|-
|'''path.forceblackbackground.enable''' || bool || 0 || 0 or 1 || 0 or 1 || Enable when rendering with transparent film and premultiplied alpha, to avoid artifacts with semi-transparent areas
|}

===="TILEPATHCPU"====
Biased path tracer with many control options and support for tile rendering. 
The sampler must be set to TILEPATHSAMPLER when using this engine.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''path.pathdepth.total''' || int || 6 || > 0 || [1, 16] || Maximum recursion depth of a path
|-
|'''path.pathdepth.diffuse''' || int || 4 || > 0 || [1, 16] ||
|-
|'''path.pathdepth.glossy''' || int || 4 || > 0 || [1, 16] ||
|-
|'''path.pathdepth.specular''' || int || 6 || > 0 || [1, 16] ||
|-
|'''path.russianroulette.depth''' || int || 3 || > 0 || [1, path.maxdepth] || The path depth where Russian Roulette stars to be used
|-
|'''path.russianroulette.cap''' || float || 0.5 || [0.0, 1.0] || [0.0, 1.0] || The threshold over which Russian Roulette is used
|-
|'''path.clamping.variance.maxvalue''' || float || 0.0 || > 0.0 || > 0.0 || Samples brighter than this value are clamped, helps to reduce fireflies. 0.0 = disabled
|-
|'''path.forceblackbackground.enable''' || bool || 0 || 0 or 1 || 0 or 1 || Enable when rendering with transparent film and premultiplied alpha, to avoid artifacts with semi-transparent areas
|-
|'''tilepath.sampling.aa.size''' || int || 3 || > 0 || [1, 13] || All diffuse/glossy/specular samples are multiplied with the squared aa size: final_samples = aa^2 * (diffuse^2 + glossy^2 + specular^2)
|-
|'''tile.size''' || int || 32 || ≥ 8 || [8, 256] || Tile size in pixels
|-
|'''tile.multipass.enable''' || bool || 1 || 0 or 1 || o or 1 || Re-render the image until a halt threshold is met or indefinitely
|-
|'''tile.multipass.convergencetest.threshold''' || float || 6.0 / 256.0 || > 0.0 || [1.0 / 256.0, 6.0 / 256.0] || Target noise level
|-
|'''tile.multipass.convergencetest.threshold.reduction''' || float || 0.0 || [0.0, 1.0] || [0.75, 0.95] || Multiply noise level with this number when all tiles have met the previous noise level. Set to 0 to disable (so rendering will stop at the noise level)
|-
|'''tile.multipass.convergencetest.warmup.count''' || int || 32 || ≥ 0 || [8, 128] || Warm up period for the convergence test expressed in samples per pixel
|}

===="BIDIRCPU"====

A Bidirectional path tracer.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''path.maxdepth''' || int || 5 || > 0 || [1, 16] || Maximum recursion depth of a eye path
|-
|'''light.maxdepth''' || int || 5 || > 0 || [1, 16] || Maximum recursion depth of a light path
|-
|'''path.russianroulette.depth''' || int || 3 || > 0 || [1, path.maxdepth] || The path depth where Russian Roulette starts to be used
|-
|'''path.russianroulette.cap''' || float || 0.5 || [0.0, 1.0] || [0.0, 1.0] || The threshold over which Russian Roulette is used
|}

===="RTPATHCPU"====
Engine optimized for interactive scene editing and camera movement. 
The sampler must be set to RTPATHCPUSAMPLER when using this engine.

Supports the same properties as [[#"PATHCPU" | "PATHCPU"]] plus the following:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''rtpathcpu.zoomphase.size''' || int || 4 || || || render scaled down film for the first few frames after a scene edit (to make interactions more fluid)
|-
|'''rtpathcpu.zoomphase.weight''' || float || 0.1 || || || description: TODO
|}

=== OpenCL Render Engines ===

OpenCL engines can run on GPUs, CPUs and other types of computing devices, they require OpenCL to run. All OpenCL render engines accept the following parameters:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''opencl.platform.index''' || int || -1 || A valid platform index || -1 || Select the OpenCL platform to use. All devices available on all platforms will be used with -1
|-
|'''opencl.cpu.use''' || bool || 1 || 0 or 1 || 0 or 1 || If to use all OpenCL CPU devices available
|-
|'''opencl.gpu.use''' || bool || 1 || 0 or 1 || 0 or 1 || If to use all OpenCL GPU devices available
|-
|'''opencl.cpu.workgroup.size''' || int || 0 || Any valid OpenCL workgroup size || 64 || Set the OpenCL workgroup size, 0 means to use the driver suggested value
|-
|'''opencl.gpu.workgroup.size''' || int || 0 || Any valid OpenCL workgroup size || 64 || Set the OpenCL workgroup size, 0 means to use the driver suggested value
|-
|'''opencl.devices.select''' || string || "" || Any valid selection string || Any valid selection string || Select each OpenCL device to use. It is a string of "0" and "1". "1" means use the device, "0" do not
|}

'''The following OpenCL engines are available:'''

===="PATHOCL"====
OpenCL version of PATHCPU. Supports the same settings as [[#"PATHCPU" | PATHCPU]] plus the following:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''pathocl.pixelatomics.enable''' || bool || 0 || 0 or 1 || 0 or 1 || Enable pixel atomic operation
|-
|'''opencl.task.count''' || int || "AUTO" || "AUTO" or > 0 || [64K, 1024K] || The number of tasks sent to the OpenCL device in one kernel call
|}

===="RTPATHOCL"====

A PATHOCL version optimized for real-time rendering with fixed frame-rate and variable quality. 
The sampler must be set to TILEPATHSAMPLER when using this engine.

Supports the same settings as [[#"PATHOCL" | PATHOCL]] plus the following:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''rtpath.resolutionreduction.preview''' || int || 4 || > 0 || [1, 32] || Render a sample every n x n pixels in the first passes. For instance 4x4 than 2x2 and than always 1x1
|-
|'''rtpath.resolutionreduction.preview.step''' || int || 8 || > 0 || [1, 32] || Each preview step is rendered for n frames
|-
|'''rtpath.resolutionreduction''' || int || 4 || > 0 || [1, 32] || Render a sample every n x n pixels, outside the preview phase, in order to reduce the per frame rendering time
|}

===="TILEPATHOCL"====

OpenCL version of TILEPATHCPU. 
The sampler must be set to TILEPATHSAMPLER when using this engine.

Supports the same settings as [[#"TILEPATHCPU" | TILEPATHCPU]] plus the following:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''tilepathocl.devices.maxtiles''' || int || 16 || ≥ 1 || [1, 32] || Maximum number of tiles to send in a single call to each OpenCL device
|}

==="FILESAVER"===

Saves everything needed to render the scene to the output path, including textures and meshes.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''filesaver.format''' || string || "TXT" || "TXT" for a text SDL format and "BIN" for a single file binary format
|-
|'''filesaver.filename''' || string || "luxcore-exported-scene.bcf" || file name for "BIN" format
|-
|'''filesaver.directory''' || string || "luxcore-exported-scene" || output path for "TXT" format
|-
|'''filesaver.renderengine.type''' || string || "PATHCPU" || render engine to use when rendering the scene after it was saved with FILESAVER. Any engine string from above can be used here.
|}

===Experimental and debugging engines===

'''These engines are experimental, deprecated or are only intended for very specific purposes:'''

===="BIDIRVMCPU"====

Bidir with vertex merging, currently experimental. 
Supports the same settings as [[#"BIDIRCPU" | BIDIRCPU]] plus the following:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''bidirvm.lightpath.count''' || int || 16 * 1024 || > 0 || || Number of lightpaths per pass
|-
|'''bidirvm.startradius.scale''' || float || 0.003 || > 0 || || Photon radius of the first pass
|-
|'''bidirvm.alpha''' || float || 3 || > 0 || [0.0, 1.0] || Photon radius is multiplied with this value after every pass to reduce the radius
|}

===="LIGHTCPU"====

For testing.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''light.maxdepth''' || int || 5 || > 0 || [1, 16] || Maximum recursion depth of a light path
|-
|'''light.russianroulette.depth''' || int || 3 || > 0 || [1, path.maxdepth] || The path depth where Russian Roulette starts to be used
|-
|'''light.russianroulette.cap''' || float || 0.5 || [0.0, 1.0] || [0.0, 1.0] || The threshold over which Russian Roulette is used
|}

==Sampler==

Samplers are used by following render engines:

* LIGHTCPU
* PATHCPU
* BIDIRCPU
* BIDIRVMCPU
* PATHOCL

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''sampler.type''' || string || "SOBOL" || sampler type
|}

The following samplers are available:

==="SOBOL"===

Sampler with sobol pattern.
Parameters:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''sampler.sobol.adaptive.strength''' || float || 0.7 || 0 ≤ x < 0.95 || 0.5 - 0.9 || it sets if the sampler should be more or less adaptive
|}

==="METROPOLIS"===

Metropolis sampler.
Parameters:
{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''sampler.metropolis.largesteprate''' || float || 0.4 || 0 ≤ x ≤ 1 || 0 - 1 || Probability of generating a large sample mutation
|-
|'''sampler.metropolis.maxconsecutivereject''' || int || 512 || x ≥ 0 || 0 - 32768 || Number of consecutive rejects before a next mutation is forced. Low values can cause bias
|-
|'''sampler.metropolis.imagemutationrate''' || float || 0.1 || 0 ≤ x ≤ 1 || 0 - 1 || Maximum distance over the image plane for a small mutation
|}

==="RANDOM"===

Fully random sampler. This sampler is mostly intended for testing purpose.
Parameters:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''sampler.random.adaptive.strength''' || float || 0.7 || 0 ≤ x < 0.95 || 0.5 - 0.9 || it sets if the sampler should be more or less adaptive
|}

==Filter==

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''film.filter.type''' || string || "BLACKMANHARRIS" || || || Type of pixel filter.
|-
|'''film.filter.width''' || float || 2.0 || x > 0.0 || 0.1 - 3.0 || Filter radius in pixels. Does not have an effect on the NONE filter
|-
|'''film.filter.xwidth''' || float || 2.0 || x > 0.0 || 0.1 - 3.0 || Width in pixels. Overwrite '''film.filter.width''' value
|-
|'''film.filter.ywidth''' || float || 2.0 || x > 0.0 || 0.1 - 3.0 || Width in pixels. Overwrite '''film.filter.width''' value
|}

Available filters are:

==="NONE"===

Disable pixel filtering.

==="BOX"===

Box pixel filter. No parameters.

==="GAUSSIAN"===

Gaussian pixel filter.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''film.filter.gaussian.alpha''' || float || 2.0 || x > 0.0 || 0.1 - 10.0 || Gaussian rate of falloff. Lower values give blurrier images.
|}

==="MITCHELL"===

Mitchel pixel filter.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
| '''film.filter.mitchell.b''' || float || 1.0/3.0 || 0.0 ≤ x ≤ 1.0 || 0.0 - 1.0 || B parameter for the mitchell filter in the range
|-
| '''film.filter.mitchell.c''' || float || 1.0/3.0 || 0.0 ≤ x ≤ 1.0 || 0.0 - 1.0 || C parameter for the mitchell filter in the range 0..1
|}

==="MITCHELL_SS"===

Mitchel pixel filter with super-sampling (i.e. image will be filtered first with a grid of 4 pixels for each pixel).

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
| '''film.filter.mitchellss.b''' || float || 1.0/3.0 || 0.0 ≤ x ≤ 1.0 || 0.0 - 1.0 || B parameter for the mitchell filter in the range
|-
| '''film.filter.mitchellss.c''' || float || 1.0/3.0 || 0.0 ≤ x ≤ 1.0 || 0.0 - 1.0 || C parameter for the mitchell filter in the range 0..1
|}

==="BLACKMANHARRIS"===

Blcakman-Harris pixel filter. No parameters.

==Light Strategy==

The direct light sampling strategy is defined by the following property:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''lightstrategy.type''' || string || "LOG_POWER" || "UNIFORM", "POWER", "LOG_POWER" or "DLS_CACHE" || N/A || Direct light sampling strategy
|}

==="UNIFORM"===

"UNIFORM" light strategy samples evenly all light sources.

==="POWER"===

"POWER" light strategy samples the light sources based on their power.

==="LOG_POWER"===

"LOG_POWER" light strategy samples the light sources based on logarithm of their power.

==="DLS_CACHE"===

Build direct light sampling cache to optimize many-lights rendering, beneficial in scenes with multiple light sources with few overlap between their influence areas (e.g. a building with many disconnected rooms and interior lights).

Options for the DLS cache:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''lightstrategy.entry.radius''' || float || 0.0 || || N/A || Entry radius in meters, automatic radius estimation is used if the radius is set to 0
|-
|'''lightstrategy.entry.normalangle''' || float || 25.0 || || N/A ||
|-
|'''lightstrategy.entry.maxpasses''' || int || 1024 || || N/A ||
|-
|'''lightstrategy.entry.convergencethreshold''' || float || 0.05 || || N/A ||
|-
|'''lightstrategy.entry.warmupsamples''' || int || 24 || || N/A ||
|-
|'''lightstrategy.targetcachehitratio''' || float || 0.995 || || N/A ||
|-
|'''lightstrategy.maxdepth''' || int || 4 || || N/A ||
|-
|'''lightstrategy.maxsamplescount''' || int || 10000000 || || N/A ||
|-
|'''lightstrategy.persistent.file''' || string || "" || || N/A ||
|-
|'''lightstrategy.persistent.safesave''' || bool || 1 || || N/A ||

|}

==Accelerator==

The ray/triangle intersection accelerator to use for the rendering is defined by the following properties:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''accelerator.type''' || string || "AUTO" || "AUTO", "BVH", "MBVH", "EMBREE" || "AUTO" || The intersection accelerator. "AUTO" will select the best one available for the current [[LuxRays]] intersection device. "EMBREE" is currently usable only on CPU render engines
|-
|'''accelerator.instances.enable''' || bool || 1 || 0 or 1 || 0 or 1 || Enable instance support (or disable in order to slightly increase rendering speed)
|}

==Epsilon==

Minimum and maximum allowed value for scene epsilon can be define by the following properties:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''scene.epsilon.min''' || float || 1e-5f || Any float value || 1e-6f ≤ x ≤ 1e-1f || Minimum allowed value for scene epsilon
|-
|'''scene.epsilon.max''' || float || 1e-1f || Any float value || 1e-3f ≤ x ≤ 1e+2f || Maximum allowed value for scene epsilon
|}

==Film==

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.safesave''' || bool || 1 || enable "safe save" of Film serialization. A backup of the output is always valid even in the case of a system failure.
|}

===Film OpenCL Options===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.opencl.enable''' || bool || 1 || enable OpenCL film operations
|-
|'''film.opencl.platform''' || unsigned int || -1 || choose which platform will be used by the film operations. (0 is first platform, 1 second and so on. -1 for all)
|-
|'''film.opencl.device''' || unsigned int || -1 || choose which device will be used by the film operations. (0 is first device, 1 second and so on. -1 for first GPU device)
|}

===Film Outputs (aka AOVs)===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.outputs.safesave''' || bool || 1 || enable "safe save" for Film outputs. A backup of the output is always valid even in the case of a system failure
|}

The film object supports many types of outputs (aka AOVs). The complete list of supported output types:

{| class="wikitable" cellspacing="2"
!Name
!Type
|-
|'''RGB''' || HDR
|-
|'''RGBA''' || HDR
|-
|'''RGB_IMAGEPIPELINE''' || HDR/LDR
|-
|'''RGBA_IMAGEPIPELINE''' || HDR/LDR
|-
|'''ALPHA''' || HDR/LDR
|-
|'''DEPTH''' || HDR
|-
|'''POSITION''' || HDR
|-
|'''GEOMETRY_NORMAL''' || HDR
|-
|'''SHADING_NORMAL''' || HDR
|-
|'''MATERIAL_ID''' || LDR
|-
|'''DIRECT_DIFFUSE''' || HDR
|-
|'''DIRECT_GLOSSY''' || HDR
|-
|'''EMISSION''' || HDR
|-
|'''INDIRECT_DIFFUSE''' || HDR
|-
|'''INDIRECT_GLOSSY''' || HDR
|-
|'''INDIRECT_SPECULAR''' || HDR
|-
|'''MATERIAL_ID_MASK''' || HDR/LDR
|-
|'''DIRECT_SHADOW_MASK''' || HDR/LDR
|-
|'''INDIRECT_SHADOW_MASK''' || HDR/LDR
|-
|'''RADIANCE_GROUP''' || HDR/LDR
|-
|'''UV''' || HDR/LDR
|-
|'''RAYCOUNT''' || HDR/LDR
|-
|'''BY_MATERIAL_ID''' || HDR/LDR
|-
|'''IRRADIANCE''' || HDR
|-
|'''OBJECT_ID''' || LDR
|-
|'''OBJECT_ID_MASK''' || HDR/LDR
|-
|'''BY_OBJECT_ID''' || HDR/LDR
|-
|'''SAMPLECOUNT''' || HDR/LDR
|-
|'''CONVERGENCE''' || HDR/LDR
|-
|'''NOISE''' || HDR/LDR
|-
|'''SERIALIZED_FILM''' || N/A
|-
|'''MATERIAL_ID_COLOR''' || HDR/LDR
|}

Outputs are enabled with the following properties:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.outputs.<index>.type''' || string || || Type of output, e.g. "RGBA" or "ALPHA" (see the list above for the available types)
|-
|'''film.outputs.<index>.filename''' || string || || Filename to use when saving the output. The filename should use ".exr" as extension for HDR outputs and ".png" for LDR outputs (see list above for which output is HDR and which LDR)
|-
|'''film.outputs.<index>.id''' || int || || Specify for the following outputs: '''MATERIAL_ID_MASK''', '''RADIANCE_GROUP''', '''BY_MATERIAL_ID''', '''OBJECT_ID_MASK''', '''BY_OBJECT_ID''' (to choose the object ID, material ID or radiance group ID of the output)
|-
|'''film.outputs.<index>.index''' || int || || Specify for an imagepipeline output (RGB_IMAGEPIPELINE or RGBA_IMAGEPIPELINE) to select the imagepipeline of the output. For example, if you have 3 imagepipelines defined, and you want to specify the output of the third imagepipeline, use 2 for the ".index" property of the output
|}

Note that the Bidir engine does not support all AOVs.
Not supported by Bidir are: EMISSION, DIRECT_DIFFUSE, DIRECT_GLOSSY, INDIRECT_DIFFUSE, INDIRECT_GLOSSY, INDIRECT_SPECULAR, DIRECT_SHADOW_MASK, INDIRECT_SHADOW_MASK, IRRADIANCE, RAYCOUNT.

This is the list of output channel data types and sizes:

{| class="wikitable" cellspacing="2"
!Output type
!Data type
!Size
!Description
|-
|RGB||float||film width x film height x 3||R, G, B
|-
|RGB_IMAGEPIPELINE||float||film width x film height x 3||R, G, B
|-
|RGBA||float||film width x film height x 4||R, G, B, A
|-
|ALPHA||float||film width x film height x 1||Alpha value [0, 1]
|-
|DEPTH||float||film width x film height x 1||Camera distance
|-
|POSITION||float||film width x film height x 3||World X, Y, Z
|-
|GEOMETRY_NORMAL||float||film width x film height x 3||Normal vector X, Y, Z
|-
|SHADING_NORMAL||float||film width x film height x 3||Normal vector X, Y, Z
|-
|DIRECT_DIFFUSE||float||film width x film height x 3||Diffuse R, G, B
|-
|DIRECT_GLOSSY||float||film width x film height x 3||Glossy R, G, B
|-
|EMISSION||float||film width x film height x 3||Emission R, G, B
|-
|INDIRECT_DIFFUSE||float||film width x film height x 3||Indirect diffuse R, G, B
|-
|INDIRECT_GLOSSY||float||film width x film height x 3||Indirect glossy R, G, B
|-
|INDIRECT_SPECULAR||float||film width x film height x 3||Indirect specular R, G, B
|-
|MATERIAL_ID_MASK||float||film width x film height x 1||Material mask [0, 1]
|-
|DIRECT_SHADOW_MASK||float||film width x film height x 1||Shadow mask [0, 1]
|-
|INDIRECT_SHADOW_MASK||float||film width x film height x 1||Shadow mask [0, 1]
|-
|RADIANCE_GROUP||float||film width x film height x 3||R, G, B
|-
|UV||float||film width x film height x 2||Texture coordinates U, V
|-
|RAYCOUNT||float||film width x film height x 1||Ray count
|-
|BY_MATERIAL_ID||float||film width x film height x 3||By material ID
|-
|MATERIAL_ID||uint||film width x film height x 1||Material ID
|-
|IRRADIANCE||float||film width x film height x 3||R, G, B
|-
|OBJECT_ID_MASK||float||film width x film height x 1||Object mask [0, 1]
|-
|BY_OBJECT_ID||float||film width x film height x 3||By object ID
|-
|OBJECT_ID||uint||film width x film height x 1||Object ID
|-
|SAMPLECOUNT||uint||film width x film height x 1||Sample count
|-
|CONVERGENCE||float||film width x film height x 1||The distance of each pixel from the convergence threshold
|-
|NOISE||float||film width x film height x 1||The noise estimated for each pixel
|-
|SERIALIZED_FILM||N/A||N/A||The complete Film serialized in binary format
|-
|MATERIAL_ID_COLOR||float||film width x film height x 3||Material ID converted to colors (with anti-aliasing)
|}

===Film Channels===

Film channels are implicitly enabled by declaring film outputs (even if the output is never used). For instance, declaring a "RGBA" output will automatically enable "RADIANCE_PER_PIXEL_NORMALIZED" (and "RADIANCE_PER_SCREEN_NORMALIZED" for BIDIRCPU) and "ALPHA".
The supported channels are:

{| class="wikitable" cellspacing="2"
!Channel type
!Data type
!Size
!Last element is weight ?
!Note
|-
|CHANNEL_RADIANCE_PER_PIXEL_NORMALIZED||float||film width x film height x 4||Yes||One for each radiance group. Eye paths radiance.
|-
|CHANNEL_RADIANCE_PER_SCREEN_NORMALIZED||float||film width x film height x 3||No||One for each radiance group. Light paths radiance. Used only by LIGHTCPU and BIDIRCPU.
|-
|CHANNEL_ALPHA||float||film width x film height x 2||Yes||
|-
|CHANNEL_RGB_IMAGEPIPELINE||float||film width x film height x 3||No||
|-
|CHANNEL_DEPTH||float||film width x film height x 1||No||
|-
|CHANNEL_POSITION||float||film width x film height x 3||No||
|-
|CHANNEL_GEOMETRY_NORMAL||float||film width x film height x 3||No||
|-
|CHANNEL_SHADING_NORMAL||float||film width x film height x 3||No||
|-
|CHANNEL_MATERIAL_ID||u_int||film width x film height x 1||No||
|-
|CHANNEL_DIRECT_DIFFUSE||float||film width x film height x 4||Yes||
|-
|CHANNEL_DIRECT_GLOSSY||float||film width x film height x 4||Yes||
|-
|CHANNEL_EMISSION||float||film width x film height x 4||Yes||
|-
|CHANNEL_INDIRECT_DIFFUSE||float||film width x film height x 4||Yes||
|-
|CHANNEL_INDIRECT_SPECULAR||float||film width x film height x 4||Yes||
|-
|CHANNEL_MATERIAL_ID_MASK||float||film width x film height x 2||Yes||
|-
|CHANNEL_DIRECT_SHADOW_MASK||float||film width x film height x 2||Yes||
|-
|CHANNEL_INDIRECT_SHADOW_MASK||float||film width x film height x 2||Yes||
|-
|CHANNEL_UV||float||film width x film height x 2||No||
|-
|CHANNEL_RAYCOUNT||float||film width x film height||No||
|-
|CHANNEL_BY_MATERIAL_ID||float||film width x film height x 4||Yes||
|-
|CHANNEL_IRRADIANCE||float||film width x film height x 4||Yes||
|-
|CHANNEL_OBJECT_ID||u_int||film width x film height x 1||No||
|-
|CHANNEL_OBJECT_ID_MASK||float||film width x film height x 2||Yes||
|-
|CHANNEL_BY_OBJECT_ID||float||film width x film height x 4||Yes||
|}

This is the list of channels enabled by each output:

{| class="wikitable" cellspacing="2"
!Output
!Enabled channels
|-
|'''RGB''' || CHANNEL_RADIANCE_PER_PIXEL_NORMALIZED, CHANNEL_RADIANCE_PER_SCREEN_NORMALIZED (only for LIGHTCPU and BIDIRCPU)
|-
|'''RGBA''' || CHANNEL_RADIANCE_PER_PIXEL_NORMALIZED, CHANNEL_RADIANCE_PER_SCREEN_NORMALIZED (only for LIGHTCPU and BIDIRCPU), ALPHA
|-
|'''RGB_IMAGEPIPELINE''' || CHANNEL_RADIANCE_PER_PIXEL_NORMALIZED, CHANNEL_RADIANCE_PER_SCREEN_NORMALIZED (only for LIGHTCPU and BIDIRCPU)
|-
|'''RGBA_IMAGEPIPELINE''' || CHANNEL_RADIANCE_PER_PIXEL_NORMALIZED, CHANNEL_RADIANCE_PER_SCREEN_NORMALIZED (only for LIGHTCPU and BIDIRCPU), ALPHA
|-
|'''ALPHA''' || ALPHA
|-
|'''DEPTH''' || DEPTH
|-
|'''POSITION''' || DEPTH, POSITION
|-
|'''GEOMETRY_NORMAL''' || DEPTH, GEOMETRY_NORMAL
|-
|'''SHADING_NORMAL''' || DEPTH, SHADING_NORMAL
|-
|'''MATERIAL_ID''' || DEPTH, MATERIAL_ID
|-
|'''DIRECT_DIFFUSE''' || DIRECT_DIFFUSE
|-
|'''DIRECT_GLOSSY''' || DIRECT_GLOSSY
|-
|'''EMISSION''' || EMISSION
|-
|'''INDIRECT_DIFFUSE''' || INDIRECT_DIFFUSE
|-
|'''INDIRECT_GLOSSY''' || INDIRECT_GLOSSY
|-
|'''INDIRECT_SPECULAR''' || INDIRECT_SPECULAR
|-
|'''MATERIAL_ID_MASK''' || MATERIAL_ID, MATERIAL_ID_MASK
|-
|'''DIRECT_SHADOW_MASK''' || DIRECT_SHADOW_MASK
|-
|'''INDIRECT_SHADOW_MASK''' || INDIRECT_SHADOW_MASK
|-
|'''RADIANCE_GROUP''' || CHANNEL_RADIANCE_PER_PIXEL_NORMALIZED, CHANNEL_RADIANCE_PER_SCREEN_NORMALIZED (only for LIGHTCPU and BIDIRCPU)
|-
|'''UV''' || DEPTH, UV
|-
|'''RAYCOUNT''' || DEPTH, RAYCOUNT
|-
|'''BY_MATERIAL_ID''' || BY_MATERIAL_ID
|-
|'''IRRADIANCE''' || IRRADIANCE
|-
|'''OBJECT_ID''' || DEPTH, OBJECT_ID
|-
|'''OBJECT_ID_MASK''' || OBJECT_ID, OBJECT_ID_MASK
|-
|'''BY_OBJECT_ID''' || BY_OBJECT_ID
|}

Note: CHANNEL_RGB_IMAGEPIPELINE is always enable and the result of running the image pipeline.

===Image pipeline===

It is possible to [http://www.luxrender.net/forum/viewtopic.php?f=8&p=120169#p120169 define multiple image pipelines at the same time]

====Radiance Group====

Radiance groups are used to get only the contribution of a group of lights in the scene. 
Lights can be grouped by setting their [[#Common_parameters | '''.id''']] property to the same number, on materials this is done with the [[#Light_emission | '''.emission.id''']] property. 

Note that the OpenCL engines only support up to 8 radiance groups (one of them is the default group).

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.radiancescales.<id>.globalscale''' || float|| 1 || global weighting of radiance group
|-
|'''film.imagepipelines.<pipeline #>.radiancescales.<id>.temperature ''' || float || 6500.0 || light temperature
|-
|'''film.imagepipelines.<pipeline #>.radiancescales.<id>.rgbscale''' || vector || 1.0 1.0 1.0 || light color
|-
|'''film.imagepipelines.<pipeline #>.radiancescales.radiancescales.<id>.enabled''' || bool || 1 || enable radiance group
|}

====Image pipeline plug-ins====

=====Type: TONEMAP_LINEAR=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "TONEMAP_LINEAR" || linear tonemapping
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.scale''' || float || 1.0 || tonemapping scale
|}

=====Type: TONEMAP_REINHARD02=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "TONEMAP_REINHARD02" || reinhard tonemapping
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.prescale''' || float || 1.0 || reinhard prescale
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.postscale''' || float || 1.2 || reinhard postscale
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.burn''' || float || 3.75 || reinhard burn
|}

=====Type: TONEMAP_AUTOLINEAR=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "TONEMAP_AUTOLINEAR" || automatic linear tonemapping
|}

=====Type: TONEMAP_LUXLINEAR=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "TONEMAP_LUXLINEAR" || linear tonemapping with real camera settings
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.sensitivity''' || float || 100.0 || ISO sensitivity
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.exposure''' || float || 0.001 || exposure time
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.fstop''' || float || 2.8 || f/aperture
|}

=====Type: NOP=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipeline.<pipeline #>.<plugin #>.type''' || string || "NOP" || no parameters tonemapper
|}

=====Type: GAMMA_CORRECTION=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "TONEMAP_LINEAR" || gamma correction
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.value''' || float || 2.2 || gamma value
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.table.size''' || unsigned int || 4096 || resolution
|}

=====Type: OUTPUT_SWITCHER=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "OUTPUT_SWITCHER" || overwrite output
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.channel''' || string || "DEPTH" || channel whose values are used to overwrite
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.index''' || unsigned int || 0 || index
|}

=====Type: GAUSSIANFILTER_3x3=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "GAUSSIANFILTER_3x3" || gaussian filter
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.weight''' || float || 0.15 || blurring weight
|}

=====Type: CAMERA_RESPONSE_FUNC=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || CAMERA_RESPONSE_FUNC || analog camera film simulation
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.name''' || string || "Advantix_100CD" || film type
|}

=====Type: BACKGROUND_IMG=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || BACKGROUND_IMG || show the background image where alpha < 1 (simple compositing)
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.file''' || string || ... || background image path (e.g scenes/simple-mat/sky.exr)
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.gamma''' || float || 2.2 || background image gamma
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.storage ''' || string || auto || background image storage type
|}
Note: When the size of the background image differs from the film size, it will be stretched to fit the film size.

=====Type: BLOOM=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "BLOOM" || bloom effect
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.radius''' || float || 0.07 || how large the bloom effect is in % of the image size (i.e. 1.0 = all image)
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.weight''' || float || 0.25 || how strong the effect is (i.e. 0.0 = nothing, 1.0 = max. strength)
|}

=====Type: VIGNETTING=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "VIGNETTING" || vignetting effect
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.scale''' || float || 0.4 || vignetting strength
|}

=====Type: COLOR_ABERRATION=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "COLOR_ABERRATION" || color aberration effect
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.amount''' || float || 0.005 || color aberration amount
|}

=====Type: MIST=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "MIST" || aerial perspective effect (fake fog)
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.color''' || spectrum|| [1, 1, 1] || mist color
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.amount''' || float || 0.005 || mist amount
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.startdistance''' || float || 0 || distance from camera until where the mist effect has zero effect
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.enddistance''' || float || 10000 || distance from camera from where the mist effect has maximum effect
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.excludebackground''' || bool || false || Do not apply mist effect on pixels with infinite distance to the camera
|}

=====Type: CONTOUR_LINES=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "CONTOUR_LINES" || contour lines for IRRADIANCE AOV
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.range''' || float|| ? || ?
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.scale''' || float || ? || ?
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.steps''' || int || ? || ?
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.zerogridsize''' || int || ? || ?
|}

=====Type: WHITE_BALANCE =====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "WHITE_BALANCE" || White temperature correction
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.temperature''' || unsigned int|| 6500 || Target image temperature in Kelvin
|-
|}

===Film Subregion===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.subregion''' || vector || ... || <xstart> <xstop> <ystart> <ystop>
|}

===Rendering halt conditions===

By default, a LuxCore rendering will never stop however you can enable one or multiple halt conditions:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''batch.haltnoisethreshold''' || float || -1.0 || enable image convergence test and stops when the error is under the defined value. Use a value like "n / 256.0" where n is the level of error you are looking for. It may be hard to achieve a level of error smaller than 3.0 / 256.0. -1.0 disables the halt condition.
|-
|'''batch.haltnoisethreshold.warmup''' || unsigned int || 64 || number of average samples per pixel before to start the convergence test
|-
|'''batch.haltnoisethreshold.step''' || unsigned int || 64 || number of average samples per pixel between two tests
|-
|'''batch.haltnoisethreshold.filter.enable''' || bool || 1 || if the CONVERGENCE AOV (generated by the batch.haltnoisethreshold) should be filtered or not with a 3x3 box filter
|-
|'''batch.haltnoisethreshold.stoprendering.enable''' || bool || 1 || Set this to 0 (false) if you only want to use the haltnoisethreshold settings for adaptive sampling in an endless render
|-
|'''batch.haltnoisethreshold.index''' || unsigned int || 0 || Film pipeline index used to estimate noise for stopping
|-
|'''batch.halttime''' || float || 0.0 || number of seconds before stopping the rendering
|-
|'''batch.haltspp''' || unsigned int || 0 || number of average samples per pixel before stopping the rendering
|}

===Noise estimation===

Image noise can be estimated and its result can be used to drive the Sobol and Random samplers to focus its sampling in the noisier regions.
Setting any of these properties will enable the noise estimation.
The adaptiveness strength is a Sampler property.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.noiseestimation.warmup''' || unsigned int || 32 || number of average samples per pixel before to start the convergence test
|-
|'''film.noiseestimation.step''' || unsigned int || 32 || number of average samples per pixel between two tests
|-
|'''film.noiseestimation.filter.scale''' || unsigned int || 4 || Box filter scale used to filter the NOISE AOV (generated by the noise estimation). Set to 0 to disable.
|-
|'''film.noiseestimation.index''' || unsigned int || 0 || Film pipeline index used to estimate noise for adaptive sampling
|-
|}

=Scene file=

==Camera==

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.camera.type''' || string || "perspective" || "perspective", "orthographic" or "environment" (360° panorama mapped in latlong format)
|-
|'''scene.camera.lookat.orig''' || point (float float float) || 0.0 10.0 0.0 || camera location
|-
|'''scene.camera.lookat.target''' || point (float float float) || 0.0 0.0 0.0 || camera target
|-
|'''scene.camera.up''' || vector (float float float) || (0.0, 0.0, 1.0) || camera up vector
|-
|'''scene.camera.fieldofview''' || float || 45.0 || field of view
|-
|'''scene.camera.screenwindow''' || vector || 0.0 1.0 0.0 1.0 || <xstart> <xstop> <ystart> <ystop>
|-
|'''scene.camera.shutteropen''' || float || 0.0 || camera shutter open time (used for motion blur)
|-
|'''scene.camera.shutterclose''' || float || 0.0 || camera shutter close time (used for motion blur)
|-
|'''scene.camera.autovolume.enable''' || bool || true || try automatically to discover scene.camera.volume
|-
|'''scene.camera.volume''' || string || || the initial volume rays will travel in
|}

The camera supports motion blur. See [[ LuxCore_SDL_Reference_Manual_v2.0#Object_Motion_Blur | Object Motion Blur ]]. 
(Only difference being that instead of the prefix '''scene.objects.<object name>''', the prefix '''scene.camera''' is used when setting motion properties of the camera)

==Textures==

Check [[LuxCoreRender_Textures|LuxCoreRender Textures]] for a high level description and examples of the textures.

===Mapping===

Some texture (mostly procedural textures) supports 2D or 3D mapping parameters:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.mapping.type''' || string || "uvmapping2d" || type of mapping
|-
|'''scene.textures.<texture name>.mapping.rotation''' || float || 0.0 || UV rotation (in degrees)
|-
|'''scene.textures.<texture name>.mapping.uvscale''' || UV || 1.0 1.0 || UV scale
|-
|'''scene.textures.<texture name>.mapping.uvdelta''' || UV || 0.0 0.0 || UV translation
|}

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.mapping.type''' || string || "uvmapping3d" || type of mapping
|-
|'''scene.textures.<texture name>.mapping.transformation''' || Matrix4x4 || 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0|| transformation matrix
|}

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.mapping.type''' || string || "globalmapping3d" || type of mapping
|-
|'''scene.textures.<texture name>.mapping.transformation''' || Matrix4x4 || 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0|| transformation matrix
|}

===Type: add===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "add" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant
|}

===Type: subtract===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "subtract" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant
|}

===Type: band===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "band" || type of texture
|-
|'''scene.textures.<texture name>.amount''' || texture || 0.5|| texture name or constant
|-
|'''scene.textures.<texture name>.interpolation''' || string || "linear"|| "linear", "cubic" or "none"
|-
|'''scene.textures.<texture name>.offset[0..n]''' || float || 0.0 || multiple offsets in the range of [0.0, 1.0]
|-
|'''scene.textures.<texture name>.value[0..n]''' || spectrum || 1.0 1.0 1.0 || a value for each offset
|}

===Type: blender_blend===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_blend" || type of texture
|-
|'''scene.textures.<texture name>.progressiontype''' || string || "linear" || linear, quadratic, easing, diagonal, spherical, quadratic_spherical, halo or radial
|-
|'''scene.textures.<texture name>.direction''' || string || "horizontal" || horizontal or vertical
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_clouds===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_clouds" || type of texture
|-
|'''scene.textures.<texture name>.noisetype''' || string || "soft_noise" || hard_noise or soft_noise
|-
|'''scene.textures.<texture name>.noisebasis''' || string || "blender_original" || blender_original, original_perlin, improved_perlin, voronoi_f1, voronoi_f2, voronoi_f3, voronoi_f4, voronoi_f2_f1, voronoi_crackle or cell_noise
|-
|'''scene.textures.<texture name>.noisesize''' || float || 0.25 ||
|-
|'''scene.textures.<texture name>.noisedepth''' || int || 2 ||
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_distortednoise===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_distortednoise" || type of texture
|-
|'''scene.textures.<texture name>.noise_distortion''' || string || "blender_original" || blender_original, original_perlin, improved_perlin, voronoi_f1, voronoi_f2, voronoi_f3, voronoi_f4, voronoi_f2_f1, voronoi_crackle or cell_noise
|-
|'''scene.textures.<texture name>.noisebasis''' || string || "blender_original" || blender_original, original_perlin, improved_perlin, voronoi_f1, voronoi_f2, voronoi_f3, voronoi_f4, voronoi_f2_f1, voronoi_crackle or cell_noise
|-
|'''scene.textures.<texture name>.noisesize''' || float || 0.25 ||
|-
|'''scene.textures.<texture name>.distortion''' || float || 1 ||
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_magic===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_magic" || type of texture
|-
|'''scene.textures.<texture name>.noisedepth''' || int || 2 ||
|-
|'''scene.textures.<texture name>.turbulence''' || float || 5.0 ||
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_marble===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_marble" || type of texture
|-
|'''scene.textures.<texture name>.marbletype''' || string || "soft" || soft, sharp or sharper
|-
|'''scene.textures.<texture name>.turbulence''' || float || 5.0 ||
|-
|'''scene.textures.<texture name>.noisebasis''' || string || "blender_original" || blender_original, original_perlin, improved_perlin, voronoi_f1, voronoi_f2, voronoi_f3, voronoi_f4, voronoi_f2_f1, voronoi_crackle or cell_noise
|-
|'''scene.textures.<texture name>.noisebasis2''' || string || "sin" || sin, saw or tri
|-
|'''scene.textures.<texture name>.noisedepth''' || int || 2 ||
|-
|'''scene.textures.<texture name>.noisesize''' || float || 0.25 ||
|-
|'''scene.textures.<texture name>.noisetype''' || string || "soft_noise" || soft_noise or hard_noise
|-
|'''scene.textures.<texture name>.turbulence''' || float || 5.0 ||
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_musgrave===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_musgrave" || type of texture
|-
|'''scene.textures.<texture name>.musgravetype''' || string || "multifractal" || multifractal, ridged_multifractal, hybrid_multifractal, fBM or hetero_terrain
|-
|'''scene.textures.<texture name>.noisebasis''' || string || "blender_original" || blender_original, original_perlin, improved_perlin, voronoi_f1, voronoi_f2, voronoi_f3, voronoi_f4, voronoi_f2_f1, voronoi_crackle or cell_noise
|-
|'''scene.textures.<texture name>.dimension''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.intensity''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.lacunarity''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.offset''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.gain''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.octaves''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.gain''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.noisesize''' || float || 0.25 ||
|-
|'''scene.textures.<texture name>.noisetype''' || string || "soft_noise" || soft_noise or hard_noise
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_noise===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_noise" || type of texture
|-
|'''scene.textures.<texture name>.noisedepth''' || int || 2 ||
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_stucci===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_stucci" || type of texture
|-
|'''scene.textures.<texture name>.stuccitype''' || string || "plastic" || plastic, wall_in or wall_out
|-
|'''scene.textures.<texture name>.noisebasis''' || string || "blender_original" || blender_original, original_perlin, improved_perlin, voronoi_f1, voronoi_f2, voronoi_f3, voronoi_f4, voronoi_f2_f1, voronoi_crackle or cell_noise
|-
|'''scene.textures.<texture name>.noisetype''' || string || "soft_noise" || soft_noise or hard_noise
|-
|'''scene.textures.<texture name>.noisesize''' || float || 0.25 ||
|-
|'''scene.textures.<texture name>.turbulence''' || float || 5.0 ||
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_wood===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_wood" || type of texture
|-
|'''scene.textures.<texture name>.woodtype''' || string || "bands" || bands, rings, bandnoise or ringnoise
|-
|'''scene.textures.<texture name>.noisebasis''' || string || "blender_original" || blender_original, original_perlin, improved_perlin, voronoi_f1, voronoi_f2, voronoi_f3, voronoi_f4, voronoi_f2_f1, voronoi_crackle or cell_noise
|-
|'''scene.textures.<texture name>.noisebasis2''' || string || "sin" || sin, saw or tri
|-
|'''scene.textures.<texture name>.noisetype''' || string || "soft_noise" || soft_noise or hard_noise
|-
|'''scene.textures.<texture name>.noisesize''' || float || 0.25 ||
|-
|'''scene.textures.<texture name>.turbulence''' || float || 5.0 ||
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_voronoi===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_voronoi" || type of texture
|-
|'''scene.textures.<texture name>.intensity''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.distmetric''' || string || "actual_distance" || actual_distance, distance_squared, manhattan, chebychev, minkowski_half, minkowski_four or minkowski
|-
|'''scene.textures.<texture name>.w1''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.w2''' || float || 0.0 ||
|-
|'''scene.textures.<texture name>.w3''' || float || 0.0 ||
|-
|'''scene.textures.<texture name>.w4''' || float || 0.0 ||
|-
|'''scene.textures.<texture name>.noisesize''' || float || 0.25 ||
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: brick===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "brick" || type of texture
|-
|'''scene.textures.<texture name>.bricktex''' || texture || 1.0 1.0 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.mortartex''' || texture || 0.2 0.2 0.2 || texture name or constant
|-
|'''scene.textures.<texture name>.brickmodtex''' || texture || 1.0 1.0 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.brickmodbias''' || float || 0.0 || With bias = -1, only the bricktex is used for the brick color. With bias between -1 and 1, a pseudo-random interpolation between bricktex and brickmodtex is used as brick color. With bias = 1, only the brickmodtex is used for the brick color.
|-
|'''scene.textures.<texture name>.brickbond''' || string || "running" || "flemish", "english", "herringbone", "basket" or "chain link"
|-
|'''scene.textures.<texture name>.brickwidth''' || float || 0.3 || brick width
|-
|'''scene.textures.<texture name>.brickheight''' || float || 0.1 || brick height
|-
|'''scene.textures.<texture name>.brickdepth''' || float || 0.15 || brick depth
|-
|'''scene.textures.<texture name>.mortarsize''' || float || 0.01 ||mortar size
|-
|'''scene.textures.<texture name>.brickrun''' || float || 0.75 || brick run
|}

This texture supports 3D mapping.

===Type: checkerboard3d===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "checkerboard3d" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 0.0 || texture name or constant
|}

This texture supports 3D mapping.

===Type: checkerboard2d===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "checkerboard2d" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 0.0 || texture name or constant
|}

This texture supports 2D mapping.

===Type: constfloat1===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "constfloat1" || type of texture
|-
|'''scene.textures.<texture name>.value''' || float || 1.0 || constant value
|}

===Type: constfloat3===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "constfloat3" || type of texture
|-
|'''scene.textures.<texture name>.value''' || spectrum || (1.0, 1.0, 1.0) || RGB constant value
|}

===Type: densitygrid===

You can use ".data", ".data3" or ".openvdb.file" to define the 3D grid values.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "densitygrid" || type of texture
|-
|'''scene.textures.<texture name>.nx''' || unsigned int || || grid x size
|-
|'''scene.textures.<texture name>.ny''' || unsigned int || || grid y size
|-
|'''scene.textures.<texture name>.nz''' || unsigned int || || grid z size
|-
|'''scene.textures.<texture name>.wrap''' || string || "repeat" || select the type of grid wrapping mode: "repeat", "black", "white", "clamp"
|-
|'''scene.textures.<texture name>.wrap''' || string || "repeat" || select the type of grid wrapping mode: "repeat", "black", "white", "clamp"
|-
|'''scene.textures.<texture name>.storage''' || string || "half" || select the type of memory storage: "auto", "byte", "half", "float"
|-
|'''scene.textures.<texture name>.data''' || float || || vector grid values (total count: nx * ny * nz)
|-
|'''scene.textures.<texture name>.data3''' || float || || vector grid values (total count: nx * ny * nz * 3)
|-
|'''scene.textures.<texture name>.openvdb.file''' || string || || OpenVDB file name
|-
|'''scene.textures.<texture name>.openvdb.grid''' || string || || OpenVDB grid name to read from the file
|}

===Type: dots===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "dots" || type of texture
|-
|'''scene.textures.<texture name>.inside''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.outside''' || texture || 0.0 || texture name or constant
|}

This texture supports 2D mapping.

===Type: fbm===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "fbm" || type of texture
|-
|'''scene.textures.<texture name>.octaves''' || int || 8 || noise octaves
|-
|'''scene.textures.<texture name>.roughness''' || float || 0.5 || noise roughness
|}

This texture supports 3D mapping.

===Type: fresnelapproxk===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "fresnelapproxk" || type of texture
|-
|'''scene.textures.<texture name>.texture''' || texture || (0.5, 0.5, 0.5) || texture name or constant
|}

===Type: fresnelapproxn===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "fresnelapproxn" || type of texture
|-
|'''scene.textures.<texture name>.texture''' || texture || (0.5, 0.5, 0.5) || texture name or constant
|}

===Type: hitpointalpha===

Use the value obtained by interpolating triangle vertices alphas.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "hitpointalpha" || type of texture
|}

===Type: hitpointcolor===

Use the color obtained by interpolating triangle vertices colors.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "hitpointcolor" || type of texture
|}

===Type: hitpointgrey===

Use the value obtained by interpolating triangle vertices colors, mapped to a float value (RGB converted into greyscale).

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "hitpointgrey" || type of texture
|-
|'''scene.textures.<texture name>.channel''' || int || -1 || the index of the RGB channel to use. -1 means the luminance of the RGB value
|}

===Type: hsv===

Hue saturation value manipulation.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "hsv" || type of texture
|-
|'''scene.textures.<texture name>.texture''' || texture || 0 0 0 || input color that will be manipulated
|-
|'''scene.textures.<texture name>.hue''' || texture || 0.5 || shift in hue (range: 0..1)
|-
|'''scene.textures.<texture name>.saturation''' || texture || 1.0 || saturation (range: 0..inf)
|-
|'''scene.textures.<texture name>.value''' || texture || 1.0 || brightness multiplier (range: 0..inf)
|}

===Type: imagemap===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "imagemap" || type of texture
|-
|'''scene.textures.<texture name>.file''' || string || "image.png" || name of the image file
|-
|'''scene.textures.<texture name>.gamma''' || float || 2.2 || gamma correction value used in the image
|-
|'''scene.textures.<texture name>.gain''' || float || 1.0 || image values are multiplied by gain value
|-
|'''scene.textures.<texture name>.storage''' || string || "auto" || select the type of memory storage: "auto", "byte", "half", "float"
|-
|'''scene.textures.<texture name>.wrap''' || string || "repeat" || select the type of image map wrapping mode: "repeat", "black", "white", "clamp"
|-
|'''scene.textures.<texture name>.channel''' || string || "default" || extract from the image only the selected channels: "default", "red", "green", "blue", "alpha", "mean", "colored_mean", "rgb"
|}

===Type: normalmap===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "normalmap" || type of texture
|-
|'''scene.textures.<texture name>.texture''' || texture || 0 0 0 || input. Is treated as an XYZ vector in tangent space.
|-
|'''scene.textures.<texture name>.scale''' || float || 1.0 || multiplier for adjusting normalmap height
|}

===Type: marble===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "marble" || type of texture
|-
|'''scene.textures.<texture name>.octaves''' || int || 8 || noise octaves
|-
|'''scene.textures.<texture name>.roughness''' || float || 0.5 || noise roughness
|-
|'''scene.textures.<texture name>.scale''' || float || 1.0 || marble scale
|-
|'''scene.textures.<texture name>.variation''' || float || 0.2 || marble variation
|}

This texture supports 3D mapping.

===Type: mix===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "mix" || type of texture
|-
|'''scene.textures.<texture name>.amount''' || texture || 0.5 || texture name or constant
|-
|'''scene.textures.<texture name>.texture1''' || texture || 0.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant
|}

===Type: scale===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "scale" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant
|}

===Type: uv===

This procedural texture has no parameters aside from the support of 2D mapping.

===Type: windy===

This procedural texture has no parameters aside from the support of 3D mapping.

===Type: wood===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "wood" || type of texture
|-
|'''scene.textures.<texture name>.woodtype''' || string || "bands" || "bands", "rings", "bandnoise" or "ringnoise"
|-
|'''scene.textures.<texture name>.noisebasis2''' || string || "sin" || "sin", "saw" or "tri"
|-
|'''scene.textures.<texture name>.noisetype''' || string || "soft_noise" || "soft_noise" or "hard_noise"
|-
|'''scene.textures.<texture name>.noisesize''' || float || 0.25 || noise size
|-
|'''scene.textures.<texture name>.turbulence''' || float || 5.0 || noise turbulence
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 || bright
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 || contrast
|}

This texture supports 3D mapping.

===Type: wrinkled===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "wrinkled" || type of texture
|-
|'''scene.textures.<texture name>.octaves''' || int || 8 || noise octaves
|-
|'''scene.textures.<texture name>.roughness''' || float || 0.5 || noise roughness
|}

This texture supports 3D mapping.

===Type: abs===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "abs" || type of texture
|-
|'''scene.textures.<texture name>.texture''' || texture || 1.0 || texture name or constant
|}

===Type: clamp===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "clamp" || type of texture
|-
|'''scene.textures.<texture name>.texture''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.min''' || float || 0.0 || lower boundary of the clamping
|-
|'''scene.textures.<texture name>.max''' || float || 1.0 || upper boundary of the clamping
|}

===Type: divide===

Note: If texture2 (the divisor) is 0, 0 is returned.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "divide" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant (dividend)
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant (divisor)
|}

===Type: remap===

This texture brings the value from the source range into the target range.

Note: The value is clamped into source range before performing the remap operation, and the resulting number is also clamped into the target range.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "remap" || type of texture
|-
|'''scene.textures.<texture name>.value''' || texture || 0.5 || texture name or constant
|-
|'''scene.textures.<texture name>.sourcemin''' || texture || 0.0 || texture name or constant
|-
|'''scene.textures.<texture name>.sourcemax''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.targetmin''' || texture || 0.0 || texture name or constant
|-
|'''scene.textures.<texture name>.targetmax''' || texture || 1.0 || texture name or constant
|}

===Type: objectid===

Raw object ID (range 0 to 0xfffffffe).

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "objectid" || type of texture
|}

===Type: objectidcolor===

Object ID interpreted as color. 
The object ID is a 4 byte unsigned int. To convert to color, the lower three bytes are interpreted as r, g, b values (each range 0 to 255). The highest byte is ignored.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "objectidcolor" || type of texture
|}

===Type: objectidnormalized===

Normalized object ID (range 0 to 1).

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "objectidnormalized" || type of texture
|}

===Type: dotproduct ===

Dot product of the two input vectors.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "dotproduct" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant
|}

===Type: power ===

pow(base, exponent)

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "power" || type of texture
|-
|'''scene.textures.<texture name>.base''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.exponent''' || texture || 1.0 || texture name or constant
|}

===Type: lessthan ===

returns 1 if texture1 < texture2, 0 if otherwise.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "lessthan" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant
|}

===Type: greaterthan ===

returns 1 if texture1 > texture2, 0 if otherwise.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "greaterthan" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant
|}

===Type: shadingnormal ===

Returns the shading normal of the mesh at the hitpoint.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "shadingnormal" || type of texture
|}

===Type: position ===

Returns the position of the hitpoint.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "position" || type of texture
|}

===Type: splitfloat3 ===

Extract a channel from a float3 texture. Can for example be used to get the R, G or B channel of a color texture, or to get the X, Y or Z components of a vector texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "splitfloat3" || type of texture
|-
|'''scene.textures.<texture name>.texture''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.channel''' || int || 0 || the channel to get from the input texture. 0 for first channel, 1 for second, 2 for third channel
|}

===Type: makefloat3 ===

Combine three float textures into one float3 texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "makefloat3" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture3''' || texture || 1.0 || texture name or constant
|}

===Type: blackbody===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blackbody" || type of texture
|-
|'''scene.textures.<texture name>.temperature''' || float || 6500 || emission temperature
|-
|'''scene.textures.<texture name>.normalize''' || bool || false || normalize the output
|}

===Type: irregulardata===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "irregulardata" || type of texture
|-
|'''scene.textures.<texture name>.wavelengths''' || vector || 580.0 620.0 660.0|| wavelenghts
|-
|'''scene.textures.<texture name>.data''' || vector || 0.0 0.000015 0.0|| data (length should match wavelength's length)
|}

===Type: lampspectrum===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "lampspectrum" || type of texture
|-
|'''scene.textures.<texture name>.name''' || string || "Daylight" || lamp light spectrum
|}

===Type: Fresnel Textures===

Textures for loading optical data

====Type: fresnelcolor====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || fresnelcolor || type of texture
|-
|'''scene.textures.<texture name>.kr''' || vector || 0.5 0.0 0.0 || reflection color
|}

====Type: fresnelpreset====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || fresnelpreset || type of texture
|-
|'''scene.textures.<texture name>.name''' || string || aluminium || fresnel preset ("aluminium", "silver", "copper", "gold" or "amorphous carbon")
|}

====Type: fresnelsopra====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || fresnelpreset || type of texture
|-
|'''scene.textures.<texture name>.file''' || string || ... || nk file path (e.g scenes/luxball/Au.nk)
|}

====Type: fresnelluxpop====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || fresnelpreset || type of texture
|-
|'''scene.textures.<texture name>.file''' || string || ... || nk file path (e.g scenes/luxball/Cr.nk)
|}

====Type: distort====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || distort || type of texture
|-
|'''scene.textures.<texture name>.texture''' || texture || 0.0 || texture name or constant; input texture
|-
|'''scene.textures.<texture name>.offset''' || texture || 0.0 || texture name or constant; offset to add to the hitpoint coordinates and UV values before evaluating the input texture
|-
|'''scene.textures.<texture name>.strength''' || float || 1.0 || strength multiplier, is multiplied with the offset
|}

==Volumes==

Check [[LuxCoreRender_Volumes|LuxCoreRender Volumes]] for a high level description and examples of the volumes.

All volumes share these properties

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.volumes.<volume name>.type''' || string || clear || volume type
|-
|'''scene.volumes.<volume name>.priority''' || unsigned int|| 0|| volume priority (when volumes overlap, the one with highest priority overrides the others)
|-
|'''scene.volumes.<volume name>.ior''' || texture|| ... || index of refraction
|-
|'''scene.volumes.<volume name>.absorption''' || texture || ... || absorption texture
|-
|'''scene.volumes.<volume name>.emission ''' || texture || ... || emission
|-
|'''scene.volumes.<volume name>.emission.id ''' || unsigned int || ... || emission ID
|}

===Volume: Clear===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.volumes.<volume name>.type''' || string || clear || volume type
|}

===Volume: Homogeneous===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.volumes.<volume name>.type''' || string || homogeneous|| volume type
|-
|'''scene.volumes.<volume name>.scattering''' || texture || ... || scattering texture
|-
|'''scene.volumes.<volume name>.asymmetry''' || texture || ... || asymmetry texture
|-
|'''scene.volumes.<volume name>.multiscattering''' || bool || ... || multiscattering
|}

===Volume: Heterogeneous===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.volumes.<volume name>.type''' || string || heterogeneous || volume type
|-
|'''scene.volumes.<volume name>.scattering''' || texture || ... || scattering texture
|-
|'''scene.volumes.<volume name>.asymmetry''' || texture || ... || asymmetry texture
|-
|'''scene.volumes.<volume name>.multiscattering''' || bool || ... || multiscattering
|-
|'''scene.volumes.<volume name>.steps.size''' || float || ... || step size
|-
|'''scene.volumes.<volume name>.steps.maxcount''' || unsigned int || ... || step maximum count
|}

==Materials==

Check [[LuxCoreRender_Materials|LuxCoreRender Materials]] for a high level description and examples of the materials.

===Common properties===

Common material properties:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.bumptex''' || texture || || texture to use for the bump mapping
|-
|'''scene.materials.<material name>.normaltex''' || texture || || texture to use for the normal mapping
|-
|'''scene.materials.<material name>.samples''' || int || -1 || number of rays used to sample this material. -1 means use the default global value. This property is an hint and the render engine can ignore this information.
|-
|'''scene.materials.<material name>.visibility.indirect.diffuse.enable''' || bool || true || if this material is visible in indirect rays. This property is an hint and the render engine can ignore this information.
|-
|'''scene.materials.<material name>.visibility.indirect.glossy.enable''' || bool || true || if this material is visible in indirect rays. This property is an hint and the render engine can ignore this information.
|-
|'''scene.materials.<material name>.visibility.indirect.specular.enable''' || bool || true || if this material is visible in indirect rays. This property is an hint and the render engine can ignore this information.
|-
|'''scene.materials.<material name>.bumpsamplingdistance''' || float || 0.001 || set the offset used to sample bump/normal mapping.
|-
|'''scene.materials.<material name>.volume.interior''' || string || vol1 || name of interior volume (for volume rendering)
|-
|'''scene.materials.<material name>.volume.exterior''' || string || vol2 || name of exterior volume (for volume rendering)
|-
|'''scene.materials.<material name>.id''' || int|| ... || material id
|-
|'''scene.materials.<material name>.transparency''' || texture || 1.0 || transparency of the material. 1 for opaque, 0 for fully transparent
|-
|'''scene.materials.<material name>.shadowcatcher.enable''' || bool || false || If true, the material will be transparent where hit by direct light and opaque otherwise (alpha transparency). Used for compositing.
|}

====Normal maps====
Normal maps are set first as a texture type and then assigned to the material. For example:

<blockquote><pre>
scene.textures.normmap.type = imagemap
scene.textures.normmap.file = scenes/bump/normal.png
scene.textures.normmap.gamma = 1

scene.materials.mat_white.type = matte
scene.materials.mat_white.kd = 0.8 0.8 0.8
scene.materials.mat_white.normaltex = normmap
</pre></blockquote>

====Light emission====

All materials can emit light:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.emission''' || texture || 0.0 0.0 0.0 || color of the emitted light
|-
|'''scene.materials.<material name>.emission.gain''' || spectrum || 1.0 1.0 1.0 || multiplier for lamp brigthness
|-
|'''scene.materials.<material name>.emission.power''' || float || 0.0 || lamp output power in watts. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.materials.<material name>.emission.efficency''' || float || 0.0 || luminous efficacy in lumens/watt. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.materials.<material name>.emission.mapfile''' || string || || the name of an optional image map that can be used to scale the emitted light
|-
|'''scene.materials.<material name>.emission.gamma''' || float || 2.2 || gamma value of the image map defined with .mapfile property
|-
|'''scene.materials.<material name>.emission.iesfile''' || string || || a [http://en.wikipedia.org/wiki/Illuminating_Engineering_Society_of_North_America IES] profile of emitted light
|-
|'''scene.materials.<material name>.emission.iesblob''' || blob || || a [http://en.wikipedia.org/wiki/Illuminating_Engineering_Society_of_North_America IES] profile of emitted light embedded in a blob
|-
|'''scene.materials.<material name>.emission.flipz''' || bool || false || flip the IES profile along the Z axis
|-
|'''scene.materials.<material name>.emission.samples''' || int || -1 || the number of shadow ray to trace to compute direct light from this material. This property is an hint and the render engine can ignore this information. -1 means use the default global value.
|-
|'''scene.materials.<material name>.emission.map.width''' || unsigned int || 0 || scale the image or IES map to the specified width. 0 means use the original size
|-
|'''scene.materials.<material name>.emission.map.height''' || unsigned int || 0 || scale the image or IES map to the specified height. 0 means use the original size
|-
|'''scene.materials.<material name>.emission.id''' || int || 0 || the radiance group the light emitted from this material is assigned to.
|-
|'''scene.materials.<material name>.emission.theta''' || float || 90.0 || How directional the light is emitted, set as the half-angle of the light source. Default is 90°. Smaller values mean that more light is emitted in the direction of the face normals and less to the sides.
|-
|'''scene.materials.<material name>.emission.importance''' || float || 1.0 || A hint how often to sample this light source compared to other lights
|}

===Type: archglass===

This material should be used to replace glass material of windows when rendering architectural interiors. It allows direct light to pass trough.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "archglass" || type of material
|-
|'''scene.materials.<material name>.kr''' || texture || 1.0 1.0 1.0 || texture or constant reflected color of the material
|-
|'''scene.materials.<material name>.kt''' || texture || 1.0 1.0 1.0 || texture or constant transmitted color of the material
|-
|'''scene.materials.<material name>.interiorior''' || texture || 1.5 || inside texture or constant index of refraction (only for volume-less rendering)
|-
|'''scene.materials.<material name>.exteriorior''' || texture || 1.0 || outside texture or constant index of refraction (only for volume-less rendering)
|-
|'''scene.materials.<material name>.filmthickness''' || texture || none || thickness (in nanometers) of a [https://en.wikipedia.org/wiki/Thin-film_interference thin-film coating] on the surface. This property is optional, if it is not defined, the coating is disabled.
|-
|'''scene.materials.<material name>.filmior''' || texture || none || Refractive index of the thin-film coating. This property is optional, if it is not defined, the coating is disabled.
|}

===Type: carpaint===

Car Paint is an advanced glossy material, simulating a diffuse surface with mutliple reflective coatings.

The available presets for the carpaint material are:

*"ford f8"
*"polaris silber"
*"opel titan"
*"bmw339"
*"2k acrylack"
*"white"
*"blue"
*"blue matte"

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "carpaint" || type of material
|-
|'''scene.materials.<material name>.preset''' || string || "ford f8" || one of the avilable presets
|-
|'''scene.materials.<material name>.ka''' || texture || 0.0 0.0 0.0 || absorption color
|-
|'''scene.materials.<material name>.d''' || texture || 0.0 || absorption depth
|-
|'''scene.materials.<material name>.kd''' || texture || 0.0 0.0 0.0 || diffuse color
|-
|'''scene.materials.<material name>.ks1''' || texture || 0.0 0.0 0.0 || specular color - layer 1
|-
|'''scene.materials.<material name>.ks2''' || texture || 0.0 0.0 0.0 || specular color - layer 2
|-
|'''scene.materials.<material name>.ks3''' || texture || 0.0 0.0 0.0 || specular color - layer 3
|-
|'''scene.materials.<material name>.r1''' || texture || 0.0 0.0 0.0 || fresnel effect strength - layer 1
|-
|'''scene.materials.<material name>.r2''' || texture || 0.0 0.0 0.0 || fresnel effect strength - layer 2
|-
|'''scene.materials.<material name>.r3''' || texture || 0.0 0.0 0.0 || fresnel effect strength - layer 3
|-
|'''scene.materials.<material name>.m1''' || texture || 0.0 0.0 0.0 || roughness - layer 1
|-
|'''scene.materials.<material name>.m2''' || texture || 0.0 0.0 0.0 || roughness - layer 2
|-
|'''scene.materials.<material name>.m3''' || texture || 0.0 0.0 0.0 || roughness - layer 3
|}

===Type: cloth===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "cloth" || type of material
|-
|'''scene.materials.<material name>.preset''' || string || "denim" || denim, silk_charmeuse, silk_shantung, cotton_twill, wool_garbardine or polyester_lining_cloth
|-
|'''scene.materials.<material name>.weft_kd''' || texture || 0.5 0.5 0.5 || coefficient of diffuse reflection in one weave direction
|-
|'''scene.materials.<material name>.weft_ks''' || texture || 0.5 0.5 0.5 || coefficient of specular reflection in one weave direction
|-
|'''scene.materials.<material name>.warp_kd''' || texture || 0.5 0.5 0.5 || coefficient of diffuse reflection in the opposite weave direction
|-
|'''scene.materials.<material name>.warp_ks''' || texture || 0.5 0.5 0.5 || coefficient of specular reflection in the opposite weave direction
|-
|'''scene.materials.<material name>.repeat_u''' || float || 100.0 || thread count in the u direction
|-
|'''scene.materials.<material name>.repeat_v''' || float || 100.0 || thread count in the v direction
|}

===Type: disney===

For more details, refer to the [https://disney-animation.s3.amazonaws.com/library/s2012_pbs_disney_brdf_notes_v2.pdf original paper].

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "disney" || type of material
|-
|'''scene.materials.<material name>.basecolor''' || texture || 0.5 0.5 0.5 || Base color
|-
|'''scene.materials.<material name>.subsurface''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.roughness''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.metallic''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.specular''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.speculartint''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.clearcoat''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.clearcoatgloss''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.anisotropic''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.sheen''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.sheentint''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.filmamount''' || texture || none || Linear interpolation between no film (0) and full film effect (1) for artistic control. This property is optional, if it is not defined, the coating is disabled.
|-
|'''scene.materials.<material name>.filmthickness''' || texture || none || thickness (in nanometers) of a [https://en.wikipedia.org/wiki/Thin-film_interference thin-film coating] on the surface. This property is optional, if it is not defined, the coating is disabled.
|-
|'''scene.materials.<material name>.filmior''' || texture || none || Refractive index of the thin-film coating. This property is optional, if it is not defined, the coating is disabled.
|}

===Type: glass===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "glass" || type of material
|-
|'''scene.materials.<material name>.kr''' || texture || 1.0 || texture or constant reflected color of the material
|-
|'''scene.materials.<material name>.kt''' || texture || 1.0 || texture or constant transmitted color of the material
|-
|'''scene.materials.<material name>.interiorior''' || texture || 1.5 || inside texture or constant index of refraction (only for volume-less rendering)
|-
|'''scene.materials.<material name>.exteriorior''' || texture || 1.0 || outside texture or constant index of refraction (only for volume-less rendering)
|-
|'''scene.materials.<material name>.cauchyc''' || texture || 0.0 || if defined and > 0.0, enable dispersion. The value is the C term of the [https://en.wikipedia.org/wiki/Cauchy%27s_equation Cauchy's equation]
|-
|'''scene.materials.<material name>.filmthickness''' || texture || none || thickness (in nanometers) of a [https://en.wikipedia.org/wiki/Thin-film_interference thin-film coating] on the surface. This property is optional, if it is not defined, the coating is disabled.
|-
|'''scene.materials.<material name>.filmior''' || texture || none || Refractive index of the thin-film coating. This property is optional, if it is not defined, the coating is disabled.
|}

===Type: glossy2===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "glossy2" || type of material
|-
|'''scene.materials.<material name>.kd''' || texture || 0.5 0.5 0.5 || texture or constant diffuse color of the material
|-
|'''scene.materials.<material name>.ks''' || texture || 0.5 0.5 0.5 || texture or constant specular color of the material
|-
|'''scene.materials.<material name>.uroughness''' || texture || 0.1 || texture or constant roughness value along u coordinate of the material
|-
|'''scene.materials.<material name>.vroughness''' || texture || 0.1 || texture or constant roughness value along v coordinate of the material
|-
|'''scene.materials.<material name>.ka''' || texture || 0.0 0.0 0.0 || texture or constant value of coefficient of absorption of the coating layer
|-
|'''scene.materials.<material name>.d''' || texture || 0.0 || texture or constant value of the depth (thickness) of the coating layer for absorption effects. (0 = disables)
|-
|'''scene.materials.<material name>.index''' || texture || 0.0 0.0 0.0 || IOR of the coating. IOR overrides color Ks if both are specified
|-
|'''scene.materials.<material name>.multibounce''' || bool || false || simulation of asperity (velvet-like reflection) on the glossy surface
|}

===Type: glossytranslucent===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "glossytranslucent" || type of material
|-
|'''scene.materials.<material name>.kd''' || texture || 0.5 0.5 0.5 || texture or constant diffuse color of the material
|-
|'''scene.materials.<material name>.kt''' || texture || 0.5 0.5 0.5 || texture or constant transmission color of the material
|-
|'''scene.materials.<material name>.ks''' || texture || 0.5 0.5 0.5 || texture or constant specular color of the material
|-
|'''scene.materials.<material name>.ks_bf''' || texture || 0.5 0.5 0.5 || texture or constant backface specular color of the material
|-
|'''scene.materials.<material name>.uroughness''' || texture || 0.1 || texture or constant roughness value along u coordinate of the material
|-
|'''scene.materials.<material name>.uroughness_bf''' || texture || 0.1 || texture or constant backface roughness value along u coordinate of the material
|-
|'''scene.materials.<material name>.vroughness''' || texture || 0.1 || texture or constant roughness value along v coordinate of the material
|-
|'''scene.materials.<material name>.vroughness_bf''' || texture || 0.1 || texture or constant backface roughness value along v coordinate of the material
|-
|'''scene.materials.<material name>.ka''' || texture || 0.0 0.0 0.0 || texture or constant value of coefficient of absorption of the coating layer
|-
|'''scene.materials.<material name>.ka_bf''' || texture || 0.0 0.0 0.0 || texture or constant value of backface coefficient of absorption of the coating layer
|-
|'''scene.materials.<material name>.d''' || texture || 0.0 || texture or constant value of the depth (thickness) of the coating layer for absorption effects. (0 = disables)
|-
|'''scene.materials.<material name>.d_bf''' || texture || 0.0 || texture or constant value of the backface depth (thickness) of the coating layer for absorption effects. (0 = disables)
|-
|'''scene.materials.<material name>.index''' || texture || 0.0 0.0 0.0 || IOR of the coating. IOR overrides color Ks if both are specified
|-
|'''scene.materials.<material name>.index_bf''' || texture || 0.0 0.0 0.0 || IOR of the backface coating. IOR overrides color Ks if both are specified
|-
|'''scene.materials.<material name>.multibounce''' || bool || false || simulation of asperity (velvet-like reflection) on the glossy surface
|-
|'''scene.materials.<material name>.multibounce_bf''' || bool || false || backface simulation of asperity (velvet-like reflection) on the glossy surface
|}

===Type: glossycoating===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "glossycoating" || type of material
|-
|'''scene.materials.<material name>.base''' || string || || name of base material, the coating layer is added on top of this material
|-
|'''scene.materials.<material name>.ks''' || texture || 0.5 0.5 0.5 || texture or constant specular color of the material
|-
|'''scene.materials.<material name>.uroughness''' || texture || 0.1 || texture or constant roughness value along u coordinate of the material
|-
|'''scene.materials.<material name>.vroughness''' || texture || 0.1 || texture or constant roughness value along v coordinate of the material
|-
|'''scene.materials.<material name>.ka''' || texture || 0.0 0.0 0.0 || texture or constant value of coefficient of absorption of the coating layer
|-
|'''scene.materials.<material name>.d''' || texture || 0.0 || texture or constant value of the depth (thickness) of the coating layer for absorption effects. (0 = disables)
|-
|'''scene.materials.<material name>.index''' || texture || 0.0 0.0 0.0 || IOR of the coating. IOR overrides color Ks if both are specified
|-
|'''scene.materials.<material name>.multibounce''' || bool || false || simulation of asperity (velvet-like reflection) on the glossy surface
|}

===Type: matte===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "matte" || type of material
|-
|'''scene.materials.<material name>.kd''' || texture || 0.75 0.75 0.75 || texture or constant color of the matte material
|}

===Type: mattetranslucent===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "mattetranslucent" || type of material
|-
|'''scene.materials.<material name>.kr''' || texture || 0.5 0.5 0.5 || texture or constant reflected color of the material
|-
|'''scene.materials.<material name>.kt''' || texture || 0.5 0.5 0.5 || texture or constant transmitted color of the material
|}

===Type: metal2===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "metal2" || type of material
|-
|'''scene.materials.<material name>.fresnel''' || fresnel texture || ... || [[#Type:_Fresnel_Textures | fresnel texture]]
|-
|'''scene.materials.<material name>.uroughness''' || texture || 0.1 || texture or constant roughness value along u coordinate of the material
|-
|'''scene.materials.<material name>.vroughness''' || texture || 0.1 || texture or constant roughness value along v coordinate of the material
|-
|'''scene.materials.<material name>.preset''' || string || "aluminium" || (DEPRECATED) "aluminium", "silver", "copper", "gold" or "amorphous carbon"
|-
|'''scene.materials.<material name>.n''' || texture || 0.5 0.5 0.5 || (DEPRECATED) texture or constant value. It can be used to directly define a fresnelapproxn texture on overwrite the .preset property
|-
|'''scene.materials.<material name>.k''' || texture || 0.5 0.5 0.5 || (DEPRECATED) texture or constant value. It can be used to directly define a fresnelapproxk texture on overwrite the .preset property
|}

===Type: mirror===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "mirror" || type of material
|-
|'''scene.materials.<material name>.kr''' || texture || 1.0 1.0 1.0 || texture or constant reflected color of the material
|}

===Type: mix===

This material can be used to mix 2 other materials.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "mix" || type of material
|-
|'''scene.materials.<material name>.material1''' || string || mat1 || name of another material
|-
|'''scene.materials.<material name>.material2''' || string || mat2 || name of another material
|-
|'''scene.materials.<material name>.amount''' || texture || 0.5 || texture or constant value used to mix the materials
|}

===Type: null===

This is empty, not visible material. It can be combined by using mix material with others. It is often used in combination with the alpha channel of an image map to render leafs, etc.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "null" || type of material
|}

===Type: roughglass===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "roughglass" || type of material
|-
|'''scene.materials.<material name>.kr''' || texture || 1.0 1.0 1.0 || texture or constant reflected color of the material
|-
|'''scene.materials.<material name>.kt''' || texture || 1.0 1.0 1.0 || texture or constant transmitted color of the material
|-
|'''scene.materials.<material name>.interiorior''' || texture || 1.5 || inside texture or constant index of refraction
|-
|'''scene.materials.<material name>.exteriorior''' || texture || 1.0 || outside texture or constant index of refraction
|-
|'''scene.materials.<material name>.uroughness''' || texture || 0.1 || texture or constant roughness value along u coordinate of the material
|-
|'''scene.materials.<material name>.vroughness''' || texture || 0.1 || texture or constant roughness value along v coordinate of the material
|-
|'''scene.materials.<material name>.filmthickness''' || texture || none || thickness (in nanometers) of a [https://en.wikipedia.org/wiki/Thin-film_interference thin-film coating] on the surface. This property is optional, if it is not defined, the coating is disabled.
|-
|'''scene.materials.<material name>.filmior''' || texture || none || Refractive index of the thin-film coating. This property is optional, if it is not defined, the coating is disabled.
|}

===Type: roughmatte===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "roughmatte" || type of material
|-
|'''scene.materials.<material name>.kd''' || texture || 0.75 0.75 0.75 || texture or constant color of the roughmatte material
|-
|'''scene.materials.<material name>.sigma''' || texture || 0.0 || the sigma parameter in the Oren-Nayer shader in degrees. Zero for pure Lambertian reflection
|}

===Type: velvet===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "velvet" || type of material
|-
|'''scene.materials.<material name>.kd''' || texture || 0.5 0.5 0.5 || color of the material's fuzz
|-
|'''scene.materials.<material name>.p1''' || texture || -2.0 || polynomial that influences the fuzz
|-
|'''scene.materials.<material name>.p2''' || texture || 20.0 || polynomial that influences the fuzz
|-
|'''scene.materials.<material name>.p3''' || texture || 2.0 || polynomial that influences the fuzz
|-
|'''scene.materials.<material name>.thickness''' || texture || 0.1 || height of the fuzz
|}

==Objects==

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.objects.<object name>.material''' || string || || type of object material
|-
|'''scene.objects.<object name>.shape''' || string || || name of [[#Shapes | shape]] with the triangle mesh description.Memory required to store the triangle mesh information is allocated only once if 2 or more different objects share the same shape, use .transformation property and true instancing is enabled.
|-
|'''scene.objects.<object name>.ply''' || string || || '''(Deprecated, use .shape instead)''' name of [http://en.wikipedia.org/wiki/PLY_(file_format) PLY] file with the triangle mesh description. Memory required to store the triangle mesh information is allocated only once if 2 or more different objects share the same file, use .transformation property and true instancing is enabled.
|-
|'''scene.objects.<object name>.transformation''' || matrix 4x4 || 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 || transformation matrix
|-
|'''scene.objects.<object name>.vertices''' || float || || This is an alternative syntax to using PLY file. It is an in-lined definition of the triangle mesh. It is a list of float values defining the vertices of the mesh (i.e. 3 coordinates for each vertex).
|-
|'''scene.objects.<object name>.faces''' || unsigned int || || This is an alternative syntax to using PLY file. It is an in-lined definition of the triangle mesh. It is a list of unsigned int values defining the triangles of the mesh (i.e. 3 index of vertices for each triangle).
|-
|'''scene.objects.<object name>.id''' || unsigned int || || object ID
|-
|'''scene.objects.<object name>.camerainvisible''' || bool || false || toggle visibility for camera rays. If set to true, the object will not show up in camera rays, but it will still be visible in reflections, refractions, shadows, indirect light etc.
|}

===Object Motion Blur===

LuxCore supports transformation motion blur for objects.
Motion blur is enabled if an object has a motion system defined as described below.

A motion system consists of steps (at least 2). Each step has a time (in seconds) and a transformation matrix of the object at this point in time.
Step indices start at 0. The times have to be monotonic (each greater than the last).

Note that the embree accelerator only supports a maximum of 129 time steps.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.objects.<object name>.motion.<step>.time''' || float || || time (in seconds) of the step
|-
|'''scene.objects.<object name>.motion.<step>.transformation''' || matrix 4x4 || 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 || transformation matrix of the object at the given step
|-
|}

==Shapes==

===Type: mesh===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.shapes.<shape name>.type''' || string || "mesh" || mesh shape
|-
|'''scene.shapes.<shape name>.ply''' || string || ... || mesh path (e.g ''scenes/luxball/luxball-shell.ply'')
|-
|'''scene.shapes.<shape name>.appliedtransformation''' || Matrix4x4 || 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0|| transformation matrix applied to the mesh vertices. Used to define the local object reference space.
|}

===Type: inlinedmesh===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.shapes.<shape name>.type''' || string || "inlinedmesh" || inlinedmesh shape
|-
|'''scene.shapes.<shape name>.vertices''' || vector || ... || inlinedmesh vertices (e.g 0.0 0.0 0.0 1.0 0.0 0.0 0.0 1.0 0.0)
|-
|'''scene.shapes.<shape name>.faces''' || vector || ... || inlinedmesh faces (e.g 0 1 2)
|-
|'''scene.shapes.<shape name>.appliedtransformation''' || Matrix4x4 || 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0|| transformation matrix applied to the mesh vertices. Used to define the local object reference space.
|}

===Type: pointiness===

Contains surface curvature information in vertex alpha channel. 
You can access this information in materials via a hitpointalpha texture. 
The values range from -1 to 1 (float). 
Values from -1 to 0 are concave, while values from 0 to 1 are convex.

[[ Shape:_Pointiness | Examples ]]

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.shapes.<shape name>.type''' || string || "pointiness" || pointiness shape
|-
|'''scene.shapes.<shape name>.source''' || string || ... || pointiness source (a mesh shape)
|}

===Type: strands===

Can be used for hair, fur, grass etc. 
Note that you need to define the camera before defining any strands shapes, because the tesselation process is viewpoint-dependent.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.shapes.<shape name>.type''' || string || "strands" || strands shape
|-
|'''scene.shapes.<shape name>.file''' || string || ... || strands file (''scenes/strands/straight.hair'')
|}

====Strands tessellation methods====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.shapes.<shape name>.tessellation.type''' || string || "ribbon" || ribbon tessellation
|-
|'''scene.shapes.<shape name>.tessellation.usecameraposition''' || bool || 1 || use camera position
|}

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.shapes.<shape name>.tessellation.type''' || string || "ribbonadaptive" || ribbon adaptive tessellation method
|-
|'''scene.shapes.<shape name>.tessellation.adaptative.maxdepth''' || unsigned int || 12 || max tessellation depth
|-
|'''scene.shapes.<shape name>.tessellation.adaptative.error ''' || float || 0.0075 || max tessellation error
|}

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.shapes.<shape name>.tessellation.type''' || string || "solid" || solid tessellation method
|-
|'''scene.shapes.<shape name>.tessellation.solid.sidecount ''' || unsigned int || 12 || tessellation's side count
|}

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.shapes.<shape name>.tessellation.type''' || string || "solidadaptive" || solidadaptive tessellation method
|-
|'''scene.shapes.<shape name>.tessellation.solidadaptive.sidecount ''' || unsigned int || 8 || tessellation's side count
|-
|'''scene.shapes.<shape name>.tessellation.solidadaptive.maxdepth''' || unsigned int || 16 || tessellation's max depth
|-
|'''scene.shapes.<shape name>.tessellation.solidadaptive.error''' || float || 0.05 || tessellation's max error
|}

===Type: group===

Todo.

===Type: displacement===

Todo.

===Type: subdiv===

Todo.

===Type: harlequin===

Todo.

===Type: simplify===

Todo.

===Type: islandaov===

Todo.

===Type: randomtriangleaov===

Todo.

==Light sources==

Check [[Lighting|LuxCoreRender Lighting]] for an high level description and example of the light sources.

===Common parameters===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.gain''' || spectrum || 1.0 1.0 1.0 || intensity of the light
|-
|'''scene.lights.<light name>.transformation''' || matrix 4x4 || 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 || transformation matrix
|-
|'''scene.lights.<light name>.samples''' || int || -1 || the number of shadow ray to trace to compute direct light for this light source. This property is an hint and the render engine can ignore this information. -1 means use the default global value.
|-
|'''scene.lights.<light name>.id''' || int || 0 || the radiance group the light emitted from this material is assigned to.

|-
|'''scene.lights.<light name>.importance''' || float || 1.0 || A hint how often to sample this light compared to other lights
|}

===Type: sun===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "sun" || type of light
|-
|'''scene.lights.<light name>.turbidity''' || float || 2.2 || turbidity can go from 1.0 to 30+. 2-6 are most useful for clear days
|-
|'''scene.lights.<light name>.relsize''' || float || 1.0 || relative size to the sun
|-
|'''scene.lights.<light name>.dir''' || vector || 0.0 0.0 1.0 || direction vector of the sun
|-
|'''scene.lights.<light name>.visibility.indirect.diffuse.enable''' || bool || true || if the light source is visible by indirect rays on diffuse surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.visibility.indirect.glossy.enable''' || bool || true || if the light source is visible by indirect rays on glossy surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.visibility.indirect.specular.enable''' || bool || true || if the light source is visible by indirect rays on specular surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|}

===Type: sky2===

Hosek-Wilkie sky model.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "sky2" || type of light
|-
|'''scene.lights.<light name>.turbidity''' || float || 2.2 || turbidity can go from 1.0 to 30+. 2-6 are most useful for clear days
|-
|'''scene.lights.<light name>.dir''' || vector || 0.0 0.0 1.0 || direction vector of the sun
|-
|'''scene.lights.<light name>.gain''' || vector || ... || gain
|-
|'''scene.lights.<light name>.groundalbedo''' || vector || 0.5 0.5 0.5 || ground albedo
|-
|'''scene.lights.<light name>.visibility.indirect.diffuse.enable''' || bool || true || if the light source is visible by indirect rays on diffuse surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.visibility.indirect.glossy.enable''' || bool || true || if the light source is visible by indirect rays on glossy surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.visibility.indirect.specular.enable''' || bool || true || if the light source is visible by indirect rays on specular surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.ground.enable''' || bool || 1 || enable ground color
|-
|'''scene.lights.<light name>.ground.color''' || vector|| ... || RGB ground color
|}

===Type: infinite===

Spherical lightsource surrounding the scene at infinite distance. 
Used for image based lighting (IBL) and HDR environment lighting if the file is a high dynamic range image.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "infinite" || type of light
|-
|'''scene.lights.<light name>.file''' || string || "image.png" || filename of the environment map
|-
|'''scene.lights.<light name>.gamma''' || float || 2.2 || gamma correction used by the image map
|-
|'''scene.lights.<light name>.storage''' || string || "auto" || environment map storage type ("auto", "byte", "half" or "float")
|-
|'''scene.lights.<light name>.visibility.indirect.diffuse.enable''' || bool || true || if the light source is visible by indirect rays on diffuse surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.visibility.indirect.glossy.enable''' || bool || true || if the light source is visible by indirect rays on glossy surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.visibility.indirect.specular.enable''' || bool || true || if the light source is visible by indirect rays on specular surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.sampleupperhemisphereonly''' || bool || false || an option set to black the lower hemisphere. Mostly useful for shadow catchers.
|}

===Type: point===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "point" || type of light
|-
|'''scene.lights.<light name>.position''' || point || 0.0 0.0 0.0 || position
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.power''' || float || 0.0 || lamp output power in watts. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.efficency''' || float || 0.0 || luminous efficacy in lumens/watt. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|}

===Type: mappoint===

Point light with support for IES files or image maps controlling the strength of light emitted.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "mappoint" || type of light
|-
|'''scene.lights.<light name>.position''' || point || 0.0 0.0 0.0 || position
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.power''' || float || 0.0 || lamp output power in watts. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.efficency''' || float || 0.0 || luminous efficacy in lumens/watt. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.mapfile''' || string || || the name of an optional image map that can be used to scale the emitted light
|-
|'''scene.lights.<light name>.gamma''' || float || 2.2 || gamma value of the image map defined with .mapfile property
|-
|'''scene.lights.<light name>.iesfile''' || string || || a [http://en.wikipedia.org/wiki/Illuminating_Engineering_Society_of_North_America IES] profile of emitted light and the render engine can ignore this information. -1 means use the default global value.
|-
|'''scene.lights.<light name>.iesblob''' || string || || a [http://en.wikipedia.org/wiki/Illuminating_Engineering_Society_of_North_America IES] profile of emitted light embedded in a blob
|-
|'''scene.lights.<light name>.flipz''' || bool || false || flip the IES profile along the Z axis
|-
|'''scene.lights.<light name>.map.width''' || unsigned int || 0 || scale the image or IES map to the specified width. 0 means use the original size
|-
|'''scene.lights.<light name>.map.height''' || unsigned int || 0 || scale the image or IES map to the specified height. 0 means use the original size
|}

===Type: sphere===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "sphere" || type of light
|-
|'''scene.lights.<light name>.position''' || point || 0.0 0.0 0.0 || position
|-
|'''scene.lights.<light name>.radius''' || float || 1.0 || position
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.power''' || float || 0.0 || lamp output power in watts. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.efficency''' || float || 0.0 || luminous efficacy in lumens/watt. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|}

===Type: mapsphere===

Sphere light with support for IES files or image maps controlling the strength of light emitted.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "mapsphere" || type of light
|-
|'''scene.lights.<light name>.position''' || point || 0.0 0.0 0.0 || position
|-
|'''scene.lights.<light name>.radius''' || float || 1.0 || position
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.power''' || float || 0.0 || lamp output power in watts. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.efficency''' || float || 0.0 || luminous efficacy in lumens/watt. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.mapfile''' || string || || the name of an optional image map that can be used to scale the emitted light
|-
|'''scene.lights.<light name>.gamma''' || float || 2.2 || gamma value of the image map defined with .mapfile property
|-
|'''scene.lights.<light name>.iesfile''' || string || || a [http://en.wikipedia.org/wiki/Illuminating_Engineering_Society_of_North_America IES] profile of emitted light and the render engine can ignore this information. -1 means use the default global value.
|-
|'''scene.lights.<light name>.iesblob''' || string || || a [http://en.wikipedia.org/wiki/Illuminating_Engineering_Society_of_North_America IES] profile of emitted light embedded in a blob
|-
|'''scene.lights.<light name>.flipz''' || bool || false || flip the IES profile along the Z axis
|-
|'''scene.lights.<light name>.map.width''' || unsigned int || 0 || scale the image or IES map to the specified width. 0 means use the original size
|-
|'''scene.lights.<light name>.map.height''' || unsigned int || 0 || scale the image or IES map to the specified height. 0 means use the original size
|}

===Type: spot===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "spot" || type of light
|-
|'''scene.lights.<light name>.position''' || point || 0.0 0.0 0.0 || position
|-
|'''scene.lights.<light name>.target''' || point || 0.0 0.0 1.0 || target
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.power''' || float || 0.0 || lamp output power in watts. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.efficency''' || float || 0.0 || luminous efficacy in lumens/watt. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.coneangle''' || float || 30.0 || angle in degrees of the spotlight cone
|-
|'''scene.lights.<light name>.conedeltaangle''' || float || 5.0 || angle at which the spotlight intensity starts to fade from the edge
|}

===Type: projection===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "projection" || type of light
|-
|'''scene.lights.<light name>.position''' || point || 0.0 0.0 0.0 || position
|-
|'''scene.lights.<light name>.target''' || point || 0.0 0.0 1.0 || target
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.power''' || float || 0.0 || lamp output power in watts. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.efficency''' || float || 0.0 || luminous efficacy in lumens/watt. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.fov''' || float || 45.0 || field of view in terms of angular spread along the shorter image axis
|-
|'''scene.lights.<light name>.mapfile''' || string || || filename of the image to project. If not specified, a constat light color will be used.
|-
|'''scene.lights.<light name>.gamma''' || float || 2.2 || gamma value of the image map defined with .mapfile property
|}

===Type: constantinfinite===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "constantinfinite" || type of light
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.visibility.indirect.diffuse.enable''' || bool || true || if the light source is visible by indirect rays on diffuse surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.visibility.indirect.glossy.enable''' || bool || true || if the light source is visible by indirect rays on glossy surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.visibility.indirect.specular.enable''' || bool || true || if the light source is visible by indirect rays on specular surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|}

===Type: sharpdistant===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "sharpdistant" || type of light
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.direction''' || vector || 0.0 0.0 1.0 || direction
|}

===Type: distant===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "distant" || type of light
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.direction''' || vector || 0.0 0.0 1.0 || direction
|-
|'''scene.lights.<light name>.theta''' || float || 10.0 || half angle of the light source in degree. Must be > 0 for soft shadows
|}

===Type: laser===

A light source emitting parallel light rays (like sharpdistant light, but starting inside the scene instead of infinitely far away).

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "laser" || type of light
|-
|'''scene.lights.<light name>.position''' || point || 0.0 0.0 0.0 || position
|-
|'''scene.lights.<light name>.target''' || point || 0.0 0.0 1.0 || target
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.power''' || float || 0.0 || lamp output power in watts. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.efficency''' || float || 0.0 || luminous efficacy in lumens/watt. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.radius''' || float || 0.01 || radius of the laser beam
|}

LuxCore SDL Reference Manual v2.5

2020-08-27T13:55:09Z

Byob: Add brickmodbias property, remove brickbevel property

The scene description language (SDL) is used to configure the renderer and to define objects, materials, textures etc. in the scene. 
The file ending of the render configuration file is ".cfg", for the scene file it's ".scn".

These files are usually created by exporter plugins, e.g. BlendLuxCore. 
This wiki page is primarily a reference for exporter developers, normal end-users should not need to edit cfg/scn files by hand.

Sometimes the API is updated faster than the wiki, in this case you can look at the code directly: https://github.com/LuxCoreRender/LuxCore/tree/master/src/slg/scene

Note that matrices are passed as flat lists in column-major form.

=Render configuration file=

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''resumerendering.filesafe''' || bool || 1 || enable/disable "safe save" mode for resume rendering file. A backup of the output is always valid even in the case of a system failure
|}

==Seed==

The global seed value that is used to generate random numbers. 
Two images rendered with the same seed will have the same noise pattern.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''renderengine.seed''' || unsigned int || 1 || min 1
|}

==Periodic save==

Options related to periodic save operations.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''periodicsave.resumerendering.period''' || float || 0 || save the resume rendering file every specified amount of time (value in seconds). A value <= 0.0 disable the saving
|-
|'''periodicsave.resumerendering.filename''' || string || "resume.rsm" || the name to use to save the rendering resume information periodically
|-
|'''periodicsave.film.period''' || float || 0 || save the Film every specified amount of time (value in seconds). A value <= 0.0 disable the saving
|-
|'''periodicsave.film.filename''' || string || "film.flm" || the name to use to save the film periodically
|-
|'''periodicsave.film.outputs.period''' || float || 600 || save all Film outputs every specified amount of time (value in seconds). A value <= 0.0 disable the saving
|}

==Render Engine==

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''renderengine.type''' || string || "PATHCPU" || engine type
|}

=== CPU Render Engines ===

CPU render engines are written in C++ and don't require OpenCL. All CPU render engines accept the following parameters:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''native.threads.count''' || int || CPU core count || > 0 || > 0 || The number of threads will be used for the rendering
|}

'''The following CPU engines are available:'''

===="PATHCPU"====

A path tracer with full image plane rendering (i.e. supporting Metropolis sampler).

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''path.pathdepth.total''' || int || 6 || > 0 || [1, 16] || Maximum recursion depth of a path
|-
|'''path.pathdepth.diffuse''' || int || 4 || > 0 || [1, 16] ||
|-
|'''path.pathdepth.glossy''' || int || 4 || > 0 || [1, 16] ||
|-
|'''path.pathdepth.specular''' || int || 6 || > 0 || [1, 16] ||
|-
|'''path.russianroulette.depth''' || int || 3 || > 0 || [1, path.maxdepth] || The path depth where Russian Roulette stars to be used
|-
|'''path.russianroulette.cap''' || float || 0.5 || [0.0, 1.0] || [0.0, 1.0] || The threshold over which Russian Roulette is used
|-
|'''path.clamping.variance.maxvalue''' || float || 0.0 || > 0.0 || > 0.0 || Samples brighter than this value are clamped, helps to reduce fireflies. 0.0 = disabled
|-
|'''path.forceblackbackground.enable''' || bool || 0 || 0 or 1 || 0 or 1 || Enable when rendering with transparent film and premultiplied alpha, to avoid artifacts with semi-transparent areas
|}

===="TILEPATHCPU"====
Biased path tracer with many control options and support for tile rendering. 
The sampler must be set to TILEPATHSAMPLER when using this engine.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''path.pathdepth.total''' || int || 6 || > 0 || [1, 16] || Maximum recursion depth of a path
|-
|'''path.pathdepth.diffuse''' || int || 4 || > 0 || [1, 16] ||
|-
|'''path.pathdepth.glossy''' || int || 4 || > 0 || [1, 16] ||
|-
|'''path.pathdepth.specular''' || int || 6 || > 0 || [1, 16] ||
|-
|'''path.russianroulette.depth''' || int || 3 || > 0 || [1, path.maxdepth] || The path depth where Russian Roulette stars to be used
|-
|'''path.russianroulette.cap''' || float || 0.5 || [0.0, 1.0] || [0.0, 1.0] || The threshold over which Russian Roulette is used
|-
|'''path.clamping.variance.maxvalue''' || float || 0.0 || > 0.0 || > 0.0 || Samples brighter than this value are clamped, helps to reduce fireflies. 0.0 = disabled
|-
|'''path.forceblackbackground.enable''' || bool || 0 || 0 or 1 || 0 or 1 || Enable when rendering with transparent film and premultiplied alpha, to avoid artifacts with semi-transparent areas
|-
|'''tilepath.sampling.aa.size''' || int || 3 || > 0 || [1, 13] || All diffuse/glossy/specular samples are multiplied with the squared aa size: final_samples = aa^2 * (diffuse^2 + glossy^2 + specular^2)
|-
|'''tile.size''' || int || 32 || ≥ 8 || [8, 256] || Tile size in pixels
|-
|'''tile.multipass.enable''' || bool || 1 || 0 or 1 || o or 1 || Re-render the image until a halt threshold is met or indefinitely
|-
|'''tile.multipass.convergencetest.threshold''' || float || 6.0 / 256.0 || > 0.0 || [1.0 / 256.0, 6.0 / 256.0] || Target noise level
|-
|'''tile.multipass.convergencetest.threshold.reduction''' || float || 0.0 || [0.0, 1.0] || [0.75, 0.95] || Multiply noise level with this number when all tiles have met the previous noise level. Set to 0 to disable (so rendering will stop at the noise level)
|-
|'''tile.multipass.convergencetest.warmup.count''' || int || 32 || ≥ 0 || [8, 128] || Warm up period for the convergence test expressed in samples per pixel
|}

===="BIDIRCPU"====

A Bidirectional path tracer.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''path.maxdepth''' || int || 5 || > 0 || [1, 16] || Maximum recursion depth of a eye path
|-
|'''light.maxdepth''' || int || 5 || > 0 || [1, 16] || Maximum recursion depth of a light path
|-
|'''path.russianroulette.depth''' || int || 3 || > 0 || [1, path.maxdepth] || The path depth where Russian Roulette starts to be used
|-
|'''path.russianroulette.cap''' || float || 0.5 || [0.0, 1.0] || [0.0, 1.0] || The threshold over which Russian Roulette is used
|}

===="RTPATHCPU"====
Engine optimized for interactive scene editing and camera movement. 
The sampler must be set to RTPATHCPUSAMPLER when using this engine.

Supports the same properties as [[#"PATHCPU" | "PATHCPU"]] plus the following:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''rtpathcpu.zoomphase.size''' || int || 4 || || || render scaled down film for the first few frames after a scene edit (to make interactions more fluid)
|-
|'''rtpathcpu.zoomphase.weight''' || float || 0.1 || || || description: TODO
|}

=== OpenCL Render Engines ===

OpenCL engines can run on GPUs, CPUs and other types of computing devices, they require OpenCL to run. All OpenCL render engines accept the following parameters:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''opencl.platform.index''' || int || -1 || A valid platform index || -1 || Select the OpenCL platform to use. All devices available on all platforms will be used with -1
|-
|'''opencl.cpu.use''' || bool || 1 || 0 or 1 || 0 or 1 || If to use all OpenCL CPU devices available
|-
|'''opencl.gpu.use''' || bool || 1 || 0 or 1 || 0 or 1 || If to use all OpenCL GPU devices available
|-
|'''opencl.cpu.workgroup.size''' || int || 0 || Any valid OpenCL workgroup size || 64 || Set the OpenCL workgroup size, 0 means to use the driver suggested value
|-
|'''opencl.gpu.workgroup.size''' || int || 0 || Any valid OpenCL workgroup size || 64 || Set the OpenCL workgroup size, 0 means to use the driver suggested value
|-
|'''opencl.devices.select''' || string || "" || Any valid selection string || Any valid selection string || Select each OpenCL device to use. It is a string of "0" and "1". "1" means use the device, "0" do not
|}

'''The following OpenCL engines are available:'''

===="PATHOCL"====
OpenCL version of PATHCPU. Supports the same settings as [[#"PATHCPU" | PATHCPU]] plus the following:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''pathocl.pixelatomics.enable''' || bool || 0 || 0 or 1 || 0 or 1 || Enable pixel atomic operation
|-
|'''opencl.task.count''' || int || "AUTO" || "AUTO" or > 0 || [64K, 1024K] || The number of tasks sent to the OpenCL device in one kernel call
|}

===="RTPATHOCL"====

A PATHOCL version optimized for real-time rendering with fixed frame-rate and variable quality. 
The sampler must be set to TILEPATHSAMPLER when using this engine.

Supports the same settings as [[#"PATHOCL" | PATHOCL]] plus the following:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''rtpath.resolutionreduction.preview''' || int || 4 || > 0 || [1, 32] || Render a sample every n x n pixels in the first passes. For instance 4x4 than 2x2 and than always 1x1
|-
|'''rtpath.resolutionreduction.preview.step''' || int || 8 || > 0 || [1, 32] || Each preview step is rendered for n frames
|-
|'''rtpath.resolutionreduction''' || int || 4 || > 0 || [1, 32] || Render a sample every n x n pixels, outside the preview phase, in order to reduce the per frame rendering time
|}

===="TILEPATHOCL"====

OpenCL version of TILEPATHCPU. 
The sampler must be set to TILEPATHSAMPLER when using this engine.

Supports the same settings as [[#"TILEPATHCPU" | TILEPATHCPU]] plus the following:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''tilepathocl.devices.maxtiles''' || int || 16 || ≥ 1 || [1, 32] || Maximum number of tiles to send in a single call to each OpenCL device
|}

==="FILESAVER"===

Saves everything needed to render the scene to the output path, including textures and meshes.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''filesaver.format''' || string || "TXT" || "TXT" for a text SDL format and "BIN" for a single file binary format
|-
|'''filesaver.filename''' || string || "luxcore-exported-scene.bcf" || file name for "BIN" format
|-
|'''filesaver.directory''' || string || "luxcore-exported-scene" || output path for "TXT" format
|-
|'''filesaver.renderengine.type''' || string || "PATHCPU" || render engine to use when rendering the scene after it was saved with FILESAVER. Any engine string from above can be used here.
|}

===Experimental and debugging engines===

'''These engines are experimental, deprecated or are only intended for very specific purposes:'''

===="BIDIRVMCPU"====

Bidir with vertex merging, currently experimental. 
Supports the same settings as [[#"BIDIRCPU" | BIDIRCPU]] plus the following:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''bidirvm.lightpath.count''' || int || 16 * 1024 || > 0 || || Number of lightpaths per pass
|-
|'''bidirvm.startradius.scale''' || float || 0.003 || > 0 || || Photon radius of the first pass
|-
|'''bidirvm.alpha''' || float || 3 || > 0 || [0.0, 1.0] || Photon radius is multiplied with this value after every pass to reduce the radius
|}

===="LIGHTCPU"====

For testing.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''light.maxdepth''' || int || 5 || > 0 || [1, 16] || Maximum recursion depth of a light path
|-
|'''light.russianroulette.depth''' || int || 3 || > 0 || [1, path.maxdepth] || The path depth where Russian Roulette starts to be used
|-
|'''light.russianroulette.cap''' || float || 0.5 || [0.0, 1.0] || [0.0, 1.0] || The threshold over which Russian Roulette is used
|}

==Sampler==

Samplers are used by following render engines:

* LIGHTCPU
* PATHCPU
* BIDIRCPU
* BIDIRVMCPU
* PATHOCL

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''sampler.type''' || string || "SOBOL" || sampler type
|}

The following samplers are available:

==="SOBOL"===

Sampler with sobol pattern.
Parameters:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''sampler.sobol.adaptive.strength''' || float || 0.7 || 0 ≤ x < 0.95 || 0.5 - 0.9 || it sets if the sampler should be more or less adaptive
|}

==="METROPOLIS"===

Metropolis sampler.
Parameters:
{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''sampler.metropolis.largesteprate''' || float || 0.4 || 0 ≤ x ≤ 1 || 0 - 1 || Probability of generating a large sample mutation
|-
|'''sampler.metropolis.maxconsecutivereject''' || int || 512 || x ≥ 0 || 0 - 32768 || Number of consecutive rejects before a next mutation is forced. Low values can cause bias
|-
|'''sampler.metropolis.imagemutationrate''' || float || 0.1 || 0 ≤ x ≤ 1 || 0 - 1 || Maximum distance over the image plane for a small mutation
|}

==="RANDOM"===

Fully random sampler. This sampler is mostly intended for testing purpose.
Parameters:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''sampler.random.adaptive.strength''' || float || 0.7 || 0 ≤ x < 0.95 || 0.5 - 0.9 || it sets if the sampler should be more or less adaptive
|}

==Filter==

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''film.filter.type''' || string || "BLACKMANHARRIS" || || || Type of pixel filter.
|-
|'''film.filter.width''' || float || 2.0 || x > 0.0 || 0.1 - 3.0 || Filter radius in pixels. Does not have an effect on the NONE filter
|-
|'''film.filter.xwidth''' || float || 2.0 || x > 0.0 || 0.1 - 3.0 || Width in pixels. Overwrite '''film.filter.width''' value
|-
|'''film.filter.ywidth''' || float || 2.0 || x > 0.0 || 0.1 - 3.0 || Width in pixels. Overwrite '''film.filter.width''' value
|}

Available filters are:

==="NONE"===

Disable pixel filtering.

==="BOX"===

Box pixel filter. No parameters.

==="GAUSSIAN"===

Gaussian pixel filter.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''film.filter.gaussian.alpha''' || float || 2.0 || x > 0.0 || 0.1 - 10.0 || Gaussian rate of falloff. Lower values give blurrier images.
|}

==="MITCHELL"===

Mitchel pixel filter.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
| '''film.filter.mitchell.b''' || float || 1.0/3.0 || 0.0 ≤ x ≤ 1.0 || 0.0 - 1.0 || B parameter for the mitchell filter in the range
|-
| '''film.filter.mitchell.c''' || float || 1.0/3.0 || 0.0 ≤ x ≤ 1.0 || 0.0 - 1.0 || C parameter for the mitchell filter in the range 0..1
|}

==="MITCHELL_SS"===

Mitchel pixel filter with super-sampling (i.e. image will be filtered first with a grid of 4 pixels for each pixel).

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
| '''film.filter.mitchellss.b''' || float || 1.0/3.0 || 0.0 ≤ x ≤ 1.0 || 0.0 - 1.0 || B parameter for the mitchell filter in the range
|-
| '''film.filter.mitchellss.c''' || float || 1.0/3.0 || 0.0 ≤ x ≤ 1.0 || 0.0 - 1.0 || C parameter for the mitchell filter in the range 0..1
|}

==="BLACKMANHARRIS"===

Blcakman-Harris pixel filter. No parameters.

==Light Strategy==

The direct light sampling strategy is defined by the following property:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''lightstrategy.type''' || string || "LOG_POWER" || "UNIFORM", "POWER", "LOG_POWER" or "DLS_CACHE" || N/A || Direct light sampling strategy
|}

==="UNIFORM"===

"UNIFORM" light strategy samples evenly all light sources.

==="POWER"===

"POWER" light strategy samples the light sources based on their power.

==="LOG_POWER"===

"LOG_POWER" light strategy samples the light sources based on logarithm of their power.

==="DLS_CACHE"===

Build direct light sampling cache to optimize many-lights rendering, beneficial in scenes with multiple light sources with few overlap between their influence areas (e.g. a building with many disconnected rooms and interior lights).

Options for the DLS cache:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''lightstrategy.entry.radius''' || float || 0.0 || || N/A || Entry radius in meters, automatic radius estimation is used if the radius is set to 0
|-
|'''lightstrategy.entry.normalangle''' || float || 25.0 || || N/A ||
|-
|'''lightstrategy.entry.maxpasses''' || int || 1024 || || N/A ||
|-
|'''lightstrategy.entry.convergencethreshold''' || float || 0.05 || || N/A ||
|-
|'''lightstrategy.entry.warmupsamples''' || int || 24 || || N/A ||
|-
|'''lightstrategy.targetcachehitratio''' || float || 0.995 || || N/A ||
|-
|'''lightstrategy.maxdepth''' || int || 4 || || N/A ||
|-
|'''lightstrategy.maxsamplescount''' || int || 10000000 || || N/A ||
|-
|'''lightstrategy.persistent.file''' || string || "" || || N/A ||
|-
|'''lightstrategy.persistent.safesave''' || bool || 1 || || N/A ||

|}

==Accelerator==

The ray/triangle intersection accelerator to use for the rendering is defined by the following properties:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''accelerator.type''' || string || "AUTO" || "AUTO", "BVH", "MBVH", "EMBREE" || "AUTO" || The intersection accelerator. "AUTO" will select the best one available for the current [[LuxRays]] intersection device. "EMBREE" is currently usable only on CPU render engines
|-
|'''accelerator.instances.enable''' || bool || 1 || 0 or 1 || 0 or 1 || Enable instance support (or disable in order to slightly increase rendering speed)
|}

==Epsilon==

Minimum and maximum allowed value for scene epsilon can be define by the following properties:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''scene.epsilon.min''' || float || 1e-5f || Any float value || 1e-6f ≤ x ≤ 1e-1f || Minimum allowed value for scene epsilon
|-
|'''scene.epsilon.max''' || float || 1e-1f || Any float value || 1e-3f ≤ x ≤ 1e+2f || Maximum allowed value for scene epsilon
|}

==Film==

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.safesave''' || bool || 1 || enable "safe save" of Film serialization. A backup of the output is always valid even in the case of a system failure.
|}

===Film OpenCL Options===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.opencl.enable''' || bool || 1 || enable OpenCL film operations
|-
|'''film.opencl.platform''' || unsigned int || -1 || choose which platform will be used by the film operations. (0 is first platform, 1 second and so on. -1 for all)
|-
|'''film.opencl.device''' || unsigned int || -1 || choose which device will be used by the film operations. (0 is first device, 1 second and so on. -1 for first GPU device)
|}

===Film Outputs (aka AOVs)===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.outputs.safesave''' || bool || 1 || enable "safe save" for Film outputs. A backup of the output is always valid even in the case of a system failure
|}

The film object supports many types of outputs (aka AOVs). The complete list of supported output types:

{| class="wikitable" cellspacing="2"
!Name
!Type
|-
|'''RGB''' || HDR
|-
|'''RGBA''' || HDR
|-
|'''RGB_IMAGEPIPELINE''' || HDR/LDR
|-
|'''RGBA_IMAGEPIPELINE''' || HDR/LDR
|-
|'''ALPHA''' || HDR/LDR
|-
|'''DEPTH''' || HDR
|-
|'''POSITION''' || HDR
|-
|'''GEOMETRY_NORMAL''' || HDR
|-
|'''SHADING_NORMAL''' || HDR
|-
|'''MATERIAL_ID''' || LDR
|-
|'''DIRECT_DIFFUSE''' || HDR
|-
|'''DIRECT_GLOSSY''' || HDR
|-
|'''EMISSION''' || HDR
|-
|'''INDIRECT_DIFFUSE''' || HDR
|-
|'''INDIRECT_GLOSSY''' || HDR
|-
|'''INDIRECT_SPECULAR''' || HDR
|-
|'''MATERIAL_ID_MASK''' || HDR/LDR
|-
|'''DIRECT_SHADOW_MASK''' || HDR/LDR
|-
|'''INDIRECT_SHADOW_MASK''' || HDR/LDR
|-
|'''RADIANCE_GROUP''' || HDR/LDR
|-
|'''UV''' || HDR/LDR
|-
|'''RAYCOUNT''' || HDR/LDR
|-
|'''BY_MATERIAL_ID''' || HDR/LDR
|-
|'''IRRADIANCE''' || HDR
|-
|'''OBJECT_ID''' || LDR
|-
|'''OBJECT_ID_MASK''' || HDR/LDR
|-
|'''BY_OBJECT_ID''' || HDR/LDR
|-
|'''SAMPLECOUNT''' || HDR/LDR
|-
|'''CONVERGENCE''' || HDR/LDR
|-
|'''NOISE''' || HDR/LDR
|-
|'''SERIALIZED_FILM''' || N/A
|-
|'''MATERIAL_ID_COLOR''' || HDR/LDR
|}

Outputs are enabled with the following properties:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.outputs.<index>.type''' || string || || Type of output, e.g. "RGBA" or "ALPHA" (see the list above for the available types)
|-
|'''film.outputs.<index>.filename''' || string || || Filename to use when saving the output. The filename should use ".exr" as extension for HDR outputs and ".png" for LDR outputs (see list above for which output is HDR and which LDR)
|-
|'''film.outputs.<index>.id''' || int || || Specify for the following outputs: '''MATERIAL_ID_MASK''', '''RADIANCE_GROUP''', '''BY_MATERIAL_ID''', '''OBJECT_ID_MASK''', '''BY_OBJECT_ID''' (to choose the object ID, material ID or radiance group ID of the output)
|-
|'''film.outputs.<index>.index''' || int || || Specify for an imagepipeline output (RGB_IMAGEPIPELINE or RGBA_IMAGEPIPELINE) to select the imagepipeline of the output. For example, if you have 3 imagepipelines defined, and you want to specify the output of the third imagepipeline, use 2 for the ".index" property of the output
|}

Note that the Bidir engine does not support all AOVs.
Not supported by Bidir are: EMISSION, DIRECT_DIFFUSE, DIRECT_GLOSSY, INDIRECT_DIFFUSE, INDIRECT_GLOSSY, INDIRECT_SPECULAR, DIRECT_SHADOW_MASK, INDIRECT_SHADOW_MASK, IRRADIANCE, RAYCOUNT.

This is the list of output channel data types and sizes:

{| class="wikitable" cellspacing="2"
!Output type
!Data type
!Size
!Description
|-
|RGB||float||film width x film height x 3||R, G, B
|-
|RGB_IMAGEPIPELINE||float||film width x film height x 3||R, G, B
|-
|RGBA||float||film width x film height x 4||R, G, B, A
|-
|ALPHA||float||film width x film height x 1||Alpha value [0, 1]
|-
|DEPTH||float||film width x film height x 1||Camera distance
|-
|POSITION||float||film width x film height x 3||World X, Y, Z
|-
|GEOMETRY_NORMAL||float||film width x film height x 3||Normal vector X, Y, Z
|-
|SHADING_NORMAL||float||film width x film height x 3||Normal vector X, Y, Z
|-
|DIRECT_DIFFUSE||float||film width x film height x 3||Diffuse R, G, B
|-
|DIRECT_GLOSSY||float||film width x film height x 3||Glossy R, G, B
|-
|EMISSION||float||film width x film height x 3||Emission R, G, B
|-
|INDIRECT_DIFFUSE||float||film width x film height x 3||Indirect diffuse R, G, B
|-
|INDIRECT_GLOSSY||float||film width x film height x 3||Indirect glossy R, G, B
|-
|INDIRECT_SPECULAR||float||film width x film height x 3||Indirect specular R, G, B
|-
|MATERIAL_ID_MASK||float||film width x film height x 1||Material mask [0, 1]
|-
|DIRECT_SHADOW_MASK||float||film width x film height x 1||Shadow mask [0, 1]
|-
|INDIRECT_SHADOW_MASK||float||film width x film height x 1||Shadow mask [0, 1]
|-
|RADIANCE_GROUP||float||film width x film height x 3||R, G, B
|-
|UV||float||film width x film height x 2||Texture coordinates U, V
|-
|RAYCOUNT||float||film width x film height x 1||Ray count
|-
|BY_MATERIAL_ID||float||film width x film height x 3||By material ID
|-
|MATERIAL_ID||uint||film width x film height x 1||Material ID
|-
|IRRADIANCE||float||film width x film height x 3||R, G, B
|-
|OBJECT_ID_MASK||float||film width x film height x 1||Object mask [0, 1]
|-
|BY_OBJECT_ID||float||film width x film height x 3||By object ID
|-
|OBJECT_ID||uint||film width x film height x 1||Object ID
|-
|SAMPLECOUNT||uint||film width x film height x 1||Sample count
|-
|CONVERGENCE||float||film width x film height x 1||The distance of each pixel from the convergence threshold
|-
|NOISE||float||film width x film height x 1||The noise estimated for each pixel
|-
|SERIALIZED_FILM||N/A||N/A||The complete Film serialized in binary format
|-
|MATERIAL_ID_COLOR||float||film width x film height x 3||Material ID converted to colors (with anti-aliasing)
|}

===Film Channels===

Film channels are implicitly enabled by declaring film outputs (even if the output is never used). For instance, declaring a "RGBA" output will automatically enable "RADIANCE_PER_PIXEL_NORMALIZED" (and "RADIANCE_PER_SCREEN_NORMALIZED" for BIDIRCPU) and "ALPHA".
The supported channels are:

{| class="wikitable" cellspacing="2"
!Channel type
!Data type
!Size
!Last element is weight ?
!Note
|-
|CHANNEL_RADIANCE_PER_PIXEL_NORMALIZED||float||film width x film height x 4||Yes||One for each radiance group. Eye paths radiance.
|-
|CHANNEL_RADIANCE_PER_SCREEN_NORMALIZED||float||film width x film height x 3||No||One for each radiance group. Light paths radiance. Used only by LIGHTCPU and BIDIRCPU.
|-
|CHANNEL_ALPHA||float||film width x film height x 2||Yes||
|-
|CHANNEL_RGB_IMAGEPIPELINE||float||film width x film height x 3||No||
|-
|CHANNEL_DEPTH||float||film width x film height x 1||No||
|-
|CHANNEL_POSITION||float||film width x film height x 3||No||
|-
|CHANNEL_GEOMETRY_NORMAL||float||film width x film height x 3||No||
|-
|CHANNEL_SHADING_NORMAL||float||film width x film height x 3||No||
|-
|CHANNEL_MATERIAL_ID||u_int||film width x film height x 1||No||
|-
|CHANNEL_DIRECT_DIFFUSE||float||film width x film height x 4||Yes||
|-
|CHANNEL_DIRECT_GLOSSY||float||film width x film height x 4||Yes||
|-
|CHANNEL_EMISSION||float||film width x film height x 4||Yes||
|-
|CHANNEL_INDIRECT_DIFFUSE||float||film width x film height x 4||Yes||
|-
|CHANNEL_INDIRECT_SPECULAR||float||film width x film height x 4||Yes||
|-
|CHANNEL_MATERIAL_ID_MASK||float||film width x film height x 2||Yes||
|-
|CHANNEL_DIRECT_SHADOW_MASK||float||film width x film height x 2||Yes||
|-
|CHANNEL_INDIRECT_SHADOW_MASK||float||film width x film height x 2||Yes||
|-
|CHANNEL_UV||float||film width x film height x 2||No||
|-
|CHANNEL_RAYCOUNT||float||film width x film height||No||
|-
|CHANNEL_BY_MATERIAL_ID||float||film width x film height x 4||Yes||
|-
|CHANNEL_IRRADIANCE||float||film width x film height x 4||Yes||
|-
|CHANNEL_OBJECT_ID||u_int||film width x film height x 1||No||
|-
|CHANNEL_OBJECT_ID_MASK||float||film width x film height x 2||Yes||
|-
|CHANNEL_BY_OBJECT_ID||float||film width x film height x 4||Yes||
|}

This is the list of channels enabled by each output:

{| class="wikitable" cellspacing="2"
!Output
!Enabled channels
|-
|'''RGB''' || CHANNEL_RADIANCE_PER_PIXEL_NORMALIZED, CHANNEL_RADIANCE_PER_SCREEN_NORMALIZED (only for LIGHTCPU and BIDIRCPU)
|-
|'''RGBA''' || CHANNEL_RADIANCE_PER_PIXEL_NORMALIZED, CHANNEL_RADIANCE_PER_SCREEN_NORMALIZED (only for LIGHTCPU and BIDIRCPU), ALPHA
|-
|'''RGB_IMAGEPIPELINE''' || CHANNEL_RADIANCE_PER_PIXEL_NORMALIZED, CHANNEL_RADIANCE_PER_SCREEN_NORMALIZED (only for LIGHTCPU and BIDIRCPU)
|-
|'''RGBA_IMAGEPIPELINE''' || CHANNEL_RADIANCE_PER_PIXEL_NORMALIZED, CHANNEL_RADIANCE_PER_SCREEN_NORMALIZED (only for LIGHTCPU and BIDIRCPU), ALPHA
|-
|'''ALPHA''' || ALPHA
|-
|'''DEPTH''' || DEPTH
|-
|'''POSITION''' || DEPTH, POSITION
|-
|'''GEOMETRY_NORMAL''' || DEPTH, GEOMETRY_NORMAL
|-
|'''SHADING_NORMAL''' || DEPTH, SHADING_NORMAL
|-
|'''MATERIAL_ID''' || DEPTH, MATERIAL_ID
|-
|'''DIRECT_DIFFUSE''' || DIRECT_DIFFUSE
|-
|'''DIRECT_GLOSSY''' || DIRECT_GLOSSY
|-
|'''EMISSION''' || EMISSION
|-
|'''INDIRECT_DIFFUSE''' || INDIRECT_DIFFUSE
|-
|'''INDIRECT_GLOSSY''' || INDIRECT_GLOSSY
|-
|'''INDIRECT_SPECULAR''' || INDIRECT_SPECULAR
|-
|'''MATERIAL_ID_MASK''' || MATERIAL_ID, MATERIAL_ID_MASK
|-
|'''DIRECT_SHADOW_MASK''' || DIRECT_SHADOW_MASK
|-
|'''INDIRECT_SHADOW_MASK''' || INDIRECT_SHADOW_MASK
|-
|'''RADIANCE_GROUP''' || CHANNEL_RADIANCE_PER_PIXEL_NORMALIZED, CHANNEL_RADIANCE_PER_SCREEN_NORMALIZED (only for LIGHTCPU and BIDIRCPU)
|-
|'''UV''' || DEPTH, UV
|-
|'''RAYCOUNT''' || DEPTH, RAYCOUNT
|-
|'''BY_MATERIAL_ID''' || BY_MATERIAL_ID
|-
|'''IRRADIANCE''' || IRRADIANCE
|-
|'''OBJECT_ID''' || DEPTH, OBJECT_ID
|-
|'''OBJECT_ID_MASK''' || OBJECT_ID, OBJECT_ID_MASK
|-
|'''BY_OBJECT_ID''' || BY_OBJECT_ID
|}

Note: CHANNEL_RGB_IMAGEPIPELINE is always enable and the result of running the image pipeline.

===Image pipeline===

It is possible to [http://www.luxrender.net/forum/viewtopic.php?f=8&p=120169#p120169 define multiple image pipelines at the same time]

====Radiance Group====

Radiance groups are used to get only the contribution of a group of lights in the scene. 
Lights can be grouped by setting their [[#Common_parameters | '''.id''']] property to the same number, on materials this is done with the [[#Light_emission | '''.emission.id''']] property. 

Note that the OpenCL engines only support up to 8 radiance groups (one of them is the default group).

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.radiancescales.<id>.globalscale''' || float|| 1 || global weighting of radiance group
|-
|'''film.imagepipelines.<pipeline #>.radiancescales.<id>.temperature ''' || float || 6500.0 || light temperature
|-
|'''film.imagepipelines.<pipeline #>.radiancescales.<id>.rgbscale''' || vector || 1.0 1.0 1.0 || light color
|-
|'''film.imagepipelines.<pipeline #>.radiancescales.radiancescales.<id>.enabled''' || bool || 1 || enable radiance group
|}

====Image pipeline plug-ins====

=====Type: TONEMAP_LINEAR=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "TONEMAP_LINEAR" || linear tonemapping
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.scale''' || float || 1.0 || tonemapping scale
|}

=====Type: TONEMAP_REINHARD02=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "TONEMAP_REINHARD02" || reinhard tonemapping
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.prescale''' || float || 1.0 || reinhard prescale
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.postscale''' || float || 1.2 || reinhard postscale
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.burn''' || float || 3.75 || reinhard burn
|}

=====Type: TONEMAP_AUTOLINEAR=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "TONEMAP_AUTOLINEAR" || automatic linear tonemapping
|}

=====Type: TONEMAP_LUXLINEAR=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "TONEMAP_LUXLINEAR" || linear tonemapping with real camera settings
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.sensitivity''' || float || 100.0 || ISO sensitivity
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.exposure''' || float || 0.001 || exposure time
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.fstop''' || float || 2.8 || f/aperture
|}

=====Type: NOP=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipeline.<pipeline #>.<plugin #>.type''' || string || "NOP" || no parameters tonemapper
|}

=====Type: GAMMA_CORRECTION=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "TONEMAP_LINEAR" || gamma correction
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.value''' || float || 2.2 || gamma value
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.table.size''' || unsigned int || 4096 || resolution
|}

=====Type: OUTPUT_SWITCHER=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "OUTPUT_SWITCHER" || overwrite output
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.channel''' || string || "DEPTH" || channel whose values are used to overwrite
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.index''' || unsigned int || 0 || index
|}

=====Type: GAUSSIANFILTER_3x3=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "GAUSSIANFILTER_3x3" || gaussian filter
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.weight''' || float || 0.15 || blurring weight
|}

=====Type: CAMERA_RESPONSE_FUNC=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || CAMERA_RESPONSE_FUNC || analog camera film simulation
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.name''' || string || "Advantix_100CD" || film type
|}

=====Type: BACKGROUND_IMG=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || BACKGROUND_IMG || show the background image where alpha < 1 (simple compositing)
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.file''' || string || ... || background image path (e.g scenes/simple-mat/sky.exr)
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.gamma''' || float || 2.2 || background image gamma
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.storage ''' || string || auto || background image storage type
|}
Note: When the size of the background image differs from the film size, it will be stretched to fit the film size.

=====Type: BLOOM=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "BLOOM" || bloom effect
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.radius''' || float || 0.07 || how large the bloom effect is in % of the image size (i.e. 1.0 = all image)
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.weight''' || float || 0.25 || how strong the effect is (i.e. 0.0 = nothing, 1.0 = max. strength)
|}

=====Type: VIGNETTING=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "VIGNETTING" || vignetting effect
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.scale''' || float || 0.4 || vignetting strength
|}

=====Type: COLOR_ABERRATION=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "COLOR_ABERRATION" || color aberration effect
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.amount''' || float || 0.005 || color aberration amount
|}

=====Type: MIST=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "MIST" || aerial perspective effect (fake fog)
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.color''' || spectrum|| [1, 1, 1] || mist color
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.amount''' || float || 0.005 || mist amount
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.startdistance''' || float || 0 || distance from camera until where the mist effect has zero effect
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.enddistance''' || float || 10000 || distance from camera from where the mist effect has maximum effect
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.excludebackground''' || bool || false || Do not apply mist effect on pixels with infinite distance to the camera
|}

=====Type: CONTOUR_LINES=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "CONTOUR_LINES" || contour lines for IRRADIANCE AOV
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.range''' || float|| ? || ?
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.scale''' || float || ? || ?
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.steps''' || int || ? || ?
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.zerogridsize''' || int || ? || ?
|}

=====Type: WHITE_BALANCE =====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "WHITE_BALANCE" || White temperature correction
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.temperature''' || unsigned int|| 6500 || Target image temperature in Kelvin
|-
|}

===Film Subregion===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.subregion''' || vector || ... || <xstart> <xstop> <ystart> <ystop>
|}

===Rendering halt conditions===

By default, a LuxCore rendering will never stop however you can enable one or multiple halt conditions:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''batch.haltnoisethreshold''' || float || -1.0 || enable image convergence test and stops when the error is under the defined value. Use a value like "n / 256.0" where n is the level of error you are looking for. It may be hard to achieve a level of error smaller than 3.0 / 256.0. -1.0 disables the halt condition.
|-
|'''batch.haltnoisethreshold.warmup''' || unsigned int || 64 || number of average samples per pixel before to start the convergence test
|-
|'''batch.haltnoisethreshold.step''' || unsigned int || 64 || number of average samples per pixel between two tests
|-
|'''batch.haltnoisethreshold.filter.enable''' || bool || 1 || if the CONVERGENCE AOV (generated by the batch.haltnoisethreshold) should be filtered or not with a 3x3 box filter
|-
|'''batch.haltnoisethreshold.stoprendering.enable''' || bool || 1 || Set this to 0 (false) if you only want to use the haltnoisethreshold settings for adaptive sampling in an endless render
|-
|'''batch.haltnoisethreshold.index''' || unsigned int || 0 || Film pipeline index used to estimate noise for stopping
|-
|'''batch.halttime''' || float || 0.0 || number of seconds before stopping the rendering
|-
|'''batch.haltspp''' || unsigned int || 0 || number of average samples per pixel before stopping the rendering
|}

===Noise estimation===

Image noise can be estimated and its result can be used to drive the Sobol and Random samplers to focus its sampling in the noisier regions.
Setting any of these properties will enable the noise estimation.
The adaptiveness strength is a Sampler property.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.noiseestimation.warmup''' || unsigned int || 32 || number of average samples per pixel before to start the convergence test
|-
|'''film.noiseestimation.step''' || unsigned int || 32 || number of average samples per pixel between two tests
|-
|'''film.noiseestimation.filter.scale''' || unsigned int || 4 || Box filter scale used to filter the NOISE AOV (generated by the noise estimation). Set to 0 to disable.
|-
|'''film.noiseestimation.index''' || unsigned int || 0 || Film pipeline index used to estimate noise for adaptive sampling
|-
|}

=Scene file=

==Camera==

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.camera.type''' || string || "perspective" || "perspective", "orthographic" or "environment" (360° panorama mapped in latlong format)
|-
|'''scene.camera.lookat.orig''' || point (float float float) || 0.0 10.0 0.0 || camera location
|-
|'''scene.camera.lookat.target''' || point (float float float) || 0.0 0.0 0.0 || camera target
|-
|'''scene.camera.up''' || vector (float float float) || (0.0, 0.0, 1.0) || camera up vector
|-
|'''scene.camera.fieldofview''' || float || 45.0 || field of view
|-
|'''scene.camera.screenwindow''' || vector || 0.0 1.0 0.0 1.0 || <xstart> <xstop> <ystart> <ystop>
|-
|'''scene.camera.shutteropen''' || float || 0.0 || camera shutter open time (used for motion blur)
|-
|'''scene.camera.shutterclose''' || float || 0.0 || camera shutter close time (used for motion blur)
|-
|'''scene.camera.autovolume.enable''' || bool || true || try automatically to discover scene.camera.volume
|-
|'''scene.camera.volume''' || string || || the initial volume rays will travel in
|}

The camera supports motion blur. See [[ LuxCore_SDL_Reference_Manual_v2.0#Object_Motion_Blur | Object Motion Blur ]]. 
(Only difference being that instead of the prefix '''scene.objects.<object name>''', the prefix '''scene.camera''' is used when setting motion properties of the camera)

==Textures==

Check [[LuxCoreRender_Textures|LuxCoreRender Textures]] for a high level description and examples of the textures.

===Mapping===

Some texture (mostly procedural textures) supports 2D or 3D mapping parameters:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.mapping.type''' || string || "uvmapping2d" || type of mapping
|-
|'''scene.textures.<texture name>.mapping.rotation''' || float || 0.0 || UV rotation (in degrees)
|-
|'''scene.textures.<texture name>.mapping.uvscale''' || UV || 1.0 1.0 || UV scale
|-
|'''scene.textures.<texture name>.mapping.uvdelta''' || UV || 0.0 0.0 || UV translation
|}

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.mapping.type''' || string || "uvmapping3d" || type of mapping
|-
|'''scene.textures.<texture name>.mapping.transformation''' || Matrix4x4 || 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0|| transformation matrix
|}

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.mapping.type''' || string || "globalmapping3d" || type of mapping
|-
|'''scene.textures.<texture name>.mapping.transformation''' || Matrix4x4 || 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0|| transformation matrix
|}

===Type: add===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "add" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant
|}

===Type: subtract===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "subtract" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant
|}

===Type: band===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "band" || type of texture
|-
|'''scene.textures.<texture name>.amount''' || texture || 0.5|| texture name or constant
|-
|'''scene.textures.<texture name>.interpolation''' || string || "linear"|| "linear", "cubic" or "none"
|-
|'''scene.textures.<texture name>.offset[0..n]''' || float || 0.0 || multiple offsets in the range of [0.0, 1.0]
|-
|'''scene.textures.<texture name>.value[0..n]''' || spectrum || 1.0 1.0 1.0 || a value for each offset
|}

===Type: blender_blend===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_blend" || type of texture
|-
|'''scene.textures.<texture name>.progressiontype''' || string || "linear" || linear, quadratic, easing, diagonal, spherical, quadratic_spherical, halo or radial
|-
|'''scene.textures.<texture name>.direction''' || string || "horizontal" || horizontal or vertical
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_clouds===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_clouds" || type of texture
|-
|'''scene.textures.<texture name>.noisetype''' || string || "soft_noise" || hard_noise or soft_noise
|-
|'''scene.textures.<texture name>.noisebasis''' || string || "blender_original" || blender_original, original_perlin, improved_perlin, voronoi_f1, voronoi_f2, voronoi_f3, voronoi_f4, voronoi_f2_f1, voronoi_crackle or cell_noise
|-
|'''scene.textures.<texture name>.noisesize''' || float || 0.25 ||
|-
|'''scene.textures.<texture name>.noisedepth''' || int || 2 ||
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_distortednoise===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_distortednoise" || type of texture
|-
|'''scene.textures.<texture name>.noise_distortion''' || string || "blender_original" || blender_original, original_perlin, improved_perlin, voronoi_f1, voronoi_f2, voronoi_f3, voronoi_f4, voronoi_f2_f1, voronoi_crackle or cell_noise
|-
|'''scene.textures.<texture name>.noisebasis''' || string || "blender_original" || blender_original, original_perlin, improved_perlin, voronoi_f1, voronoi_f2, voronoi_f3, voronoi_f4, voronoi_f2_f1, voronoi_crackle or cell_noise
|-
|'''scene.textures.<texture name>.noisesize''' || float || 0.25 ||
|-
|'''scene.textures.<texture name>.distortion''' || float || 1 ||
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_magic===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_magic" || type of texture
|-
|'''scene.textures.<texture name>.noisedepth''' || int || 2 ||
|-
|'''scene.textures.<texture name>.turbulence''' || float || 5.0 ||
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_marble===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_marble" || type of texture
|-
|'''scene.textures.<texture name>.marbletype''' || string || "soft" || soft, sharp or sharper
|-
|'''scene.textures.<texture name>.turbulence''' || float || 5.0 ||
|-
|'''scene.textures.<texture name>.noisebasis''' || string || "blender_original" || blender_original, original_perlin, improved_perlin, voronoi_f1, voronoi_f2, voronoi_f3, voronoi_f4, voronoi_f2_f1, voronoi_crackle or cell_noise
|-
|'''scene.textures.<texture name>.noisebasis2''' || string || "sin" || sin, saw or tri
|-
|'''scene.textures.<texture name>.noisedepth''' || int || 2 ||
|-
|'''scene.textures.<texture name>.noisesize''' || float || 0.25 ||
|-
|'''scene.textures.<texture name>.noisetype''' || string || "soft_noise" || soft_noise or hard_noise
|-
|'''scene.textures.<texture name>.turbulence''' || float || 5.0 ||
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_musgrave===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_musgrave" || type of texture
|-
|'''scene.textures.<texture name>.musgravetype''' || string || "multifractal" || multifractal, ridged_multifractal, hybrid_multifractal, fBM or hetero_terrain
|-
|'''scene.textures.<texture name>.noisebasis''' || string || "blender_original" || blender_original, original_perlin, improved_perlin, voronoi_f1, voronoi_f2, voronoi_f3, voronoi_f4, voronoi_f2_f1, voronoi_crackle or cell_noise
|-
|'''scene.textures.<texture name>.dimension''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.intensity''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.lacunarity''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.offset''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.gain''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.octaves''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.gain''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.noisesize''' || float || 0.25 ||
|-
|'''scene.textures.<texture name>.noisetype''' || string || "soft_noise" || soft_noise or hard_noise
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_noise===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_noise" || type of texture
|-
|'''scene.textures.<texture name>.noisedepth''' || int || 2 ||
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_stucci===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_stucci" || type of texture
|-
|'''scene.textures.<texture name>.stuccitype''' || string || "plastic" || plastic, wall_in or wall_out
|-
|'''scene.textures.<texture name>.noisebasis''' || string || "blender_original" || blender_original, original_perlin, improved_perlin, voronoi_f1, voronoi_f2, voronoi_f3, voronoi_f4, voronoi_f2_f1, voronoi_crackle or cell_noise
|-
|'''scene.textures.<texture name>.noisetype''' || string || "soft_noise" || soft_noise or hard_noise
|-
|'''scene.textures.<texture name>.noisesize''' || float || 0.25 ||
|-
|'''scene.textures.<texture name>.turbulence''' || float || 5.0 ||
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_wood===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_wood" || type of texture
|-
|'''scene.textures.<texture name>.woodtype''' || string || "bands" || bands, rings, bandnoise or ringnoise
|-
|'''scene.textures.<texture name>.noisebasis''' || string || "blender_original" || blender_original, original_perlin, improved_perlin, voronoi_f1, voronoi_f2, voronoi_f3, voronoi_f4, voronoi_f2_f1, voronoi_crackle or cell_noise
|-
|'''scene.textures.<texture name>.noisebasis2''' || string || "sin" || sin, saw or tri
|-
|'''scene.textures.<texture name>.noisetype''' || string || "soft_noise" || soft_noise or hard_noise
|-
|'''scene.textures.<texture name>.noisesize''' || float || 0.25 ||
|-
|'''scene.textures.<texture name>.turbulence''' || float || 5.0 ||
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_voronoi===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_voronoi" || type of texture
|-
|'''scene.textures.<texture name>.intensity''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.distmetric''' || string || "actual_distance" || actual_distance, distance_squared, manhattan, chebychev, minkowski_half, minkowski_four or minkowski
|-
|'''scene.textures.<texture name>.w1''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.w2''' || float || 0.0 ||
|-
|'''scene.textures.<texture name>.w3''' || float || 0.0 ||
|-
|'''scene.textures.<texture name>.w4''' || float || 0.0 ||
|-
|'''scene.textures.<texture name>.noisesize''' || float || 0.25 ||
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: brick===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "brick" || type of texture
|-
|'''scene.textures.<texture name>.bricktex''' || texture || 1.0 1.0 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.mortartex''' || texture || 0.2 0.2 0.2 || texture name or constant
|-
|'''scene.textures.<texture name>.brickmodtex''' || texture || 1.0 1.0 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.brickmodbias''' || float || 0.0 || With bias = -1, only the bricktex is used for the brick color. With bias between -1 and 1, a pseudo-random interpolation between bricktex and brickmodtex is used as brick color. With bias = 1, only the brickmodtex is used for the brick color.
|-
|'''scene.textures.<texture name>.brickbond''' || string || "running" || "flemish", "english", "herringbone", "basket" or "chain link"
|-
|'''scene.textures.<texture name>.brickwidth''' || float || 0.3 || brick width
|-
|'''scene.textures.<texture name>.brickheight''' || float || 0.1 || brick height
|-
|'''scene.textures.<texture name>.brickdepth''' || float || 0.15 || brick depth
|-
|'''scene.textures.<texture name>.mortarsize''' || float || 0.01 ||mortar size
|-
|'''scene.textures.<texture name>.brickrun''' || float || 0.75 || brick run
|}

This texture supports 3D mapping.

===Type: checkerboard3d===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "checkerboard3d" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 0.0 || texture name or constant
|}

This texture supports 3D mapping.

===Type: checkerboard2d===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "checkerboard2d" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 0.0 || texture name or constant
|}

This texture supports 2D mapping.

===Type: constfloat1===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "constfloat1" || type of texture
|-
|'''scene.textures.<texture name>.value''' || float || 1.0 || constant value
|}

===Type: constfloat3===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "constfloat3" || type of texture
|-
|'''scene.textures.<texture name>.value''' || spectrum || (1.0, 1.0, 1.0) || RGB constant value
|}

===Type: densitygrid===

You can use ".data", ".data3" or ".openvdb.file" to define the 3D grid values.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "densitygrid" || type of texture
|-
|'''scene.textures.<texture name>.nx''' || unsigned int || || grid x size
|-
|'''scene.textures.<texture name>.ny''' || unsigned int || || grid y size
|-
|'''scene.textures.<texture name>.nz''' || unsigned int || || grid z size
|-
|'''scene.textures.<texture name>.wrap''' || string || "repeat" || select the type of grid wrapping mode: "repeat", "black", "white", "clamp"
|-
|'''scene.textures.<texture name>.wrap''' || string || "repeat" || select the type of grid wrapping mode: "repeat", "black", "white", "clamp"
|-
|'''scene.textures.<texture name>.storage''' || string || "half" || select the type of memory storage: "auto", "byte", "half", "float"
|-
|'''scene.textures.<texture name>.data''' || float || || vector grid values (total count: nx * ny * nz)
|-
|'''scene.textures.<texture name>.data3''' || float || || vector grid values (total count: nx * ny * nz * 3)
|-
|'''scene.textures.<texture name>.openvdb.file''' || string || || OpenVDB file name
|-
|'''scene.textures.<texture name>.openvdb.grid''' || string || || OpenVDB grid name to read from the file
|}

===Type: dots===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "dots" || type of texture
|-
|'''scene.textures.<texture name>.inside''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.outside''' || texture || 0.0 || texture name or constant
|}

This texture supports 2D mapping.

===Type: fbm===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "fbm" || type of texture
|-
|'''scene.textures.<texture name>.octaves''' || int || 8 || noise octaves
|-
|'''scene.textures.<texture name>.roughness''' || float || 0.5 || noise roughness
|}

This texture supports 3D mapping.

===Type: fresnelapproxk===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "fresnelapproxk" || type of texture
|-
|'''scene.textures.<texture name>.texture''' || texture || (0.5, 0.5, 0.5) || texture name or constant
|}

===Type: fresnelapproxn===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "fresnelapproxn" || type of texture
|-
|'''scene.textures.<texture name>.texture''' || texture || (0.5, 0.5, 0.5) || texture name or constant
|}

===Type: hitpointalpha===

Use the value obtained by interpolating triangle vertices alphas.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "hitpointalpha" || type of texture
|}

===Type: hitpointcolor===

Use the color obtained by interpolating triangle vertices colors.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "hitpointcolor" || type of texture
|}

===Type: hitpointgrey===

Use the value obtained by interpolating triangle vertices colors, mapped to a float value (RGB converted into greyscale).

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "hitpointgrey" || type of texture
|-
|'''scene.textures.<texture name>.channel''' || int || -1 || the index of the RGB channel to use. -1 means the luminance of the RGB value
|}

===Type: hsv===

Hue saturation value manipulation.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "hsv" || type of texture
|-
|'''scene.textures.<texture name>.texture''' || texture || 0 0 0 || input color that will be manipulated
|-
|'''scene.textures.<texture name>.hue''' || texture || 0.5 || shift in hue (range: 0..1)
|-
|'''scene.textures.<texture name>.saturation''' || texture || 1.0 || saturation (range: 0..inf)
|-
|'''scene.textures.<texture name>.value''' || texture || 1.0 || brightness multiplier (range: 0..inf)
|}

===Type: imagemap===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "imagemap" || type of texture
|-
|'''scene.textures.<texture name>.file''' || string || "image.png" || name of the image file
|-
|'''scene.textures.<texture name>.gamma''' || float || 2.2 || gamma correction value used in the image
|-
|'''scene.textures.<texture name>.gain''' || float || 1.0 || image values are multiplied by gain value
|-
|'''scene.textures.<texture name>.storage''' || string || "auto" || select the type of memory storage: "auto", "byte", "half", "float"
|-
|'''scene.textures.<texture name>.wrap''' || string || "repeat" || select the type of image map wrapping mode: "repeat", "black", "white", "clamp"
|-
|'''scene.textures.<texture name>.channel''' || string || "default" || extract from the image only the selected channels: "default", "red", "green", "blue", "alpha", "mean", "colored_mean", "rgb"
|}

===Type: normalmap===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "normalmap" || type of texture
|-
|'''scene.textures.<texture name>.texture''' || texture || 0 0 0 || input. Is treated as an XYZ vector in tangent space.
|-
|'''scene.textures.<texture name>.scale''' || float || 1.0 || multiplier for adjusting normalmap height
|}

===Type: marble===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "marble" || type of texture
|-
|'''scene.textures.<texture name>.octaves''' || int || 8 || noise octaves
|-
|'''scene.textures.<texture name>.roughness''' || float || 0.5 || noise roughness
|-
|'''scene.textures.<texture name>.scale''' || float || 1.0 || marble scale
|-
|'''scene.textures.<texture name>.variation''' || float || 0.2 || marble variation
|}

This texture supports 3D mapping.

===Type: mix===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "mix" || type of texture
|-
|'''scene.textures.<texture name>.amount''' || texture || 0.5 || texture name or constant
|-
|'''scene.textures.<texture name>.texture1''' || texture || 0.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant
|}

===Type: scale===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "scale" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant
|}

===Type: uv===

This procedural texture has no parameters aside from the support of 2D mapping.

===Type: windy===

This procedural texture has no parameters aside from the support of 3D mapping.

===Type: wood===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "wood" || type of texture
|-
|'''scene.textures.<texture name>.woodtype''' || string || "bands" || "bands", "rings", "bandnoise" or "ringnoise"
|-
|'''scene.textures.<texture name>.noisebasis2''' || string || "sin" || "sin", "saw" or "tri"
|-
|'''scene.textures.<texture name>.noisetype''' || string || "soft_noise" || "soft_noise" or "hard_noise"
|-
|'''scene.textures.<texture name>.noisesize''' || float || 0.25 || noise size
|-
|'''scene.textures.<texture name>.turbulence''' || float || 5.0 || noise turbulence
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 || bright
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 || contrast
|}

This texture supports 3D mapping.

===Type: wrinkled===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "wrinkled" || type of texture
|-
|'''scene.textures.<texture name>.octaves''' || int || 8 || noise octaves
|-
|'''scene.textures.<texture name>.roughness''' || float || 0.5 || noise roughness
|}

This texture supports 3D mapping.

===Type: abs===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "abs" || type of texture
|-
|'''scene.textures.<texture name>.texture''' || texture || 1.0 || texture name or constant
|}

===Type: clamp===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "clamp" || type of texture
|-
|'''scene.textures.<texture name>.texture''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.min''' || float || 0.0 || lower boundary of the clamping
|-
|'''scene.textures.<texture name>.max''' || float || 1.0 || upper boundary of the clamping
|}

===Type: divide===

Note: If texture2 (the divisor) is 0, 0 is returned.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "divide" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant (dividend)
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant (divisor)
|}

===Type: remap===

This texture brings the value from the source range into the target range.

Note: The value is clamped into source range before performing the remap operation, and the resulting number is also clamped into the target range.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "remap" || type of texture
|-
|'''scene.textures.<texture name>.value''' || texture || 0.5 || texture name or constant
|-
|'''scene.textures.<texture name>.sourcemin''' || texture || 0.0 || texture name or constant
|-
|'''scene.textures.<texture name>.sourcemax''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.targetmin''' || texture || 0.0 || texture name or constant
|-
|'''scene.textures.<texture name>.targetmax''' || texture || 1.0 || texture name or constant
|}

===Type: objectid===

Raw object ID (range 0 to 0xfffffffe).

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "objectid" || type of texture
|}

===Type: objectidcolor===

Object ID interpreted as color. 
The object ID is a 4 byte unsigned int. To convert to color, the lower three bytes are interpreted as r, g, b values (each range 0 to 255). The highest byte is ignored.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "objectidcolor" || type of texture
|}

===Type: objectidnormalized===

Normalized object ID (range 0 to 1).

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "objectidnormalized" || type of texture
|}

===Type: dotproduct ===

Dot product of the two input vectors.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "dotproduct" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant
|}

===Type: power ===

pow(base, exponent)

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "power" || type of texture
|-
|'''scene.textures.<texture name>.base''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.exponent''' || texture || 1.0 || texture name or constant
|}

===Type: lessthan ===

returns 1 if texture1 < texture2, 0 if otherwise.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "lessthan" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant
|}

===Type: greaterthan ===

returns 1 if texture1 > texture2, 0 if otherwise.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "greaterthan" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant
|}

===Type: shadingnormal ===

Returns the shading normal of the mesh at the hitpoint.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "shadingnormal" || type of texture
|}

===Type: position ===

Returns the position of the hitpoint.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "position" || type of texture
|}

===Type: splitfloat3 ===

Extract a channel from a float3 texture. Can for example be used to get the R, G or B channel of a color texture, or to get the X, Y or Z components of a vector texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "splitfloat3" || type of texture
|-
|'''scene.textures.<texture name>.texture''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.channel''' || int || 0 || the channel to get from the input texture. 0 for first channel, 1 for second, 2 for third channel
|}

===Type: makefloat3 ===

Combine three float textures into one float3 texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "makefloat3" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture3''' || texture || 1.0 || texture name or constant
|}

===Type: blackbody===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blackbody" || type of texture
|-
|'''scene.textures.<texture name>.temperature''' || float || 6500 || emission temperature
|-
|'''scene.textures.<texture name>.normalize''' || bool || false || normalize the output
|}

===Type: irregulardata===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "irregulardata" || type of texture
|-
|'''scene.textures.<texture name>.wavelengths''' || vector || 580.0 620.0 660.0|| wavelenghts
|-
|'''scene.textures.<texture name>.data''' || vector || 0.0 0.000015 0.0|| data (length should match wavelength's length)
|}

===Type: lampspectrum===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "lampspectrum" || type of texture
|-
|'''scene.textures.<texture name>.name''' || string || "Daylight" || lamp light spectrum
|}

===Type: Fresnel Textures===

Textures for loading optical data

====Type: fresnelcolor====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || fresnelcolor || type of texture
|-
|'''scene.textures.<texture name>.kr''' || vector || 0.5 0.0 0.0 || reflection color
|}

====Type: fresnelpreset====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || fresnelpreset || type of texture
|-
|'''scene.textures.<texture name>.name''' || string || aluminium || fresnel preset ("aluminium", "silver", "copper", "gold" or "amorphous carbon")
|}

====Type: fresnelsopra====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || fresnelpreset || type of texture
|-
|'''scene.textures.<texture name>.file''' || string || ... || nk file path (e.g scenes/luxball/Au.nk)
|}

====Type: fresnelluxpop====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || fresnelpreset || type of texture
|-
|'''scene.textures.<texture name>.file''' || string || ... || nk file path (e.g scenes/luxball/Cr.nk)
|}

==Volumes==

Check [[LuxCoreRender_Volumes|LuxCoreRender Volumes]] for a high level description and examples of the volumes.

All volumes share these properties

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.volumes.<volume name>.type''' || string || clear || volume type
|-
|'''scene.volumes.<volume name>.priority''' || unsigned int|| 0|| volume priority (when volumes overlap, the one with highest priority overrides the others)
|-
|'''scene.volumes.<volume name>.ior''' || texture|| ... || index of refraction
|-
|'''scene.volumes.<volume name>.absorption''' || texture || ... || absorption texture
|-
|'''scene.volumes.<volume name>.emission ''' || texture || ... || emission
|-
|'''scene.volumes.<volume name>.emission.id ''' || unsigned int || ... || emission ID
|}

===Volume: Clear===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.volumes.<volume name>.type''' || string || clear || volume type
|}

===Volume: Homogeneous===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.volumes.<volume name>.type''' || string || homogeneous|| volume type
|-
|'''scene.volumes.<volume name>.scattering''' || texture || ... || scattering texture
|-
|'''scene.volumes.<volume name>.asymmetry''' || texture || ... || asymmetry texture
|-
|'''scene.volumes.<volume name>.multiscattering''' || bool || ... || multiscattering
|}

===Volume: Heterogeneous===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.volumes.<volume name>.type''' || string || heterogeneous || volume type
|-
|'''scene.volumes.<volume name>.scattering''' || texture || ... || scattering texture
|-
|'''scene.volumes.<volume name>.asymmetry''' || texture || ... || asymmetry texture
|-
|'''scene.volumes.<volume name>.multiscattering''' || bool || ... || multiscattering
|-
|'''scene.volumes.<volume name>.steps.size''' || float || ... || step size
|-
|'''scene.volumes.<volume name>.steps.maxcount''' || unsigned int || ... || step maximum count
|}

==Materials==

Check [[LuxCoreRender_Materials|LuxCoreRender Materials]] for a high level description and examples of the materials.

===Common properties===

Common material properties:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.bumptex''' || texture || || texture to use for the bump mapping
|-
|'''scene.materials.<material name>.normaltex''' || texture || || texture to use for the normal mapping
|-
|'''scene.materials.<material name>.samples''' || int || -1 || number of rays used to sample this material. -1 means use the default global value. This property is an hint and the render engine can ignore this information.
|-
|'''scene.materials.<material name>.visibility.indirect.diffuse.enable''' || bool || true || if this material is visible in indirect rays. This property is an hint and the render engine can ignore this information.
|-
|'''scene.materials.<material name>.visibility.indirect.glossy.enable''' || bool || true || if this material is visible in indirect rays. This property is an hint and the render engine can ignore this information.
|-
|'''scene.materials.<material name>.visibility.indirect.specular.enable''' || bool || true || if this material is visible in indirect rays. This property is an hint and the render engine can ignore this information.
|-
|'''scene.materials.<material name>.bumpsamplingdistance''' || float || 0.001 || set the offset used to sample bump/normal mapping.
|-
|'''scene.materials.<material name>.volume.interior''' || string || vol1 || name of interior volume (for volume rendering)
|-
|'''scene.materials.<material name>.volume.exterior''' || string || vol2 || name of exterior volume (for volume rendering)
|-
|'''scene.materials.<material name>.id''' || int|| ... || material id
|-
|'''scene.materials.<material name>.transparency''' || texture || 1.0 || transparency of the material. 1 for opaque, 0 for fully transparent
|-
|'''scene.materials.<material name>.shadowcatcher.enable''' || bool || false || If true, the material will be transparent where hit by direct light and opaque otherwise (alpha transparency). Used for compositing.
|}

====Normal maps====
Normal maps are set first as a texture type and then assigned to the material. For example:

<blockquote><pre>
scene.textures.normmap.type = imagemap
scene.textures.normmap.file = scenes/bump/normal.png
scene.textures.normmap.gamma = 1

scene.materials.mat_white.type = matte
scene.materials.mat_white.kd = 0.8 0.8 0.8
scene.materials.mat_white.normaltex = normmap
</pre></blockquote>

====Light emission====

All materials can emit light:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.emission''' || texture || 0.0 0.0 0.0 || color of the emitted light
|-
|'''scene.materials.<material name>.emission.gain''' || spectrum || 1.0 1.0 1.0 || multiplier for lamp brigthness
|-
|'''scene.materials.<material name>.emission.power''' || float || 0.0 || lamp output power in watts. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.materials.<material name>.emission.efficency''' || float || 0.0 || luminous efficacy in lumens/watt. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.materials.<material name>.emission.mapfile''' || string || || the name of an optional image map that can be used to scale the emitted light
|-
|'''scene.materials.<material name>.emission.gamma''' || float || 2.2 || gamma value of the image map defined with .mapfile property
|-
|'''scene.materials.<material name>.emission.iesfile''' || string || || a [http://en.wikipedia.org/wiki/Illuminating_Engineering_Society_of_North_America IES] profile of emitted light
|-
|'''scene.materials.<material name>.emission.iesblob''' || blob || || a [http://en.wikipedia.org/wiki/Illuminating_Engineering_Society_of_North_America IES] profile of emitted light embedded in a blob
|-
|'''scene.materials.<material name>.emission.flipz''' || bool || false || flip the IES profile along the Z axis
|-
|'''scene.materials.<material name>.emission.samples''' || int || -1 || the number of shadow ray to trace to compute direct light from this material. This property is an hint and the render engine can ignore this information. -1 means use the default global value.
|-
|'''scene.materials.<material name>.emission.map.width''' || unsigned int || 0 || scale the image or IES map to the specified width. 0 means use the original size
|-
|'''scene.materials.<material name>.emission.map.height''' || unsigned int || 0 || scale the image or IES map to the specified height. 0 means use the original size
|-
|'''scene.materials.<material name>.emission.id''' || int || 0 || the radiance group the light emitted from this material is assigned to.
|-
|'''scene.materials.<material name>.emission.theta''' || float || 90.0 || How directional the light is emitted, set as the half-angle of the light source. Default is 90°. Smaller values mean that more light is emitted in the direction of the face normals and less to the sides.
|-
|'''scene.materials.<material name>.emission.importance''' || float || 1.0 || A hint how often to sample this light source compared to other lights
|}

===Type: archglass===

This material should be used to replace glass material of windows when rendering architectural interiors. It allows direct light to pass trough.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "archglass" || type of material
|-
|'''scene.materials.<material name>.kr''' || texture || 1.0 1.0 1.0 || texture or constant reflected color of the material
|-
|'''scene.materials.<material name>.kt''' || texture || 1.0 1.0 1.0 || texture or constant transmitted color of the material
|-
|'''scene.materials.<material name>.interiorior''' || texture || 1.5 || inside texture or constant index of refraction (only for volume-less rendering)
|-
|'''scene.materials.<material name>.exteriorior''' || texture || 1.0 || outside texture or constant index of refraction (only for volume-less rendering)
|-
|'''scene.materials.<material name>.filmthickness''' || texture || none || thickness (in nanometers) of a [https://en.wikipedia.org/wiki/Thin-film_interference thin-film coating] on the surface. This property is optional, if it is not defined, the coating is disabled.
|-
|'''scene.materials.<material name>.filmior''' || texture || none || Refractive index of the thin-film coating. This property is optional, if it is not defined, the coating is disabled.
|}

===Type: carpaint===

Car Paint is an advanced glossy material, simulating a diffuse surface with mutliple reflective coatings.

The available presets for the carpaint material are:

*"ford f8"
*"polaris silber"
*"opel titan"
*"bmw339"
*"2k acrylack"
*"white"
*"blue"
*"blue matte"

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "carpaint" || type of material
|-
|'''scene.materials.<material name>.preset''' || string || "ford f8" || one of the avilable presets
|-
|'''scene.materials.<material name>.ka''' || texture || 0.0 0.0 0.0 || absorption color
|-
|'''scene.materials.<material name>.d''' || texture || 0.0 || absorption depth
|-
|'''scene.materials.<material name>.kd''' || texture || 0.0 0.0 0.0 || diffuse color
|-
|'''scene.materials.<material name>.ks1''' || texture || 0.0 0.0 0.0 || specular color - layer 1
|-
|'''scene.materials.<material name>.ks2''' || texture || 0.0 0.0 0.0 || specular color - layer 2
|-
|'''scene.materials.<material name>.ks3''' || texture || 0.0 0.0 0.0 || specular color - layer 3
|-
|'''scene.materials.<material name>.r1''' || texture || 0.0 0.0 0.0 || fresnel effect strength - layer 1
|-
|'''scene.materials.<material name>.r2''' || texture || 0.0 0.0 0.0 || fresnel effect strength - layer 2
|-
|'''scene.materials.<material name>.r3''' || texture || 0.0 0.0 0.0 || fresnel effect strength - layer 3
|-
|'''scene.materials.<material name>.m1''' || texture || 0.0 0.0 0.0 || roughness - layer 1
|-
|'''scene.materials.<material name>.m2''' || texture || 0.0 0.0 0.0 || roughness - layer 2
|-
|'''scene.materials.<material name>.m3''' || texture || 0.0 0.0 0.0 || roughness - layer 3
|}

===Type: cloth===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "cloth" || type of material
|-
|'''scene.materials.<material name>.preset''' || string || "denim" || denim, silk_charmeuse, silk_shantung, cotton_twill, wool_garbardine or polyester_lining_cloth
|-
|'''scene.materials.<material name>.weft_kd''' || texture || 0.5 0.5 0.5 || coefficient of diffuse reflection in one weave direction
|-
|'''scene.materials.<material name>.weft_ks''' || texture || 0.5 0.5 0.5 || coefficient of specular reflection in one weave direction
|-
|'''scene.materials.<material name>.warp_kd''' || texture || 0.5 0.5 0.5 || coefficient of diffuse reflection in the opposite weave direction
|-
|'''scene.materials.<material name>.warp_ks''' || texture || 0.5 0.5 0.5 || coefficient of specular reflection in the opposite weave direction
|-
|'''scene.materials.<material name>.repeat_u''' || float || 100.0 || thread count in the u direction
|-
|'''scene.materials.<material name>.repeat_v''' || float || 100.0 || thread count in the v direction
|}

===Type: disney===

For more details, refer to the [https://disney-animation.s3.amazonaws.com/library/s2012_pbs_disney_brdf_notes_v2.pdf original paper].

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "disney" || type of material
|-
|'''scene.materials.<material name>.basecolor''' || texture || 0.5 0.5 0.5 || Base color
|-
|'''scene.materials.<material name>.subsurface''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.roughness''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.metallic''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.specular''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.speculartint''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.clearcoat''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.clearcoatgloss''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.anisotropic''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.sheen''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.sheentint''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.filmamount''' || texture || none || Linear interpolation between no film (0) and full film effect (1) for artistic control. This property is optional, if it is not defined, the coating is disabled.
|-
|'''scene.materials.<material name>.filmthickness''' || texture || none || thickness (in nanometers) of a [https://en.wikipedia.org/wiki/Thin-film_interference thin-film coating] on the surface. This property is optional, if it is not defined, the coating is disabled.
|-
|'''scene.materials.<material name>.filmior''' || texture || none || Refractive index of the thin-film coating. This property is optional, if it is not defined, the coating is disabled.
|}

===Type: glass===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "glass" || type of material
|-
|'''scene.materials.<material name>.kr''' || texture || 1.0 || texture or constant reflected color of the material
|-
|'''scene.materials.<material name>.kt''' || texture || 1.0 || texture or constant transmitted color of the material
|-
|'''scene.materials.<material name>.interiorior''' || texture || 1.5 || inside texture or constant index of refraction (only for volume-less rendering)
|-
|'''scene.materials.<material name>.exteriorior''' || texture || 1.0 || outside texture or constant index of refraction (only for volume-less rendering)
|-
|'''scene.materials.<material name>.cauchyc''' || texture || 0.0 || if defined and > 0.0, enable dispersion. The value is the C term of the [https://en.wikipedia.org/wiki/Cauchy%27s_equation Cauchy's equation]
|-
|'''scene.materials.<material name>.filmthickness''' || texture || none || thickness (in nanometers) of a [https://en.wikipedia.org/wiki/Thin-film_interference thin-film coating] on the surface. This property is optional, if it is not defined, the coating is disabled.
|-
|'''scene.materials.<material name>.filmior''' || texture || none || Refractive index of the thin-film coating. This property is optional, if it is not defined, the coating is disabled.
|}

===Type: glossy2===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "glossy2" || type of material
|-
|'''scene.materials.<material name>.kd''' || texture || 0.5 0.5 0.5 || texture or constant diffuse color of the material
|-
|'''scene.materials.<material name>.ks''' || texture || 0.5 0.5 0.5 || texture or constant specular color of the material
|-
|'''scene.materials.<material name>.uroughness''' || texture || 0.1 || texture or constant roughness value along u coordinate of the material
|-
|'''scene.materials.<material name>.vroughness''' || texture || 0.1 || texture or constant roughness value along v coordinate of the material
|-
|'''scene.materials.<material name>.ka''' || texture || 0.0 0.0 0.0 || texture or constant value of coefficient of absorption of the coating layer
|-
|'''scene.materials.<material name>.d''' || texture || 0.0 || texture or constant value of the depth (thickness) of the coating layer for absorption effects. (0 = disables)
|-
|'''scene.materials.<material name>.index''' || texture || 0.0 0.0 0.0 || IOR of the coating. IOR overrides color Ks if both are specified
|-
|'''scene.materials.<material name>.multibounce''' || bool || false || simulation of asperity (velvet-like reflection) on the glossy surface
|}

===Type: glossytranslucent===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "glossytranslucent" || type of material
|-
|'''scene.materials.<material name>.kd''' || texture || 0.5 0.5 0.5 || texture or constant diffuse color of the material
|-
|'''scene.materials.<material name>.kt''' || texture || 0.5 0.5 0.5 || texture or constant transmission color of the material
|-
|'''scene.materials.<material name>.ks''' || texture || 0.5 0.5 0.5 || texture or constant specular color of the material
|-
|'''scene.materials.<material name>.ks_bf''' || texture || 0.5 0.5 0.5 || texture or constant backface specular color of the material
|-
|'''scene.materials.<material name>.uroughness''' || texture || 0.1 || texture or constant roughness value along u coordinate of the material
|-
|'''scene.materials.<material name>.uroughness_bf''' || texture || 0.1 || texture or constant backface roughness value along u coordinate of the material
|-
|'''scene.materials.<material name>.vroughness''' || texture || 0.1 || texture or constant roughness value along v coordinate of the material
|-
|'''scene.materials.<material name>.vroughness_bf''' || texture || 0.1 || texture or constant backface roughness value along v coordinate of the material
|-
|'''scene.materials.<material name>.ka''' || texture || 0.0 0.0 0.0 || texture or constant value of coefficient of absorption of the coating layer
|-
|'''scene.materials.<material name>.ka_bf''' || texture || 0.0 0.0 0.0 || texture or constant value of backface coefficient of absorption of the coating layer
|-
|'''scene.materials.<material name>.d''' || texture || 0.0 || texture or constant value of the depth (thickness) of the coating layer for absorption effects. (0 = disables)
|-
|'''scene.materials.<material name>.d_bf''' || texture || 0.0 || texture or constant value of the backface depth (thickness) of the coating layer for absorption effects. (0 = disables)
|-
|'''scene.materials.<material name>.index''' || texture || 0.0 0.0 0.0 || IOR of the coating. IOR overrides color Ks if both are specified
|-
|'''scene.materials.<material name>.index_bf''' || texture || 0.0 0.0 0.0 || IOR of the backface coating. IOR overrides color Ks if both are specified
|-
|'''scene.materials.<material name>.multibounce''' || bool || false || simulation of asperity (velvet-like reflection) on the glossy surface
|-
|'''scene.materials.<material name>.multibounce_bf''' || bool || false || backface simulation of asperity (velvet-like reflection) on the glossy surface
|}

===Type: glossycoating===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "glossycoating" || type of material
|-
|'''scene.materials.<material name>.base''' || string || || name of base material, the coating layer is added on top of this material
|-
|'''scene.materials.<material name>.ks''' || texture || 0.5 0.5 0.5 || texture or constant specular color of the material
|-
|'''scene.materials.<material name>.uroughness''' || texture || 0.1 || texture or constant roughness value along u coordinate of the material
|-
|'''scene.materials.<material name>.vroughness''' || texture || 0.1 || texture or constant roughness value along v coordinate of the material
|-
|'''scene.materials.<material name>.ka''' || texture || 0.0 0.0 0.0 || texture or constant value of coefficient of absorption of the coating layer
|-
|'''scene.materials.<material name>.d''' || texture || 0.0 || texture or constant value of the depth (thickness) of the coating layer for absorption effects. (0 = disables)
|-
|'''scene.materials.<material name>.index''' || texture || 0.0 0.0 0.0 || IOR of the coating. IOR overrides color Ks if both are specified
|-
|'''scene.materials.<material name>.multibounce''' || bool || false || simulation of asperity (velvet-like reflection) on the glossy surface
|}

===Type: matte===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "matte" || type of material
|-
|'''scene.materials.<material name>.kd''' || texture || 0.75 0.75 0.75 || texture or constant color of the matte material
|}

===Type: mattetranslucent===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "mattetranslucent" || type of material
|-
|'''scene.materials.<material name>.kr''' || texture || 0.5 0.5 0.5 || texture or constant reflected color of the material
|-
|'''scene.materials.<material name>.kt''' || texture || 0.5 0.5 0.5 || texture or constant transmitted color of the material
|}

===Type: metal2===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "metal2" || type of material
|-
|'''scene.materials.<material name>.fresnel''' || fresnel texture || ... || [[#Type:_Fresnel_Textures | fresnel texture]]
|-
|'''scene.materials.<material name>.uroughness''' || texture || 0.1 || texture or constant roughness value along u coordinate of the material
|-
|'''scene.materials.<material name>.vroughness''' || texture || 0.1 || texture or constant roughness value along v coordinate of the material
|-
|'''scene.materials.<material name>.preset''' || string || "aluminium" || (DEPRECATED) "aluminium", "silver", "copper", "gold" or "amorphous carbon"
|-
|'''scene.materials.<material name>.n''' || texture || 0.5 0.5 0.5 || (DEPRECATED) texture or constant value. It can be used to directly define a fresnelapproxn texture on overwrite the .preset property
|-
|'''scene.materials.<material name>.k''' || texture || 0.5 0.5 0.5 || (DEPRECATED) texture or constant value. It can be used to directly define a fresnelapproxk texture on overwrite the .preset property
|}

===Type: mirror===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "mirror" || type of material
|-
|'''scene.materials.<material name>.kr''' || texture || 1.0 1.0 1.0 || texture or constant reflected color of the material
|}

===Type: mix===

This material can be used to mix 2 other materials.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "mix" || type of material
|-
|'''scene.materials.<material name>.material1''' || string || mat1 || name of another material
|-
|'''scene.materials.<material name>.material2''' || string || mat2 || name of another material
|-
|'''scene.materials.<material name>.amount''' || texture || 0.5 || texture or constant value used to mix the materials
|}

===Type: null===

This is empty, not visible material. It can be combined by using mix material with others. It is often used in combination with the alpha channel of an image map to render leafs, etc.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "null" || type of material
|}

===Type: roughglass===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "roughglass" || type of material
|-
|'''scene.materials.<material name>.kr''' || texture || 1.0 1.0 1.0 || texture or constant reflected color of the material
|-
|'''scene.materials.<material name>.kt''' || texture || 1.0 1.0 1.0 || texture or constant transmitted color of the material
|-
|'''scene.materials.<material name>.interiorior''' || texture || 1.5 || inside texture or constant index of refraction
|-
|'''scene.materials.<material name>.exteriorior''' || texture || 1.0 || outside texture or constant index of refraction
|-
|'''scene.materials.<material name>.uroughness''' || texture || 0.1 || texture or constant roughness value along u coordinate of the material
|-
|'''scene.materials.<material name>.vroughness''' || texture || 0.1 || texture or constant roughness value along v coordinate of the material
|-
|'''scene.materials.<material name>.filmthickness''' || texture || none || thickness (in nanometers) of a [https://en.wikipedia.org/wiki/Thin-film_interference thin-film coating] on the surface. This property is optional, if it is not defined, the coating is disabled.
|-
|'''scene.materials.<material name>.filmior''' || texture || none || Refractive index of the thin-film coating. This property is optional, if it is not defined, the coating is disabled.
|}

===Type: roughmatte===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "roughmatte" || type of material
|-
|'''scene.materials.<material name>.kd''' || texture || 0.75 0.75 0.75 || texture or constant color of the roughmatte material
|-
|'''scene.materials.<material name>.sigma''' || texture || 0.0 || the sigma parameter in the Oren-Nayer shader in degrees. Zero for pure Lambertian reflection
|}

===Type: velvet===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "velvet" || type of material
|-
|'''scene.materials.<material name>.kd''' || texture || 0.5 0.5 0.5 || color of the material's fuzz
|-
|'''scene.materials.<material name>.p1''' || texture || -2.0 || polynomial that influences the fuzz
|-
|'''scene.materials.<material name>.p2''' || texture || 20.0 || polynomial that influences the fuzz
|-
|'''scene.materials.<material name>.p3''' || texture || 2.0 || polynomial that influences the fuzz
|-
|'''scene.materials.<material name>.thickness''' || texture || 0.1 || height of the fuzz
|}

==Objects==

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.objects.<object name>.material''' || string || || type of object material
|-
|'''scene.objects.<object name>.shape''' || string || || name of [[#Shapes | shape]] with the triangle mesh description.Memory required to store the triangle mesh information is allocated only once if 2 or more different objects share the same shape, use .transformation property and true instancing is enabled.
|-
|'''scene.objects.<object name>.ply''' || string || || '''(Deprecated, use .shape instead)''' name of [http://en.wikipedia.org/wiki/PLY_(file_format) PLY] file with the triangle mesh description. Memory required to store the triangle mesh information is allocated only once if 2 or more different objects share the same file, use .transformation property and true instancing is enabled.
|-
|'''scene.objects.<object name>.transformation''' || matrix 4x4 || 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 || transformation matrix
|-
|'''scene.objects.<object name>.vertices''' || float || || This is an alternative syntax to using PLY file. It is an in-lined definition of the triangle mesh. It is a list of float values defining the vertices of the mesh (i.e. 3 coordinates for each vertex).
|-
|'''scene.objects.<object name>.faces''' || unsigned int || || This is an alternative syntax to using PLY file. It is an in-lined definition of the triangle mesh. It is a list of unsigned int values defining the triangles of the mesh (i.e. 3 index of vertices for each triangle).
|-
|'''scene.objects.<object name>.id''' || unsigned int || || object ID
|-
|'''scene.objects.<object name>.camerainvisible''' || bool || false || toggle visibility for camera rays. If set to true, the object will not show up in camera rays, but it will still be visible in reflections, refractions, shadows, indirect light etc.
|}

===Object Motion Blur===

LuxCore supports transformation motion blur for objects.
Motion blur is enabled if an object has a motion system defined as described below.

A motion system consists of steps (at least 2). Each step has a time (in seconds) and a transformation matrix of the object at this point in time.
Step indices start at 0. The times have to be monotonic (each greater than the last).

Note that the embree accelerator only supports a maximum of 129 time steps.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.objects.<object name>.motion.<step>.time''' || float || || time (in seconds) of the step
|-
|'''scene.objects.<object name>.motion.<step>.transformation''' || matrix 4x4 || 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 || transformation matrix of the object at the given step
|-
|}

==Shapes==

===Type: mesh===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.shapes.<shape name>.type''' || string || "mesh" || mesh shape
|-
|'''scene.shapes.<shape name>.ply''' || string || ... || mesh path (e.g ''scenes/luxball/luxball-shell.ply'')
|-
|'''scene.shapes.<shape name>.appliedtransformation''' || Matrix4x4 || 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0|| transformation matrix applied to the mesh vertices. Used to define the local object reference space.
|}

===Type: inlinedmesh===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.shapes.<shape name>.type''' || string || "inlinedmesh" || inlinedmesh shape
|-
|'''scene.shapes.<shape name>.vertices''' || vector || ... || inlinedmesh vertices (e.g 0.0 0.0 0.0 1.0 0.0 0.0 0.0 1.0 0.0)
|-
|'''scene.shapes.<shape name>.faces''' || vector || ... || inlinedmesh faces (e.g 0 1 2)
|-
|'''scene.shapes.<shape name>.appliedtransformation''' || Matrix4x4 || 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0|| transformation matrix applied to the mesh vertices. Used to define the local object reference space.
|}

===Type: pointiness===

Contains surface curvature information in vertex alpha channel. 
You can access this information in materials via a hitpointalpha texture. 
The values range from -1 to 1 (float). 
Values from -1 to 0 are concave, while values from 0 to 1 are convex.

[[ Shape:_Pointiness | Examples ]]

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.shapes.<shape name>.type''' || string || "pointiness" || pointiness shape
|-
|'''scene.shapes.<shape name>.source''' || string || ... || pointiness source (a mesh shape)
|}

===Type: strands===

Can be used for hair, fur, grass etc. 
Note that you need to define the camera before defining any strands shapes, because the tesselation process is viewpoint-dependent.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.shapes.<shape name>.type''' || string || "strands" || strands shape
|-
|'''scene.shapes.<shape name>.file''' || string || ... || strands file (''scenes/strands/straight.hair'')
|}

====Strands tessellation methods====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.shapes.<shape name>.tessellation.type''' || string || "ribbon" || ribbon tessellation
|-
|'''scene.shapes.<shape name>.tessellation.usecameraposition''' || bool || 1 || use camera position
|}

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.shapes.<shape name>.tessellation.type''' || string || "ribbonadaptive" || ribbon adaptive tessellation method
|-
|'''scene.shapes.<shape name>.tessellation.adaptative.maxdepth''' || unsigned int || 12 || max tessellation depth
|-
|'''scene.shapes.<shape name>.tessellation.adaptative.error ''' || float || 0.0075 || max tessellation error
|}

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.shapes.<shape name>.tessellation.type''' || string || "solid" || solid tessellation method
|-
|'''scene.shapes.<shape name>.tessellation.solid.sidecount ''' || unsigned int || 12 || tessellation's side count
|}

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.shapes.<shape name>.tessellation.type''' || string || "solidadaptive" || solidadaptive tessellation method
|-
|'''scene.shapes.<shape name>.tessellation.solidadaptive.sidecount ''' || unsigned int || 8 || tessellation's side count
|-
|'''scene.shapes.<shape name>.tessellation.solidadaptive.maxdepth''' || unsigned int || 16 || tessellation's max depth
|-
|'''scene.shapes.<shape name>.tessellation.solidadaptive.error''' || float || 0.05 || tessellation's max error
|}

===Type: group===

Todo.

===Type: displacement===

Todo.

===Type: subdiv===

Todo.

===Type: harlequin===

Todo.

===Type: simplify===

Todo.

===Type: islandaov===

Todo.

===Type: randomtriangleaov===

Todo.

==Light sources==

Check [[Lighting|LuxCoreRender Lighting]] for an high level description and example of the light sources.

===Common parameters===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.gain''' || spectrum || 1.0 1.0 1.0 || intensity of the light
|-
|'''scene.lights.<light name>.transformation''' || matrix 4x4 || 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 || transformation matrix
|-
|'''scene.lights.<light name>.samples''' || int || -1 || the number of shadow ray to trace to compute direct light for this light source. This property is an hint and the render engine can ignore this information. -1 means use the default global value.
|-
|'''scene.lights.<light name>.id''' || int || 0 || the radiance group the light emitted from this material is assigned to.

|-
|'''scene.lights.<light name>.importance''' || float || 1.0 || A hint how often to sample this light compared to other lights
|}

===Type: sun===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "sun" || type of light
|-
|'''scene.lights.<light name>.turbidity''' || float || 2.2 || turbidity can go from 1.0 to 30+. 2-6 are most useful for clear days
|-
|'''scene.lights.<light name>.relsize''' || float || 1.0 || relative size to the sun
|-
|'''scene.lights.<light name>.dir''' || vector || 0.0 0.0 1.0 || direction vector of the sun
|-
|'''scene.lights.<light name>.visibility.indirect.diffuse.enable''' || bool || true || if the light source is visible by indirect rays on diffuse surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.visibility.indirect.glossy.enable''' || bool || true || if the light source is visible by indirect rays on glossy surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.visibility.indirect.specular.enable''' || bool || true || if the light source is visible by indirect rays on specular surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|}

===Type: sky2===

Hosek-Wilkie sky model.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "sky2" || type of light
|-
|'''scene.lights.<light name>.turbidity''' || float || 2.2 || turbidity can go from 1.0 to 30+. 2-6 are most useful for clear days
|-
|'''scene.lights.<light name>.dir''' || vector || 0.0 0.0 1.0 || direction vector of the sun
|-
|'''scene.lights.<light name>.gain''' || vector || ... || gain
|-
|'''scene.lights.<light name>.groundalbedo''' || vector || 0.5 0.5 0.5 || ground albedo
|-
|'''scene.lights.<light name>.visibility.indirect.diffuse.enable''' || bool || true || if the light source is visible by indirect rays on diffuse surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.visibility.indirect.glossy.enable''' || bool || true || if the light source is visible by indirect rays on glossy surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.visibility.indirect.specular.enable''' || bool || true || if the light source is visible by indirect rays on specular surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.ground.enable''' || bool || 1 || enable ground color
|-
|'''scene.lights.<light name>.ground.color''' || vector|| ... || RGB ground color
|}

===Type: infinite===

Spherical lightsource surrounding the scene at infinite distance. 
Used for image based lighting (IBL) and HDR environment lighting if the file is a high dynamic range image.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "infinite" || type of light
|-
|'''scene.lights.<light name>.file''' || string || "image.png" || filename of the environment map
|-
|'''scene.lights.<light name>.gamma''' || float || 2.2 || gamma correction used by the image map
|-
|'''scene.lights.<light name>.storage''' || string || "auto" || environment map storage type ("auto", "byte", "half" or "float")
|-
|'''scene.lights.<light name>.visibility.indirect.diffuse.enable''' || bool || true || if the light source is visible by indirect rays on diffuse surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.visibility.indirect.glossy.enable''' || bool || true || if the light source is visible by indirect rays on glossy surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.visibility.indirect.specular.enable''' || bool || true || if the light source is visible by indirect rays on specular surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.sampleupperhemisphereonly''' || bool || false || an option set to black the lower hemisphere. Mostly useful for shadow catchers.
|}

===Type: point===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "point" || type of light
|-
|'''scene.lights.<light name>.position''' || point || 0.0 0.0 0.0 || position
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.power''' || float || 0.0 || lamp output power in watts. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.efficency''' || float || 0.0 || luminous efficacy in lumens/watt. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|}

===Type: mappoint===

Point light with support for IES files or image maps controlling the strength of light emitted.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "mappoint" || type of light
|-
|'''scene.lights.<light name>.position''' || point || 0.0 0.0 0.0 || position
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.power''' || float || 0.0 || lamp output power in watts. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.efficency''' || float || 0.0 || luminous efficacy in lumens/watt. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.mapfile''' || string || || the name of an optional image map that can be used to scale the emitted light
|-
|'''scene.lights.<light name>.gamma''' || float || 2.2 || gamma value of the image map defined with .mapfile property
|-
|'''scene.lights.<light name>.iesfile''' || string || || a [http://en.wikipedia.org/wiki/Illuminating_Engineering_Society_of_North_America IES] profile of emitted light and the render engine can ignore this information. -1 means use the default global value.
|-
|'''scene.lights.<light name>.iesblob''' || string || || a [http://en.wikipedia.org/wiki/Illuminating_Engineering_Society_of_North_America IES] profile of emitted light embedded in a blob
|-
|'''scene.lights.<light name>.flipz''' || bool || false || flip the IES profile along the Z axis
|-
|'''scene.lights.<light name>.map.width''' || unsigned int || 0 || scale the image or IES map to the specified width. 0 means use the original size
|-
|'''scene.lights.<light name>.map.height''' || unsigned int || 0 || scale the image or IES map to the specified height. 0 means use the original size
|}

===Type: sphere===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "sphere" || type of light
|-
|'''scene.lights.<light name>.position''' || point || 0.0 0.0 0.0 || position
|-
|'''scene.lights.<light name>.radius''' || float || 1.0 || position
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.power''' || float || 0.0 || lamp output power in watts. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.efficency''' || float || 0.0 || luminous efficacy in lumens/watt. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|}

===Type: mapsphere===

Sphere light with support for IES files or image maps controlling the strength of light emitted.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "mapsphere" || type of light
|-
|'''scene.lights.<light name>.position''' || point || 0.0 0.0 0.0 || position
|-
|'''scene.lights.<light name>.radius''' || float || 1.0 || position
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.power''' || float || 0.0 || lamp output power in watts. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.efficency''' || float || 0.0 || luminous efficacy in lumens/watt. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.mapfile''' || string || || the name of an optional image map that can be used to scale the emitted light
|-
|'''scene.lights.<light name>.gamma''' || float || 2.2 || gamma value of the image map defined with .mapfile property
|-
|'''scene.lights.<light name>.iesfile''' || string || || a [http://en.wikipedia.org/wiki/Illuminating_Engineering_Society_of_North_America IES] profile of emitted light and the render engine can ignore this information. -1 means use the default global value.
|-
|'''scene.lights.<light name>.iesblob''' || string || || a [http://en.wikipedia.org/wiki/Illuminating_Engineering_Society_of_North_America IES] profile of emitted light embedded in a blob
|-
|'''scene.lights.<light name>.flipz''' || bool || false || flip the IES profile along the Z axis
|-
|'''scene.lights.<light name>.map.width''' || unsigned int || 0 || scale the image or IES map to the specified width. 0 means use the original size
|-
|'''scene.lights.<light name>.map.height''' || unsigned int || 0 || scale the image or IES map to the specified height. 0 means use the original size
|}

===Type: spot===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "spot" || type of light
|-
|'''scene.lights.<light name>.position''' || point || 0.0 0.0 0.0 || position
|-
|'''scene.lights.<light name>.target''' || point || 0.0 0.0 1.0 || target
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.power''' || float || 0.0 || lamp output power in watts. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.efficency''' || float || 0.0 || luminous efficacy in lumens/watt. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.coneangle''' || float || 30.0 || angle in degrees of the spotlight cone
|-
|'''scene.lights.<light name>.conedeltaangle''' || float || 5.0 || angle at which the spotlight intensity starts to fade from the edge
|}

===Type: projection===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "projection" || type of light
|-
|'''scene.lights.<light name>.position''' || point || 0.0 0.0 0.0 || position
|-
|'''scene.lights.<light name>.target''' || point || 0.0 0.0 1.0 || target
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.power''' || float || 0.0 || lamp output power in watts. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.efficency''' || float || 0.0 || luminous efficacy in lumens/watt. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.fov''' || float || 45.0 || field of view in terms of angular spread along the shorter image axis
|-
|'''scene.lights.<light name>.mapfile''' || string || || filename of the image to project. If not specified, a constat light color will be used.
|-
|'''scene.lights.<light name>.gamma''' || float || 2.2 || gamma value of the image map defined with .mapfile property
|}

===Type: constantinfinite===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "constantinfinite" || type of light
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.visibility.indirect.diffuse.enable''' || bool || true || if the light source is visible by indirect rays on diffuse surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.visibility.indirect.glossy.enable''' || bool || true || if the light source is visible by indirect rays on glossy surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.visibility.indirect.specular.enable''' || bool || true || if the light source is visible by indirect rays on specular surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|}

===Type: sharpdistant===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "sharpdistant" || type of light
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.direction''' || vector || 0.0 0.0 1.0 || direction
|}

===Type: distant===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "distant" || type of light
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.direction''' || vector || 0.0 0.0 1.0 || direction
|-
|'''scene.lights.<light name>.theta''' || float || 10.0 || half angle of the light source in degree. Must be > 0 for soft shadows
|}

===Type: laser===

A light source emitting parallel light rays (like sharpdistant light, but starting inside the scene instead of infinitely far away).

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "laser" || type of light
|-
|'''scene.lights.<light name>.position''' || point || 0.0 0.0 0.0 || position
|-
|'''scene.lights.<light name>.target''' || point || 0.0 0.0 1.0 || target
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.power''' || float || 0.0 || lamp output power in watts. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.efficency''' || float || 0.0 || luminous efficacy in lumens/watt. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.radius''' || float || 0.01 || radius of the laser beam
|}

LuxCore SDL Reference Manual v2.5

2020-08-27T13:50:46Z

Byob: Created page with "The scene description language (SDL) is used to configure the renderer and to define objects, materials, textures etc. in the scene. The file ending of the render configur..."

The scene description language (SDL) is used to configure the renderer and to define objects, materials, textures etc. in the scene. 
The file ending of the render configuration file is ".cfg", for the scene file it's ".scn".

These files are usually created by exporter plugins, e.g. BlendLuxCore. 
This wiki page is primarily a reference for exporter developers, normal end-users should not need to edit cfg/scn files by hand.

Sometimes the API is updated faster than the wiki, in this case you can look at the code directly: https://github.com/LuxCoreRender/LuxCore/tree/master/src/slg/scene

Note that matrices are passed as flat lists in column-major form.

=Render configuration file=

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''resumerendering.filesafe''' || bool || 1 || enable/disable "safe save" mode for resume rendering file. A backup of the output is always valid even in the case of a system failure
|}

==Seed==

The global seed value that is used to generate random numbers. 
Two images rendered with the same seed will have the same noise pattern.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''renderengine.seed''' || unsigned int || 1 || min 1
|}

==Periodic save==

Options related to periodic save operations.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''periodicsave.resumerendering.period''' || float || 0 || save the resume rendering file every specified amount of time (value in seconds). A value <= 0.0 disable the saving
|-
|'''periodicsave.resumerendering.filename''' || string || "resume.rsm" || the name to use to save the rendering resume information periodically
|-
|'''periodicsave.film.period''' || float || 0 || save the Film every specified amount of time (value in seconds). A value <= 0.0 disable the saving
|-
|'''periodicsave.film.filename''' || string || "film.flm" || the name to use to save the film periodically
|-
|'''periodicsave.film.outputs.period''' || float || 600 || save all Film outputs every specified amount of time (value in seconds). A value <= 0.0 disable the saving
|}

==Render Engine==

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''renderengine.type''' || string || "PATHCPU" || engine type
|}

=== CPU Render Engines ===

CPU render engines are written in C++ and don't require OpenCL. All CPU render engines accept the following parameters:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''native.threads.count''' || int || CPU core count || > 0 || > 0 || The number of threads will be used for the rendering
|}

'''The following CPU engines are available:'''

===="PATHCPU"====

A path tracer with full image plane rendering (i.e. supporting Metropolis sampler).

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''path.pathdepth.total''' || int || 6 || > 0 || [1, 16] || Maximum recursion depth of a path
|-
|'''path.pathdepth.diffuse''' || int || 4 || > 0 || [1, 16] ||
|-
|'''path.pathdepth.glossy''' || int || 4 || > 0 || [1, 16] ||
|-
|'''path.pathdepth.specular''' || int || 6 || > 0 || [1, 16] ||
|-
|'''path.russianroulette.depth''' || int || 3 || > 0 || [1, path.maxdepth] || The path depth where Russian Roulette stars to be used
|-
|'''path.russianroulette.cap''' || float || 0.5 || [0.0, 1.0] || [0.0, 1.0] || The threshold over which Russian Roulette is used
|-
|'''path.clamping.variance.maxvalue''' || float || 0.0 || > 0.0 || > 0.0 || Samples brighter than this value are clamped, helps to reduce fireflies. 0.0 = disabled
|-
|'''path.forceblackbackground.enable''' || bool || 0 || 0 or 1 || 0 or 1 || Enable when rendering with transparent film and premultiplied alpha, to avoid artifacts with semi-transparent areas
|}

===="TILEPATHCPU"====
Biased path tracer with many control options and support for tile rendering. 
The sampler must be set to TILEPATHSAMPLER when using this engine.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''path.pathdepth.total''' || int || 6 || > 0 || [1, 16] || Maximum recursion depth of a path
|-
|'''path.pathdepth.diffuse''' || int || 4 || > 0 || [1, 16] ||
|-
|'''path.pathdepth.glossy''' || int || 4 || > 0 || [1, 16] ||
|-
|'''path.pathdepth.specular''' || int || 6 || > 0 || [1, 16] ||
|-
|'''path.russianroulette.depth''' || int || 3 || > 0 || [1, path.maxdepth] || The path depth where Russian Roulette stars to be used
|-
|'''path.russianroulette.cap''' || float || 0.5 || [0.0, 1.0] || [0.0, 1.0] || The threshold over which Russian Roulette is used
|-
|'''path.clamping.variance.maxvalue''' || float || 0.0 || > 0.0 || > 0.0 || Samples brighter than this value are clamped, helps to reduce fireflies. 0.0 = disabled
|-
|'''path.forceblackbackground.enable''' || bool || 0 || 0 or 1 || 0 or 1 || Enable when rendering with transparent film and premultiplied alpha, to avoid artifacts with semi-transparent areas
|-
|'''tilepath.sampling.aa.size''' || int || 3 || > 0 || [1, 13] || All diffuse/glossy/specular samples are multiplied with the squared aa size: final_samples = aa^2 * (diffuse^2 + glossy^2 + specular^2)
|-
|'''tile.size''' || int || 32 || ≥ 8 || [8, 256] || Tile size in pixels
|-
|'''tile.multipass.enable''' || bool || 1 || 0 or 1 || o or 1 || Re-render the image until a halt threshold is met or indefinitely
|-
|'''tile.multipass.convergencetest.threshold''' || float || 6.0 / 256.0 || > 0.0 || [1.0 / 256.0, 6.0 / 256.0] || Target noise level
|-
|'''tile.multipass.convergencetest.threshold.reduction''' || float || 0.0 || [0.0, 1.0] || [0.75, 0.95] || Multiply noise level with this number when all tiles have met the previous noise level. Set to 0 to disable (so rendering will stop at the noise level)
|-
|'''tile.multipass.convergencetest.warmup.count''' || int || 32 || ≥ 0 || [8, 128] || Warm up period for the convergence test expressed in samples per pixel
|}

===="BIDIRCPU"====

A Bidirectional path tracer.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''path.maxdepth''' || int || 5 || > 0 || [1, 16] || Maximum recursion depth of a eye path
|-
|'''light.maxdepth''' || int || 5 || > 0 || [1, 16] || Maximum recursion depth of a light path
|-
|'''path.russianroulette.depth''' || int || 3 || > 0 || [1, path.maxdepth] || The path depth where Russian Roulette starts to be used
|-
|'''path.russianroulette.cap''' || float || 0.5 || [0.0, 1.0] || [0.0, 1.0] || The threshold over which Russian Roulette is used
|}

===="RTPATHCPU"====
Engine optimized for interactive scene editing and camera movement. 
The sampler must be set to RTPATHCPUSAMPLER when using this engine.

Supports the same properties as [[#"PATHCPU" | "PATHCPU"]] plus the following:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''rtpathcpu.zoomphase.size''' || int || 4 || || || render scaled down film for the first few frames after a scene edit (to make interactions more fluid)
|-
|'''rtpathcpu.zoomphase.weight''' || float || 0.1 || || || description: TODO
|}

=== OpenCL Render Engines ===

OpenCL engines can run on GPUs, CPUs and other types of computing devices, they require OpenCL to run. All OpenCL render engines accept the following parameters:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''opencl.platform.index''' || int || -1 || A valid platform index || -1 || Select the OpenCL platform to use. All devices available on all platforms will be used with -1
|-
|'''opencl.cpu.use''' || bool || 1 || 0 or 1 || 0 or 1 || If to use all OpenCL CPU devices available
|-
|'''opencl.gpu.use''' || bool || 1 || 0 or 1 || 0 or 1 || If to use all OpenCL GPU devices available
|-
|'''opencl.cpu.workgroup.size''' || int || 0 || Any valid OpenCL workgroup size || 64 || Set the OpenCL workgroup size, 0 means to use the driver suggested value
|-
|'''opencl.gpu.workgroup.size''' || int || 0 || Any valid OpenCL workgroup size || 64 || Set the OpenCL workgroup size, 0 means to use the driver suggested value
|-
|'''opencl.devices.select''' || string || "" || Any valid selection string || Any valid selection string || Select each OpenCL device to use. It is a string of "0" and "1". "1" means use the device, "0" do not
|}

'''The following OpenCL engines are available:'''

===="PATHOCL"====
OpenCL version of PATHCPU. Supports the same settings as [[#"PATHCPU" | PATHCPU]] plus the following:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''pathocl.pixelatomics.enable''' || bool || 0 || 0 or 1 || 0 or 1 || Enable pixel atomic operation
|-
|'''opencl.task.count''' || int || "AUTO" || "AUTO" or > 0 || [64K, 1024K] || The number of tasks sent to the OpenCL device in one kernel call
|}

===="RTPATHOCL"====

A PATHOCL version optimized for real-time rendering with fixed frame-rate and variable quality. 
The sampler must be set to TILEPATHSAMPLER when using this engine.

Supports the same settings as [[#"PATHOCL" | PATHOCL]] plus the following:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''rtpath.resolutionreduction.preview''' || int || 4 || > 0 || [1, 32] || Render a sample every n x n pixels in the first passes. For instance 4x4 than 2x2 and than always 1x1
|-
|'''rtpath.resolutionreduction.preview.step''' || int || 8 || > 0 || [1, 32] || Each preview step is rendered for n frames
|-
|'''rtpath.resolutionreduction''' || int || 4 || > 0 || [1, 32] || Render a sample every n x n pixels, outside the preview phase, in order to reduce the per frame rendering time
|}

===="TILEPATHOCL"====

OpenCL version of TILEPATHCPU. 
The sampler must be set to TILEPATHSAMPLER when using this engine.

Supports the same settings as [[#"TILEPATHCPU" | TILEPATHCPU]] plus the following:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''tilepathocl.devices.maxtiles''' || int || 16 || ≥ 1 || [1, 32] || Maximum number of tiles to send in a single call to each OpenCL device
|}

==="FILESAVER"===

Saves everything needed to render the scene to the output path, including textures and meshes.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''filesaver.format''' || string || "TXT" || "TXT" for a text SDL format and "BIN" for a single file binary format
|-
|'''filesaver.filename''' || string || "luxcore-exported-scene.bcf" || file name for "BIN" format
|-
|'''filesaver.directory''' || string || "luxcore-exported-scene" || output path for "TXT" format
|-
|'''filesaver.renderengine.type''' || string || "PATHCPU" || render engine to use when rendering the scene after it was saved with FILESAVER. Any engine string from above can be used here.
|}

===Experimental and debugging engines===

'''These engines are experimental, deprecated or are only intended for very specific purposes:'''

===="BIDIRVMCPU"====

Bidir with vertex merging, currently experimental. 
Supports the same settings as [[#"BIDIRCPU" | BIDIRCPU]] plus the following:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''bidirvm.lightpath.count''' || int || 16 * 1024 || > 0 || || Number of lightpaths per pass
|-
|'''bidirvm.startradius.scale''' || float || 0.003 || > 0 || || Photon radius of the first pass
|-
|'''bidirvm.alpha''' || float || 3 || > 0 || [0.0, 1.0] || Photon radius is multiplied with this value after every pass to reduce the radius
|}

===="LIGHTCPU"====

For testing.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''light.maxdepth''' || int || 5 || > 0 || [1, 16] || Maximum recursion depth of a light path
|-
|'''light.russianroulette.depth''' || int || 3 || > 0 || [1, path.maxdepth] || The path depth where Russian Roulette starts to be used
|-
|'''light.russianroulette.cap''' || float || 0.5 || [0.0, 1.0] || [0.0, 1.0] || The threshold over which Russian Roulette is used
|}

==Sampler==

Samplers are used by following render engines:

* LIGHTCPU
* PATHCPU
* BIDIRCPU
* BIDIRVMCPU
* PATHOCL

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''sampler.type''' || string || "SOBOL" || sampler type
|}

The following samplers are available:

==="SOBOL"===

Sampler with sobol pattern.
Parameters:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''sampler.sobol.adaptive.strength''' || float || 0.7 || 0 ≤ x < 0.95 || 0.5 - 0.9 || it sets if the sampler should be more or less adaptive
|}

==="METROPOLIS"===

Metropolis sampler.
Parameters:
{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''sampler.metropolis.largesteprate''' || float || 0.4 || 0 ≤ x ≤ 1 || 0 - 1 || Probability of generating a large sample mutation
|-
|'''sampler.metropolis.maxconsecutivereject''' || int || 512 || x ≥ 0 || 0 - 32768 || Number of consecutive rejects before a next mutation is forced. Low values can cause bias
|-
|'''sampler.metropolis.imagemutationrate''' || float || 0.1 || 0 ≤ x ≤ 1 || 0 - 1 || Maximum distance over the image plane for a small mutation
|}

==="RANDOM"===

Fully random sampler. This sampler is mostly intended for testing purpose.
Parameters:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''sampler.random.adaptive.strength''' || float || 0.7 || 0 ≤ x < 0.95 || 0.5 - 0.9 || it sets if the sampler should be more or less adaptive
|}

==Filter==

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''film.filter.type''' || string || "BLACKMANHARRIS" || || || Type of pixel filter.
|-
|'''film.filter.width''' || float || 2.0 || x > 0.0 || 0.1 - 3.0 || Filter radius in pixels. Does not have an effect on the NONE filter
|-
|'''film.filter.xwidth''' || float || 2.0 || x > 0.0 || 0.1 - 3.0 || Width in pixels. Overwrite '''film.filter.width''' value
|-
|'''film.filter.ywidth''' || float || 2.0 || x > 0.0 || 0.1 - 3.0 || Width in pixels. Overwrite '''film.filter.width''' value
|}

Available filters are:

==="NONE"===

Disable pixel filtering.

==="BOX"===

Box pixel filter. No parameters.

==="GAUSSIAN"===

Gaussian pixel filter.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''film.filter.gaussian.alpha''' || float || 2.0 || x > 0.0 || 0.1 - 10.0 || Gaussian rate of falloff. Lower values give blurrier images.
|}

==="MITCHELL"===

Mitchel pixel filter.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
| '''film.filter.mitchell.b''' || float || 1.0/3.0 || 0.0 ≤ x ≤ 1.0 || 0.0 - 1.0 || B parameter for the mitchell filter in the range
|-
| '''film.filter.mitchell.c''' || float || 1.0/3.0 || 0.0 ≤ x ≤ 1.0 || 0.0 - 1.0 || C parameter for the mitchell filter in the range 0..1
|}

==="MITCHELL_SS"===

Mitchel pixel filter with super-sampling (i.e. image will be filtered first with a grid of 4 pixels for each pixel).

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
| '''film.filter.mitchellss.b''' || float || 1.0/3.0 || 0.0 ≤ x ≤ 1.0 || 0.0 - 1.0 || B parameter for the mitchell filter in the range
|-
| '''film.filter.mitchellss.c''' || float || 1.0/3.0 || 0.0 ≤ x ≤ 1.0 || 0.0 - 1.0 || C parameter for the mitchell filter in the range 0..1
|}

==="BLACKMANHARRIS"===

Blcakman-Harris pixel filter. No parameters.

==Light Strategy==

The direct light sampling strategy is defined by the following property:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''lightstrategy.type''' || string || "LOG_POWER" || "UNIFORM", "POWER", "LOG_POWER" or "DLS_CACHE" || N/A || Direct light sampling strategy
|}

==="UNIFORM"===

"UNIFORM" light strategy samples evenly all light sources.

==="POWER"===

"POWER" light strategy samples the light sources based on their power.

==="LOG_POWER"===

"LOG_POWER" light strategy samples the light sources based on logarithm of their power.

==="DLS_CACHE"===

Build direct light sampling cache to optimize many-lights rendering, beneficial in scenes with multiple light sources with few overlap between their influence areas (e.g. a building with many disconnected rooms and interior lights).

Options for the DLS cache:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''lightstrategy.entry.radius''' || float || 0.0 || || N/A || Entry radius in meters, automatic radius estimation is used if the radius is set to 0
|-
|'''lightstrategy.entry.normalangle''' || float || 25.0 || || N/A ||
|-
|'''lightstrategy.entry.maxpasses''' || int || 1024 || || N/A ||
|-
|'''lightstrategy.entry.convergencethreshold''' || float || 0.05 || || N/A ||
|-
|'''lightstrategy.entry.warmupsamples''' || int || 24 || || N/A ||
|-
|'''lightstrategy.targetcachehitratio''' || float || 0.995 || || N/A ||
|-
|'''lightstrategy.maxdepth''' || int || 4 || || N/A ||
|-
|'''lightstrategy.maxsamplescount''' || int || 10000000 || || N/A ||
|-
|'''lightstrategy.persistent.file''' || string || "" || || N/A ||
|-
|'''lightstrategy.persistent.safesave''' || bool || 1 || || N/A ||

|}

==Accelerator==

The ray/triangle intersection accelerator to use for the rendering is defined by the following properties:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''accelerator.type''' || string || "AUTO" || "AUTO", "BVH", "MBVH", "EMBREE" || "AUTO" || The intersection accelerator. "AUTO" will select the best one available for the current [[LuxRays]] intersection device. "EMBREE" is currently usable only on CPU render engines
|-
|'''accelerator.instances.enable''' || bool || 1 || 0 or 1 || 0 or 1 || Enable instance support (or disable in order to slightly increase rendering speed)
|}

==Epsilon==

Minimum and maximum allowed value for scene epsilon can be define by the following properties:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Theoretical range
!Recommended range
!Description
|-
|'''scene.epsilon.min''' || float || 1e-5f || Any float value || 1e-6f ≤ x ≤ 1e-1f || Minimum allowed value for scene epsilon
|-
|'''scene.epsilon.max''' || float || 1e-1f || Any float value || 1e-3f ≤ x ≤ 1e+2f || Maximum allowed value for scene epsilon
|}

==Film==

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.safesave''' || bool || 1 || enable "safe save" of Film serialization. A backup of the output is always valid even in the case of a system failure.
|}

===Film OpenCL Options===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.opencl.enable''' || bool || 1 || enable OpenCL film operations
|-
|'''film.opencl.platform''' || unsigned int || -1 || choose which platform will be used by the film operations. (0 is first platform, 1 second and so on. -1 for all)
|-
|'''film.opencl.device''' || unsigned int || -1 || choose which device will be used by the film operations. (0 is first device, 1 second and so on. -1 for first GPU device)
|}

===Film Outputs (aka AOVs)===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.outputs.safesave''' || bool || 1 || enable "safe save" for Film outputs. A backup of the output is always valid even in the case of a system failure
|}

The film object supports many types of outputs (aka AOVs). The complete list of supported output types:

{| class="wikitable" cellspacing="2"
!Name
!Type
|-
|'''RGB''' || HDR
|-
|'''RGBA''' || HDR
|-
|'''RGB_IMAGEPIPELINE''' || HDR/LDR
|-
|'''RGBA_IMAGEPIPELINE''' || HDR/LDR
|-
|'''ALPHA''' || HDR/LDR
|-
|'''DEPTH''' || HDR
|-
|'''POSITION''' || HDR
|-
|'''GEOMETRY_NORMAL''' || HDR
|-
|'''SHADING_NORMAL''' || HDR
|-
|'''MATERIAL_ID''' || LDR
|-
|'''DIRECT_DIFFUSE''' || HDR
|-
|'''DIRECT_GLOSSY''' || HDR
|-
|'''EMISSION''' || HDR
|-
|'''INDIRECT_DIFFUSE''' || HDR
|-
|'''INDIRECT_GLOSSY''' || HDR
|-
|'''INDIRECT_SPECULAR''' || HDR
|-
|'''MATERIAL_ID_MASK''' || HDR/LDR
|-
|'''DIRECT_SHADOW_MASK''' || HDR/LDR
|-
|'''INDIRECT_SHADOW_MASK''' || HDR/LDR
|-
|'''RADIANCE_GROUP''' || HDR/LDR
|-
|'''UV''' || HDR/LDR
|-
|'''RAYCOUNT''' || HDR/LDR
|-
|'''BY_MATERIAL_ID''' || HDR/LDR
|-
|'''IRRADIANCE''' || HDR
|-
|'''OBJECT_ID''' || LDR
|-
|'''OBJECT_ID_MASK''' || HDR/LDR
|-
|'''BY_OBJECT_ID''' || HDR/LDR
|-
|'''SAMPLECOUNT''' || HDR/LDR
|-
|'''CONVERGENCE''' || HDR/LDR
|-
|'''NOISE''' || HDR/LDR
|-
|'''SERIALIZED_FILM''' || N/A
|-
|'''MATERIAL_ID_COLOR''' || HDR/LDR
|}

Outputs are enabled with the following properties:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.outputs.<index>.type''' || string || || Type of output, e.g. "RGBA" or "ALPHA" (see the list above for the available types)
|-
|'''film.outputs.<index>.filename''' || string || || Filename to use when saving the output. The filename should use ".exr" as extension for HDR outputs and ".png" for LDR outputs (see list above for which output is HDR and which LDR)
|-
|'''film.outputs.<index>.id''' || int || || Specify for the following outputs: '''MATERIAL_ID_MASK''', '''RADIANCE_GROUP''', '''BY_MATERIAL_ID''', '''OBJECT_ID_MASK''', '''BY_OBJECT_ID''' (to choose the object ID, material ID or radiance group ID of the output)
|-
|'''film.outputs.<index>.index''' || int || || Specify for an imagepipeline output (RGB_IMAGEPIPELINE or RGBA_IMAGEPIPELINE) to select the imagepipeline of the output. For example, if you have 3 imagepipelines defined, and you want to specify the output of the third imagepipeline, use 2 for the ".index" property of the output
|}

Note that the Bidir engine does not support all AOVs.
Not supported by Bidir are: EMISSION, DIRECT_DIFFUSE, DIRECT_GLOSSY, INDIRECT_DIFFUSE, INDIRECT_GLOSSY, INDIRECT_SPECULAR, DIRECT_SHADOW_MASK, INDIRECT_SHADOW_MASK, IRRADIANCE, RAYCOUNT.

This is the list of output channel data types and sizes:

{| class="wikitable" cellspacing="2"
!Output type
!Data type
!Size
!Description
|-
|RGB||float||film width x film height x 3||R, G, B
|-
|RGB_IMAGEPIPELINE||float||film width x film height x 3||R, G, B
|-
|RGBA||float||film width x film height x 4||R, G, B, A
|-
|ALPHA||float||film width x film height x 1||Alpha value [0, 1]
|-
|DEPTH||float||film width x film height x 1||Camera distance
|-
|POSITION||float||film width x film height x 3||World X, Y, Z
|-
|GEOMETRY_NORMAL||float||film width x film height x 3||Normal vector X, Y, Z
|-
|SHADING_NORMAL||float||film width x film height x 3||Normal vector X, Y, Z
|-
|DIRECT_DIFFUSE||float||film width x film height x 3||Diffuse R, G, B
|-
|DIRECT_GLOSSY||float||film width x film height x 3||Glossy R, G, B
|-
|EMISSION||float||film width x film height x 3||Emission R, G, B
|-
|INDIRECT_DIFFUSE||float||film width x film height x 3||Indirect diffuse R, G, B
|-
|INDIRECT_GLOSSY||float||film width x film height x 3||Indirect glossy R, G, B
|-
|INDIRECT_SPECULAR||float||film width x film height x 3||Indirect specular R, G, B
|-
|MATERIAL_ID_MASK||float||film width x film height x 1||Material mask [0, 1]
|-
|DIRECT_SHADOW_MASK||float||film width x film height x 1||Shadow mask [0, 1]
|-
|INDIRECT_SHADOW_MASK||float||film width x film height x 1||Shadow mask [0, 1]
|-
|RADIANCE_GROUP||float||film width x film height x 3||R, G, B
|-
|UV||float||film width x film height x 2||Texture coordinates U, V
|-
|RAYCOUNT||float||film width x film height x 1||Ray count
|-
|BY_MATERIAL_ID||float||film width x film height x 3||By material ID
|-
|MATERIAL_ID||uint||film width x film height x 1||Material ID
|-
|IRRADIANCE||float||film width x film height x 3||R, G, B
|-
|OBJECT_ID_MASK||float||film width x film height x 1||Object mask [0, 1]
|-
|BY_OBJECT_ID||float||film width x film height x 3||By object ID
|-
|OBJECT_ID||uint||film width x film height x 1||Object ID
|-
|SAMPLECOUNT||uint||film width x film height x 1||Sample count
|-
|CONVERGENCE||float||film width x film height x 1||The distance of each pixel from the convergence threshold
|-
|NOISE||float||film width x film height x 1||The noise estimated for each pixel
|-
|SERIALIZED_FILM||N/A||N/A||The complete Film serialized in binary format
|-
|MATERIAL_ID_COLOR||float||film width x film height x 3||Material ID converted to colors (with anti-aliasing)
|}

===Film Channels===

Film channels are implicitly enabled by declaring film outputs (even if the output is never used). For instance, declaring a "RGBA" output will automatically enable "RADIANCE_PER_PIXEL_NORMALIZED" (and "RADIANCE_PER_SCREEN_NORMALIZED" for BIDIRCPU) and "ALPHA".
The supported channels are:

{| class="wikitable" cellspacing="2"
!Channel type
!Data type
!Size
!Last element is weight ?
!Note
|-
|CHANNEL_RADIANCE_PER_PIXEL_NORMALIZED||float||film width x film height x 4||Yes||One for each radiance group. Eye paths radiance.
|-
|CHANNEL_RADIANCE_PER_SCREEN_NORMALIZED||float||film width x film height x 3||No||One for each radiance group. Light paths radiance. Used only by LIGHTCPU and BIDIRCPU.
|-
|CHANNEL_ALPHA||float||film width x film height x 2||Yes||
|-
|CHANNEL_RGB_IMAGEPIPELINE||float||film width x film height x 3||No||
|-
|CHANNEL_DEPTH||float||film width x film height x 1||No||
|-
|CHANNEL_POSITION||float||film width x film height x 3||No||
|-
|CHANNEL_GEOMETRY_NORMAL||float||film width x film height x 3||No||
|-
|CHANNEL_SHADING_NORMAL||float||film width x film height x 3||No||
|-
|CHANNEL_MATERIAL_ID||u_int||film width x film height x 1||No||
|-
|CHANNEL_DIRECT_DIFFUSE||float||film width x film height x 4||Yes||
|-
|CHANNEL_DIRECT_GLOSSY||float||film width x film height x 4||Yes||
|-
|CHANNEL_EMISSION||float||film width x film height x 4||Yes||
|-
|CHANNEL_INDIRECT_DIFFUSE||float||film width x film height x 4||Yes||
|-
|CHANNEL_INDIRECT_SPECULAR||float||film width x film height x 4||Yes||
|-
|CHANNEL_MATERIAL_ID_MASK||float||film width x film height x 2||Yes||
|-
|CHANNEL_DIRECT_SHADOW_MASK||float||film width x film height x 2||Yes||
|-
|CHANNEL_INDIRECT_SHADOW_MASK||float||film width x film height x 2||Yes||
|-
|CHANNEL_UV||float||film width x film height x 2||No||
|-
|CHANNEL_RAYCOUNT||float||film width x film height||No||
|-
|CHANNEL_BY_MATERIAL_ID||float||film width x film height x 4||Yes||
|-
|CHANNEL_IRRADIANCE||float||film width x film height x 4||Yes||
|-
|CHANNEL_OBJECT_ID||u_int||film width x film height x 1||No||
|-
|CHANNEL_OBJECT_ID_MASK||float||film width x film height x 2||Yes||
|-
|CHANNEL_BY_OBJECT_ID||float||film width x film height x 4||Yes||
|}

This is the list of channels enabled by each output:

{| class="wikitable" cellspacing="2"
!Output
!Enabled channels
|-
|'''RGB''' || CHANNEL_RADIANCE_PER_PIXEL_NORMALIZED, CHANNEL_RADIANCE_PER_SCREEN_NORMALIZED (only for LIGHTCPU and BIDIRCPU)
|-
|'''RGBA''' || CHANNEL_RADIANCE_PER_PIXEL_NORMALIZED, CHANNEL_RADIANCE_PER_SCREEN_NORMALIZED (only for LIGHTCPU and BIDIRCPU), ALPHA
|-
|'''RGB_IMAGEPIPELINE''' || CHANNEL_RADIANCE_PER_PIXEL_NORMALIZED, CHANNEL_RADIANCE_PER_SCREEN_NORMALIZED (only for LIGHTCPU and BIDIRCPU)
|-
|'''RGBA_IMAGEPIPELINE''' || CHANNEL_RADIANCE_PER_PIXEL_NORMALIZED, CHANNEL_RADIANCE_PER_SCREEN_NORMALIZED (only for LIGHTCPU and BIDIRCPU), ALPHA
|-
|'''ALPHA''' || ALPHA
|-
|'''DEPTH''' || DEPTH
|-
|'''POSITION''' || DEPTH, POSITION
|-
|'''GEOMETRY_NORMAL''' || DEPTH, GEOMETRY_NORMAL
|-
|'''SHADING_NORMAL''' || DEPTH, SHADING_NORMAL
|-
|'''MATERIAL_ID''' || DEPTH, MATERIAL_ID
|-
|'''DIRECT_DIFFUSE''' || DIRECT_DIFFUSE
|-
|'''DIRECT_GLOSSY''' || DIRECT_GLOSSY
|-
|'''EMISSION''' || EMISSION
|-
|'''INDIRECT_DIFFUSE''' || INDIRECT_DIFFUSE
|-
|'''INDIRECT_GLOSSY''' || INDIRECT_GLOSSY
|-
|'''INDIRECT_SPECULAR''' || INDIRECT_SPECULAR
|-
|'''MATERIAL_ID_MASK''' || MATERIAL_ID, MATERIAL_ID_MASK
|-
|'''DIRECT_SHADOW_MASK''' || DIRECT_SHADOW_MASK
|-
|'''INDIRECT_SHADOW_MASK''' || INDIRECT_SHADOW_MASK
|-
|'''RADIANCE_GROUP''' || CHANNEL_RADIANCE_PER_PIXEL_NORMALIZED, CHANNEL_RADIANCE_PER_SCREEN_NORMALIZED (only for LIGHTCPU and BIDIRCPU)
|-
|'''UV''' || DEPTH, UV
|-
|'''RAYCOUNT''' || DEPTH, RAYCOUNT
|-
|'''BY_MATERIAL_ID''' || BY_MATERIAL_ID
|-
|'''IRRADIANCE''' || IRRADIANCE
|-
|'''OBJECT_ID''' || DEPTH, OBJECT_ID
|-
|'''OBJECT_ID_MASK''' || OBJECT_ID, OBJECT_ID_MASK
|-
|'''BY_OBJECT_ID''' || BY_OBJECT_ID
|}

Note: CHANNEL_RGB_IMAGEPIPELINE is always enable and the result of running the image pipeline.

===Image pipeline===

It is possible to [http://www.luxrender.net/forum/viewtopic.php?f=8&p=120169#p120169 define multiple image pipelines at the same time]

====Radiance Group====

Radiance groups are used to get only the contribution of a group of lights in the scene. 
Lights can be grouped by setting their [[#Common_parameters | '''.id''']] property to the same number, on materials this is done with the [[#Light_emission | '''.emission.id''']] property. 

Note that the OpenCL engines only support up to 8 radiance groups (one of them is the default group).

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.radiancescales.<id>.globalscale''' || float|| 1 || global weighting of radiance group
|-
|'''film.imagepipelines.<pipeline #>.radiancescales.<id>.temperature ''' || float || 6500.0 || light temperature
|-
|'''film.imagepipelines.<pipeline #>.radiancescales.<id>.rgbscale''' || vector || 1.0 1.0 1.0 || light color
|-
|'''film.imagepipelines.<pipeline #>.radiancescales.radiancescales.<id>.enabled''' || bool || 1 || enable radiance group
|}

====Image pipeline plug-ins====

=====Type: TONEMAP_LINEAR=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "TONEMAP_LINEAR" || linear tonemapping
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.scale''' || float || 1.0 || tonemapping scale
|}

=====Type: TONEMAP_REINHARD02=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "TONEMAP_REINHARD02" || reinhard tonemapping
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.prescale''' || float || 1.0 || reinhard prescale
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.postscale''' || float || 1.2 || reinhard postscale
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.burn''' || float || 3.75 || reinhard burn
|}

=====Type: TONEMAP_AUTOLINEAR=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "TONEMAP_AUTOLINEAR" || automatic linear tonemapping
|}

=====Type: TONEMAP_LUXLINEAR=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "TONEMAP_LUXLINEAR" || linear tonemapping with real camera settings
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.sensitivity''' || float || 100.0 || ISO sensitivity
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.exposure''' || float || 0.001 || exposure time
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.fstop''' || float || 2.8 || f/aperture
|}

=====Type: NOP=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipeline.<pipeline #>.<plugin #>.type''' || string || "NOP" || no parameters tonemapper
|}

=====Type: GAMMA_CORRECTION=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "TONEMAP_LINEAR" || gamma correction
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.value''' || float || 2.2 || gamma value
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.table.size''' || unsigned int || 4096 || resolution
|}

=====Type: OUTPUT_SWITCHER=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "OUTPUT_SWITCHER" || overwrite output
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.channel''' || string || "DEPTH" || channel whose values are used to overwrite
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.index''' || unsigned int || 0 || index
|}

=====Type: GAUSSIANFILTER_3x3=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "GAUSSIANFILTER_3x3" || gaussian filter
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.weight''' || float || 0.15 || blurring weight
|}

=====Type: CAMERA_RESPONSE_FUNC=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || CAMERA_RESPONSE_FUNC || analog camera film simulation
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.name''' || string || "Advantix_100CD" || film type
|}

=====Type: BACKGROUND_IMG=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || BACKGROUND_IMG || show the background image where alpha < 1 (simple compositing)
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.file''' || string || ... || background image path (e.g scenes/simple-mat/sky.exr)
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.gamma''' || float || 2.2 || background image gamma
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.storage ''' || string || auto || background image storage type
|}
Note: When the size of the background image differs from the film size, it will be stretched to fit the film size.

=====Type: BLOOM=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "BLOOM" || bloom effect
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.radius''' || float || 0.07 || how large the bloom effect is in % of the image size (i.e. 1.0 = all image)
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.weight''' || float || 0.25 || how strong the effect is (i.e. 0.0 = nothing, 1.0 = max. strength)
|}

=====Type: VIGNETTING=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "VIGNETTING" || vignetting effect
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.scale''' || float || 0.4 || vignetting strength
|}

=====Type: COLOR_ABERRATION=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "COLOR_ABERRATION" || color aberration effect
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.amount''' || float || 0.005 || color aberration amount
|}

=====Type: MIST=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "MIST" || aerial perspective effect (fake fog)
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.color''' || spectrum|| [1, 1, 1] || mist color
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.amount''' || float || 0.005 || mist amount
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.startdistance''' || float || 0 || distance from camera until where the mist effect has zero effect
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.enddistance''' || float || 10000 || distance from camera from where the mist effect has maximum effect
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.excludebackground''' || bool || false || Do not apply mist effect on pixels with infinite distance to the camera
|}

=====Type: CONTOUR_LINES=====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "CONTOUR_LINES" || contour lines for IRRADIANCE AOV
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.range''' || float|| ? || ?
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.scale''' || float || ? || ?
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.steps''' || int || ? || ?
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.zerogridsize''' || int || ? || ?
|}

=====Type: WHITE_BALANCE =====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.type''' || string || "WHITE_BALANCE" || White temperature correction
|-
|'''film.imagepipelines.<pipeline #>.<plugin #>.temperature''' || unsigned int|| 6500 || Target image temperature in Kelvin
|-
|}

===Film Subregion===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.subregion''' || vector || ... || <xstart> <xstop> <ystart> <ystop>
|}

===Rendering halt conditions===

By default, a LuxCore rendering will never stop however you can enable one or multiple halt conditions:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''batch.haltnoisethreshold''' || float || -1.0 || enable image convergence test and stops when the error is under the defined value. Use a value like "n / 256.0" where n is the level of error you are looking for. It may be hard to achieve a level of error smaller than 3.0 / 256.0. -1.0 disables the halt condition.
|-
|'''batch.haltnoisethreshold.warmup''' || unsigned int || 64 || number of average samples per pixel before to start the convergence test
|-
|'''batch.haltnoisethreshold.step''' || unsigned int || 64 || number of average samples per pixel between two tests
|-
|'''batch.haltnoisethreshold.filter.enable''' || bool || 1 || if the CONVERGENCE AOV (generated by the batch.haltnoisethreshold) should be filtered or not with a 3x3 box filter
|-
|'''batch.haltnoisethreshold.stoprendering.enable''' || bool || 1 || Set this to 0 (false) if you only want to use the haltnoisethreshold settings for adaptive sampling in an endless render
|-
|'''batch.haltnoisethreshold.index''' || unsigned int || 0 || Film pipeline index used to estimate noise for stopping
|-
|'''batch.halttime''' || float || 0.0 || number of seconds before stopping the rendering
|-
|'''batch.haltspp''' || unsigned int || 0 || number of average samples per pixel before stopping the rendering
|}

===Noise estimation===

Image noise can be estimated and its result can be used to drive the Sobol and Random samplers to focus its sampling in the noisier regions.
Setting any of these properties will enable the noise estimation.
The adaptiveness strength is a Sampler property.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''film.noiseestimation.warmup''' || unsigned int || 32 || number of average samples per pixel before to start the convergence test
|-
|'''film.noiseestimation.step''' || unsigned int || 32 || number of average samples per pixel between two tests
|-
|'''film.noiseestimation.filter.scale''' || unsigned int || 4 || Box filter scale used to filter the NOISE AOV (generated by the noise estimation). Set to 0 to disable.
|-
|'''film.noiseestimation.index''' || unsigned int || 0 || Film pipeline index used to estimate noise for adaptive sampling
|-
|}

=Scene file=

==Camera==

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.camera.type''' || string || "perspective" || "perspective", "orthographic" or "environment" (360° panorama mapped in latlong format)
|-
|'''scene.camera.lookat.orig''' || point (float float float) || 0.0 10.0 0.0 || camera location
|-
|'''scene.camera.lookat.target''' || point (float float float) || 0.0 0.0 0.0 || camera target
|-
|'''scene.camera.up''' || vector (float float float) || (0.0, 0.0, 1.0) || camera up vector
|-
|'''scene.camera.fieldofview''' || float || 45.0 || field of view
|-
|'''scene.camera.screenwindow''' || vector || 0.0 1.0 0.0 1.0 || <xstart> <xstop> <ystart> <ystop>
|-
|'''scene.camera.shutteropen''' || float || 0.0 || camera shutter open time (used for motion blur)
|-
|'''scene.camera.shutterclose''' || float || 0.0 || camera shutter close time (used for motion blur)
|-
|'''scene.camera.autovolume.enable''' || bool || true || try automatically to discover scene.camera.volume
|-
|'''scene.camera.volume''' || string || || the initial volume rays will travel in
|}

The camera supports motion blur. See [[ LuxCore_SDL_Reference_Manual_v2.0#Object_Motion_Blur | Object Motion Blur ]]. 
(Only difference being that instead of the prefix '''scene.objects.<object name>''', the prefix '''scene.camera''' is used when setting motion properties of the camera)

==Textures==

Check [[LuxCoreRender_Textures|LuxCoreRender Textures]] for a high level description and examples of the textures.

===Mapping===

Some texture (mostly procedural textures) supports 2D or 3D mapping parameters:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.mapping.type''' || string || "uvmapping2d" || type of mapping
|-
|'''scene.textures.<texture name>.mapping.rotation''' || float || 0.0 || UV rotation (in degrees)
|-
|'''scene.textures.<texture name>.mapping.uvscale''' || UV || 1.0 1.0 || UV scale
|-
|'''scene.textures.<texture name>.mapping.uvdelta''' || UV || 0.0 0.0 || UV translation
|}

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.mapping.type''' || string || "uvmapping3d" || type of mapping
|-
|'''scene.textures.<texture name>.mapping.transformation''' || Matrix4x4 || 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0|| transformation matrix
|}

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.mapping.type''' || string || "globalmapping3d" || type of mapping
|-
|'''scene.textures.<texture name>.mapping.transformation''' || Matrix4x4 || 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0|| transformation matrix
|}

===Type: add===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "add" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant
|}

===Type: subtract===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "subtract" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant
|}

===Type: band===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "band" || type of texture
|-
|'''scene.textures.<texture name>.amount''' || texture || 0.5|| texture name or constant
|-
|'''scene.textures.<texture name>.interpolation''' || string || "linear"|| "linear", "cubic" or "none"
|-
|'''scene.textures.<texture name>.offset[0..n]''' || float || 0.0 || multiple offsets in the range of [0.0, 1.0]
|-
|'''scene.textures.<texture name>.value[0..n]''' || spectrum || 1.0 1.0 1.0 || a value for each offset
|}

===Type: blender_blend===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_blend" || type of texture
|-
|'''scene.textures.<texture name>.progressiontype''' || string || "linear" || linear, quadratic, easing, diagonal, spherical, quadratic_spherical, halo or radial
|-
|'''scene.textures.<texture name>.direction''' || string || "horizontal" || horizontal or vertical
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_clouds===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_clouds" || type of texture
|-
|'''scene.textures.<texture name>.noisetype''' || string || "soft_noise" || hard_noise or soft_noise
|-
|'''scene.textures.<texture name>.noisebasis''' || string || "blender_original" || blender_original, original_perlin, improved_perlin, voronoi_f1, voronoi_f2, voronoi_f3, voronoi_f4, voronoi_f2_f1, voronoi_crackle or cell_noise
|-
|'''scene.textures.<texture name>.noisesize''' || float || 0.25 ||
|-
|'''scene.textures.<texture name>.noisedepth''' || int || 2 ||
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_distortednoise===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_distortednoise" || type of texture
|-
|'''scene.textures.<texture name>.noise_distortion''' || string || "blender_original" || blender_original, original_perlin, improved_perlin, voronoi_f1, voronoi_f2, voronoi_f3, voronoi_f4, voronoi_f2_f1, voronoi_crackle or cell_noise
|-
|'''scene.textures.<texture name>.noisebasis''' || string || "blender_original" || blender_original, original_perlin, improved_perlin, voronoi_f1, voronoi_f2, voronoi_f3, voronoi_f4, voronoi_f2_f1, voronoi_crackle or cell_noise
|-
|'''scene.textures.<texture name>.noisesize''' || float || 0.25 ||
|-
|'''scene.textures.<texture name>.distortion''' || float || 1 ||
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_magic===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_magic" || type of texture
|-
|'''scene.textures.<texture name>.noisedepth''' || int || 2 ||
|-
|'''scene.textures.<texture name>.turbulence''' || float || 5.0 ||
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_marble===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_marble" || type of texture
|-
|'''scene.textures.<texture name>.marbletype''' || string || "soft" || soft, sharp or sharper
|-
|'''scene.textures.<texture name>.turbulence''' || float || 5.0 ||
|-
|'''scene.textures.<texture name>.noisebasis''' || string || "blender_original" || blender_original, original_perlin, improved_perlin, voronoi_f1, voronoi_f2, voronoi_f3, voronoi_f4, voronoi_f2_f1, voronoi_crackle or cell_noise
|-
|'''scene.textures.<texture name>.noisebasis2''' || string || "sin" || sin, saw or tri
|-
|'''scene.textures.<texture name>.noisedepth''' || int || 2 ||
|-
|'''scene.textures.<texture name>.noisesize''' || float || 0.25 ||
|-
|'''scene.textures.<texture name>.noisetype''' || string || "soft_noise" || soft_noise or hard_noise
|-
|'''scene.textures.<texture name>.turbulence''' || float || 5.0 ||
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_musgrave===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_musgrave" || type of texture
|-
|'''scene.textures.<texture name>.musgravetype''' || string || "multifractal" || multifractal, ridged_multifractal, hybrid_multifractal, fBM or hetero_terrain
|-
|'''scene.textures.<texture name>.noisebasis''' || string || "blender_original" || blender_original, original_perlin, improved_perlin, voronoi_f1, voronoi_f2, voronoi_f3, voronoi_f4, voronoi_f2_f1, voronoi_crackle or cell_noise
|-
|'''scene.textures.<texture name>.dimension''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.intensity''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.lacunarity''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.offset''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.gain''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.octaves''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.gain''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.noisesize''' || float || 0.25 ||
|-
|'''scene.textures.<texture name>.noisetype''' || string || "soft_noise" || soft_noise or hard_noise
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_noise===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_noise" || type of texture
|-
|'''scene.textures.<texture name>.noisedepth''' || int || 2 ||
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_stucci===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_stucci" || type of texture
|-
|'''scene.textures.<texture name>.stuccitype''' || string || "plastic" || plastic, wall_in or wall_out
|-
|'''scene.textures.<texture name>.noisebasis''' || string || "blender_original" || blender_original, original_perlin, improved_perlin, voronoi_f1, voronoi_f2, voronoi_f3, voronoi_f4, voronoi_f2_f1, voronoi_crackle or cell_noise
|-
|'''scene.textures.<texture name>.noisetype''' || string || "soft_noise" || soft_noise or hard_noise
|-
|'''scene.textures.<texture name>.noisesize''' || float || 0.25 ||
|-
|'''scene.textures.<texture name>.turbulence''' || float || 5.0 ||
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_wood===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_wood" || type of texture
|-
|'''scene.textures.<texture name>.woodtype''' || string || "bands" || bands, rings, bandnoise or ringnoise
|-
|'''scene.textures.<texture name>.noisebasis''' || string || "blender_original" || blender_original, original_perlin, improved_perlin, voronoi_f1, voronoi_f2, voronoi_f3, voronoi_f4, voronoi_f2_f1, voronoi_crackle or cell_noise
|-
|'''scene.textures.<texture name>.noisebasis2''' || string || "sin" || sin, saw or tri
|-
|'''scene.textures.<texture name>.noisetype''' || string || "soft_noise" || soft_noise or hard_noise
|-
|'''scene.textures.<texture name>.noisesize''' || float || 0.25 ||
|-
|'''scene.textures.<texture name>.turbulence''' || float || 5.0 ||
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: blender_voronoi===

Emulate Blender procedural texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blender_voronoi" || type of texture
|-
|'''scene.textures.<texture name>.intensity''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.distmetric''' || string || "actual_distance" || actual_distance, distance_squared, manhattan, chebychev, minkowski_half, minkowski_four or minkowski
|-
|'''scene.textures.<texture name>.w1''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.w2''' || float || 0.0 ||
|-
|'''scene.textures.<texture name>.w3''' || float || 0.0 ||
|-
|'''scene.textures.<texture name>.w4''' || float || 0.0 ||
|-
|'''scene.textures.<texture name>.noisesize''' || float || 0.25 ||
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 ||
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 ||
|}

===Type: brick===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "brick" || type of texture
|-
|'''scene.textures.<texture name>.bricktex''' || texture || 1.0 1.0 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.mortartex''' || texture || 0.2 0.2 0.2 || texture name or constant
|-
|'''scene.textures.<texture name>.brickmodtex''' || texture || 1.0 1.0 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.brickbond''' || string || "running" || "flemish", "english", "herringbone", "basket" or "chain link"
|-
|'''scene.textures.<texture name>.brickwidth''' || float || 0.3 || brick width
|-
|'''scene.textures.<texture name>.brickheight''' || float || 0.1 || brick height
|-
|'''scene.textures.<texture name>.brickdepth''' || float || 0.15 || brick depth
|-
|'''scene.textures.<texture name>.mortarsize''' || float || 0.01 ||mortar size
|-
|'''scene.textures.<texture name>.brickrun''' || float || 0.75 || brick run
|-
|'''scene.textures.<texture name>.brickbevel''' || float || 0.0 || brick bevel
|}

This texture supports 3D mapping.

===Type: checkerboard3d===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "checkerboard3d" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 0.0 || texture name or constant
|}

This texture supports 3D mapping.

===Type: checkerboard2d===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "checkerboard2d" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 0.0 || texture name or constant
|}

This texture supports 2D mapping.

===Type: constfloat1===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "constfloat1" || type of texture
|-
|'''scene.textures.<texture name>.value''' || float || 1.0 || constant value
|}

===Type: constfloat3===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "constfloat3" || type of texture
|-
|'''scene.textures.<texture name>.value''' || spectrum || (1.0, 1.0, 1.0) || RGB constant value
|}

===Type: densitygrid===

You can use ".data", ".data3" or ".openvdb.file" to define the 3D grid values.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "densitygrid" || type of texture
|-
|'''scene.textures.<texture name>.nx''' || unsigned int || || grid x size
|-
|'''scene.textures.<texture name>.ny''' || unsigned int || || grid y size
|-
|'''scene.textures.<texture name>.nz''' || unsigned int || || grid z size
|-
|'''scene.textures.<texture name>.wrap''' || string || "repeat" || select the type of grid wrapping mode: "repeat", "black", "white", "clamp"
|-
|'''scene.textures.<texture name>.wrap''' || string || "repeat" || select the type of grid wrapping mode: "repeat", "black", "white", "clamp"
|-
|'''scene.textures.<texture name>.storage''' || string || "half" || select the type of memory storage: "auto", "byte", "half", "float"
|-
|'''scene.textures.<texture name>.data''' || float || || vector grid values (total count: nx * ny * nz)
|-
|'''scene.textures.<texture name>.data3''' || float || || vector grid values (total count: nx * ny * nz * 3)
|-
|'''scene.textures.<texture name>.openvdb.file''' || string || || OpenVDB file name
|-
|'''scene.textures.<texture name>.openvdb.grid''' || string || || OpenVDB grid name to read from the file
|}

===Type: dots===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "dots" || type of texture
|-
|'''scene.textures.<texture name>.inside''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.outside''' || texture || 0.0 || texture name or constant
|}

This texture supports 2D mapping.

===Type: fbm===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "fbm" || type of texture
|-
|'''scene.textures.<texture name>.octaves''' || int || 8 || noise octaves
|-
|'''scene.textures.<texture name>.roughness''' || float || 0.5 || noise roughness
|}

This texture supports 3D mapping.

===Type: fresnelapproxk===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "fresnelapproxk" || type of texture
|-
|'''scene.textures.<texture name>.texture''' || texture || (0.5, 0.5, 0.5) || texture name or constant
|}

===Type: fresnelapproxn===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "fresnelapproxn" || type of texture
|-
|'''scene.textures.<texture name>.texture''' || texture || (0.5, 0.5, 0.5) || texture name or constant
|}

===Type: hitpointalpha===

Use the value obtained by interpolating triangle vertices alphas.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "hitpointalpha" || type of texture
|}

===Type: hitpointcolor===

Use the color obtained by interpolating triangle vertices colors.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "hitpointcolor" || type of texture
|}

===Type: hitpointgrey===

Use the value obtained by interpolating triangle vertices colors, mapped to a float value (RGB converted into greyscale).

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "hitpointgrey" || type of texture
|-
|'''scene.textures.<texture name>.channel''' || int || -1 || the index of the RGB channel to use. -1 means the luminance of the RGB value
|}

===Type: hsv===

Hue saturation value manipulation.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "hsv" || type of texture
|-
|'''scene.textures.<texture name>.texture''' || texture || 0 0 0 || input color that will be manipulated
|-
|'''scene.textures.<texture name>.hue''' || texture || 0.5 || shift in hue (range: 0..1)
|-
|'''scene.textures.<texture name>.saturation''' || texture || 1.0 || saturation (range: 0..inf)
|-
|'''scene.textures.<texture name>.value''' || texture || 1.0 || brightness multiplier (range: 0..inf)
|}

===Type: imagemap===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "imagemap" || type of texture
|-
|'''scene.textures.<texture name>.file''' || string || "image.png" || name of the image file
|-
|'''scene.textures.<texture name>.gamma''' || float || 2.2 || gamma correction value used in the image
|-
|'''scene.textures.<texture name>.gain''' || float || 1.0 || image values are multiplied by gain value
|-
|'''scene.textures.<texture name>.storage''' || string || "auto" || select the type of memory storage: "auto", "byte", "half", "float"
|-
|'''scene.textures.<texture name>.wrap''' || string || "repeat" || select the type of image map wrapping mode: "repeat", "black", "white", "clamp"
|-
|'''scene.textures.<texture name>.channel''' || string || "default" || extract from the image only the selected channels: "default", "red", "green", "blue", "alpha", "mean", "colored_mean", "rgb"
|}

===Type: normalmap===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "normalmap" || type of texture
|-
|'''scene.textures.<texture name>.texture''' || texture || 0 0 0 || input. Is treated as an XYZ vector in tangent space.
|-
|'''scene.textures.<texture name>.scale''' || float || 1.0 || multiplier for adjusting normalmap height
|}

===Type: marble===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "marble" || type of texture
|-
|'''scene.textures.<texture name>.octaves''' || int || 8 || noise octaves
|-
|'''scene.textures.<texture name>.roughness''' || float || 0.5 || noise roughness
|-
|'''scene.textures.<texture name>.scale''' || float || 1.0 || marble scale
|-
|'''scene.textures.<texture name>.variation''' || float || 0.2 || marble variation
|}

This texture supports 3D mapping.

===Type: mix===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "mix" || type of texture
|-
|'''scene.textures.<texture name>.amount''' || texture || 0.5 || texture name or constant
|-
|'''scene.textures.<texture name>.texture1''' || texture || 0.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant
|}

===Type: scale===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "scale" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant
|}

===Type: uv===

This procedural texture has no parameters aside from the support of 2D mapping.

===Type: windy===

This procedural texture has no parameters aside from the support of 3D mapping.

===Type: wood===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "wood" || type of texture
|-
|'''scene.textures.<texture name>.woodtype''' || string || "bands" || "bands", "rings", "bandnoise" or "ringnoise"
|-
|'''scene.textures.<texture name>.noisebasis2''' || string || "sin" || "sin", "saw" or "tri"
|-
|'''scene.textures.<texture name>.noisetype''' || string || "soft_noise" || "soft_noise" or "hard_noise"
|-
|'''scene.textures.<texture name>.noisesize''' || float || 0.25 || noise size
|-
|'''scene.textures.<texture name>.turbulence''' || float || 5.0 || noise turbulence
|-
|'''scene.textures.<texture name>.bright''' || float || 1.0 || bright
|-
|'''scene.textures.<texture name>.contrast''' || float || 1.0 || contrast
|}

This texture supports 3D mapping.

===Type: wrinkled===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "wrinkled" || type of texture
|-
|'''scene.textures.<texture name>.octaves''' || int || 8 || noise octaves
|-
|'''scene.textures.<texture name>.roughness''' || float || 0.5 || noise roughness
|}

This texture supports 3D mapping.

===Type: abs===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "abs" || type of texture
|-
|'''scene.textures.<texture name>.texture''' || texture || 1.0 || texture name or constant
|}

===Type: clamp===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "clamp" || type of texture
|-
|'''scene.textures.<texture name>.texture''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.min''' || float || 0.0 || lower boundary of the clamping
|-
|'''scene.textures.<texture name>.max''' || float || 1.0 || upper boundary of the clamping
|}

===Type: divide===

Note: If texture2 (the divisor) is 0, 0 is returned.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "divide" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant (dividend)
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant (divisor)
|}

===Type: remap===

This texture brings the value from the source range into the target range.

Note: The value is clamped into source range before performing the remap operation, and the resulting number is also clamped into the target range.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "remap" || type of texture
|-
|'''scene.textures.<texture name>.value''' || texture || 0.5 || texture name or constant
|-
|'''scene.textures.<texture name>.sourcemin''' || texture || 0.0 || texture name or constant
|-
|'''scene.textures.<texture name>.sourcemax''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.targetmin''' || texture || 0.0 || texture name or constant
|-
|'''scene.textures.<texture name>.targetmax''' || texture || 1.0 || texture name or constant
|}

===Type: objectid===

Raw object ID (range 0 to 0xfffffffe).

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "objectid" || type of texture
|}

===Type: objectidcolor===

Object ID interpreted as color. 
The object ID is a 4 byte unsigned int. To convert to color, the lower three bytes are interpreted as r, g, b values (each range 0 to 255). The highest byte is ignored.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "objectidcolor" || type of texture
|}

===Type: objectidnormalized===

Normalized object ID (range 0 to 1).

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "objectidnormalized" || type of texture
|}

===Type: dotproduct ===

Dot product of the two input vectors.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "dotproduct" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant
|}

===Type: power ===

pow(base, exponent)

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "power" || type of texture
|-
|'''scene.textures.<texture name>.base''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.exponent''' || texture || 1.0 || texture name or constant
|}

===Type: lessthan ===

returns 1 if texture1 < texture2, 0 if otherwise.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "lessthan" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant
|}

===Type: greaterthan ===

returns 1 if texture1 > texture2, 0 if otherwise.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "greaterthan" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant
|}

===Type: shadingnormal ===

Returns the shading normal of the mesh at the hitpoint.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "shadingnormal" || type of texture
|}

===Type: position ===

Returns the position of the hitpoint.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "position" || type of texture
|}

===Type: splitfloat3 ===

Extract a channel from a float3 texture. Can for example be used to get the R, G or B channel of a color texture, or to get the X, Y or Z components of a vector texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "splitfloat3" || type of texture
|-
|'''scene.textures.<texture name>.texture''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.channel''' || int || 0 || the channel to get from the input texture. 0 for first channel, 1 for second, 2 for third channel
|}

===Type: makefloat3 ===

Combine three float textures into one float3 texture.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "makefloat3" || type of texture
|-
|'''scene.textures.<texture name>.texture1''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture2''' || texture || 1.0 || texture name or constant
|-
|'''scene.textures.<texture name>.texture3''' || texture || 1.0 || texture name or constant
|}

===Type: blackbody===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "blackbody" || type of texture
|-
|'''scene.textures.<texture name>.temperature''' || float || 6500 || emission temperature
|-
|'''scene.textures.<texture name>.normalize''' || bool || false || normalize the output
|}

===Type: irregulardata===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "irregulardata" || type of texture
|-
|'''scene.textures.<texture name>.wavelengths''' || vector || 580.0 620.0 660.0|| wavelenghts
|-
|'''scene.textures.<texture name>.data''' || vector || 0.0 0.000015 0.0|| data (length should match wavelength's length)
|}

===Type: lampspectrum===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || "lampspectrum" || type of texture
|-
|'''scene.textures.<texture name>.name''' || string || "Daylight" || lamp light spectrum
|}

===Type: Fresnel Textures===

Textures for loading optical data

====Type: fresnelcolor====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || fresnelcolor || type of texture
|-
|'''scene.textures.<texture name>.kr''' || vector || 0.5 0.0 0.0 || reflection color
|}

====Type: fresnelpreset====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || fresnelpreset || type of texture
|-
|'''scene.textures.<texture name>.name''' || string || aluminium || fresnel preset ("aluminium", "silver", "copper", "gold" or "amorphous carbon")
|}

====Type: fresnelsopra====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || fresnelpreset || type of texture
|-
|'''scene.textures.<texture name>.file''' || string || ... || nk file path (e.g scenes/luxball/Au.nk)
|}

====Type: fresnelluxpop====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.textures.<texture name>.type''' || string || fresnelpreset || type of texture
|-
|'''scene.textures.<texture name>.file''' || string || ... || nk file path (e.g scenes/luxball/Cr.nk)
|}

==Volumes==

Check [[LuxCoreRender_Volumes|LuxCoreRender Volumes]] for a high level description and examples of the volumes.

All volumes share these properties

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.volumes.<volume name>.type''' || string || clear || volume type
|-
|'''scene.volumes.<volume name>.priority''' || unsigned int|| 0|| volume priority (when volumes overlap, the one with highest priority overrides the others)
|-
|'''scene.volumes.<volume name>.ior''' || texture|| ... || index of refraction
|-
|'''scene.volumes.<volume name>.absorption''' || texture || ... || absorption texture
|-
|'''scene.volumes.<volume name>.emission ''' || texture || ... || emission
|-
|'''scene.volumes.<volume name>.emission.id ''' || unsigned int || ... || emission ID
|}

===Volume: Clear===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.volumes.<volume name>.type''' || string || clear || volume type
|}

===Volume: Homogeneous===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.volumes.<volume name>.type''' || string || homogeneous|| volume type
|-
|'''scene.volumes.<volume name>.scattering''' || texture || ... || scattering texture
|-
|'''scene.volumes.<volume name>.asymmetry''' || texture || ... || asymmetry texture
|-
|'''scene.volumes.<volume name>.multiscattering''' || bool || ... || multiscattering
|}

===Volume: Heterogeneous===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.volumes.<volume name>.type''' || string || heterogeneous || volume type
|-
|'''scene.volumes.<volume name>.scattering''' || texture || ... || scattering texture
|-
|'''scene.volumes.<volume name>.asymmetry''' || texture || ... || asymmetry texture
|-
|'''scene.volumes.<volume name>.multiscattering''' || bool || ... || multiscattering
|-
|'''scene.volumes.<volume name>.steps.size''' || float || ... || step size
|-
|'''scene.volumes.<volume name>.steps.maxcount''' || unsigned int || ... || step maximum count
|}

==Materials==

Check [[LuxCoreRender_Materials|LuxCoreRender Materials]] for a high level description and examples of the materials.

===Common properties===

Common material properties:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.bumptex''' || texture || || texture to use for the bump mapping
|-
|'''scene.materials.<material name>.normaltex''' || texture || || texture to use for the normal mapping
|-
|'''scene.materials.<material name>.samples''' || int || -1 || number of rays used to sample this material. -1 means use the default global value. This property is an hint and the render engine can ignore this information.
|-
|'''scene.materials.<material name>.visibility.indirect.diffuse.enable''' || bool || true || if this material is visible in indirect rays. This property is an hint and the render engine can ignore this information.
|-
|'''scene.materials.<material name>.visibility.indirect.glossy.enable''' || bool || true || if this material is visible in indirect rays. This property is an hint and the render engine can ignore this information.
|-
|'''scene.materials.<material name>.visibility.indirect.specular.enable''' || bool || true || if this material is visible in indirect rays. This property is an hint and the render engine can ignore this information.
|-
|'''scene.materials.<material name>.bumpsamplingdistance''' || float || 0.001 || set the offset used to sample bump/normal mapping.
|-
|'''scene.materials.<material name>.volume.interior''' || string || vol1 || name of interior volume (for volume rendering)
|-
|'''scene.materials.<material name>.volume.exterior''' || string || vol2 || name of exterior volume (for volume rendering)
|-
|'''scene.materials.<material name>.id''' || int|| ... || material id
|-
|'''scene.materials.<material name>.transparency''' || texture || 1.0 || transparency of the material. 1 for opaque, 0 for fully transparent
|-
|'''scene.materials.<material name>.shadowcatcher.enable''' || bool || false || If true, the material will be transparent where hit by direct light and opaque otherwise (alpha transparency). Used for compositing.
|}

====Normal maps====
Normal maps are set first as a texture type and then assigned to the material. For example:

<blockquote><pre>
scene.textures.normmap.type = imagemap
scene.textures.normmap.file = scenes/bump/normal.png
scene.textures.normmap.gamma = 1

scene.materials.mat_white.type = matte
scene.materials.mat_white.kd = 0.8 0.8 0.8
scene.materials.mat_white.normaltex = normmap
</pre></blockquote>

====Light emission====

All materials can emit light:

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.emission''' || texture || 0.0 0.0 0.0 || color of the emitted light
|-
|'''scene.materials.<material name>.emission.gain''' || spectrum || 1.0 1.0 1.0 || multiplier for lamp brigthness
|-
|'''scene.materials.<material name>.emission.power''' || float || 0.0 || lamp output power in watts. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.materials.<material name>.emission.efficency''' || float || 0.0 || luminous efficacy in lumens/watt. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.materials.<material name>.emission.mapfile''' || string || || the name of an optional image map that can be used to scale the emitted light
|-
|'''scene.materials.<material name>.emission.gamma''' || float || 2.2 || gamma value of the image map defined with .mapfile property
|-
|'''scene.materials.<material name>.emission.iesfile''' || string || || a [http://en.wikipedia.org/wiki/Illuminating_Engineering_Society_of_North_America IES] profile of emitted light
|-
|'''scene.materials.<material name>.emission.iesblob''' || blob || || a [http://en.wikipedia.org/wiki/Illuminating_Engineering_Society_of_North_America IES] profile of emitted light embedded in a blob
|-
|'''scene.materials.<material name>.emission.flipz''' || bool || false || flip the IES profile along the Z axis
|-
|'''scene.materials.<material name>.emission.samples''' || int || -1 || the number of shadow ray to trace to compute direct light from this material. This property is an hint and the render engine can ignore this information. -1 means use the default global value.
|-
|'''scene.materials.<material name>.emission.map.width''' || unsigned int || 0 || scale the image or IES map to the specified width. 0 means use the original size
|-
|'''scene.materials.<material name>.emission.map.height''' || unsigned int || 0 || scale the image or IES map to the specified height. 0 means use the original size
|-
|'''scene.materials.<material name>.emission.id''' || int || 0 || the radiance group the light emitted from this material is assigned to.
|-
|'''scene.materials.<material name>.emission.theta''' || float || 90.0 || How directional the light is emitted, set as the half-angle of the light source. Default is 90°. Smaller values mean that more light is emitted in the direction of the face normals and less to the sides.
|-
|'''scene.materials.<material name>.emission.importance''' || float || 1.0 || A hint how often to sample this light source compared to other lights
|}

===Type: archglass===

This material should be used to replace glass material of windows when rendering architectural interiors. It allows direct light to pass trough.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "archglass" || type of material
|-
|'''scene.materials.<material name>.kr''' || texture || 1.0 1.0 1.0 || texture or constant reflected color of the material
|-
|'''scene.materials.<material name>.kt''' || texture || 1.0 1.0 1.0 || texture or constant transmitted color of the material
|-
|'''scene.materials.<material name>.interiorior''' || texture || 1.5 || inside texture or constant index of refraction (only for volume-less rendering)
|-
|'''scene.materials.<material name>.exteriorior''' || texture || 1.0 || outside texture or constant index of refraction (only for volume-less rendering)
|-
|'''scene.materials.<material name>.filmthickness''' || texture || none || thickness (in nanometers) of a [https://en.wikipedia.org/wiki/Thin-film_interference thin-film coating] on the surface. This property is optional, if it is not defined, the coating is disabled.
|-
|'''scene.materials.<material name>.filmior''' || texture || none || Refractive index of the thin-film coating. This property is optional, if it is not defined, the coating is disabled.
|}

===Type: carpaint===

Car Paint is an advanced glossy material, simulating a diffuse surface with mutliple reflective coatings.

The available presets for the carpaint material are:

*"ford f8"
*"polaris silber"
*"opel titan"
*"bmw339"
*"2k acrylack"
*"white"
*"blue"
*"blue matte"

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "carpaint" || type of material
|-
|'''scene.materials.<material name>.preset''' || string || "ford f8" || one of the avilable presets
|-
|'''scene.materials.<material name>.ka''' || texture || 0.0 0.0 0.0 || absorption color
|-
|'''scene.materials.<material name>.d''' || texture || 0.0 || absorption depth
|-
|'''scene.materials.<material name>.kd''' || texture || 0.0 0.0 0.0 || diffuse color
|-
|'''scene.materials.<material name>.ks1''' || texture || 0.0 0.0 0.0 || specular color - layer 1
|-
|'''scene.materials.<material name>.ks2''' || texture || 0.0 0.0 0.0 || specular color - layer 2
|-
|'''scene.materials.<material name>.ks3''' || texture || 0.0 0.0 0.0 || specular color - layer 3
|-
|'''scene.materials.<material name>.r1''' || texture || 0.0 0.0 0.0 || fresnel effect strength - layer 1
|-
|'''scene.materials.<material name>.r2''' || texture || 0.0 0.0 0.0 || fresnel effect strength - layer 2
|-
|'''scene.materials.<material name>.r3''' || texture || 0.0 0.0 0.0 || fresnel effect strength - layer 3
|-
|'''scene.materials.<material name>.m1''' || texture || 0.0 0.0 0.0 || roughness - layer 1
|-
|'''scene.materials.<material name>.m2''' || texture || 0.0 0.0 0.0 || roughness - layer 2
|-
|'''scene.materials.<material name>.m3''' || texture || 0.0 0.0 0.0 || roughness - layer 3
|}

===Type: cloth===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "cloth" || type of material
|-
|'''scene.materials.<material name>.preset''' || string || "denim" || denim, silk_charmeuse, silk_shantung, cotton_twill, wool_garbardine or polyester_lining_cloth
|-
|'''scene.materials.<material name>.weft_kd''' || texture || 0.5 0.5 0.5 || coefficient of diffuse reflection in one weave direction
|-
|'''scene.materials.<material name>.weft_ks''' || texture || 0.5 0.5 0.5 || coefficient of specular reflection in one weave direction
|-
|'''scene.materials.<material name>.warp_kd''' || texture || 0.5 0.5 0.5 || coefficient of diffuse reflection in the opposite weave direction
|-
|'''scene.materials.<material name>.warp_ks''' || texture || 0.5 0.5 0.5 || coefficient of specular reflection in the opposite weave direction
|-
|'''scene.materials.<material name>.repeat_u''' || float || 100.0 || thread count in the u direction
|-
|'''scene.materials.<material name>.repeat_v''' || float || 100.0 || thread count in the v direction
|}

===Type: disney===

For more details, refer to the [https://disney-animation.s3.amazonaws.com/library/s2012_pbs_disney_brdf_notes_v2.pdf original paper].

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "disney" || type of material
|-
|'''scene.materials.<material name>.basecolor''' || texture || 0.5 0.5 0.5 || Base color
|-
|'''scene.materials.<material name>.subsurface''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.roughness''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.metallic''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.specular''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.speculartint''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.clearcoat''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.clearcoatgloss''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.anisotropic''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.sheen''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.sheentint''' || texture || 0.0 ||
|-
|'''scene.materials.<material name>.filmamount''' || texture || none || Linear interpolation between no film (0) and full film effect (1) for artistic control. This property is optional, if it is not defined, the coating is disabled.
|-
|'''scene.materials.<material name>.filmthickness''' || texture || none || thickness (in nanometers) of a [https://en.wikipedia.org/wiki/Thin-film_interference thin-film coating] on the surface. This property is optional, if it is not defined, the coating is disabled.
|-
|'''scene.materials.<material name>.filmior''' || texture || none || Refractive index of the thin-film coating. This property is optional, if it is not defined, the coating is disabled.
|}

===Type: glass===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "glass" || type of material
|-
|'''scene.materials.<material name>.kr''' || texture || 1.0 || texture or constant reflected color of the material
|-
|'''scene.materials.<material name>.kt''' || texture || 1.0 || texture or constant transmitted color of the material
|-
|'''scene.materials.<material name>.interiorior''' || texture || 1.5 || inside texture or constant index of refraction (only for volume-less rendering)
|-
|'''scene.materials.<material name>.exteriorior''' || texture || 1.0 || outside texture or constant index of refraction (only for volume-less rendering)
|-
|'''scene.materials.<material name>.cauchyc''' || texture || 0.0 || if defined and > 0.0, enable dispersion. The value is the C term of the [https://en.wikipedia.org/wiki/Cauchy%27s_equation Cauchy's equation]
|-
|'''scene.materials.<material name>.filmthickness''' || texture || none || thickness (in nanometers) of a [https://en.wikipedia.org/wiki/Thin-film_interference thin-film coating] on the surface. This property is optional, if it is not defined, the coating is disabled.
|-
|'''scene.materials.<material name>.filmior''' || texture || none || Refractive index of the thin-film coating. This property is optional, if it is not defined, the coating is disabled.
|}

===Type: glossy2===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "glossy2" || type of material
|-
|'''scene.materials.<material name>.kd''' || texture || 0.5 0.5 0.5 || texture or constant diffuse color of the material
|-
|'''scene.materials.<material name>.ks''' || texture || 0.5 0.5 0.5 || texture or constant specular color of the material
|-
|'''scene.materials.<material name>.uroughness''' || texture || 0.1 || texture or constant roughness value along u coordinate of the material
|-
|'''scene.materials.<material name>.vroughness''' || texture || 0.1 || texture or constant roughness value along v coordinate of the material
|-
|'''scene.materials.<material name>.ka''' || texture || 0.0 0.0 0.0 || texture or constant value of coefficient of absorption of the coating layer
|-
|'''scene.materials.<material name>.d''' || texture || 0.0 || texture or constant value of the depth (thickness) of the coating layer for absorption effects. (0 = disables)
|-
|'''scene.materials.<material name>.index''' || texture || 0.0 0.0 0.0 || IOR of the coating. IOR overrides color Ks if both are specified
|-
|'''scene.materials.<material name>.multibounce''' || bool || false || simulation of asperity (velvet-like reflection) on the glossy surface
|}

===Type: glossytranslucent===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "glossytranslucent" || type of material
|-
|'''scene.materials.<material name>.kd''' || texture || 0.5 0.5 0.5 || texture or constant diffuse color of the material
|-
|'''scene.materials.<material name>.kt''' || texture || 0.5 0.5 0.5 || texture or constant transmission color of the material
|-
|'''scene.materials.<material name>.ks''' || texture || 0.5 0.5 0.5 || texture or constant specular color of the material
|-
|'''scene.materials.<material name>.ks_bf''' || texture || 0.5 0.5 0.5 || texture or constant backface specular color of the material
|-
|'''scene.materials.<material name>.uroughness''' || texture || 0.1 || texture or constant roughness value along u coordinate of the material
|-
|'''scene.materials.<material name>.uroughness_bf''' || texture || 0.1 || texture or constant backface roughness value along u coordinate of the material
|-
|'''scene.materials.<material name>.vroughness''' || texture || 0.1 || texture or constant roughness value along v coordinate of the material
|-
|'''scene.materials.<material name>.vroughness_bf''' || texture || 0.1 || texture or constant backface roughness value along v coordinate of the material
|-
|'''scene.materials.<material name>.ka''' || texture || 0.0 0.0 0.0 || texture or constant value of coefficient of absorption of the coating layer
|-
|'''scene.materials.<material name>.ka_bf''' || texture || 0.0 0.0 0.0 || texture or constant value of backface coefficient of absorption of the coating layer
|-
|'''scene.materials.<material name>.d''' || texture || 0.0 || texture or constant value of the depth (thickness) of the coating layer for absorption effects. (0 = disables)
|-
|'''scene.materials.<material name>.d_bf''' || texture || 0.0 || texture or constant value of the backface depth (thickness) of the coating layer for absorption effects. (0 = disables)
|-
|'''scene.materials.<material name>.index''' || texture || 0.0 0.0 0.0 || IOR of the coating. IOR overrides color Ks if both are specified
|-
|'''scene.materials.<material name>.index_bf''' || texture || 0.0 0.0 0.0 || IOR of the backface coating. IOR overrides color Ks if both are specified
|-
|'''scene.materials.<material name>.multibounce''' || bool || false || simulation of asperity (velvet-like reflection) on the glossy surface
|-
|'''scene.materials.<material name>.multibounce_bf''' || bool || false || backface simulation of asperity (velvet-like reflection) on the glossy surface
|}

===Type: glossycoating===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "glossycoating" || type of material
|-
|'''scene.materials.<material name>.base''' || string || || name of base material, the coating layer is added on top of this material
|-
|'''scene.materials.<material name>.ks''' || texture || 0.5 0.5 0.5 || texture or constant specular color of the material
|-
|'''scene.materials.<material name>.uroughness''' || texture || 0.1 || texture or constant roughness value along u coordinate of the material
|-
|'''scene.materials.<material name>.vroughness''' || texture || 0.1 || texture or constant roughness value along v coordinate of the material
|-
|'''scene.materials.<material name>.ka''' || texture || 0.0 0.0 0.0 || texture or constant value of coefficient of absorption of the coating layer
|-
|'''scene.materials.<material name>.d''' || texture || 0.0 || texture or constant value of the depth (thickness) of the coating layer for absorption effects. (0 = disables)
|-
|'''scene.materials.<material name>.index''' || texture || 0.0 0.0 0.0 || IOR of the coating. IOR overrides color Ks if both are specified
|-
|'''scene.materials.<material name>.multibounce''' || bool || false || simulation of asperity (velvet-like reflection) on the glossy surface
|}

===Type: matte===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "matte" || type of material
|-
|'''scene.materials.<material name>.kd''' || texture || 0.75 0.75 0.75 || texture or constant color of the matte material
|}

===Type: mattetranslucent===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "mattetranslucent" || type of material
|-
|'''scene.materials.<material name>.kr''' || texture || 0.5 0.5 0.5 || texture or constant reflected color of the material
|-
|'''scene.materials.<material name>.kt''' || texture || 0.5 0.5 0.5 || texture or constant transmitted color of the material
|}

===Type: metal2===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "metal2" || type of material
|-
|'''scene.materials.<material name>.fresnel''' || fresnel texture || ... || [[#Type:_Fresnel_Textures | fresnel texture]]
|-
|'''scene.materials.<material name>.uroughness''' || texture || 0.1 || texture or constant roughness value along u coordinate of the material
|-
|'''scene.materials.<material name>.vroughness''' || texture || 0.1 || texture or constant roughness value along v coordinate of the material
|-
|'''scene.materials.<material name>.preset''' || string || "aluminium" || (DEPRECATED) "aluminium", "silver", "copper", "gold" or "amorphous carbon"
|-
|'''scene.materials.<material name>.n''' || texture || 0.5 0.5 0.5 || (DEPRECATED) texture or constant value. It can be used to directly define a fresnelapproxn texture on overwrite the .preset property
|-
|'''scene.materials.<material name>.k''' || texture || 0.5 0.5 0.5 || (DEPRECATED) texture or constant value. It can be used to directly define a fresnelapproxk texture on overwrite the .preset property
|}

===Type: mirror===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "mirror" || type of material
|-
|'''scene.materials.<material name>.kr''' || texture || 1.0 1.0 1.0 || texture or constant reflected color of the material
|}

===Type: mix===

This material can be used to mix 2 other materials.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "mix" || type of material
|-
|'''scene.materials.<material name>.material1''' || string || mat1 || name of another material
|-
|'''scene.materials.<material name>.material2''' || string || mat2 || name of another material
|-
|'''scene.materials.<material name>.amount''' || texture || 0.5 || texture or constant value used to mix the materials
|}

===Type: null===

This is empty, not visible material. It can be combined by using mix material with others. It is often used in combination with the alpha channel of an image map to render leafs, etc.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "null" || type of material
|}

===Type: roughglass===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "roughglass" || type of material
|-
|'''scene.materials.<material name>.kr''' || texture || 1.0 1.0 1.0 || texture or constant reflected color of the material
|-
|'''scene.materials.<material name>.kt''' || texture || 1.0 1.0 1.0 || texture or constant transmitted color of the material
|-
|'''scene.materials.<material name>.interiorior''' || texture || 1.5 || inside texture or constant index of refraction
|-
|'''scene.materials.<material name>.exteriorior''' || texture || 1.0 || outside texture or constant index of refraction
|-
|'''scene.materials.<material name>.uroughness''' || texture || 0.1 || texture or constant roughness value along u coordinate of the material
|-
|'''scene.materials.<material name>.vroughness''' || texture || 0.1 || texture or constant roughness value along v coordinate of the material
|-
|'''scene.materials.<material name>.filmthickness''' || texture || none || thickness (in nanometers) of a [https://en.wikipedia.org/wiki/Thin-film_interference thin-film coating] on the surface. This property is optional, if it is not defined, the coating is disabled.
|-
|'''scene.materials.<material name>.filmior''' || texture || none || Refractive index of the thin-film coating. This property is optional, if it is not defined, the coating is disabled.
|}

===Type: roughmatte===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "roughmatte" || type of material
|-
|'''scene.materials.<material name>.kd''' || texture || 0.75 0.75 0.75 || texture or constant color of the roughmatte material
|-
|'''scene.materials.<material name>.sigma''' || texture || 0.0 || the sigma parameter in the Oren-Nayer shader in degrees. Zero for pure Lambertian reflection
|}

===Type: velvet===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.materials.<material name>.type''' || string || "velvet" || type of material
|-
|'''scene.materials.<material name>.kd''' || texture || 0.5 0.5 0.5 || color of the material's fuzz
|-
|'''scene.materials.<material name>.p1''' || texture || -2.0 || polynomial that influences the fuzz
|-
|'''scene.materials.<material name>.p2''' || texture || 20.0 || polynomial that influences the fuzz
|-
|'''scene.materials.<material name>.p3''' || texture || 2.0 || polynomial that influences the fuzz
|-
|'''scene.materials.<material name>.thickness''' || texture || 0.1 || height of the fuzz
|}

==Objects==

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.objects.<object name>.material''' || string || || type of object material
|-
|'''scene.objects.<object name>.shape''' || string || || name of [[#Shapes | shape]] with the triangle mesh description.Memory required to store the triangle mesh information is allocated only once if 2 or more different objects share the same shape, use .transformation property and true instancing is enabled.
|-
|'''scene.objects.<object name>.ply''' || string || || '''(Deprecated, use .shape instead)''' name of [http://en.wikipedia.org/wiki/PLY_(file_format) PLY] file with the triangle mesh description. Memory required to store the triangle mesh information is allocated only once if 2 or more different objects share the same file, use .transformation property and true instancing is enabled.
|-
|'''scene.objects.<object name>.transformation''' || matrix 4x4 || 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 || transformation matrix
|-
|'''scene.objects.<object name>.vertices''' || float || || This is an alternative syntax to using PLY file. It is an in-lined definition of the triangle mesh. It is a list of float values defining the vertices of the mesh (i.e. 3 coordinates for each vertex).
|-
|'''scene.objects.<object name>.faces''' || unsigned int || || This is an alternative syntax to using PLY file. It is an in-lined definition of the triangle mesh. It is a list of unsigned int values defining the triangles of the mesh (i.e. 3 index of vertices for each triangle).
|-
|'''scene.objects.<object name>.id''' || unsigned int || || object ID
|-
|'''scene.objects.<object name>.camerainvisible''' || bool || false || toggle visibility for camera rays. If set to true, the object will not show up in camera rays, but it will still be visible in reflections, refractions, shadows, indirect light etc.
|}

===Object Motion Blur===

LuxCore supports transformation motion blur for objects.
Motion blur is enabled if an object has a motion system defined as described below.

A motion system consists of steps (at least 2). Each step has a time (in seconds) and a transformation matrix of the object at this point in time.
Step indices start at 0. The times have to be monotonic (each greater than the last).

Note that the embree accelerator only supports a maximum of 129 time steps.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.objects.<object name>.motion.<step>.time''' || float || || time (in seconds) of the step
|-
|'''scene.objects.<object name>.motion.<step>.transformation''' || matrix 4x4 || 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 || transformation matrix of the object at the given step
|-
|}

==Shapes==

===Type: mesh===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.shapes.<shape name>.type''' || string || "mesh" || mesh shape
|-
|'''scene.shapes.<shape name>.ply''' || string || ... || mesh path (e.g ''scenes/luxball/luxball-shell.ply'')
|-
|'''scene.shapes.<shape name>.appliedtransformation''' || Matrix4x4 || 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0|| transformation matrix applied to the mesh vertices. Used to define the local object reference space.
|}

===Type: inlinedmesh===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.shapes.<shape name>.type''' || string || "inlinedmesh" || inlinedmesh shape
|-
|'''scene.shapes.<shape name>.vertices''' || vector || ... || inlinedmesh vertices (e.g 0.0 0.0 0.0 1.0 0.0 0.0 0.0 1.0 0.0)
|-
|'''scene.shapes.<shape name>.faces''' || vector || ... || inlinedmesh faces (e.g 0 1 2)
|-
|'''scene.shapes.<shape name>.appliedtransformation''' || Matrix4x4 || 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0|| transformation matrix applied to the mesh vertices. Used to define the local object reference space.
|}

===Type: pointiness===

Contains surface curvature information in vertex alpha channel. 
You can access this information in materials via a hitpointalpha texture. 
The values range from -1 to 1 (float). 
Values from -1 to 0 are concave, while values from 0 to 1 are convex.

[[ Shape:_Pointiness | Examples ]]

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.shapes.<shape name>.type''' || string || "pointiness" || pointiness shape
|-
|'''scene.shapes.<shape name>.source''' || string || ... || pointiness source (a mesh shape)
|}

===Type: strands===

Can be used for hair, fur, grass etc. 
Note that you need to define the camera before defining any strands shapes, because the tesselation process is viewpoint-dependent.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.shapes.<shape name>.type''' || string || "strands" || strands shape
|-
|'''scene.shapes.<shape name>.file''' || string || ... || strands file (''scenes/strands/straight.hair'')
|}

====Strands tessellation methods====

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.shapes.<shape name>.tessellation.type''' || string || "ribbon" || ribbon tessellation
|-
|'''scene.shapes.<shape name>.tessellation.usecameraposition''' || bool || 1 || use camera position
|}

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.shapes.<shape name>.tessellation.type''' || string || "ribbonadaptive" || ribbon adaptive tessellation method
|-
|'''scene.shapes.<shape name>.tessellation.adaptative.maxdepth''' || unsigned int || 12 || max tessellation depth
|-
|'''scene.shapes.<shape name>.tessellation.adaptative.error ''' || float || 0.0075 || max tessellation error
|}

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.shapes.<shape name>.tessellation.type''' || string || "solid" || solid tessellation method
|-
|'''scene.shapes.<shape name>.tessellation.solid.sidecount ''' || unsigned int || 12 || tessellation's side count
|}

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.shapes.<shape name>.tessellation.type''' || string || "solidadaptive" || solidadaptive tessellation method
|-
|'''scene.shapes.<shape name>.tessellation.solidadaptive.sidecount ''' || unsigned int || 8 || tessellation's side count
|-
|'''scene.shapes.<shape name>.tessellation.solidadaptive.maxdepth''' || unsigned int || 16 || tessellation's max depth
|-
|'''scene.shapes.<shape name>.tessellation.solidadaptive.error''' || float || 0.05 || tessellation's max error
|}

===Type: group===

Todo.

===Type: displacement===

Todo.

===Type: subdiv===

Todo.

===Type: harlequin===

Todo.

===Type: simplify===

Todo.

===Type: islandaov===

Todo.

===Type: randomtriangleaov===

Todo.

==Light sources==

Check [[Lighting|LuxCoreRender Lighting]] for an high level description and example of the light sources.

===Common parameters===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.gain''' || spectrum || 1.0 1.0 1.0 || intensity of the light
|-
|'''scene.lights.<light name>.transformation''' || matrix 4x4 || 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0 1.0 || transformation matrix
|-
|'''scene.lights.<light name>.samples''' || int || -1 || the number of shadow ray to trace to compute direct light for this light source. This property is an hint and the render engine can ignore this information. -1 means use the default global value.
|-
|'''scene.lights.<light name>.id''' || int || 0 || the radiance group the light emitted from this material is assigned to.

|-
|'''scene.lights.<light name>.importance''' || float || 1.0 || A hint how often to sample this light compared to other lights
|}

===Type: sun===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "sun" || type of light
|-
|'''scene.lights.<light name>.turbidity''' || float || 2.2 || turbidity can go from 1.0 to 30+. 2-6 are most useful for clear days
|-
|'''scene.lights.<light name>.relsize''' || float || 1.0 || relative size to the sun
|-
|'''scene.lights.<light name>.dir''' || vector || 0.0 0.0 1.0 || direction vector of the sun
|-
|'''scene.lights.<light name>.visibility.indirect.diffuse.enable''' || bool || true || if the light source is visible by indirect rays on diffuse surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.visibility.indirect.glossy.enable''' || bool || true || if the light source is visible by indirect rays on glossy surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.visibility.indirect.specular.enable''' || bool || true || if the light source is visible by indirect rays on specular surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|}

===Type: sky2===

Hosek-Wilkie sky model.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "sky2" || type of light
|-
|'''scene.lights.<light name>.turbidity''' || float || 2.2 || turbidity can go from 1.0 to 30+. 2-6 are most useful for clear days
|-
|'''scene.lights.<light name>.dir''' || vector || 0.0 0.0 1.0 || direction vector of the sun
|-
|'''scene.lights.<light name>.gain''' || vector || ... || gain
|-
|'''scene.lights.<light name>.groundalbedo''' || vector || 0.5 0.5 0.5 || ground albedo
|-
|'''scene.lights.<light name>.visibility.indirect.diffuse.enable''' || bool || true || if the light source is visible by indirect rays on diffuse surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.visibility.indirect.glossy.enable''' || bool || true || if the light source is visible by indirect rays on glossy surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.visibility.indirect.specular.enable''' || bool || true || if the light source is visible by indirect rays on specular surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.ground.enable''' || bool || 1 || enable ground color
|-
|'''scene.lights.<light name>.ground.color''' || vector|| ... || RGB ground color
|}

===Type: infinite===

Spherical lightsource surrounding the scene at infinite distance. 
Used for image based lighting (IBL) and HDR environment lighting if the file is a high dynamic range image.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "infinite" || type of light
|-
|'''scene.lights.<light name>.file''' || string || "image.png" || filename of the environment map
|-
|'''scene.lights.<light name>.gamma''' || float || 2.2 || gamma correction used by the image map
|-
|'''scene.lights.<light name>.storage''' || string || "auto" || environment map storage type ("auto", "byte", "half" or "float")
|-
|'''scene.lights.<light name>.visibility.indirect.diffuse.enable''' || bool || true || if the light source is visible by indirect rays on diffuse surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.visibility.indirect.glossy.enable''' || bool || true || if the light source is visible by indirect rays on glossy surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.visibility.indirect.specular.enable''' || bool || true || if the light source is visible by indirect rays on specular surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.sampleupperhemisphereonly''' || bool || false || an option set to black the lower hemisphere. Mostly useful for shadow catchers.
|}

===Type: point===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "point" || type of light
|-
|'''scene.lights.<light name>.position''' || point || 0.0 0.0 0.0 || position
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.power''' || float || 0.0 || lamp output power in watts. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.efficency''' || float || 0.0 || luminous efficacy in lumens/watt. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|}

===Type: mappoint===

Point light with support for IES files or image maps controlling the strength of light emitted.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "mappoint" || type of light
|-
|'''scene.lights.<light name>.position''' || point || 0.0 0.0 0.0 || position
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.power''' || float || 0.0 || lamp output power in watts. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.efficency''' || float || 0.0 || luminous efficacy in lumens/watt. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.mapfile''' || string || || the name of an optional image map that can be used to scale the emitted light
|-
|'''scene.lights.<light name>.gamma''' || float || 2.2 || gamma value of the image map defined with .mapfile property
|-
|'''scene.lights.<light name>.iesfile''' || string || || a [http://en.wikipedia.org/wiki/Illuminating_Engineering_Society_of_North_America IES] profile of emitted light and the render engine can ignore this information. -1 means use the default global value.
|-
|'''scene.lights.<light name>.iesblob''' || string || || a [http://en.wikipedia.org/wiki/Illuminating_Engineering_Society_of_North_America IES] profile of emitted light embedded in a blob
|-
|'''scene.lights.<light name>.flipz''' || bool || false || flip the IES profile along the Z axis
|-
|'''scene.lights.<light name>.map.width''' || unsigned int || 0 || scale the image or IES map to the specified width. 0 means use the original size
|-
|'''scene.lights.<light name>.map.height''' || unsigned int || 0 || scale the image or IES map to the specified height. 0 means use the original size
|}

===Type: sphere===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "sphere" || type of light
|-
|'''scene.lights.<light name>.position''' || point || 0.0 0.0 0.0 || position
|-
|'''scene.lights.<light name>.radius''' || float || 1.0 || position
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.power''' || float || 0.0 || lamp output power in watts. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.efficency''' || float || 0.0 || luminous efficacy in lumens/watt. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|}

===Type: mapsphere===

Sphere light with support for IES files or image maps controlling the strength of light emitted.

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "mapsphere" || type of light
|-
|'''scene.lights.<light name>.position''' || point || 0.0 0.0 0.0 || position
|-
|'''scene.lights.<light name>.radius''' || float || 1.0 || position
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.power''' || float || 0.0 || lamp output power in watts. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.efficency''' || float || 0.0 || luminous efficacy in lumens/watt. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.mapfile''' || string || || the name of an optional image map that can be used to scale the emitted light
|-
|'''scene.lights.<light name>.gamma''' || float || 2.2 || gamma value of the image map defined with .mapfile property
|-
|'''scene.lights.<light name>.iesfile''' || string || || a [http://en.wikipedia.org/wiki/Illuminating_Engineering_Society_of_North_America IES] profile of emitted light and the render engine can ignore this information. -1 means use the default global value.
|-
|'''scene.lights.<light name>.iesblob''' || string || || a [http://en.wikipedia.org/wiki/Illuminating_Engineering_Society_of_North_America IES] profile of emitted light embedded in a blob
|-
|'''scene.lights.<light name>.flipz''' || bool || false || flip the IES profile along the Z axis
|-
|'''scene.lights.<light name>.map.width''' || unsigned int || 0 || scale the image or IES map to the specified width. 0 means use the original size
|-
|'''scene.lights.<light name>.map.height''' || unsigned int || 0 || scale the image or IES map to the specified height. 0 means use the original size
|}

===Type: spot===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "spot" || type of light
|-
|'''scene.lights.<light name>.position''' || point || 0.0 0.0 0.0 || position
|-
|'''scene.lights.<light name>.target''' || point || 0.0 0.0 1.0 || target
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.power''' || float || 0.0 || lamp output power in watts. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.efficency''' || float || 0.0 || luminous efficacy in lumens/watt. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.coneangle''' || float || 30.0 || angle in degrees of the spotlight cone
|-
|'''scene.lights.<light name>.conedeltaangle''' || float || 5.0 || angle at which the spotlight intensity starts to fade from the edge
|}

===Type: projection===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "projection" || type of light
|-
|'''scene.lights.<light name>.position''' || point || 0.0 0.0 0.0 || position
|-
|'''scene.lights.<light name>.target''' || point || 0.0 0.0 1.0 || target
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.power''' || float || 0.0 || lamp output power in watts. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.efficency''' || float || 0.0 || luminous efficacy in lumens/watt. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.fov''' || float || 45.0 || field of view in terms of angular spread along the shorter image axis
|-
|'''scene.lights.<light name>.mapfile''' || string || || filename of the image to project. If not specified, a constat light color will be used.
|-
|'''scene.lights.<light name>.gamma''' || float || 2.2 || gamma value of the image map defined with .mapfile property
|}

===Type: constantinfinite===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "constantinfinite" || type of light
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.visibility.indirect.diffuse.enable''' || bool || true || if the light source is visible by indirect rays on diffuse surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.visibility.indirect.glossy.enable''' || bool || true || if the light source is visible by indirect rays on glossy surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|-
|'''scene.lights.<light name>.visibility.indirect.specular.enable''' || bool || true || if the light source is visible by indirect rays on specular surfaces. This is an hint and can be optional supported by the render engine. It can be used to remove fireflies.
|}

===Type: sharpdistant===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "sharpdistant" || type of light
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.direction''' || vector || 0.0 0.0 1.0 || direction
|}

===Type: distant===

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "distant" || type of light
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.direction''' || vector || 0.0 0.0 1.0 || direction
|-
|'''scene.lights.<light name>.theta''' || float || 10.0 || half angle of the light source in degree. Must be > 0 for soft shadows
|}

===Type: laser===

A light source emitting parallel light rays (like sharpdistant light, but starting inside the scene instead of infinitely far away).

{| class="wikitable" cellspacing="2"
!Property name
!Property type
!Default value
!Description
|-
|'''scene.lights.<light name>.type''' || string || "laser" || type of light
|-
|'''scene.lights.<light name>.position''' || point || 0.0 0.0 0.0 || position
|-
|'''scene.lights.<light name>.target''' || point || 0.0 0.0 1.0 || target
|-
|'''scene.lights.<light name>.color''' || spectrum || 1.0 1.0 1.0 || color
|-
|'''scene.lights.<light name>.power''' || float || 0.0 || lamp output power in watts. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.efficency''' || float || 0.0 || luminous efficacy in lumens/watt. Setting 0 for both power and efficacy bypasses this feature and uses only the lamp gain
|-
|'''scene.lights.<light name>.radius''' || float || 0.01 || radius of the laser beam
|}

LuxCore SDL Reference Manual

2020-08-27T13:50:23Z

Byob:

Reference manual for:

* [[LuxCore_SDL_Reference_Manual_v2.5|v2.5 (in development)]]
* [[LuxCore_SDL_Reference_Manual_v2.4|v2.4]]
* [[LuxCore_SDL_Reference_Manual_v2.3|v2.3]]
* [[LuxCore_SDL_Reference_Manual_v2.2|v2.2]]
* [[LuxCore_SDL_Reference_Manual_v2.1|v2.1]]
* [[LuxCore_SDL_Reference_Manual_v2.0|v2.0]]

LuxCoreRender Materials Glossy

2020-07-27T08:44:23Z

Byob: /* Absorption Color / Depth */

[[file:Luxcore_materials_glossy.jpg|400px]]

The Glossy material represents a diffuse surface with a varnish coat. It is well suited to most plastics, lacquered wood, glazed ceramics (porcelain/tile), and wet surfaces. With the "multibounce" option enabled, the material will have a soft appearance, mimicking the scattering by fuzz or hair, making it well suited to rendering many types of cloth.

== Options ==

=== Diffuse Color ===

This is the color of the matte base layer, and will be the main color of the material.

=== Specular Color and IOR ===

This is the color of the varnish coat. In many real world materials, all color is in the base rather than the gloss, so this color should often be left as gray. (For example, the paint on porcelain is applied before the glaze, so your paint texture should only be on the diffuse channel). Darker colors will make the material less shiny, especially at shallow angles. Optionally, you can specify an index of refraction for the coating material, however this will prevent you from coloring the coating, it will always be gray. This can be useful if you want to specify a specific material making up the coating. For example, a wet floor would have IOR = 1.333, the IOR of water.

The specular color should not be set higher than about .25, and many everyday materials will have much lower values, such as .03-.05.


=== Roughness ===

This determines how shiny the material is. Lower values are shinier, with 0 being a perfect reflector and .8 being matte. Values between .8 and 1 are an unrealistic "super-matte" and should be avoided.

=== Absorption Color / Depth ===

These allow you to specify the color and depth of light absorption by the varnish. Note that since this is an absorption color, it will seem to work "backwards". Setting it to blue will cause blue light to be absorbed, leaving you with a yellow-orange appearance. You can invert the color before plugging it into this slot to make it easier to achieve the desired look. To disable this option, set the color to full black or the absorption depth to 0 nm. Conversely, the absorption depth needs to be greater than 0 to see an effect.

=== Multibounce ===

The option will simulate light being scattered at the surface by things such as fuzz or fine hair. It is useful when using glossy for a skin or cloth material, and will give a soft, fuzzy appearance.

[[file:Luxcore_materials_glossy_multibounce.jpg|left|thumb|400px|Left side no multibounce and right side multibounce]]
 

Back to [[LuxCoreRender_Materials|Materials]]

LuxCoreRender Tutorials

2020-07-26T12:01:59Z

Byob: /* Video Tutorials */

== Video Tutorials ==

=== Blender 2.8x ===

{| width="100%"
|
[[File:BlendLuxCore-2.8-Interior-Tutorial.png|thumb|none|300x300px|link=https://youtu.be/XjwCOIWwQo4| [https://youtu.be/XjwCOIWwQo4 BlendLuxCore v2.8 Interior Tutorial] ]]
|
[[File:Shader_tutorial.jpg|thumb|none|300x300px|link=https://youtu.be/xZOdXI9181k| [https://youtu.be/xZOdXI9181k LuxCore Shader Tutorial 1] ]]
|
[[File:Shader_2.jpg|thumb|none|300x300px|link=https://youtu.be/79V_ySn5ZoY| [https://youtu.be/79V_ySn5ZoY LuxCore Shader Tutorial 2] ]]
|}

{| width="100%"
|
[[File:Orange_juice_tutorial.png|thumb|none|300x300px|link=https://youtu.be/R2-u3YNJbHQ| [https://youtu.be/R2-u3YNJbHQ Orange Juice Tutorial] ]]
|
[[File:Caustics_pool_tutorial.png|thumb|none|300x300px|link=https://youtu.be/mHYpWe4KF8I| [https://youtu.be/mHYpWe4KF8I Caustics Pool Tutorial] ]]
|
[[File:Caustics_Master.jpg|thumb|none|300x300px|link=https://youtu.be/gvo9WLBqNVU| [https://youtu.be/gvo9WLBqNVU Caustics & Fog] ]]
|}

{| width="100%"
|
[[File:Displacement_tut.jpg|thumb|none|300x300px|link=https://youtu.be/OrgCGEJL_sk| [https://youtu.be/OrgCGEJL_sk Displacement Tutorial] ]]
|
[[File:Heads.jpg|thumb|none|300x300px|link=https://youtu.be/1COAMA_r1Ao| [https://youtu.be/1COAMA_r1Ao Skin Shader Tutorial] ]]
|
[[File:HAIIRRR.jpg|thumb|none|300x300px|link=https://youtu.be/RMKwv6N4trQ| [https://youtu.be/RMKwv6N4trQ Hair Shader Tutorial] ]]
|}

{| width="100%"
|
[[File:Light Groups2.jpg|thumb|none|300x300px|link=https://youtu.be/Lsz9yx6GM7I| [https://youtu.be/Lsz9yx6GM7I Light Group Tutorial] ]]
|
[[File:Carpaint tut.jpg|thumb|none|300x300px|link=https://youtu.be/KFbk_JxPUj4| [https://youtu.be/KFbk_JxPUj4 Carpaint Tutorial] ]]
|
[[File:Pbr_leaf_texture_tut.jpg|thumb|none|300x300px|link=https://youtu.be/j8TXpqtdcvY| [https://youtu.be/j8TXpqtdcvY PBR Leaf Texture Tutorial] ]]
|}

* [https://youtu.be/UVattTf1a5Q Blender 2.8 Luxcore Engine Setting Tutorial]
* [https://youtu.be/JBYneEf62PU Blender 2.8 Luxcore Online Library Tutorial]
* [https://youtu.be/vsVIFtle9OU Blender 2.8 luxcore fast tips]
* [https://youtu.be/32Ojuidbc7k Blender 2.8 Luxcore Fast Tips Light Shape]
* [https://youtu.be/YU38Pqb8gI4 Blender 2 8 Luxcore Projector & Sci-fi laser scan Tutorial]
* [https://youtu.be/HOxWI_0y6KI Blender 2.8 Luxcore shadow catcher]

==== BlendLuxCore Guide by Mike Zurawski ====

* [https://youtu.be/Ron1se5liV8 Render settings - Tracing method I]
* [https://youtu.be/EgLSibsTpgY Render settings - Light paths II]
* [https://youtu.be/qlYrtUwhNoY Render settings - Light paths III]
* [https://youtu.be/gSwXpWc5uFg Render settings - Light strategy & Filter IV]
* [https://youtu.be/fXoa2rJu_nY Render settings - Performance & Denoiser V]
* [https://youtu.be/ogkOyOmMDpA Render settings - Halt conditions, display and viewport settings VI]
* [https://youtu.be/FnORHMBpQHY Render settings - Photon GI cache VII]

=== Tutorials by cgvirus ===

* [https://youtu.be/ZRXXe3pevxk Shadow Catcher]
* [https://youtu.be/f6o1z9cZp_0 Intel Denoiser with LuxCore in the Compositor]
* [https://youtu.be/BoVXeHuzl6s Combining Multipass AOV of LuxCoreRender in Blender compositor for Creating Beauty Pass]

=== Blender 2.79 ===

{| width="100%"
|
[[File:beginner_tutorial.jpg|thumb|none|300x300px|link=https://youtu.be/-BmXeUDRqSo| [https://youtu.be/-BmXeUDRqSo Introduction to LuxCoreRender in Blender] ]]
|
[[File:DLSC_tutorial_thumbnail.jpg|thumb|none|300x300px|link=https://youtu.be/dIfwr2YPxPw| [https://youtu.be/dIfwr2YPxPw Tutorial about the Direct Light Sampling Cache (DLSC)] ]]
|
[[File:Sss tutorial thumbnail.jpg|thumb|none|300x300px|link=https://youtu.be/gEGDyHMnlkg| [https://youtu.be/gEGDyHMnlkg Subsurface Scattering and Volume Tutorial] ]]
|}

{| width="100%"
|
[[File:Brushed steel thumbnail.png|thumb|none|300x300px|link=https://youtu.be/FGhPAP0oV9k| [https://youtu.be/FGhPAP0oV9k Brushed Steel Tutorial] ]]
|
[[File:Photongi_tutorial.jpg|thumb|none|300x300px|link=https://youtu.be/trkUldfb380| [https://youtu.be/trkUldfb380 PhotonGI Tutorial] ]]
|
[[File:LED_tutorial.png|thumb|none|300x300px|link=https://youtu.be/saGvvLWS4xs| [https://youtu.be/saGvvLWS4xs LED Tutorial] ]]
|}

== General Tutorials ==

These tutorials are not about LuxCoreRender, but about scene composition, lighting and other universal concepts.

* ciechanow.ski: [https://ciechanow.ski/lights-and-shadows/ Lights and Shadows]
* ciechanow.ski: [https://ciechanow.ski/color-spaces/ Color Spaces]
* blenderer.com: [https://www.blendernation.com/2018/06/18/how-to-make-a-beautiful-scene/ What makes a beautiful scene]
* blenderer.com: [https://www.blendernation.com/2018/06/22/how-to-improve-your-interior-scenes/ Secrets to making the best interior scenes]

== Old Tutorials for LuxBlend ==

The tutorials listed here were made with the old LuxBlend addon.

* Create nice beer using Blender and LuxCore: [https://www.youtube.com/watch?v=EtsA7iDK32A Part 1] and [https://www.youtube.com/watch?v=lJliJFKir8Y Part 2]
* [https://youtu.be/GpvHYi8uW1Y Create an interior scene using Blender and LuxCore]

LuxCoreRender Release Notes v2.4

2020-07-25T11:34:33Z

Byob: /* Fixed Bugs */

__TOC__

A user-friendly version of this changelog is available at https://luxcorerender.org/new-features-in-v2-4/.

=LuxCore=

===New Features===

* New OpenCL code to evaluate textures and materials. It doesn't require kernel re-compilation anymore
* LuxCoreUI "Fill kernel cache" menu option now pre-compile all possible GPU kernels
* LuxCore API KernelCacheFill() is now available for Python
* New 2-levels Env. Light Visibility Cache (ELVC)
* Added the support for a new ".sharpness" (default value 0.1, range [0.0, 1.0]) Intel OIDN parameter to blend original and denoised output
* Removed LuxRays support for virtual devices and hybrid rendering (old LuxRender GPU doing ray intersections and CPU everything else)
* Geometry vertex and triangle AOVs (arbitrary data associated to mesh vertices and triangle usable by textures)
* Removed the support for Triplanar texture .uvindex (side effect of the above new feature)
* New hitpointvertexaov and hitpointtriangleaov textures
* Pointiness shape can now assign curvature values to vertex AOV with .aovindex property (a 4294967296 value will force the use of alpha channel instead, default value for compatibility with the past)
* LuxCore API has now SetMeshVertexAOV() and SetMeshTriangleAOV() methods to set geometry vertex and triangle AOV
* Added the support for new Random texture
* Added the support for the new IslandAOV shape
* Added the support for RandomTriangleAOV shape
* Accelerated duplicate vertex detection in pointiness shape (from 6.7 seconds to 0.016 seconds on a 100k vertex mesh)
* LuxRays API reworked to support generic hardware devices (now OpenCL, potentially CUDA, Vulkan, Metal, etc.)
* Added the support for light groups to PhotonGI
* New LuxCore API RenderConfig::HasCachedKernels() method to check if a (long) kernel compilation time is required
* Glossycoating material on GPUs now supports bump mapping exactly like CPU version (issue #307)
* Mix material on GPUs now supports bump mapping exactly like CPU version (issue #307)
* Added processor group support to enable LuxCoreRender to use more than 64 logical processors on Windows
* Added the support for CUDA rendering
* Added the support for out of core CUDA rendering (i.e. to render scenes larger than GPU ram available)
* GPU rendering now uses 64bit image map pixel indices (i.e. removed the limit of 8 * 4GB of scene image maps)
* New cache and out-of-core friendly mode for Random/Sobol samplers
* Added the support for denoising baked light maps with Intel ODIN
* pyluxcoretools merge now supports saving film AOVs via new --aov-output option
* New improved Metropolis sampler warmup period
* Added thin film interference option for many materials
* Added the support for a new color re-mapping image pipeline plug-in using .cube files (issue #81)
* LuxCore API now support unicode UTF-8 strings and files
* luxcore::KernelCacheFill() now supports opencl.devices.select, scene.epsilon.min and scene.epsilon.max properties (issue #374)
* LuxCoreRender can now be compiled without OpenCL/CUDA SDK and it will load OpenCL/CUDA at run time (one executable can now be used for all types of installations)
* RTPathOCLRenderEngine::WaitNewFrame() takes is not more synchronous with rendering refresh
* The use of more than 64 logical processors on Windows is now extended to all render engines
* It is now possible to render scenes without light sources (!)
* The use of more than 64 logical processors on Windows is now extended to all pre-processing tasks like caches, etc.

===Fixed Bugs===

* Fixed a rendering difference when using/not using geometry negative scale transformations (issue #309)
* Fixed an out of bound access in BAKECPU
* Fixed a problem when using path.forceblackbackground.enable and env. lights
* Fixed a problem with scenes with very hard light paths and Metropolis sampler (issue #312)
* Sampler shared data are now reseted at the end of a scene edit (issue #312)
* Fixed a problem in automatic cache radius estimation of PhotonGI when using Orthographic camera (issue #324)
* Fixed an OpenCL compilation error when using large number of objects on some old GPUs
* Fixed a problem with BlendLuxCore when parsing more than 9 image pipelines (#336)
* Fixed a bug causing fireflies when using light tracing for caustics in some case (#329)
* Fixed a crash when using RemoveUnusedTextures() with Volumes (issue #377)
* Fixed a banding problem when using sphere light sources with very small radius (issue LuxCoreRender/BlendLuxCore#477)
* Fixed LXS parsing of UV inlined coordinates (issue #392)

===Changes that break backwards-compatibility===

Due to Glossycoating updated support for bump mapping on GPUs, some old scene using this kind of material/bump map combination may require some fix.

===About Performance on GPUs===

In the past versions, we have been moving from very specialized, scene dependent OpenCL kernels to general-purpose kernels. This development simultaneously has drawbacks and benefits in simple scenes, which are explained below. Complex scenes that use most features and shaders of LuxCore are less affected by the drawbacks, sometimes not at all, while still reaping the full benefits.

* v2.2 is fastest (at samples/sec) because it uses conditional compilation: lots of renderengine features and materials/textures are turned off when not used. Requires kernel re-compilations each time you change rendersettings or material/texture settings. Viewport rendering with OpenCL engines is out of the question, unless all you do is move the camera or other objects around.

* v2.3 is slower because it no longer uses conditional compilation for renderengine features: all of them are active, always. This means that re-compilations are no longer necessary when changing render settings (e.g. clamping value). Materials/textures still use conditional compilation in v2.3, requiring re-compilations on most shader changes, which makes OpenCL engines still unusable for viewport rendering.

* v2.4 is slowest because it has no conditional compilation at all anymore. The kernel is compiled once for each engine type with all features enabled, and materials/textures are now evaluated at runtime using a stack-based method.

Note, the speed difference is more visible the simpler the scene is. This is because with conditional compilation, most features will be disabled in such a scene. The more features your scene uses (meaning, the more complex it is), the less this matters. With a very complex scene using all features, v2.2 will have very similar speed to v2.4.

Also, don't forget that you now save the time for kernel compilation, always (which could range from seconds to minutes). This can actually benefit simpler scenes, if the total rendertime is short (like for animations). If you render 500 frames at 60 sec/frame, saving 20 seconds of kernel compilation can matter a lot.

===Known Problems===

* accelerator.bvh.builder.type = EMBREE_MORTON doesn't work with the latest Embree
* Python crashes when calling sys.exit()
* TILEPATHOCL (and RTPATHOCL) count the layers of transparent surfaces as an iteration of the rendering finite state machine so they require to increase the max. path depth to avoid black regions.
* Light emitted by motion blurred triangle lights is approximated using the triangle area of time 0.0 (computing triangle area at runtime would be expansive) so it may be not totally accurate if the motion blur transformation include a scale.
* Variance clamping is not applied to AOVs

=Blender Addon (BlendLuxCore)=

===New Features===

* Optimize viewport update checks in scenes with many particles/duplis
* Replaced the Eevee lookdev (which required Cycles materials) with an albedo render mode that is intended as a fast texture preview for both Lux and Cycles node trees
* Node editor quality of life (support for muting nodes and some [https://github.com/LuxCoreRender/BlendLuxCore/issues/407 node wrangler functions])
* When using PhotonGI debug modes, disable light tracing and use an exposure compensated tonemapper
* Support for custom split normals, weighted normals etc. (only in Blender versions 2.82a and 2.83)
* Reworked statistics, added some sub-stats about export time (mesh conversion time, hair conversion time) as well as information about which caches are enabled/disabled
* Use Cycles nodes on linked materials without Lux nodes (so materials on Cycles assets automatically try to use Cycles nodes, unless you create a Lux material on the assets)
* Limit max. subdiv in material previews to 1
* Add support for indirect only collection visibility mode
* Support for manta flow smoke export in blender 2.82
* New triplanar normalmap node
* Add triplanar projection mode to imagemap node, general rework/polishing of the imagemap node
* Add support for transparency in the denoised result (both viewport and final render)
* Emulate Cycles material UI in Lux material node editor (material and slot dropdown instead of node tree dropdown)
* [https://forums.luxcorerender.org/viewtopic.php?f=5&t=2165 Thin film coating support] for glass and disney materials
* Cycles node reader:
** Add support for nested Cycles node groups
** Add support for principled emission, alpha and transmission sockets
** Add support for geometry node outputs: position and normal
** Add support for object info node outputs: object index, material index, random
** Add support for refraction shader
** Add support for blackbody texture
* LuxCore Online Library is now integrated in Blender (3D view > N-Panel > LuxCoreOnlineLibrary tab)
* New addon preferences:
** GPU backend (OpenCL/CUDA)
** Option to enable/disable image node thumbnails on new nodes by default
** LuxCore Online Library preferences
* Support for new sampling patterns and out-of-core rendering
* Amount of light tracing samples is now shown in statistics (image editor > N-Panel > LuxCore tab)
* Support for COLOR_LUT imagepipeline plugin, allowing to load .cube LUT files
* New material presets:
** Hybrid glass (regular refractive glass with white shadow color, as an alternative to architectural glass)
** Colored smoke
* New interactive render settings guide
* New maximum input to invert node
* New "Visible" setting for area lights, disabling hides the light not only for the camera, but also for shadow rays

===Fixed Bugs===

* Fix world volume ui panel drawing
* Fix material presets panel not showing without a material
* Fix remesh panel in mesh data properties not showing up
* Fix bugs in 3D mapping node UI (the controls were disappearing when the selected object was of type "CURVE", "SURFACE" or "FONT")
* Fix export of metaballs with shared data
* Fix shapes being added to cached meshes over and over in viewport render
* Fix check for UV maps on curve, surface and font objects being broken
* Fix shapes not working on hair
* Fix possible key collision in image exporter after undo (fixes #431)
* Fix color tint not working for sky and HDRIs
* Put Blender post processing panel in the right place (output props instead of render props)
* Fix wrong view layer visibility check
* Fix possible config export error if film opencl device was not set

''beta1 released''

* fix "compiling kernels" message shown before viewport render even if kernels were already cached
* fix duplicate texture math node category, leading to errors when unregistering the addon
* fix invert node compatibility code not being used, leading to errors when old node trees with invert nodes are exported
* fix brick bond and carpaint presets not working
* render settings helper: fix photongi cache not being enabled even if caustic cache is enabled
* fix wrong sampler dropdown being shown when device is set to GPU and engine to Bidir
* export objects with displacement always as instances to avoid discrepancies between viewport and final render

''RC1 released''

* fix addon not registering on macOS because of missing viewport denoiser binary
* fix LOL preview images being too bright in Blender 2.83

===Known Problems===

* [https://github.com/LuxCoreRender/BlendLuxCore/issues/167 Inserted keyframes in material node graph don't show up in graph editor or anywhere else]
* LuxCore node parameters can not be animated in Blender 2.82. This bug is fixed in Blender 2.83 and later
* Rendering with caches (e.g. PhotonGI, DLSC, Env. light cache) can lead to problems '''if border rendering is enabled'''. A workaround is to disable automatic radius estimation and setting the radius manually instead when using border rendering

LuxCoreRender Release Notes v2.4

2020-07-25T11:32:50Z

Byob: /* Fixed Bugs */

__TOC__

A user-friendly version of this changelog is available at https://luxcorerender.org/new-features-in-v2-4/.

=LuxCore=

===New Features===

* New OpenCL code to evaluate textures and materials. It doesn't require kernel re-compilation anymore
* LuxCoreUI "Fill kernel cache" menu option now pre-compile all possible GPU kernels
* LuxCore API KernelCacheFill() is now available for Python
* New 2-levels Env. Light Visibility Cache (ELVC)
* Added the support for a new ".sharpness" (default value 0.1, range [0.0, 1.0]) Intel OIDN parameter to blend original and denoised output
* Removed LuxRays support for virtual devices and hybrid rendering (old LuxRender GPU doing ray intersections and CPU everything else)
* Geometry vertex and triangle AOVs (arbitrary data associated to mesh vertices and triangle usable by textures)
* Removed the support for Triplanar texture .uvindex (side effect of the above new feature)
* New hitpointvertexaov and hitpointtriangleaov textures
* Pointiness shape can now assign curvature values to vertex AOV with .aovindex property (a 4294967296 value will force the use of alpha channel instead, default value for compatibility with the past)
* LuxCore API has now SetMeshVertexAOV() and SetMeshTriangleAOV() methods to set geometry vertex and triangle AOV
* Added the support for new Random texture
* Added the support for the new IslandAOV shape
* Added the support for RandomTriangleAOV shape
* Accelerated duplicate vertex detection in pointiness shape (from 6.7 seconds to 0.016 seconds on a 100k vertex mesh)
* LuxRays API reworked to support generic hardware devices (now OpenCL, potentially CUDA, Vulkan, Metal, etc.)
* Added the support for light groups to PhotonGI
* New LuxCore API RenderConfig::HasCachedKernels() method to check if a (long) kernel compilation time is required
* Glossycoating material on GPUs now supports bump mapping exactly like CPU version (issue #307)
* Mix material on GPUs now supports bump mapping exactly like CPU version (issue #307)
* Added processor group support to enable LuxCoreRender to use more than 64 logical processors on Windows
* Added the support for CUDA rendering
* Added the support for out of core CUDA rendering (i.e. to render scenes larger than GPU ram available)
* GPU rendering now uses 64bit image map pixel indices (i.e. removed the limit of 8 * 4GB of scene image maps)
* New cache and out-of-core friendly mode for Random/Sobol samplers
* Added the support for denoising baked light maps with Intel ODIN
* pyluxcoretools merge now supports saving film AOVs via new --aov-output option
* New improved Metropolis sampler warmup period
* Added thin film interference option for many materials
* Added the support for a new color re-mapping image pipeline plug-in using .cube files (issue #81)
* LuxCore API now support unicode UTF-8 strings and files
* luxcore::KernelCacheFill() now supports opencl.devices.select, scene.epsilon.min and scene.epsilon.max properties (issue #374)
* LuxCoreRender can now be compiled without OpenCL/CUDA SDK and it will load OpenCL/CUDA at run time (one executable can now be used for all types of installations)
* RTPathOCLRenderEngine::WaitNewFrame() takes is not more synchronous with rendering refresh
* The use of more than 64 logical processors on Windows is now extended to all render engines
* It is now possible to render scenes without light sources (!)
* The use of more than 64 logical processors on Windows is now extended to all pre-processing tasks like caches, etc.

===Fixed Bugs===

* Fixed a rendering difference when using/not using geometry negative scale transformations (issue #309)
* Fixed an out of bound access in BAKECPU
* Fixed a problem when using path.forceblackbackground.enable and env. lights
* Fixed a problem with scenes with very hard light paths and Metropolis sampler (issue #312)
* Sampler shared data are now reseted at the end of a scene edit (issue #312)
* Fixed a problem in automatic cache radius estimation of PhotonGI when using Orthographic camera (issue #324)
* Fixed an OpenCL compilation error when using large number of objects on some old GPUs
* Fixed a problem with BlendLuxCore when parsing more than 9 image pipelines (#336)
* Fixed a bug causing fireflies when using light tracing for caustics in some case (#329)
* Fixed a crash when using RemoveUnusedTextures() with Volumes (issue #377)
* Fixed a banding problem when using sphere light sources with very small radius (issue LuxCoreRender/BlendLuxCore#477)
* Fixed LXS parsing of UV inlined coordinates (issue #392)

===Changes that break backwards-compatibility===

Due to Glossycoating updated support for bump mapping on GPUs, some old scene using this kind of material/bump map combination may require some fix.

===About Performance on GPUs===

In the past versions, we have been moving from very specialized, scene dependent OpenCL kernels to general-purpose kernels. This development simultaneously has drawbacks and benefits in simple scenes, which are explained below. Complex scenes that use most features and shaders of LuxCore are less affected by the drawbacks, sometimes not at all, while still reaping the full benefits.

* v2.2 is fastest (at samples/sec) because it uses conditional compilation: lots of renderengine features and materials/textures are turned off when not used. Requires kernel re-compilations each time you change rendersettings or material/texture settings. Viewport rendering with OpenCL engines is out of the question, unless all you do is move the camera or other objects around.

* v2.3 is slower because it no longer uses conditional compilation for renderengine features: all of them are active, always. This means that re-compilations are no longer necessary when changing render settings (e.g. clamping value). Materials/textures still use conditional compilation in v2.3, requiring re-compilations on most shader changes, which makes OpenCL engines still unusable for viewport rendering.

* v2.4 is slowest because it has no conditional compilation at all anymore. The kernel is compiled once for each engine type with all features enabled, and materials/textures are now evaluated at runtime using a stack-based method.

Note, the speed difference is more visible the simpler the scene is. This is because with conditional compilation, most features will be disabled in such a scene. The more features your scene uses (meaning, the more complex it is), the less this matters. With a very complex scene using all features, v2.2 will have very similar speed to v2.4.

Also, don't forget that you now save the time for kernel compilation, always (which could range from seconds to minutes). This can actually benefit simpler scenes, if the total rendertime is short (like for animations). If you render 500 frames at 60 sec/frame, saving 20 seconds of kernel compilation can matter a lot.

===Known Problems===

* accelerator.bvh.builder.type = EMBREE_MORTON doesn't work with the latest Embree
* Python crashes when calling sys.exit()
* TILEPATHOCL (and RTPATHOCL) count the layers of transparent surfaces as an iteration of the rendering finite state machine so they require to increase the max. path depth to avoid black regions.
* Light emitted by motion blurred triangle lights is approximated using the triangle area of time 0.0 (computing triangle area at runtime would be expansive) so it may be not totally accurate if the motion blur transformation include a scale.
* Variance clamping is not applied to AOVs

=Blender Addon (BlendLuxCore)=

===New Features===

* Optimize viewport update checks in scenes with many particles/duplis
* Replaced the Eevee lookdev (which required Cycles materials) with an albedo render mode that is intended as a fast texture preview for both Lux and Cycles node trees
* Node editor quality of life (support for muting nodes and some [https://github.com/LuxCoreRender/BlendLuxCore/issues/407 node wrangler functions])
* When using PhotonGI debug modes, disable light tracing and use an exposure compensated tonemapper
* Support for custom split normals, weighted normals etc. (only in Blender versions 2.82a and 2.83)
* Reworked statistics, added some sub-stats about export time (mesh conversion time, hair conversion time) as well as information about which caches are enabled/disabled
* Use Cycles nodes on linked materials without Lux nodes (so materials on Cycles assets automatically try to use Cycles nodes, unless you create a Lux material on the assets)
* Limit max. subdiv in material previews to 1
* Add support for indirect only collection visibility mode
* Support for manta flow smoke export in blender 2.82
* New triplanar normalmap node
* Add triplanar projection mode to imagemap node, general rework/polishing of the imagemap node
* Add support for transparency in the denoised result (both viewport and final render)
* Emulate Cycles material UI in Lux material node editor (material and slot dropdown instead of node tree dropdown)
* [https://forums.luxcorerender.org/viewtopic.php?f=5&t=2165 Thin film coating support] for glass and disney materials
* Cycles node reader:
** Add support for nested Cycles node groups
** Add support for principled emission, alpha and transmission sockets
** Add support for geometry node outputs: position and normal
** Add support for object info node outputs: object index, material index, random
** Add support for refraction shader
** Add support for blackbody texture
* LuxCore Online Library is now integrated in Blender (3D view > N-Panel > LuxCoreOnlineLibrary tab)
* New addon preferences:
** GPU backend (OpenCL/CUDA)
** Option to enable/disable image node thumbnails on new nodes by default
** LuxCore Online Library preferences
* Support for new sampling patterns and out-of-core rendering
* Amount of light tracing samples is now shown in statistics (image editor > N-Panel > LuxCore tab)
* Support for COLOR_LUT imagepipeline plugin, allowing to load .cube LUT files
* New material presets:
** Hybrid glass (regular refractive glass with white shadow color, as an alternative to architectural glass)
** Colored smoke
* New interactive render settings guide
* New maximum input to invert node
* New "Visible" setting for area lights, disabling hides the light not only for the camera, but also for shadow rays

===Fixed Bugs===

* Fix world volume ui panel drawing
* Fix material presets panel not showing without a material
* Fix remesh panel in mesh data properties not showing up
* Fix bugs in 3D mapping node UI (the controls were disappearing when the selected object was of type "CURVE", "SURFACE" or "FONT")
* Fix export of metaballs with shared data
* Fix shapes being added to cached meshes over and over in viewport render
* Fix check for UV maps on curve, surface and font objects being broken
* Fix shapes not working on hair
* Fix possible key collision in image exporter after undo (fixes #431)
* Fix color tint not working for sky and HDRIs
* Put Blender post processing panel in the right place (output props instead of render props)
* Fix wrong view layer visibility check
* Fix possible config export error if film opencl device was not set

''beta1 released''

* fix "compiling kernels" message shown before viewport render even if kernels were already cached
* fix duplicate texture math node category, leading to errors when unregistering the addon
* fix invert node compatibility code not being used, leading to errors when old node trees with invert nodes are exported
* fix brick bond and carpaint presets not working
* render settings helper: fix photongi cache not being enabled even if caustic cache is enabled
* fix wrong sampler dropdown being shown when device is set to GPU and engine to Bidir
* export objects with displacement always as instances to avoid discrepancies between viewport and final render

''RC1 released''

* fix LOL preview images being too bright in Blender 2.83

===Known Problems===

* [https://github.com/LuxCoreRender/BlendLuxCore/issues/167 Inserted keyframes in material node graph don't show up in graph editor or anywhere else]
* LuxCore node parameters can not be animated in Blender 2.82. This bug is fixed in Blender 2.83 and later
* Rendering with caches (e.g. PhotonGI, DLSC, Env. light cache) can lead to problems '''if border rendering is enabled'''. A workaround is to disable automatic radius estimation and setting the radius manually instead when using border rendering

LuxCoreRender Release Notes v2.4

2020-07-20T18:20:26Z

Byob:

__TOC__

A user-friendly version of this changelog is available at https://luxcorerender.org/new-features-in-v2-4/.

=LuxCore=

===New Features===

* New OpenCL code to evaluate textures and materials. It doesn't require kernel re-compilation anymore
* LuxCoreUI "Fill kernel cache" menu option now pre-compile all possible GPU kernels
* LuxCore API KernelCacheFill() is now available for Python
* New 2-levels Env. Light Visibility Cache (ELVC)
* Added the support for a new ".sharpness" (default value 0.1, range [0.0, 1.0]) Intel OIDN parameter to blend original and denoised output
* Removed LuxRays support for virtual devices and hybrid rendering (old LuxRender GPU doing ray intersections and CPU everything else)
* Geometry vertex and triangle AOVs (arbitrary data associated to mesh vertices and triangle usable by textures)
* Removed the support for Triplanar texture .uvindex (side effect of the above new feature)
* New hitpointvertexaov and hitpointtriangleaov textures
* Pointiness shape can now assign curvature values to vertex AOV with .aovindex property (a 4294967296 value will force the use of alpha channel instead, default value for compatibility with the past)
* LuxCore API has now SetMeshVertexAOV() and SetMeshTriangleAOV() methods to set geometry vertex and triangle AOV
* Added the support for new Random texture
* Added the support for the new IslandAOV shape
* Added the support for RandomTriangleAOV shape
* Accelerated duplicate vertex detection in pointiness shape (from 6.7 seconds to 0.016 seconds on a 100k vertex mesh)
* LuxRays API reworked to support generic hardware devices (now OpenCL, potentially CUDA, Vulkan, Metal, etc.)
* Added the support for light groups to PhotonGI
* New LuxCore API RenderConfig::HasCachedKernels() method to check if a (long) kernel compilation time is required
* Glossycoating material on GPUs now supports bump mapping exactly like CPU version (issue #307)
* Mix material on GPUs now supports bump mapping exactly like CPU version (issue #307)
* Added processor group support to enable LuxCoreRender to use more than 64 logical processors on Windows
* Added the support for CUDA rendering
* Added the support for out of core CUDA rendering (i.e. to render scenes larger than GPU ram available)
* GPU rendering now uses 64bit image map pixel indices (i.e. removed the limit of 8 * 4GB of scene image maps)
* New cache and out-of-core friendly mode for Random/Sobol samplers
* Added the support for denoising baked light maps with Intel ODIN
* pyluxcoretools merge now supports saving film AOVs via new --aov-output option
* New improved Metropolis sampler warmup period
* Added thin film interference option for many materials
* Added the support for a new color re-mapping image pipeline plug-in using .cube files (issue #81)
* LuxCore API now support unicode UTF-8 strings and files
* luxcore::KernelCacheFill() now supports opencl.devices.select, scene.epsilon.min and scene.epsilon.max properties (issue #374)
* LuxCoreRender can now be compiled without OpenCL/CUDA SDK and it will load OpenCL/CUDA at run time (one executable can now be used for all types of installations)
* RTPathOCLRenderEngine::WaitNewFrame() takes is not more synchronous with rendering refresh
* The use of more than 64 logical processors on Windows is now extended to all render engines
* It is now possible to render scenes without light sources (!)
* The use of more than 64 logical processors on Windows is now extended to all pre-processing tasks like caches, etc.

===Fixed Bugs===

* Fixed a rendering difference when using/not using geometry negative scale transformations (issue #309)
* Fixed an out of bound access in BAKECPU
* Fixed a problem when using path.forceblackbackground.enable and env. lights
* Fixed a problem with scenes with very hard light paths and Metropolis sampler (issue #312)
* Sampler shared data are now reseted at the end of a scene edit (issue #312)
* Fixed a problem in automatic cache radius estimation of PhotonGI when using Orthographic camera (issue #324)
* Fixed an OpenCL compilation error when using large number of objects on some old GPUs
* Fixed a problem with BlendLuxCore when parsing more than 9 image pipelines (#336)
* Fixed a bug causing fireflies when using light tracing for caustics in some case (#329)
* Fixed a crash when using RemoveUnusedTextures() with Volumes (issue #377)
* Fixed a banding problem when using sphere light sources with very small radius (issue LuxCoreRender/BlendLuxCore#477)
* Fixed LXS parsing of UV inlined coordinates (issue #392)

===Changes that break backwards-compatibility===

Due to Glossycoating updated support for bump mapping on GPUs, some old scene using this kind of material/bump map combination may require some fix.

===About Performance on GPUs===

In the past versions, we have been moving from very specialized, scene dependent OpenCL kernels to general-purpose kernels. This development simultaneously has drawbacks and benefits in simple scenes, which are explained below. Complex scenes that use most features and shaders of LuxCore are less affected by the drawbacks, sometimes not at all, while still reaping the full benefits.

* v2.2 is fastest (at samples/sec) because it uses conditional compilation: lots of renderengine features and materials/textures are turned off when not used. Requires kernel re-compilations each time you change rendersettings or material/texture settings. Viewport rendering with OpenCL engines is out of the question, unless all you do is move the camera or other objects around.

* v2.3 is slower because it no longer uses conditional compilation for renderengine features: all of them are active, always. This means that re-compilations are no longer necessary when changing render settings (e.g. clamping value). Materials/textures still use conditional compilation in v2.3, requiring re-compilations on most shader changes, which makes OpenCL engines still unusable for viewport rendering.

* v2.4 is slowest because it has no conditional compilation at all anymore. The kernel is compiled once for each engine type with all features enabled, and materials/textures are now evaluated at runtime using a stack-based method.

Note, the speed difference is more visible the simpler the scene is. This is because with conditional compilation, most features will be disabled in such a scene. The more features your scene uses (meaning, the more complex it is), the less this matters. With a very complex scene using all features, v2.2 will have very similar speed to v2.4.

Also, don't forget that you now save the time for kernel compilation, always (which could range from seconds to minutes). This can actually benefit simpler scenes, if the total rendertime is short (like for animations). If you render 500 frames at 60 sec/frame, saving 20 seconds of kernel compilation can matter a lot.

===Known Problems===

* accelerator.bvh.builder.type = EMBREE_MORTON doesn't work with the latest Embree
* Python crashes when calling sys.exit()
* TILEPATHOCL (and RTPATHOCL) count the layers of transparent surfaces as an iteration of the rendering finite state machine so they require to increase the max. path depth to avoid black regions.
* Light emitted by motion blurred triangle lights is approximated using the triangle area of time 0.0 (computing triangle area at runtime would be expansive) so it may be not totally accurate if the motion blur transformation include a scale.
* Variance clamping is not applied to AOVs

=Blender Addon (BlendLuxCore)=

===New Features===

* Optimize viewport update checks in scenes with many particles/duplis
* Replaced the Eevee lookdev (which required Cycles materials) with an albedo render mode that is intended as a fast texture preview for both Lux and Cycles node trees
* Node editor quality of life (support for muting nodes and some [https://github.com/LuxCoreRender/BlendLuxCore/issues/407 node wrangler functions])
* When using PhotonGI debug modes, disable light tracing and use an exposure compensated tonemapper
* Support for custom split normals, weighted normals etc. (only in Blender versions 2.82a and 2.83)
* Reworked statistics, added some sub-stats about export time (mesh conversion time, hair conversion time) as well as information about which caches are enabled/disabled
* Use Cycles nodes on linked materials without Lux nodes (so materials on Cycles assets automatically try to use Cycles nodes, unless you create a Lux material on the assets)
* Limit max. subdiv in material previews to 1
* Add support for indirect only collection visibility mode
* Support for manta flow smoke export in blender 2.82
* New triplanar normalmap node
* Add triplanar projection mode to imagemap node, general rework/polishing of the imagemap node
* Add support for transparency in the denoised result (both viewport and final render)
* Emulate Cycles material UI in Lux material node editor (material and slot dropdown instead of node tree dropdown)
* [https://forums.luxcorerender.org/viewtopic.php?f=5&t=2165 Thin film coating support] for glass and disney materials
* Cycles node reader:
** Add support for nested Cycles node groups
** Add support for principled emission, alpha and transmission sockets
** Add support for geometry node outputs: position and normal
** Add support for object info node outputs: object index, material index, random
** Add support for refraction shader
** Add support for blackbody texture
* LuxCore Online Library is now integrated in Blender (3D view > N-Panel > LuxCoreOnlineLibrary tab)
* New addon preferences:
** GPU backend (OpenCL/CUDA)
** Option to enable/disable image node thumbnails on new nodes by default
** LuxCore Online Library preferences
* Support for new sampling patterns and out-of-core rendering
* Amount of light tracing samples is now shown in statistics (image editor > N-Panel > LuxCore tab)
* Support for COLOR_LUT imagepipeline plugin, allowing to load .cube LUT files
* New material presets:
** Hybrid glass (regular refractive glass with white shadow color, as an alternative to architectural glass)
** Colored smoke
* New interactive render settings guide
* New maximum input to invert node
* New "Visible" setting for area lights, disabling hides the light not only for the camera, but also for shadow rays

===Fixed Bugs===

* Fix world volume ui panel drawing
* Fix material presets panel not showing without a material
* Fix remesh panel in mesh data properties not showing up
* Fix bugs in 3D mapping node UI (the controls were disappearing when the selected object was of type "CURVE", "SURFACE" or "FONT")
* Fix export of metaballs with shared data
* Fix shapes being added to cached meshes over and over in viewport render
* Fix check for UV maps on curve, surface and font objects being broken
* Fix shapes not working on hair
* Fix possible key collision in image exporter after undo (fixes #431)
* Fix color tint not working for sky and HDRIs
* Put Blender post processing panel in the right place (output props instead of render props)
* Fix wrong view layer visibility check
* Fix possible config export error if film opencl device was not set

''beta1 released''

* fix "compiling kernels" message shown before viewport render even if kernels were already cached
* fix duplicate texture math node category, leading to errors when unregistering the addon
* fix invert node compatibility code not being used, leading to errors when old node trees with invert nodes are exported
* fix brick bond and carpaint presets not working
* render settings helper: fix photongi cache not being enabled even if caustic cache is enabled
* fix wrong sampler dropdown being shown when device is set to GPU and engine to Bidir
* export objects with displacement always as instances to avoid discrepancies between viewport and final render

===Known Problems===

* [https://github.com/LuxCoreRender/BlendLuxCore/issues/167 Inserted keyframes in material node graph don't show up in graph editor or anywhere else]
* LuxCore node parameters can not be animated in Blender 2.82. This bug is fixed in Blender 2.83 and later
* Rendering with caches (e.g. PhotonGI, DLSC, Env. light cache) can lead to problems '''if border rendering is enabled'''. A workaround is to disable automatic radius estimation and setting the radius manually instead when using border rendering

LuxCoreRender Tutorials

2020-07-16T11:52:16Z

Byob: /* Video Tutorials */

== Video Tutorials ==

=== Blender 2.8x ===

{| width="100%"
|
[[File:BlendLuxCore-2.8-Interior-Tutorial.png|thumb|none|300x300px|link=https://youtu.be/XjwCOIWwQo4| [https://youtu.be/XjwCOIWwQo4 BlendLuxCore v2.8 Interior Tutorial] ]]
|
[[File:Shader_tutorial.jpg|thumb|none|300x300px|link=https://youtu.be/xZOdXI9181k| [https://youtu.be/xZOdXI9181k LuxCore Shader Tutorial 1] ]]
|
[[File:Shader_2.jpg|thumb|none|300x300px|link=https://youtu.be/79V_ySn5ZoY| [https://youtu.be/79V_ySn5ZoY LuxCore Shader Tutorial 2] ]]
|}

{| width="100%"
|
[[File:Orange_juice_tutorial.png|thumb|none|300x300px|link=https://youtu.be/R2-u3YNJbHQ| [https://youtu.be/R2-u3YNJbHQ Orange Juice Tutorial] ]]
|
[[File:Caustics_pool_tutorial.png|thumb|none|300x300px|link=https://youtu.be/mHYpWe4KF8I| [https://youtu.be/mHYpWe4KF8I Caustics Pool Tutorial] ]]
|
[[File:Caustics_Master.jpg|thumb|none|300x300px|link=https://youtu.be/gvo9WLBqNVU| [https://youtu.be/gvo9WLBqNVU Caustics & Fog] ]]
|}

{| width="100%"
|
[[File:Displacement_tut.jpg|thumb|none|300x300px|link=https://youtu.be/OrgCGEJL_sk| [https://youtu.be/OrgCGEJL_sk Displacement Tutorial] ]]
|
[[File:Heads.jpg|thumb|none|300x300px|link=https://youtu.be/1COAMA_r1Ao| [https://youtu.be/1COAMA_r1Ao Skin Shader Tutorial] ]]
|
[[File:HAIIRRR.jpg|thumb|none|300x300px|link=https://youtu.be/RMKwv6N4trQ| [https://youtu.be/RMKwv6N4trQ Hair Shader Tutorial] ]]
|}

{| width="100%"
|
[[File:Light Groups2.jpg|thumb|none|300x300px|link=https://youtu.be/Lsz9yx6GM7I| [https://youtu.be/Lsz9yx6GM7I Light Group Tutorial] ]]
|
[[File:Carpaint tut.jpg|thumb|none|300x300px|link=https://youtu.be/KFbk_JxPUj4| [https://youtu.be/KFbk_JxPUj4 Carpaint Tutorial] ]]
|
[[File:Pbr_leaf_texture_tut.jpg|thumb|none|300x300px|link=https://youtu.be/j8TXpqtdcvY| [https://youtu.be/j8TXpqtdcvY PBR Leaf Texture Tutorial] ]]
|}

* [https://youtu.be/UVattTf1a5Q Blender 2.8 Luxcore Engine Setting Tutorial]
* [https://youtu.be/JBYneEf62PU Blender 2.8 Luxcore Online Library Tutorial]
* [https://youtu.be/vsVIFtle9OU Blender 2.8 luxcore fast tips]
* [https://youtu.be/32Ojuidbc7k Blender 2.8 Luxcore Fast Tips Light Shape]
* [https://youtu.be/YU38Pqb8gI4 Blender 2 8 Luxcore Projector & Sci-fi laser scan Tutorial]
* [https://youtu.be/HOxWI_0y6KI Blender 2.8 Luxcore shadow catcher]

==== BlendLuxCore Guide by Mike Zurawski ====

* [https://youtu.be/Ron1se5liV8 Render settings - Tracing method I]
* [https://youtu.be/EgLSibsTpgY Render settings - Light paths II]
* [https://youtu.be/qlYrtUwhNoY Render settings - Light paths III]
* [https://youtu.be/gSwXpWc5uFg Render settings - Light strategy & Filter IV]
* [https://youtu.be/fXoa2rJu_nY Render settings - Performance & Denoiser V]
* [https://youtu.be/ogkOyOmMDpA Render settings - Halt conditions, display and viewport settings VI]
* [https://youtu.be/FnORHMBpQHY Render settings - Photon GI cache VII]

=== Blender 2.79 ===

{| width="100%"
|
[[File:beginner_tutorial.jpg|thumb|none|300x300px|link=https://youtu.be/-BmXeUDRqSo| [https://youtu.be/-BmXeUDRqSo Introduction to LuxCoreRender in Blender] ]]
|
[[File:DLSC_tutorial_thumbnail.jpg|thumb|none|300x300px|link=https://youtu.be/dIfwr2YPxPw| [https://youtu.be/dIfwr2YPxPw Tutorial about the Direct Light Sampling Cache (DLSC)] ]]
|
[[File:Sss tutorial thumbnail.jpg|thumb|none|300x300px|link=https://youtu.be/gEGDyHMnlkg| [https://youtu.be/gEGDyHMnlkg Subsurface Scattering and Volume Tutorial] ]]
|}

{| width="100%"
|
[[File:Brushed steel thumbnail.png|thumb|none|300x300px|link=https://youtu.be/FGhPAP0oV9k| [https://youtu.be/FGhPAP0oV9k Brushed Steel Tutorial] ]]
|
[[File:Photongi_tutorial.jpg|thumb|none|300x300px|link=https://youtu.be/trkUldfb380| [https://youtu.be/trkUldfb380 PhotonGI Tutorial] ]]
|
[[File:LED_tutorial.png|thumb|none|300x300px|link=https://youtu.be/saGvvLWS4xs| [https://youtu.be/saGvvLWS4xs LED Tutorial] ]]
|}

== General Tutorials ==

These tutorials are not about LuxCoreRender, but about scene composition, lighting and other universal concepts.

* ciechanow.ski: [https://ciechanow.ski/lights-and-shadows/ Lights and Shadows]
* ciechanow.ski: [https://ciechanow.ski/color-spaces/ Color Spaces]
* blenderer.com: [https://www.blendernation.com/2018/06/18/how-to-make-a-beautiful-scene/ What makes a beautiful scene]
* blenderer.com: [https://www.blendernation.com/2018/06/22/how-to-improve-your-interior-scenes/ Secrets to making the best interior scenes]

== Old Tutorials for LuxBlend ==

The tutorials listed here were made with the old LuxBlend addon.

* Create nice beer using Blender and LuxCore: [https://www.youtube.com/watch?v=EtsA7iDK32A Part 1] and [https://www.youtube.com/watch?v=lJliJFKir8Y Part 2]
* [https://youtu.be/GpvHYi8uW1Y Create an interior scene using Blender and LuxCore]

LuxCoreRender Release Notes v2.4

2020-07-14T15:18:41Z

Byob: /* Fixed Bugs */

=LuxCore=

===New Features===

* New OpenCL code to evaluate textures and materials. It doesn't require kernel re-compilation anymore
* LuxCoreUI "Fill kernel cache" menu option now pre-compile all possible GPU kernels
* LuxCore API KernelCacheFill() is now available for Python
* New 2-levels Env. Light Visibility Cache (ELVC)
* Added the support for a new ".sharpness" (default value 0.1, range [0.0, 1.0]) Intel OIDN parameter to blend original and denoised output
* Removed LuxRays support for virtual devices and hybrid rendering (old LuxRender GPU doing ray intersections and CPU everything else)
* Geometry vertex and triangle AOVs (arbitrary data associated to mesh vertices and triangle usable by textures)
* Removed the support for Triplanar texture .uvindex (side effect of the above new feature)
* New hitpointvertexaov and hitpointtriangleaov textures
* Pointiness shape can now assign curvature values to vertex AOV with .aovindex property (a 4294967296 value will force the use of alpha channel instead, default value for compatibility with the past)
* LuxCore API has now SetMeshVertexAOV() and SetMeshTriangleAOV() methods to set geometry vertex and triangle AOV
* Added the support for new Random texture
* Added the support for the new IslandAOV shape
* Added the support for RandomTriangleAOV shape
* Accelerated duplicate vertex detection in pointiness shape (from 6.7 seconds to 0.016 seconds on a 100k vertex mesh)
* LuxRays API reworked to support generic hardware devices (now OpenCL, potentially CUDA, Vulkan, Metal, etc.)
* Added the support for light groups to PhotonGI
* New LuxCore API RenderConfig::HasCachedKernels() method to check if a (long) kernel compilation time is required
* Glossycoating material on GPUs now supports bump mapping exactly like CPU version (issue #307)
* Mix material on GPUs now supports bump mapping exactly like CPU version (issue #307)
* Added processor group support to enable LuxCoreRender to use more than 64 logical processors on Windows
* Added the support for CUDA rendering
* Added the support for out of core CUDA rendering (i.e. to render scenes larger than GPU ram available)
* GPU rendering now uses 64bit image map pixel indices (i.e. removed the limit of 8 * 4GB of scene image maps)
* New cache and out-of-core friendly mode for Random/Sobol samplers
* Added the support for denoising baked light maps with Intel ODIN
* pyluxcoretools merge now supports saving film AOVs via new --aov-output option
* New improved Metropolis sampler warmup period
* Added thin film interference option for many materials
* Added the support for a new color re-mapping image pipeline plug-in using .cube files (issue #81)
* LuxCore API now support unicode UTF-8 strings and files
* luxcore::KernelCacheFill() now supports opencl.devices.select, scene.epsilon.min and scene.epsilon.max properties (issue #374)
* LuxCoreRender can now be compiled without OpenCL/CUDA SDK and it will load OpenCL/CUDA at run time (one executable can now be used for all types of installations)
* RTPathOCLRenderEngine::WaitNewFrame() takes is not more synchronous with rendering refresh
* The use of more than 64 logical processors on Windows is now extended to all render engines
* It is now possible to render scenes without light sources (!)
* The use of more than 64 logical processors on Windows is now extended to all pre-processing tasks like caches, etc.

===Fixed Bugs===

* Fixed a rendering difference when using/not using geometry negative scale transformations (issue #309)
* Fixed an out of bound access in BAKECPU
* Fixed a problem when using path.forceblackbackground.enable and env. lights
* Fixed a problem with scenes with very hard light paths and Metropolis sampler (issue #312)
* Sampler shared data are now reseted at the end of a scene edit (issue #312)
* Fixed a problem in automatic cache radius estimation of PhotonGI when using Orthographic camera (issue #324)
* Fixed an OpenCL compilation error when using large number of objects on some old GPUs
* Fixed a problem with BlendLuxCore when parsing more than 9 image pipelines (#336)
* Fixed a bug causing fireflies when using light tracing for caustics in some case (#329)
* Fixed a crash when using RemoveUnusedTextures() with Volumes (issue #377)
* Fixed a banding problem when using sphere light sources with very small radius (issue LuxCoreRender/BlendLuxCore#477)
* Fixed LXS parsing of UV inlined coordinates (issue #392)

===Changes that break backwards-compatibility===

Due to Glossycoating updated support for bump mapping on GPUs, some old scene using this kind of material/bump map combination may require some fix.

===About Performance on GPUs===

In the past versions, we have been moving from very specialized, scene dependent OpenCL kernels to general-purpose kernels. This development simultaneously has drawbacks and benefits in simple scenes, which are explained below. Complex scenes that use most features and shaders of LuxCore are less affected by the drawbacks, sometimes not at all, while still reaping the full benefits.

* v2.2 is fastest (at samples/sec) because it uses conditional compilation: lots of renderengine features and materials/textures are turned off when not used. Requires kernel re-compilations each time you change rendersettings or material/texture settings. Viewport rendering with OpenCL engines is out of the question, unless all you do is move the camera or other objects around.

* v2.3 is slower because it no longer uses conditional compilation for renderengine features: all of them are active, always. This means that re-compilations are no longer necessary when changing render settings (e.g. clamping value). Materials/textures still use conditional compilation in v2.3, requiring re-compilations on most shader changes, which makes OpenCL engines still unusable for viewport rendering.

* v2.4 is slowest because it has no conditional compilation at all anymore. The kernel is compiled once for each engine type with all features enabled, and materials/textures are now evaluated at runtime using a stack-based method.

Note, the speed difference is more visible the simpler the scene is. This is because with conditional compilation, most features will be disabled in such a scene. The more features your scene uses (meaning, the more complex it is), the less this matters. With a very complex scene using all features, v2.2 will have very similar speed to v2.4.

Also, don't forget that you now save the time for kernel compilation, always (which could range from seconds to minutes). This can actually benefit simpler scenes, if the total rendertime is short (like for animations). If you render 500 frames at 60 sec/frame, saving 20 seconds of kernel compilation can matter a lot.

===Known Problems===

* accelerator.bvh.builder.type = EMBREE_MORTON doesn't work with the latest Embree
* Python crashes when calling sys.exit()
* TILEPATHOCL (and RTPATHOCL) count the layers of transparent surfaces as an iteration of the rendering finite state machine so they require to increase the max. path depth to avoid black regions.
* Light emitted by motion blurred triangle lights is approximated using the triangle area of time 0.0 (computing triangle area at runtime would be expansive) so it may be not totally accurate if the motion blur transformation include a scale.
* Variance clamping is not applied to AOVs

=Blender Addon (BlendLuxCore)=

===New Features===

* Optimize viewport update checks in scenes with many particles/duplis
* Replaced the Eevee lookdev (which required Cycles materials) with an albedo render mode that is intended as a fast texture preview for both Lux and Cycles node trees
* Node editor quality of life (support for muting nodes and some [https://github.com/LuxCoreRender/BlendLuxCore/issues/407 node wrangler functions])
* When using PhotonGI debug modes, disable light tracing and use an exposure compensated tonemapper
* Support for custom split normals, weighted normals etc. (only in Blender versions 2.82a and 2.83)
* Reworked statistics, added some sub-stats about export time (mesh conversion time, hair conversion time) as well as information about which caches are enabled/disabled
* Use Cycles nodes on linked materials without Lux nodes (so materials on Cycles assets automatically try to use Cycles nodes, unless you create a Lux material on the assets)
* Limit max. subdiv in material previews to 1
* Add support for indirect only collection visibility mode
* Support for manta flow smoke export in blender 2.82
* New triplanar normalmap node
* Add triplanar projection mode to imagemap node, general rework/polishing of the imagemap node
* Add support for transparency in the denoised result (both viewport and final render)
* Emulate Cycles material UI in Lux material node editor (material and slot dropdown instead of node tree dropdown)
* [https://forums.luxcorerender.org/viewtopic.php?f=5&t=2165 Thin film coating support] for glass and disney materials
* Cycles node reader:
** Add support for nested Cycles node groups
** Add support for principled emission, alpha and transmission sockets
** Add support for geometry node outputs: position and normal
** Add support for object info node outputs: object index, material index, random
** Add support for refraction shader
** Add support for blackbody texture
* LuxCore Online Library is now integrated in Blender (3D view > N-Panel > LuxCoreOnlineLibrary tab)
* New addon preferences:
** GPU backend (OpenCL/CUDA)
** Option to enable/disable image node thumbnails on new nodes by default
** LuxCore Online Library preferences
* Support for new sampling patterns and out-of-core rendering
* Amount of light tracing samples is now shown in statistics (image editor > N-Panel > LuxCore tab)
* Support for COLOR_LUT imagepipeline plugin, allowing to load .cube LUT files
* New material presets:
** Hybrid glass (regular refractive glass with white shadow color, as an alternative to architectural glass)
** Colored smoke
* New interactive render settings guide
* New maximum input to invert node
* New "Visible" setting for area lights, disabling hides the light not only for the camera, but also for shadow rays

===Fixed Bugs===

* Fix world volume ui panel drawing
* Fix material presets panel not showing without a material
* Fix remesh panel in mesh data properties not showing up
* Fix bugs in 3D mapping node UI (the controls were disappearing when the selected object was of type "CURVE", "SURFACE" or "FONT")
* Fix export of metaballs with shared data
* Fix shapes being added to cached meshes over and over in viewport render
* Fix check for UV maps on curve, surface and font objects being broken
* Fix shapes not working on hair
* Fix possible key collision in image exporter after undo (fixes #431)
* Fix color tint not working for sky and HDRIs
* Put Blender post processing panel in the right place (output props instead of render props)
* Fix wrong view layer visibility check
* Fix possible config export error if film opencl device was not set

''beta1 released''

* fix "compiling kernels" message shown before viewport render even if kernels were already cached
* fix duplicate texture math node category, leading to errors when unregistering the addon
* fix invert node compatibility code not being used, leading to errors when old node trees with invert nodes are exported
* fix brick bond and carpaint presets not working
* render settings helper: fix photongi cache not being enabled even if caustic cache is enabled
* fix wrong sampler dropdown being shown when device is set to GPU and engine to Bidir
* export objects with displacement always as instances to avoid discrepancies between viewport and final render

===Known Problems===

* [https://github.com/LuxCoreRender/BlendLuxCore/issues/167 Inserted keyframes in material node graph don't show up in graph editor or anywhere else]
* LuxCore node parameters can not be animated in Blender 2.82. This bug is fixed in Blender 2.83 and later
* Rendering with caches (e.g. PhotonGI, DLSC, Env. light cache) can lead to problems '''if border rendering is enabled'''. A workaround is to disable automatic radius estimation and setting the radius manually instead when using border rendering

LuxCoreRender Release Notes v2.4

2020-07-07T13:35:32Z

Byob: /* Fixed Bugs */

=LuxCore=

===New Features===

* New OpenCL code to evaluate textures and materials. It doesn't require kernel re-compilation anymore
* LuxCoreUI "Fill kernel cache" menu option now pre-compile all possible GPU kernels
* LuxCore API KernelCacheFill() is now available for Python
* New 2-levels Env. Light Visibility Cache (ELVC)
* Added the support for a new ".sharpness" (default value 0.1, range [0.0, 1.0]) Intel OIDN parameter to blend original and denoised output
* Removed LuxRays support for virtual devices and hybrid rendering (old LuxRender GPU doing ray intersections and CPU everything else)
* Geometry vertex and triangle AOVs (arbitrary data associated to mesh vertices and triangle usable by textures)
* Removed the support for Triplanar texture .uvindex (side effect of the above new feature)
* New hitpointvertexaov and hitpointtriangleaov textures
* Pointiness shape can now assign curvature values to vertex AOV with .aovindex property (a 4294967296 value will force the use of alpha channel instead, default value for compatibility with the past)
* LuxCore API has now SetMeshVertexAOV() and SetMeshTriangleAOV() methods to set geometry vertex and triangle AOV
* Added the support for new Random texture
* Added the support for the new IslandAOV shape
* Added the support for RandomTriangleAOV shape
* Accelerated duplicate vertex detection in pointiness shape (from 6.7 seconds to 0.016 seconds on a 100k vertex mesh)
* LuxRays API reworked to support generic hardware devices (now OpenCL, potentially CUDA, Vulkan, Metal, etc.)
* Added the support for light groups to PhotonGI
* New LuxCore API RenderConfig::HasCachedKernels() method to check if a (long) kernel compilation time is required
* Glossycoating material on GPUs now supports bump mapping exactly like CPU version (issue #307)
* Mix material on GPUs now supports bump mapping exactly like CPU version (issue #307)
* Added processor group support to enable LuxCoreRender to use more than 64 logical processors on Windows
* Added the support for CUDA rendering
* Added the support for out of core CUDA rendering (i.e. to render scenes larger than GPU ram available)
* GPU rendering now uses 64bit image map pixel indices (i.e. removed the limit of 8 * 4GB of scene image maps)
* New cache and out-of-core friendly mode for Random/Sobol samplers
* Added the support for denoising baked light maps with Intel ODIN
* pyluxcoretools merge now supports saving film AOVs via new --aov-output option
* New improved Metropolis sampler warmup period
* Added thin film interference option for many materials
* Added the support for a new color re-mapping image pipeline plug-in using .cube files (issue #81)
* LuxCore API now support unicode UTF-8 strings and files
* luxcore::KernelCacheFill() now supports opencl.devices.select, scene.epsilon.min and scene.epsilon.max properties (issue #374)
* LuxCoreRender can now be compiled without OpenCL/CUDA SDK and it will load OpenCL/CUDA at run time (one executable can now be used for all types of installations)
* RTPathOCLRenderEngine::WaitNewFrame() takes is not more synchronous with rendering refresh
* The use of more than 64 logical processors on Windows is now extended to all render engines
* It is now possible to render scenes without light sources (!)
* The use of more than 64 logical processors on Windows is now extended to all pre-processing tasks like caches, etc.

===Fixed Bugs===

* Fixed a rendering difference when using/not using geometry negative scale transformations (issue #309)
* Fixed an out of bound access in BAKECPU
* Fixed a problem when using path.forceblackbackground.enable and env. lights
* Fixed a problem with scenes with very hard light paths and Metropolis sampler (issue #312)
* Sampler shared data are now reseted at the end of a scene edit (issue #312)
* Fixed a problem in automatic cache radius estimation of PhotonGI when using Orthographic camera (issue #324)
* Fixed an OpenCL compilation error when using large number of objects on some old GPUs
* Fixed a problem with BlendLuxCore when parsing more than 9 image pipelines (#336)
* Fixed a bug causing fireflies when using light tracing for caustics in some case (#329)
* Fixed a crash when using RemoveUnusedTextures() with Volumes (issue #377)
* Fixed a banding problem when using sphere light sources with very small radius (issue LuxCoreRender/BlendLuxCore#477)
* Fixed LXS parsing of UV inlined coordinates (issue #392)

===Changes that break backwards-compatibility===

Due to Glossycoating updated support for bump mapping on GPUs, some old scene using this kind of material/bump map combination may require some fix.

===About Performance on GPUs===

In the past versions, we have been moving from very specialized, scene dependent OpenCL kernels to general-purpose kernels. This development simultaneously has drawbacks and benefits in simple scenes, which are explained below. Complex scenes that use most features and shaders of LuxCore are less affected by the drawbacks, sometimes not at all, while still reaping the full benefits.

* v2.2 is fastest (at samples/sec) because it uses conditional compilation: lots of renderengine features and materials/textures are turned off when not used. Requires kernel re-compilations each time you change rendersettings or material/texture settings. Viewport rendering with OpenCL engines is out of the question, unless all you do is move the camera or other objects around.

* v2.3 is slower because it no longer uses conditional compilation for renderengine features: all of them are active, always. This means that re-compilations are no longer necessary when changing render settings (e.g. clamping value). Materials/textures still use conditional compilation in v2.3, requiring re-compilations on most shader changes, which makes OpenCL engines still unusable for viewport rendering.

* v2.4 is slowest because it has no conditional compilation at all anymore. The kernel is compiled once for each engine type with all features enabled, and materials/textures are now evaluated at runtime using a stack-based method.

Note, the speed difference is more visible the simpler the scene is. This is because with conditional compilation, most features will be disabled in such a scene. The more features your scene uses (meaning, the more complex it is), the less this matters. With a very complex scene using all features, v2.2 will have very similar speed to v2.4.

Also, don't forget that you now save the time for kernel compilation, always (which could range from seconds to minutes). This can actually benefit simpler scenes, if the total rendertime is short (like for animations). If you render 500 frames at 60 sec/frame, saving 20 seconds of kernel compilation can matter a lot.

===Known Problems===

* accelerator.bvh.builder.type = EMBREE_MORTON doesn't work with the latest Embree
* Python crashes when calling sys.exit()
* TILEPATHOCL (and RTPATHOCL) count the layers of transparent surfaces as an iteration of the rendering finite state machine so they require to increase the max. path depth to avoid black regions.
* Light emitted by motion blurred triangle lights is approximated using the triangle area of time 0.0 (computing triangle area at runtime would be expansive) so it may be not totally accurate if the motion blur transformation include a scale.
* Variance clamping is not applied to AOVs

=Blender Addon (BlendLuxCore)=

===New Features===

* Optimize viewport update checks in scenes with many particles/duplis
* Replaced the Eevee lookdev (which required Cycles materials) with an albedo render mode that is intended as a fast texture preview for both Lux and Cycles node trees
* Node editor quality of life (support for muting nodes and some [https://github.com/LuxCoreRender/BlendLuxCore/issues/407 node wrangler functions])
* When using PhotonGI debug modes, disable light tracing and use an exposure compensated tonemapper
* Support for custom split normals, weighted normals etc. (only in Blender versions 2.82a and 2.83)
* Reworked statistics, added some sub-stats about export time (mesh conversion time, hair conversion time) as well as information about which caches are enabled/disabled
* Use Cycles nodes on linked materials without Lux nodes (so materials on Cycles assets automatically try to use Cycles nodes, unless you create a Lux material on the assets)
* Limit max. subdiv in material previews to 1
* Add support for indirect only collection visibility mode
* Support for manta flow smoke export in blender 2.82
* New triplanar normalmap node
* Add triplanar projection mode to imagemap node, general rework/polishing of the imagemap node
* Add support for transparency in the denoised result (both viewport and final render)
* Emulate Cycles material UI in Lux material node editor (material and slot dropdown instead of node tree dropdown)
* [https://forums.luxcorerender.org/viewtopic.php?f=5&t=2165 Thin film coating support] for glass and disney materials
* Cycles node reader:
** Add support for nested Cycles node groups
** Add support for principled emission, alpha and transmission sockets
** Add support for geometry node outputs: position and normal
** Add support for object info node outputs: object index, material index, random
** Add support for refraction shader
** Add support for blackbody texture
* LuxCore Online Library is now integrated in Blender (3D view > N-Panel > LuxCoreOnlineLibrary tab)
* New addon preferences:
** GPU backend (OpenCL/CUDA)
** Option to enable/disable image node thumbnails on new nodes by default
** LuxCore Online Library preferences
* Support for new sampling patterns and out-of-core rendering
* Amount of light tracing samples is now shown in statistics (image editor > N-Panel > LuxCore tab)
* Support for COLOR_LUT imagepipeline plugin, allowing to load .cube LUT files
* New material presets:
** Hybrid glass (regular refractive glass with white shadow color, as an alternative to architectural glass)
** Colored smoke
* New interactive render settings guide
* New maximum input to invert node
* New "Visible" setting for area lights, disabling hides the light not only for the camera, but also for shadow rays

===Fixed Bugs===

* Fix world volume ui panel drawing
* Fix material presets panel not showing without a material
* Fix remesh panel in mesh data properties not showing up
* Fix bugs in 3D mapping node UI (the controls were disappearing when the selected object was of type "CURVE", "SURFACE" or "FONT")
* Fix export of metaballs with shared data
* Fix shapes being added to cached meshes over and over in viewport render
* Fix check for UV maps on curve, surface and font objects being broken
* Fix shapes not working on hair
* Fix possible key collision in image exporter after undo (fixes #431)
* Fix color tint not working for sky and HDRIs
* Put Blender post processing panel in the right place (output props instead of render props)
* Fix wrong view layer visibility check
* Fix possible config export error if film opencl device was not set

''beta1 released''

* fix "compiling kernels" message shown before viewport render even if kernels were already cached
* fix duplicate texture math node category, leading to errors when unregistering the addon
* fix invert node compatibility code not being used, leading to errors when old node trees with invert nodes are exported
* fix brick bond and carpaint presets not working

===Known Problems===

* [https://github.com/LuxCoreRender/BlendLuxCore/issues/167 Inserted keyframes in material node graph don't show up in graph editor or anywhere else]
* LuxCore node parameters can not be animated in Blender 2.82. This bug is fixed in Blender 2.83 and later
* Rendering with caches (e.g. PhotonGI, DLSC, Env. light cache) can lead to problems '''if border rendering is enabled'''. A workaround is to disable automatic radius estimation and setting the radius manually instead when using border rendering

LuxCoreRender Release Notes v2.4

2020-07-07T13:35:16Z

Byob: /* Fixed Bugs */

=LuxCore=

===New Features===

* New OpenCL code to evaluate textures and materials. It doesn't require kernel re-compilation anymore
* LuxCoreUI "Fill kernel cache" menu option now pre-compile all possible GPU kernels
* LuxCore API KernelCacheFill() is now available for Python
* New 2-levels Env. Light Visibility Cache (ELVC)
* Added the support for a new ".sharpness" (default value 0.1, range [0.0, 1.0]) Intel OIDN parameter to blend original and denoised output
* Removed LuxRays support for virtual devices and hybrid rendering (old LuxRender GPU doing ray intersections and CPU everything else)
* Geometry vertex and triangle AOVs (arbitrary data associated to mesh vertices and triangle usable by textures)
* Removed the support for Triplanar texture .uvindex (side effect of the above new feature)
* New hitpointvertexaov and hitpointtriangleaov textures
* Pointiness shape can now assign curvature values to vertex AOV with .aovindex property (a 4294967296 value will force the use of alpha channel instead, default value for compatibility with the past)
* LuxCore API has now SetMeshVertexAOV() and SetMeshTriangleAOV() methods to set geometry vertex and triangle AOV
* Added the support for new Random texture
* Added the support for the new IslandAOV shape
* Added the support for RandomTriangleAOV shape
* Accelerated duplicate vertex detection in pointiness shape (from 6.7 seconds to 0.016 seconds on a 100k vertex mesh)
* LuxRays API reworked to support generic hardware devices (now OpenCL, potentially CUDA, Vulkan, Metal, etc.)
* Added the support for light groups to PhotonGI
* New LuxCore API RenderConfig::HasCachedKernels() method to check if a (long) kernel compilation time is required
* Glossycoating material on GPUs now supports bump mapping exactly like CPU version (issue #307)
* Mix material on GPUs now supports bump mapping exactly like CPU version (issue #307)
* Added processor group support to enable LuxCoreRender to use more than 64 logical processors on Windows
* Added the support for CUDA rendering
* Added the support for out of core CUDA rendering (i.e. to render scenes larger than GPU ram available)
* GPU rendering now uses 64bit image map pixel indices (i.e. removed the limit of 8 * 4GB of scene image maps)
* New cache and out-of-core friendly mode for Random/Sobol samplers
* Added the support for denoising baked light maps with Intel ODIN
* pyluxcoretools merge now supports saving film AOVs via new --aov-output option
* New improved Metropolis sampler warmup period
* Added thin film interference option for many materials
* Added the support for a new color re-mapping image pipeline plug-in using .cube files (issue #81)
* LuxCore API now support unicode UTF-8 strings and files
* luxcore::KernelCacheFill() now supports opencl.devices.select, scene.epsilon.min and scene.epsilon.max properties (issue #374)
* LuxCoreRender can now be compiled without OpenCL/CUDA SDK and it will load OpenCL/CUDA at run time (one executable can now be used for all types of installations)
* RTPathOCLRenderEngine::WaitNewFrame() takes is not more synchronous with rendering refresh
* The use of more than 64 logical processors on Windows is now extended to all render engines
* It is now possible to render scenes without light sources (!)
* The use of more than 64 logical processors on Windows is now extended to all pre-processing tasks like caches, etc.

===Fixed Bugs===

* Fixed a rendering difference when using/not using geometry negative scale transformations (issue #309)
* Fixed an out of bound access in BAKECPU
* Fixed a problem when using path.forceblackbackground.enable and env. lights
* Fixed a problem with scenes with very hard light paths and Metropolis sampler (issue #312)
* Sampler shared data are now reseted at the end of a scene edit (issue #312)
* Fixed a problem in automatic cache radius estimation of PhotonGI when using Orthographic camera (issue #324)
* Fixed an OpenCL compilation error when using large number of objects on some old GPUs
* Fixed a problem with BlendLuxCore when parsing more than 9 image pipelines (#336)
* Fixed a bug causing fireflies when using light tracing for caustics in some case (#329)
* Fixed a crash when using RemoveUnusedTextures() with Volumes (issue #377)
* Fixed a banding problem when using sphere light sources with very small radius (issue LuxCoreRender/BlendLuxCore#477)
* Fixed LXS parsing of UV inlined coordinates (issue #392)

===Changes that break backwards-compatibility===

Due to Glossycoating updated support for bump mapping on GPUs, some old scene using this kind of material/bump map combination may require some fix.

===About Performance on GPUs===

In the past versions, we have been moving from very specialized, scene dependent OpenCL kernels to general-purpose kernels. This development simultaneously has drawbacks and benefits in simple scenes, which are explained below. Complex scenes that use most features and shaders of LuxCore are less affected by the drawbacks, sometimes not at all, while still reaping the full benefits.

* v2.2 is fastest (at samples/sec) because it uses conditional compilation: lots of renderengine features and materials/textures are turned off when not used. Requires kernel re-compilations each time you change rendersettings or material/texture settings. Viewport rendering with OpenCL engines is out of the question, unless all you do is move the camera or other objects around.

* v2.3 is slower because it no longer uses conditional compilation for renderengine features: all of them are active, always. This means that re-compilations are no longer necessary when changing render settings (e.g. clamping value). Materials/textures still use conditional compilation in v2.3, requiring re-compilations on most shader changes, which makes OpenCL engines still unusable for viewport rendering.

* v2.4 is slowest because it has no conditional compilation at all anymore. The kernel is compiled once for each engine type with all features enabled, and materials/textures are now evaluated at runtime using a stack-based method.

Note, the speed difference is more visible the simpler the scene is. This is because with conditional compilation, most features will be disabled in such a scene. The more features your scene uses (meaning, the more complex it is), the less this matters. With a very complex scene using all features, v2.2 will have very similar speed to v2.4.

Also, don't forget that you now save the time for kernel compilation, always (which could range from seconds to minutes). This can actually benefit simpler scenes, if the total rendertime is short (like for animations). If you render 500 frames at 60 sec/frame, saving 20 seconds of kernel compilation can matter a lot.

===Known Problems===

* accelerator.bvh.builder.type = EMBREE_MORTON doesn't work with the latest Embree
* Python crashes when calling sys.exit()
* TILEPATHOCL (and RTPATHOCL) count the layers of transparent surfaces as an iteration of the rendering finite state machine so they require to increase the max. path depth to avoid black regions.
* Light emitted by motion blurred triangle lights is approximated using the triangle area of time 0.0 (computing triangle area at runtime would be expansive) so it may be not totally accurate if the motion blur transformation include a scale.
* Variance clamping is not applied to AOVs

=Blender Addon (BlendLuxCore)=

===New Features===

* Optimize viewport update checks in scenes with many particles/duplis
* Replaced the Eevee lookdev (which required Cycles materials) with an albedo render mode that is intended as a fast texture preview for both Lux and Cycles node trees
* Node editor quality of life (support for muting nodes and some [https://github.com/LuxCoreRender/BlendLuxCore/issues/407 node wrangler functions])
* When using PhotonGI debug modes, disable light tracing and use an exposure compensated tonemapper
* Support for custom split normals, weighted normals etc. (only in Blender versions 2.82a and 2.83)
* Reworked statistics, added some sub-stats about export time (mesh conversion time, hair conversion time) as well as information about which caches are enabled/disabled
* Use Cycles nodes on linked materials without Lux nodes (so materials on Cycles assets automatically try to use Cycles nodes, unless you create a Lux material on the assets)
* Limit max. subdiv in material previews to 1
* Add support for indirect only collection visibility mode
* Support for manta flow smoke export in blender 2.82
* New triplanar normalmap node
* Add triplanar projection mode to imagemap node, general rework/polishing of the imagemap node
* Add support for transparency in the denoised result (both viewport and final render)
* Emulate Cycles material UI in Lux material node editor (material and slot dropdown instead of node tree dropdown)
* [https://forums.luxcorerender.org/viewtopic.php?f=5&t=2165 Thin film coating support] for glass and disney materials
* Cycles node reader:
** Add support for nested Cycles node groups
** Add support for principled emission, alpha and transmission sockets
** Add support for geometry node outputs: position and normal
** Add support for object info node outputs: object index, material index, random
** Add support for refraction shader
** Add support for blackbody texture
* LuxCore Online Library is now integrated in Blender (3D view > N-Panel > LuxCoreOnlineLibrary tab)
* New addon preferences:
** GPU backend (OpenCL/CUDA)
** Option to enable/disable image node thumbnails on new nodes by default
** LuxCore Online Library preferences
* Support for new sampling patterns and out-of-core rendering
* Amount of light tracing samples is now shown in statistics (image editor > N-Panel > LuxCore tab)
* Support for COLOR_LUT imagepipeline plugin, allowing to load .cube LUT files
* New material presets:
** Hybrid glass (regular refractive glass with white shadow color, as an alternative to architectural glass)
** Colored smoke
* New interactive render settings guide
* New maximum input to invert node
* New "Visible" setting for area lights, disabling hides the light not only for the camera, but also for shadow rays

===Fixed Bugs===

* Fix world volume ui panel drawing
* Fix material presets panel not showing without a material
* Fix remesh panel in mesh data properties not showing up
* Fix bugs in 3D mapping node UI (the controls were disappearing when the selected object was of type "CURVE", "SURFACE" or "FONT")
* Fix export of metaballs with shared data
* Fix shapes being added to cached meshes over and over in viewport render
* Fix check for UV maps on curve, surface and font objects being broken
* Fix shapes not working on hair
* Fix possible key collision in image exporter after undo (fixes #431)
* Fix color tint not working for sky and HDRIs
* Put Blender post processing panel in the right place (output props instead of render props)
* Fix wrong view layer visibility check
* Fix possible config export error if film opencl device was not set

'''beta1 released'''

* fix "compiling kernels" message shown before viewport render even if kernels were already cached
* fix duplicate texture math node category, leading to errors when unregistering the addon
* fix invert node compatibility code not being used, leading to errors when old node trees with invert nodes are exported
* fix brick bond and carpaint presets not working

===Known Problems===

* [https://github.com/LuxCoreRender/BlendLuxCore/issues/167 Inserted keyframes in material node graph don't show up in graph editor or anywhere else]
* LuxCore node parameters can not be animated in Blender 2.82. This bug is fixed in Blender 2.83 and later
* Rendering with caches (e.g. PhotonGI, DLSC, Env. light cache) can lead to problems '''if border rendering is enabled'''. A workaround is to disable automatic radius estimation and setting the radius manually instead when using border rendering

LuxCoreRender Tutorials

2020-07-01T23:26:06Z

Byob: /* General Tutorials */

== Video Tutorials ==

=== Blender 2.8x ===

{| width="100%"
|
[[File:BlendLuxCore-2.8-Interior-Tutorial.png|thumb|none|300x300px|link=https://youtu.be/XjwCOIWwQo4| [https://youtu.be/XjwCOIWwQo4 BlendLuxCore v2.8 Interior Tutorial] ]]
|
[[File:Shader_tutorial.jpg|thumb|none|300x300px|link=https://youtu.be/xZOdXI9181k| [https://youtu.be/xZOdXI9181k LuxCore Shader Tutorial 1] ]]
|
[[File:Shader_2.jpg|thumb|none|300x300px|link=https://youtu.be/79V_ySn5ZoY| [https://youtu.be/79V_ySn5ZoY LuxCore Shader Tutorial 2] ]]
|}

{| width="100%"
|
[[File:Orange_juice_tutorial.png|thumb|none|300x300px|link=https://youtu.be/R2-u3YNJbHQ| [https://youtu.be/R2-u3YNJbHQ Orange Juice Tutorial] ]]
|
[[File:Caustics_pool_tutorial.png|thumb|none|300x300px|link=https://youtu.be/mHYpWe4KF8I| [https://youtu.be/mHYpWe4KF8I Caustics Pool Tutorial] ]]
|
[[File:Caustics_Master.jpg|thumb|none|300x300px|link=https://youtu.be/gvo9WLBqNVU| [https://youtu.be/gvo9WLBqNVU Caustics & Fog] ]]
|}

{| width="100%"
|
[[File:Displacement_tut.jpg|thumb|none|300x300px|link=https://youtu.be/OrgCGEJL_sk| [https://youtu.be/OrgCGEJL_sk Displacement Tutorial] ]]
|
[[File:Heads.jpg|thumb|none|300x300px|link=https://youtu.be/1COAMA_r1Ao| [https://youtu.be/1COAMA_r1Ao Skin Shader Tutorial] ]]
|
[[File:HAIIRRR.jpg|thumb|none|300x300px|link=https://youtu.be/RMKwv6N4trQ| [https://youtu.be/RMKwv6N4trQ Hair Shader Tutorial] ]]
|}

{| width="100%"
|
[[File:Light Groups2.jpg|thumb|none|300x300px|link=https://youtu.be/Lsz9yx6GM7I| [https://youtu.be/Lsz9yx6GM7I Light Group Tutorial] ]]
|
[[File:Carpaint tut.jpg|thumb|none|300x300px|link=https://youtu.be/KFbk_JxPUj4| [https://youtu.be/KFbk_JxPUj4 Carpaint Tutorial] ]]
|
[[File:Pbr_leaf_texture_tut.jpg|thumb|none|300x300px|link=https://youtu.be/j8TXpqtdcvY| [https://youtu.be/j8TXpqtdcvY PBR Leaf Texture Tutorial] ]]
|}

==== BlendLuxCore Guide ====

* [https://youtu.be/Ron1se5liV8 Render settings - Tracing method I]
* [https://youtu.be/EgLSibsTpgY Render settings - Light paths II]
* [https://youtu.be/qlYrtUwhNoY Render settings - Light paths III]
* [https://youtu.be/gSwXpWc5uFg Render settings - Light strategy & Filter IV]
* [https://youtu.be/fXoa2rJu_nY Render settings - Performance & Denoiser V]
* [https://youtu.be/ogkOyOmMDpA Render settings - Halt conditions, display and viewport settings VI]
* [https://youtu.be/FnORHMBpQHY Render settings - Photon GI cache VII]

=== Blender 2.79 ===

{| width="100%"
|
[[File:beginner_tutorial.jpg|thumb|none|300x300px|link=https://youtu.be/-BmXeUDRqSo| [https://youtu.be/-BmXeUDRqSo Introduction to LuxCoreRender in Blender] ]]
|
[[File:DLSC_tutorial_thumbnail.jpg|thumb|none|300x300px|link=https://youtu.be/dIfwr2YPxPw| [https://youtu.be/dIfwr2YPxPw Tutorial about the Direct Light Sampling Cache (DLSC)] ]]
|
[[File:Sss tutorial thumbnail.jpg|thumb|none|300x300px|link=https://youtu.be/gEGDyHMnlkg| [https://youtu.be/gEGDyHMnlkg Subsurface Scattering and Volume Tutorial] ]]
|}

{| width="100%"
|
[[File:Brushed steel thumbnail.png|thumb|none|300x300px|link=https://youtu.be/FGhPAP0oV9k| [https://youtu.be/FGhPAP0oV9k Brushed Steel Tutorial] ]]
|
[[File:Photongi_tutorial.jpg|thumb|none|300x300px|link=https://youtu.be/trkUldfb380| [https://youtu.be/trkUldfb380 PhotonGI Tutorial] ]]
|
[[File:LED_tutorial.png|thumb|none|300x300px|link=https://youtu.be/saGvvLWS4xs| [https://youtu.be/saGvvLWS4xs LED Tutorial] ]]
|}

== General Tutorials ==

These tutorials are not about LuxCoreRender, but about scene composition, lighting and other universal concepts.

* ciechanow.ski: [https://ciechanow.ski/lights-and-shadows/ Lights and Shadows]
* ciechanow.ski: [https://ciechanow.ski/color-spaces/ Color Spaces]
* blenderer.com: [https://www.blendernation.com/2018/06/18/how-to-make-a-beautiful-scene/ What makes a beautiful scene]
* blenderer.com: [https://www.blendernation.com/2018/06/22/how-to-improve-your-interior-scenes/ Secrets to making the best interior scenes]

== Old Tutorials for LuxBlend ==

The tutorials listed here were made with the old LuxBlend addon.

* Create nice beer using Blender and LuxCore: [https://www.youtube.com/watch?v=EtsA7iDK32A Part 1] and [https://www.youtube.com/watch?v=lJliJFKir8Y Part 2]
* [https://youtu.be/GpvHYi8uW1Y Create an interior scene using Blender and LuxCore]

LuxCoreRender Release Notes v2.4

2020-06-26T15:16:25Z

Byob: /* New Features */

=LuxCore=

===New Features===

* New OpenCL code to evaluate textures and materials. It doesn't require kernel re-compilation anymore
* LuxCoreUI "Fill kernel cache" menu option now pre-compile all possible GPU kernels
* LuxCore API KernelCacheFill() is now available for Python
* New 2-levels Env. Light Visibility Cache (ELVC)
* Added the support for a new ".sharpness" (default value 0.1, range [0.0, 1.0]) Intel OIDN parameter to blend original and denoised output
* Removed LuxRays support for virtual devices and hybrid rendering (old LuxRender GPU doing ray intersections and CPU everything else)
* Geometry vertex and triangle AOVs (arbitrary data associated to mesh vertices and triangle usable by textures)
* Removed the support for Triplanar texture .uvindex (side effect of the above new feature)
* New hitpointvertexaov nad hitpointtriangleaov textures
* Pointiness shape can now assign curvature values to vertex AOV with .aovindex property (a 4294967296 value will force the use of alpha channel instead, default value for compatibility with the past)
* LuxCore API has now SetMeshVertexAOV() and SetMeshTriangleAOV() methods to set geometry vertex and triangle AOV
* Added the support for new Random texture
* Added the support for the new IslandAOV shape
* Added the support for RandomTriangleAOV shape
* Accelerated duplicate vertex detection in pointiness shape (from 6.7 seconds to 0.016 seconds on a 100k vertex mesh)
* LuxRays API reworked to support generic hardware devices (now OpenCL, potentially CUDA, Vulkan, Metal, etc.)
* Added the support for light groups to PhotonGI
* New LuxCore API RenderConfig::HasCachedKernels() method to check if a (long) kernel compilation time is required
* Glossycoating material on GPUs now supports bump mapping exactly like CPU version (issue #307)
* Mix material on GPUs now supports bump mapping exactly like CPU version (issue #307)
* Added processor group support to enable LuxCoreRender to use more than 64 logical processors on Windows
* Added the support for CUDA rendering
* Added the support for out of core CUDA rendering (i.e. to render scenes larger than GPU ram available)
* GPU rendering now uses 64bit image map pixel indices (i.e. removed the limit of 8 * 4GB of scene image maps)
* New cache and out-of-core friendly mode for Random/Sobol samplers
* Added the support for denoising baked light maps with Intel ODIN
* pyluxcoretools merge now supports saving film AOVs via new --aov-output option
* New improved Metropolis sampler warmup period
* Added thin film interference option for many materials
* Added the support for a new color re-mapping image pipeline plug-in using .cube files (issue #81)
* LuxCore API now support unicode UTF-8 strings and files
* luxcore::KernelCacheFill() now supports opencl.devices.select, scene.epsilon.min and scene.epsilon.max properties (issue #374)

===Fixed Bugs===

* Fixed a rendering difference when using/not using geometry negative scale transformations (issue #309)
* Fixed an out of bound access in BAKECPU
* Fixed a problem when using path.forceblackbackground.enable and env. lights
* Fixed a problem with scenes with very hard light paths and Metropolis sampler (issue #312)
* Sampler shared data are now reseted at the end of a scene edit (issue #312)
* Fixed a problem in automatic cache radius estimation of PhotonGI when using Orthographic camera (issue #324)
* Fixed an OpenCL compilation error when using large number of objects on some old GPUs
* Fixed a problem with BlendLuxCore when parsing more than 9 image pipelines (#336)
* Fixed a bug causing fireflies when using light tracing for caustics in some case (#329)

===Changes that break backwards-compatibility===

Due to Glossycoating updated support for bump mapping on GPUs, some old scene using this kind of material/bump map combination may require some fix.

===About Performance on GPUs===

In the past versions, we have been moving from very specialized, scene dependent OpenCL kernels to general-purpose kernels. This development simultaneously has drawbacks and benefits in simple scenes, which are explained below. Complex scenes that use most features and shaders of LuxCore are less affected by the drawbacks, sometimes not at all, while still reaping the full benefits.

* v2.2 is fastest (at samples/sec) because it uses conditional compilation: lots of renderengine features and materials/textures are turned off when not used. Requires kernel re-compilations each time you change rendersettings or material/texture settings. Viewport rendering with OpenCL engines is out of the question, unless all you do is move the camera or other objects around.

* v2.3 is slower because it no longer uses conditional compilation for renderengine features: all of them are active, always. This means that re-compilations are no longer necessary when changing render settings (e.g. clamping value). Materials/textures still use conditional compilation in v2.3, requiring re-compilations on most shader changes, which makes OpenCL engines still unusable for viewport rendering.

* v2.4 is slowest because it has no conditional compilation at all anymore. The kernel is compiled once for each engine type with all features enabled, and materials/textures are now evaluated at runtime using a stack-based method.

Note, the speed difference is more visible the simpler the scene is. This is because with conditional compilation, most features will be disabled in such a scene. The more features your scene uses (meaning, the more complex it is), the less this matters. With a very complex scene using all features, v2.2 will have very similar speed to v2.4.

Also, don't forget that you now save the time for kernel compilation, always (which could range from seconds to minutes). This can actually benefit simpler scenes, if the total rendertime is short (like for animations). If you render 500 frames at 60 sec/frame, saving 20 seconds of kernel compilation can matter a lot.

===Known Problems===

* LuxCore API requires latin locale
* accelerator.bvh.builder.type = EMBREE_MORTON doesn't work with the latest Embree
* Python crashes when calling sys.exit()
* TILEPATHOCL (and RTPATHOCL) count the layers of transparent surfaces as an iteration of the rendering finite state machine so they require to increase the max. path depth to avoid black regions.
* Light emitted by motion blurred triangle lights is approximated using the triangle area of time 0.0 (computing triangle area at runtime would be expansive) so it may be not totally accurate if the motion blur transformation include a scale.
* Variance clamping is not applied to AOVs

=Blender Addon (BlendLuxCore)=

===New Features===

* Optimize viewport update checks in scenes with many particles/duplis
* Replaced the Eevee lookdev (which required Cycles materials) with an albedo render mode that is intended as a fast texture preview for both Lux and Cycles node trees
* Node editor quality of life (support for muting nodes and some [https://github.com/LuxCoreRender/BlendLuxCore/issues/407 node wrangler functions])
* When using PhotonGI debug modes, disable light tracing and use an exposure compensated tonemapper
* Support for custom split normals, weighted normals etc. (only in Blender versions 2.82a and 2.83)
* Reworked statistics, added some sub-stats about export time (mesh conversion time, hair conversion time) as well as information about which caches are enabled/disabled
* Use Cycles nodes on linked materials without Lux nodes (so materials on Cycles assets automatically try to use Cycles nodes, unless you create a Lux material on the assets)
* Limit max. subdiv in material previews to 1
* Add support for indirect only collection visibility mode
* Support for manta flow smoke export in blender 2.82
* New triplanar normalmap node
* Add triplanar projection mode to imagemap node, general rework/polishing of the imagemap node
* Add support for transparency in the denoised result (both viewport and final render)
* Emulate Cycles material UI in Lux material node editor (material and slot dropdown instead of node tree dropdown)
* [https://forums.luxcorerender.org/viewtopic.php?f=5&t=2165 Thin film coating support] for glass and disney materials
* Cycles node reader:
** Add support for nested Cycles node groups
** Add support for principled emission, alpha and transmission sockets
** Add support for geometry node outputs: position and normal
** Add support for object info node outputs: object index, material index, random
** Add support for refraction shader
** Add support for blackbody texture
* LuxCore Online Library is now integrated in Blender (3D view > N-Panel > LuxCoreOnlineLibrary tab)
* New addon preferences:
** GPU backend (OpenCL/CUDA)
** Option to enable/disable image node thumbnails on new nodes by default
** LuxCore Online Library preferences
* Support for new sampling patterns and out-of-core rendering
* Amount of light tracing samples is now shown in statistics (image editor > N-Panel > LuxCore tab)
* Support for COLOR_LUT imagepipeline plugin, allowing to load .cube LUT files
* New material presets:
** Hybrid glass (regular refractive glass with white shadow color, as an alternative to architectural glass)
** Colored smoke
* New interactive render settings guide
* New maximum input to invert node
* New "Visible" setting for area lights, disabling hides the light not only for the camera, but also for shadow rays

===Fixed Bugs===

* Fix world volume ui panel drawing
* Fix material presets panel not showing without a material
* Fix remesh panel in mesh data properties not showing up
* Fix bugs in 3D mapping node UI (the controls were disappearing when the selected object was of type "CURVE", "SURFACE" or "FONT")
* Fix export of metaballs with shared data
* Fix shapes being added to cached meshes over and over in viewport render
* Fix check for UV maps on curve, surface and font objects being broken
* Fix shapes not working on hair
* Fix possible key collision in image exporter after undo (fixes #431)
* Fix color tint not working for sky and HDRIs
* Put Blender post processing panel in the right place (output props instead of render props)
* Fix wrong view layer visibility check
* Fix possible config export error if film opencl device was not set

===Known Problems===

* [https://github.com/LuxCoreRender/BlendLuxCore/issues/167 Inserted keyframes in material node graph don't show up in graph editor or anywhere else]
* LuxCore node parameters can not be animated in Blender 2.82. This bug is fixed in Blender 2.83 and later
* Rendering with caches (e.g. PhotonGI, DLSC, Env. light cache) can lead to problems '''if border rendering is enabled'''. A workaround is to disable automatic radius estimation and setting the radius manually instead when using border rendering

LuxCoreRender Release Notes v2.4

2020-06-26T15:13:48Z

Byob: /* New Features */

=LuxCore=

===New Features===

* New OpenCL code to evaluate textures and materials. It doesn't require kernel re-compilation anymore
* LuxCoreUI "Fill kernel cache" menu option now pre-compile all possible GPU kernels
* LuxCore API KernelCacheFill() is now available for Python
* New 2-levels Env. Light Visibility Cache (ELVC)
* Added the support for a new ".sharpness" (default value 0.1, range [0.0, 1.0]) Intel OIDN parameter to blend original and denoised output
* Removed LuxRays support for virtual devices and hybrid rendering (old LuxRender GPU doing ray intersections and CPU everything else)
* Geometry vertex and triangle AOVs (arbitrary data associated to mesh vertices and triangle usable by textures)
* Removed the support for Triplanar texture .uvindex (side effect of the above new feature)
* New hitpointvertexaov nad hitpointtriangleaov textures
* Pointiness shape can now assign curvature values to vertex AOV with .aovindex property (a 4294967296 value will force the use of alpha channel instead, default value for compatibility with the past)
* LuxCore API has now SetMeshVertexAOV() and SetMeshTriangleAOV() methods to set geometry vertex and triangle AOV
* Added the support for new Random texture
* Added the support for the new IslandAOV shape
* Added the support for RandomTriangleAOV shape
* Accelerated duplicate vertex detection in pointiness shape (from 6.7 seconds to 0.016 seconds on a 100k vertex mesh)
* LuxRays API reworked to support generic hardware devices (now OpenCL, potentially CUDA, Vulkan, Metal, etc.)
* Added the support for light groups to PhotonGI
* New LuxCore API RenderConfig::HasCachedKernels() method to check if a (long) kernel compilation time is required
* Glossycoating material on GPUs now supports bump mapping exactly like CPU version (issue #307)
* Mix material on GPUs now supports bump mapping exactly like CPU version (issue #307)
* Added processor group support to enable LuxCoreRender to use more than 64 logical processors on Windows
* Added the support for CUDA rendering
* Added the support for out of core CUDA rendering (i.e. to render scenes larger than GPU ram available)
* GPU rendering now uses 64bit image map pixel indices (i.e. removed the limit of 8 * 4GB of scene image maps)
* New cache and out-of-core friendly mode for Random/Sobol samplers
* Added the support for denoising baked light maps with Intel ODIN
* pyluxcoretools merge now supports saving film AOVs via new --aov-output option
* New improved Metropolis sampler warmup period
* Added thin film interference option for many materials
* Added the support for a new color re-mapping image pipeline plug-in using .cube files (issue #81)
* LuxCore API now support unicode UTF-8 strings and files
* luxcore::KernelCacheFill() now supports opencl.devices.select, scene.epsilon.min and scene.epsilon.max properties (issue #374)

===Fixed Bugs===

* Fixed a rendering difference when using/not using geometry negative scale transformations (issue #309)
* Fixed an out of bound access in BAKECPU
* Fixed a problem when using path.forceblackbackground.enable and env. lights
* Fixed a problem with scenes with very hard light paths and Metropolis sampler (issue #312)
* Sampler shared data are now reseted at the end of a scene edit (issue #312)
* Fixed a problem in automatic cache radius estimation of PhotonGI when using Orthographic camera (issue #324)
* Fixed an OpenCL compilation error when using large number of objects on some old GPUs
* Fixed a problem with BlendLuxCore when parsing more than 9 image pipelines (#336)
* Fixed a bug causing fireflies when using light tracing for caustics in some case (#329)

===Changes that break backwards-compatibility===

Due to Glossycoating updated support for bump mapping on GPUs, some old scene using this kind of material/bump map combination may require some fix.

===About Performance on GPUs===

In the past versions, we have been moving from very specialized, scene dependent OpenCL kernels to general-purpose kernels. This development simultaneously has drawbacks and benefits in simple scenes, which are explained below. Complex scenes that use most features and shaders of LuxCore are less affected by the drawbacks, sometimes not at all, while still reaping the full benefits.

* v2.2 is fastest (at samples/sec) because it uses conditional compilation: lots of renderengine features and materials/textures are turned off when not used. Requires kernel re-compilations each time you change rendersettings or material/texture settings. Viewport rendering with OpenCL engines is out of the question, unless all you do is move the camera or other objects around.

* v2.3 is slower because it no longer uses conditional compilation for renderengine features: all of them are active, always. This means that re-compilations are no longer necessary when changing render settings (e.g. clamping value). Materials/textures still use conditional compilation in v2.3, requiring re-compilations on most shader changes, which makes OpenCL engines still unusable for viewport rendering.

* v2.4 is slowest because it has no conditional compilation at all anymore. The kernel is compiled once for each engine type with all features enabled, and materials/textures are now evaluated at runtime using a stack-based method.

Note, the speed difference is more visible the simpler the scene is. This is because with conditional compilation, most features will be disabled in such a scene. The more features your scene uses (meaning, the more complex it is), the less this matters. With a very complex scene using all features, v2.2 will have very similar speed to v2.4.

Also, don't forget that you now save the time for kernel compilation, always (which could range from seconds to minutes). This can actually benefit simpler scenes, if the total rendertime is short (like for animations). If you render 500 frames at 60 sec/frame, saving 20 seconds of kernel compilation can matter a lot.

===Known Problems===

* LuxCore API requires latin locale
* accelerator.bvh.builder.type = EMBREE_MORTON doesn't work with the latest Embree
* Python crashes when calling sys.exit()
* TILEPATHOCL (and RTPATHOCL) count the layers of transparent surfaces as an iteration of the rendering finite state machine so they require to increase the max. path depth to avoid black regions.
* Light emitted by motion blurred triangle lights is approximated using the triangle area of time 0.0 (computing triangle area at runtime would be expansive) so it may be not totally accurate if the motion blur transformation include a scale.
* Variance clamping is not applied to AOVs

=Blender Addon (BlendLuxCore)=

===New Features===

* Optimize viewport update checks in scenes with many particles/duplis
* Replaced the Eevee lookdev (which required Cycles materials) with an albedo render mode that is intended as a fast texture preview for both Lux and Cycles node trees
* Node editor quality of life (support for muting nodes and some [https://github.com/LuxCoreRender/BlendLuxCore/issues/407 node wrangler functions])
* When using PhotonGI debug modes, disable light tracing and use an exposure compensated tonemapper
* Support for custom split normals, weighted normals etc. (only in Blender versions 2.82a and 2.83)
* Reworked statistics, added some sub-stats about export time (mesh conversion time, hair conversion time) as well as information about which caches are enabled/disabled
* Use Cycles nodes on linked materials without Lux nodes (so materials on Cycles assets automatically try to use Cycles nodes, unless you create a Lux material on the assets)
* Limit max. subdiv in material previews to 1
* Add support for indirect only collection visibility mode
* Support for manta flow smoke export in blender 2.82
* New triplanar normalmap node
* Add triplanar projection mode to imagemap node, general rework/polishing of the imagemap node
* Add support for transparency in the denoised result (both viewport and final render)
* Emulate Cycles material UI in Lux material node editor (material and slot dropdown instead of node tree dropdown)
* [https://forums.luxcorerender.org/viewtopic.php?f=5&t=2165 Thin film coating support] for glass and disney materials
* Cycles node reader:
** Add support for nested Cycles node groups
** Add support for principled emission, alpha and transmission sockets
** Add support for geometry node outputs: position and normal
** Add support for object info node outputs: object index, material index, random
** Add support for refraction shader
** Add support for blackbody texture
* LuxCore Online Library is now integrated in Blender (3D view > N-Panel > LuxCoreOnlineLibrary tab)
* New addon preferences:
** GPU backend (OpenCL/CUDA)
** Option to enable/disable image node thumbnails on new nodes by default
** LuxCore Online Library preferences
* Support for new sampling patterns and out-of-core rendering
* Amount of light tracing samples is now shown in statistics (image editor > N-Panel > LuxCore tab)
* Support for COLOR_LUT imagepipeline plugin, allowing to load .cube LUT files
* New material presets:
** Hybrid glass (regular refractive glass with white shadow color, as an alternative to architectural glass)
** Colored smoke
* New interactive render settings guide
* Add maximum input to invert node
* New "Visible" setting for area lights, disabling hides the light not only for the camera, but also for shadow rays

===Fixed Bugs===

* Fix world volume ui panel drawing
* Fix material presets panel not showing without a material
* Fix remesh panel in mesh data properties not showing up
* Fix bugs in 3D mapping node UI (the controls were disappearing when the selected object was of type "CURVE", "SURFACE" or "FONT")
* Fix export of metaballs with shared data
* Fix shapes being added to cached meshes over and over in viewport render
* Fix check for UV maps on curve, surface and font objects being broken
* Fix shapes not working on hair
* Fix possible key collision in image exporter after undo (fixes #431)
* Fix color tint not working for sky and HDRIs
* Put Blender post processing panel in the right place (output props instead of render props)
* Fix wrong view layer visibility check
* Fix possible config export error if film opencl device was not set

===Known Problems===

* [https://github.com/LuxCoreRender/BlendLuxCore/issues/167 Inserted keyframes in material node graph don't show up in graph editor or anywhere else]
* LuxCore node parameters can not be animated in Blender 2.82. This bug is fixed in Blender 2.83 and later
* Rendering with caches (e.g. PhotonGI, DLSC, Env. light cache) can lead to problems '''if border rendering is enabled'''. A workaround is to disable automatic radius estimation and setting the radius manually instead when using border rendering

LuxCoreRender Release Notes v2.4

2020-06-26T14:51:23Z

Byob: /* Blender Addon (BlendLuxCore) */

=LuxCore=

===New Features===

* New OpenCL code to evaluate textures and materials. It doesn't require kernel re-compilation anymore
* LuxCoreUI "Fill kernel cache" menu option now pre-compile all possible GPU kernels
* LuxCore API KernelCacheFill() is now available for Python
* New 2-levels Env. Light Visibility Cache (ELVC)
* Added the support for a new ".sharpness" (default value 0.1, range [0.0, 1.0]) Intel OIDN parameter to blend original and denoised output
* Removed LuxRays support for virtual devices and hybrid rendering (old LuxRender GPU doing ray intersections and CPU everything else)
* Geometry vertex and triangle AOVs (arbitrary data associated to mesh vertices and triangle usable by textures)
* Removed the support for Triplanar texture .uvindex (side effect of the above new feature)
* New hitpointvertexaov nad hitpointtriangleaov textures
* Pointiness shape can now assign curvature values to vertex AOV with .aovindex property (a 4294967296 value will force the use of alpha channel instead, default value for compatibility with the past)
* LuxCore API has now SetMeshVertexAOV() and SetMeshTriangleAOV() methods to set geometry vertex and triangle AOV
* Added the support for new Random texture
* Added the support for the new IslandAOV shape
* Added the support for RandomTriangleAOV shape
* Accelerated duplicate vertex detection in pointiness shape (from 6.7 seconds to 0.016 seconds on a 100k vertex mesh)
* LuxRays API reworked to support generic hardware devices (now OpenCL, potentially CUDA, Vulkan, Metal, etc.)
* Added the support for light groups to PhotonGI
* New LuxCore API RenderConfig::HasCachedKernels() method to check if a (long) kernel compilation time is required
* Glossycoating material on GPUs now supports bump mapping exactly like CPU version (issue #307)
* Mix material on GPUs now supports bump mapping exactly like CPU version (issue #307)
* Added processor group support to enable LuxCoreRender to use more than 64 logical processors on Windows
* Added the support for CUDA rendering
* Added the support for out of core CUDA rendering (i.e. to render scenes larger than GPU ram available)
* GPU rendering now uses 64bit image map pixel indices (i.e. removed the limit of 8 * 4GB of scene image maps)
* New cache and out-of-core friendly mode for Random/Sobol samplers
* Added the support for denoising baked light maps with Intel ODIN
* pyluxcoretools merge now supports saving film AOVs via new --aov-output option
* New improved Metropolis sampler warmup period
* Added thin film interference option for many materials
* Added the support for a new color re-mapping image pipeline plug-in using .cube files (issue #81)
* LuxCore API now support unicode UTF-8 strings and files
* luxcore::KernelCacheFill() now supports opencl.devices.select, scene.epsilon.min and scene.epsilon.max properties (issue #374)

===Fixed Bugs===

* Fixed a rendering difference when using/not using geometry negative scale transformations (issue #309)
* Fixed an out of bound access in BAKECPU
* Fixed a problem when using path.forceblackbackground.enable and env. lights
* Fixed a problem with scenes with very hard light paths and Metropolis sampler (issue #312)
* Sampler shared data are now reseted at the end of a scene edit (issue #312)
* Fixed a problem in automatic cache radius estimation of PhotonGI when using Orthographic camera (issue #324)
* Fixed an OpenCL compilation error when using large number of objects on some old GPUs
* Fixed a problem with BlendLuxCore when parsing more than 9 image pipelines (#336)
* Fixed a bug causing fireflies when using light tracing for caustics in some case (#329)

===Changes that break backwards-compatibility===

Due to Glossycoating updated support for bump mapping on GPUs, some old scene using this kind of material/bump map combination may require some fix.

===About Performance on GPUs===

In the past versions, we have been moving from very specialized, scene dependent OpenCL kernels to general-purpose kernels. This development simultaneously has drawbacks and benefits in simple scenes, which are explained below. Complex scenes that use most features and shaders of LuxCore are less affected by the drawbacks, sometimes not at all, while still reaping the full benefits.

* v2.2 is fastest (at samples/sec) because it uses conditional compilation: lots of renderengine features and materials/textures are turned off when not used. Requires kernel re-compilations each time you change rendersettings or material/texture settings. Viewport rendering with OpenCL engines is out of the question, unless all you do is move the camera or other objects around.

* v2.3 is slower because it no longer uses conditional compilation for renderengine features: all of them are active, always. This means that re-compilations are no longer necessary when changing render settings (e.g. clamping value). Materials/textures still use conditional compilation in v2.3, requiring re-compilations on most shader changes, which makes OpenCL engines still unusable for viewport rendering.

* v2.4 is slowest because it has no conditional compilation at all anymore. The kernel is compiled once for each engine type with all features enabled, and materials/textures are now evaluated at runtime using a stack-based method.

Note, the speed difference is more visible the simpler the scene is. This is because with conditional compilation, most features will be disabled in such a scene. The more features your scene uses (meaning, the more complex it is), the less this matters. With a very complex scene using all features, v2.2 will have very similar speed to v2.4.

Also, don't forget that you now save the time for kernel compilation, always (which could range from seconds to minutes). This can actually benefit simpler scenes, if the total rendertime is short (like for animations). If you render 500 frames at 60 sec/frame, saving 20 seconds of kernel compilation can matter a lot.

===Known Problems===

* LuxCore API requires latin locale
* accelerator.bvh.builder.type = EMBREE_MORTON doesn't work with the latest Embree
* Python crashes when calling sys.exit()
* TILEPATHOCL (and RTPATHOCL) count the layers of transparent surfaces as an iteration of the rendering finite state machine so they require to increase the max. path depth to avoid black regions.
* Light emitted by motion blurred triangle lights is approximated using the triangle area of time 0.0 (computing triangle area at runtime would be expansive) so it may be not totally accurate if the motion blur transformation include a scale.
* Variance clamping is not applied to AOVs

=Blender Addon (BlendLuxCore)=

===New Features===

* Optimize viewport update checks in scenes with many particles/duplis
* Replaced the Eevee lookdev (which required Cycles materials) with an albedo render mode that is intended as a fast texture preview for both Lux and Cycles node trees
* Node editor quality of life (support for muting nodes and some [https://github.com/LuxCoreRender/BlendLuxCore/issues/407 node wrangler functions])
* When using PhotonGI debug modes, disable light tracing and use an exposure compensated tonemapper
* Support for custom split normals, weighted normals etc. (only in Blender versions 2.82a and 2.83)
* Reworked statistics, added some sub-stats about export time (mesh conversion time, hair conversion time) as well as information about which caches are enabled/disabled
* Use Cycles nodes on linked materials without Lux nodes (so materials on Cycles assets automatically try to use Cycles nodes, unless you create a Lux material on the assets)
* Limit max. subdiv in material previews to 1
* Add support for principled emission, alpha and transmission sockets to Cycles node reader
* Add support for indirect only collection visibility mode
* Support for manta flow smoke export in blender 2.82
* New triplanar normalmap node
* Add triplanar projection mode to imagemap node, general rework/polishing of the imagemap node
* Add support for transparency in the denoised result (both viewport and final render)
* Emulate Cycles material UI in Lux material node editor (material and slot dropdown instead of node tree dropdown)
* [https://forums.luxcorerender.org/viewtopic.php?f=5&t=2165 Thin film coating support] for glass and disney materials
* Cycles node reader:
** Add support for nested Cycles node groups
** Add support for geometry node outputs: position and normal
** Add support for object info node outputs: object index, material index, random
** Add support for refraction shader
** Add support for blackbody texture
* LuxCore Online Library is now integrated in Blender (3D view > N-Panel > LuxCoreOnlineLibrary tab)
* New addon preferences:
** GPU backend (OpenCL/CUDA)
** Option to enable/disable image node thumbnails on new nodes by default
** LuxCore Online Library preferences
* Support for new sampling patterns and out-of-core rendering
* Amount of light tracing samples is now shown in statistics (image editor > N-Panel > LuxCore tab)
* Support for COLOR_LUT imagepipeline plugin, allowing to load .cube LUT files
* New material presets:
** Hybrid glass (regular refractive glass with white shadow color, as an alternative to architectural glass)
** Colored smoke
* New interactive render settings guide
* Add maximum input to invert node
* New "Visible" setting for area lights, disabling hides the light not only for the camera, but also for shadow rays

===Fixed Bugs===

* Fix world volume ui panel drawing
* Fix material presets panel not showing without a material
* Fix remesh panel in mesh data properties not showing up
* Fix bugs in 3D mapping node UI (the controls were disappearing when the selected object was of type "CURVE", "SURFACE" or "FONT")
* Fix export of metaballs with shared data
* Fix shapes being added to cached meshes over and over in viewport render
* Fix check for UV maps on curve, surface and font objects being broken
* Fix shapes not working on hair
* Fix possible key collision in image exporter after undo (fixes #431)
* Fix color tint not working for sky and HDRIs
* Put Blender post processing panel in the right place (output props instead of render props)
* Fix wrong view layer visibility check
* Fix possible config export error if film opencl device was not set

===Known Problems===

* [https://github.com/LuxCoreRender/BlendLuxCore/issues/167 Inserted keyframes in material node graph don't show up in graph editor or anywhere else]
* LuxCore node parameters can not be animated in Blender 2.82. This bug is fixed in Blender 2.83 and later
* Rendering with caches (e.g. PhotonGI, DLSC, Env. light cache) can lead to problems '''if border rendering is enabled'''. A workaround is to disable automatic radius estimation and setting the radius manually instead when using border rendering

LuxCoreRender Tutorials

2020-06-14T15:47:32Z

Byob: /* BlendLuxCore Guide */

== Video Tutorials ==

=== Blender 2.8x ===

{| width="100%"
|
[[File:BlendLuxCore-2.8-Interior-Tutorial.png|thumb|none|300x300px|link=https://youtu.be/XjwCOIWwQo4| [https://youtu.be/XjwCOIWwQo4 BlendLuxCore v2.8 Interior Tutorial] ]]
|
[[File:Shader_tutorial.jpg|thumb|none|300x300px|link=https://youtu.be/xZOdXI9181k| [https://youtu.be/xZOdXI9181k LuxCore Shader Tutorial 1] ]]
|
[[File:Shader_2.jpg|thumb|none|300x300px|link=https://youtu.be/79V_ySn5ZoY| [https://youtu.be/79V_ySn5ZoY LuxCore Shader Tutorial 2] ]]
|}

{| width="100%"
|
[[File:Orange_juice_tutorial.png|thumb|none|300x300px|link=https://youtu.be/R2-u3YNJbHQ| [https://youtu.be/R2-u3YNJbHQ Orange Juice Tutorial] ]]
|
[[File:Caustics_pool_tutorial.png|thumb|none|300x300px|link=https://youtu.be/mHYpWe4KF8I| [https://youtu.be/mHYpWe4KF8I Caustics Pool Tutorial] ]]
|
[[File:Caustics_Master.jpg|thumb|none|300x300px|link=https://youtu.be/gvo9WLBqNVU| [https://youtu.be/gvo9WLBqNVU Caustics & Fog] ]]
|}

{| width="100%"
|
[[File:Displacement_tut.jpg|thumb|none|300x300px|link=https://youtu.be/OrgCGEJL_sk| [https://youtu.be/OrgCGEJL_sk Displacement Tutorial] ]]
|
[[File:Heads.jpg|thumb|none|300x300px|link=https://youtu.be/1COAMA_r1Ao| [https://youtu.be/1COAMA_r1Ao Skin Shader Tutorial] ]]
|
[[File:HAIIRRR.jpg|thumb|none|300x300px|link=https://youtu.be/RMKwv6N4trQ| [https://youtu.be/RMKwv6N4trQ Hair Shader Tutorial] ]]
|}

{| width="100%"
|
[[File:Light Groups2.jpg|thumb|none|300x300px|link=https://youtu.be/Lsz9yx6GM7I| [https://youtu.be/Lsz9yx6GM7I Light Group Tutorial] ]]
|
[[File:Carpaint tut.jpg|thumb|none|300x300px|link=https://youtu.be/KFbk_JxPUj4| [https://youtu.be/KFbk_JxPUj4 Carpaint Tutorial] ]]
|
[[File:Pbr_leaf_texture_tut.jpg|thumb|none|300x300px|link=https://youtu.be/j8TXpqtdcvY| [https://youtu.be/j8TXpqtdcvY PBR Leaf Texture Tutorial] ]]
|}

==== BlendLuxCore Guide ====

* [https://youtu.be/Ron1se5liV8 Render settings - Tracing method I]
* [https://youtu.be/EgLSibsTpgY Render settings - Light paths II]
* [https://youtu.be/qlYrtUwhNoY Render settings - Light paths III]
* [https://youtu.be/gSwXpWc5uFg Render settings - Light strategy & Filter IV]
* [https://youtu.be/fXoa2rJu_nY Render settings - Performance & Denoiser V]
* [https://youtu.be/ogkOyOmMDpA Render settings - Halt conditions, display and viewport settings VI]
* [https://youtu.be/FnORHMBpQHY Render settings - Photon GI cache VII]

=== Blender 2.79 ===

{| width="100%"
|
[[File:beginner_tutorial.jpg|thumb|none|300x300px|link=https://youtu.be/-BmXeUDRqSo| [https://youtu.be/-BmXeUDRqSo Introduction to LuxCoreRender in Blender] ]]
|
[[File:DLSC_tutorial_thumbnail.jpg|thumb|none|300x300px|link=https://youtu.be/dIfwr2YPxPw| [https://youtu.be/dIfwr2YPxPw Tutorial about the Direct Light Sampling Cache (DLSC)] ]]
|
[[File:Sss tutorial thumbnail.jpg|thumb|none|300x300px|link=https://youtu.be/gEGDyHMnlkg| [https://youtu.be/gEGDyHMnlkg Subsurface Scattering and Volume Tutorial] ]]
|}

{| width="100%"
|
[[File:Brushed steel thumbnail.png|thumb|none|300x300px|link=https://youtu.be/FGhPAP0oV9k| [https://youtu.be/FGhPAP0oV9k Brushed Steel Tutorial] ]]
|
[[File:Photongi_tutorial.jpg|thumb|none|300x300px|link=https://youtu.be/trkUldfb380| [https://youtu.be/trkUldfb380 PhotonGI Tutorial] ]]
|
[[File:LED_tutorial.png|thumb|none|300x300px|link=https://youtu.be/saGvvLWS4xs| [https://youtu.be/saGvvLWS4xs LED Tutorial] ]]
|}

== General Tutorials ==

These tutorials are not about LuxCoreRender, but about scene composition, lighting etc.

* blenderer.com: [https://www.blendernation.com/2018/06/18/how-to-make-a-beautiful-scene/ What makes a beautiful scene]
* blenderer.com: [https://www.blendernation.com/2018/06/22/how-to-improve-your-interior-scenes/ Secrets to making the best interior scenes]

== Old Tutorials for LuxBlend ==

The tutorials listed here were made with the old LuxBlend addon.

* Create nice beer using Blender and LuxCore: [https://www.youtube.com/watch?v=EtsA7iDK32A Part 1] and [https://www.youtube.com/watch?v=lJliJFKir8Y Part 2]
* [https://youtu.be/GpvHYi8uW1Y Create an interior scene using Blender and LuxCore]

LuxCoreRender Tutorials

2020-05-25T10:29:34Z

Byob:

== Video Tutorials ==

=== Blender 2.8x ===

{| width="100%"
|
[[File:BlendLuxCore-2.8-Interior-Tutorial.png|thumb|none|300x300px|link=https://youtu.be/XjwCOIWwQo4| [https://youtu.be/XjwCOIWwQo4 BlendLuxCore v2.8 Interior Tutorial] ]]
|
[[File:Shader_tutorial.jpg|thumb|none|300x300px|link=https://youtu.be/xZOdXI9181k| [https://youtu.be/xZOdXI9181k LuxCore Shader Tutorial 1] ]]
|
[[File:Shader_2.jpg|thumb|none|300x300px|link=https://youtu.be/79V_ySn5ZoY| [https://youtu.be/79V_ySn5ZoY LuxCore Shader Tutorial 2] ]]
|}

{| width="100%"
|
[[File:Orange_juice_tutorial.png|thumb|none|300x300px|link=https://youtu.be/R2-u3YNJbHQ| [https://youtu.be/R2-u3YNJbHQ Orange Juice Tutorial] ]]
|
[[File:Caustics_pool_tutorial.png|thumb|none|300x300px|link=https://youtu.be/mHYpWe4KF8I| [https://youtu.be/mHYpWe4KF8I Caustics Pool Tutorial] ]]
|
[[File:Caustics_Master.jpg|thumb|none|300x300px|link=https://youtu.be/gvo9WLBqNVU| [https://youtu.be/gvo9WLBqNVU Caustics & Fog] ]]
|}

{| width="100%"
|
[[File:Displacement_tut.jpg|thumb|none|300x300px|link=https://youtu.be/OrgCGEJL_sk| [https://youtu.be/OrgCGEJL_sk Displacement Tutorial] ]]
|
[[File:Heads.jpg|thumb|none|300x300px|link=https://youtu.be/1COAMA_r1Ao| [https://youtu.be/1COAMA_r1Ao Skin Shader Tutorial] ]]
|
[[File:HAIIRRR.jpg|thumb|none|300x300px|link=https://youtu.be/RMKwv6N4trQ| [https://youtu.be/RMKwv6N4trQ Hair Shader Tutorial] ]]
|}

{| width="100%"
|
[[File:Light Groups2.jpg|thumb|none|300x300px|link=https://youtu.be/Lsz9yx6GM7I| [https://youtu.be/Lsz9yx6GM7I Light Group Tutorial] ]]
|
[[File:Carpaint tut.jpg|thumb|none|300x300px|link=https://youtu.be/KFbk_JxPUj4| [https://youtu.be/KFbk_JxPUj4 Carpaint Tutorial] ]]
|
[[File:Pbr_leaf_texture_tut.jpg|thumb|none|300x300px|link=https://youtu.be/j8TXpqtdcvY| [https://youtu.be/j8TXpqtdcvY PBR Leaf Texture Tutorial] ]]
|}

==== BlendLuxCore Guide ====

* [https://youtu.be/Ron1se5liV8 Render settings - Tracing method I]
* [https://youtu.be/EgLSibsTpgY Render settings - Light paths II]
* [https://youtu.be/qlYrtUwhNoY Render settings - Light paths III]

=== Blender 2.79 ===

{| width="100%"
|
[[File:beginner_tutorial.jpg|thumb|none|300x300px|link=https://youtu.be/-BmXeUDRqSo| [https://youtu.be/-BmXeUDRqSo Introduction to LuxCoreRender in Blender] ]]
|
[[File:DLSC_tutorial_thumbnail.jpg|thumb|none|300x300px|link=https://youtu.be/dIfwr2YPxPw| [https://youtu.be/dIfwr2YPxPw Tutorial about the Direct Light Sampling Cache (DLSC)] ]]
|
[[File:Sss tutorial thumbnail.jpg|thumb|none|300x300px|link=https://youtu.be/gEGDyHMnlkg| [https://youtu.be/gEGDyHMnlkg Subsurface Scattering and Volume Tutorial] ]]
|}

{| width="100%"
|
[[File:Brushed steel thumbnail.png|thumb|none|300x300px|link=https://youtu.be/FGhPAP0oV9k| [https://youtu.be/FGhPAP0oV9k Brushed Steel Tutorial] ]]
|
[[File:Photongi_tutorial.jpg|thumb|none|300x300px|link=https://youtu.be/trkUldfb380| [https://youtu.be/trkUldfb380 PhotonGI Tutorial] ]]
|
[[File:LED_tutorial.png|thumb|none|300x300px|link=https://youtu.be/saGvvLWS4xs| [https://youtu.be/saGvvLWS4xs LED Tutorial] ]]
|}

== General Tutorials ==

These tutorials are not about LuxCoreRender, but about scene composition, lighting etc.

* blenderer.com: [https://www.blendernation.com/2018/06/18/how-to-make-a-beautiful-scene/ What makes a beautiful scene]
* blenderer.com: [https://www.blendernation.com/2018/06/22/how-to-improve-your-interior-scenes/ Secrets to making the best interior scenes]

== Old Tutorials for LuxBlend ==

The tutorials listed here were made with the old LuxBlend addon.

* Create nice beer using Blender and LuxCore: [https://www.youtube.com/watch?v=EtsA7iDK32A Part 1] and [https://www.youtube.com/watch?v=lJliJFKir8Y Part 2]
* [https://youtu.be/GpvHYi8uW1Y Create an interior scene using Blender and LuxCore]

LuxCoreRender Release Notes v2.4

2020-05-21T20:36:15Z

Byob: /* Blender Addon (BlendLuxCore) */

=LuxCore=

===New Features===

* New OpenCL code to evaluate textures and materials. It doesn't require kernel re-compilation anymore
* LuxCoreUI "Fill kernel cache" menu option now pre-compile all possible GPU kernels
* LuxCore API KernelCacheFill() is now available for Python
* New 2-levels Env. Light Visibility Cache (ELVC)
* Added the support for a new ".sharpness" (default value 0.1, range [0.0, 1.0]) Intel OIDN parameter to blend original and denoised output
* Removed LuxRays support for virtual devices and hybrid rendering (old LuxRender GPU doing ray intersections and CPU everything else)
* Geometry vertex and triangle AOVs (arbitrary data associated to mesh vertices and triangle usable by textures)
* Removed the support for Triplanar texture .uvindex (side effect of the above new feature)
* New hitpointvertexaov nad hitpointtriangleaov textures
* Pointiness shape can now assign curvature values to vertex AOV with .aovindex property (a 4294967296 value will force the use of alpha channel instead, default value for compatibility with the past)
* LuxCore API has now SetMeshVertexAOV() and SetMeshTriangleAOV() methods to set geometry vertex and triangle AOV
* Added the support for new Random texture
* Added the support for the new IslandAOV shape
* Added the support for RandomTriangleAOV shape
* Accelerated duplicate vertex detection in pointiness shape (from 6.7 seconds to 0.016 seconds on a 100k vertex mesh)
* LuxRays API reworked to support generic hardware devices (now OpenCL, potentially CUDA, Vulkan, Metal, etc.)
* Added the support for light groups to PhotonGI
* New LuxCore API RenderConfig::HasCachedKernels() method to check if a (long) kernel compilation time is required
* Glossycoating material on GPUs now supports bump mapping exactly like CPU version (issue #307)
* Mix material on GPUs now supports bump mapping exactly like CPU version (issue #307)
* Added processor group support to enable LuxCoreRender to use more than 64 logical processors on Windows
* Added the support for CUDA rendering
* Added the support for out of core CUDA rendering (i.e. to render scenes larger than GPU ram available)
* GPU rendering now uses 64bit image map pixel indices (i.e. removed the limit of 8 * 4GB of scene image maps)
* New cache and out-of-core friendly mode for Random/Sobol samplers
* Added the support for denoising baked light maps with Intel ODIN
* pyluxcoretools merge now supports saving film AOVs via new --aov-output option
* New improved Metropolis sampler warmup period
* Added thin film interference option for many materials
* Added the support for a new color re-mapping image pipeline plug-in using .cube files (issue #81)
* LuxCore API now support unicode UTF-8 strings and files
* luxcore::KernelCacheFill() now supports opencl.devices.select, scene.epsilon.min and scene.epsilon.max properties (issue #374)

===Fixed Bugs===

* Fixed a rendering difference when using/not using geometry negative scale transformations (issue #309)
* Fixed an out of bound access in BAKECPU
* Fixed a problem when using path.forceblackbackground.enable and env. lights
* Fixed a problem with scenes with very hard light paths and Metropolis sampler (issue #312)
* Sampler shared data are now reseted at the end of a scene edit (issue #312)
* Fixed a problem in automatic cache radius estimation of PhotonGI when using Orthographic camera (issue #324)
* Fixed an OpenCL compilation error when using large number of objects on some old GPUs
* Fixed a problem with BlendLuxCore when parsing more than 9 image pipelines (#336)
* Fixed a bug causing fireflies when using light tracing for caustics in some case (#329)

===Changes that break backwards-compatibility===

Due to Glossycoating updated support for bump mapping on GPUs, some old scene using this kind of material/bump map combination may require some fix.

===About Performance on GPUs===

In the past versions, we have been moving from very specialized, scene dependent OpenCL kernels to general-purpose kernels. This development simultaneously has drawbacks and benefits in simple scenes, which are explained below. Complex scenes that use most features and shaders of LuxCore are less affected by the drawbacks, sometimes not at all, while still reaping the full benefits.

* v2.2 is fastest (at samples/sec) because it uses conditional compilation: lots of renderengine features and materials/textures are turned off when not used. Requires kernel re-compilations each time you change rendersettings or material/texture settings. Viewport rendering with OpenCL engines is out of the question, unless all you do is move the camera or other objects around.

* v2.3 is slower because it no longer uses conditional compilation for renderengine features: all of them are active, always. This means that re-compilations are no longer necessary when changing render settings (e.g. clamping value). Materials/textures still use conditional compilation in v2.3, requiring re-compilations on most shader changes, which makes OpenCL engines still unusable for viewport rendering.

* v2.4 is slowest because it has no conditional compilation at all anymore. The kernel is compiled once for each engine type with all features enabled, and materials/textures are now evaluated at runtime using a stack-based method.

Note, the speed difference is more visible the simpler the scene is. This is because with conditional compilation, most features will be disabled in such a scene. The more features your scene uses (meaning, the more complex it is), the less this matters. With a very complex scene using all features, v2.2 will have very similar speed to v2.4.

Also, don't forget that you now save the time for kernel compilation, always (which could range from seconds to minutes). This can actually benefit simpler scenes, if the total rendertime is short (like for animations). If you render 500 frames at 60 sec/frame, saving 20 seconds of kernel compilation can matter a lot.

===Known Problems===

* LuxCore API requires latin locale
* accelerator.bvh.builder.type = EMBREE_MORTON doesn't work with the latest Embree
* Python crashes when calling sys.exit()
* TILEPATHOCL (and RTPATHOCL) count the layers of transparent surfaces as an iteration of the rendering finite state machine so they require to increase the max. path depth to avoid black regions.
* Light emitted by motion blurred triangle lights is approximated using the triangle area of time 0.0 (computing triangle area at runtime would be expansive) so it may be not totally accurate if the motion blur transformation include a scale.
* Variance clamping is not applied to AOVs

=Blender Addon (BlendLuxCore)=

===New Features===

* Optimize viewport update checks in scenes with many particles/duplis
* Replaced the Eevee lookdev (which required Cycles materials) with an albedo render mode that is intended as a fast texture preview for both Lux and Cycles node trees
* Node editor quality of life (support for muting nodes and some [https://github.com/LuxCoreRender/BlendLuxCore/issues/407 node wrangler functions])
* When using PhotonGI debug modes, disable light tracing and use an exposure compensated tonemapper
* Support for custom split normals, weighted normals etc.
* Reworked statistics, added some sub-stats about export time (mesh conversion time, hair conversion time) as well as information about which caches are enabled/disabled
* Use Cycles nodes on linked materials without Lux nodes (so materials on Cycles assets automatically try to use Cycles nodes, unless you create a Lux material on the assets)
* Limit max. subdiv in material previews to 1
* Add support for principled emission, alpha and transmission sockets to Cycles node reader
* Add support for indirect only collection visibility mode
* Support for manta flow smoke export in blender 2.82
* New triplanar normalmap node
* Add triplanar projection mode to imagemap node, general rework/polishing of the imagemap node
* Add support for transparency in the denoised result (both viewport and final render)
* Emulate Cycles material UI in Lux material node editor (material and slot dropdown instead of node tree dropdown)
* [https://forums.luxcorerender.org/viewtopic.php?f=5&t=2165 Thin film coating support] for glass and disney materials
* Cycles node reader:
** Add support for nested Cycles node groups
** Add support for geometry node outputs: position and normal
** Add support for object info node outputs: object index, material index, random
** Add support for refraction shader
** Add support for blackbody texture
* LuxCore Online Library is now integrated in Blender (3D view > N-Panel > LuxCoreOnlineLibrary tab)
* New addon preferences:
** GPU backend (OpenCL/CUDA)
** Option to enable/disable image node thumbnails on new nodes by default
** LuxCore Online Library preferences
* Support for new sampling patterns and out-of-core rendering
* Amount of light tracing samples is now shown in statistics (image editor > N-Panel > LuxCore tab)
* Support for COLOR_LUT imagepipeline plugin, allowing to load .cube LUT files
* New material presets:
** Hybrid glass (regular refractive glass with white shadow color, as an alternative to architectural glass)
** Colored smoke
* New interactive render settings guide

===Fixed Bugs===

* Fix world volume ui panel drawing
* Fix material presets panel not showing without a material
* Fix remesh panel in mesh data properties not showing up
* Fix bugs in 3D mapping node UI (the controls were disappearing when the selected object was of type "CURVE", "SURFACE" or "FONT")
* Fix export of metaballs with shared data
* Fix shapes being added to cached meshes over and over in viewport render
* Fix check for UV maps on curve, surface and font objects being broken
* Fix shapes not working on hair
* Fix possible key collision in image exporter after undo (fixes #431)
* Fix color tint not working for sky and HDRIs
* Put Blender post processing panel in the right place (output props instead of render props)
* Fix wrong view layer visibility check
* Fix possible config export error if film opencl device was not set

===Known Problems===

* [https://github.com/LuxCoreRender/BlendLuxCore/issues/167 Inserted keyframes in material node graph don't show up in graph editor or anywhere else]
* LuxCore node parameters can not be animated in Blender 2.82. This bug is fixed in Blender 2.83 and later
* Rendering with caches (e.g. PhotonGI, DLSC, Env. light cache) can lead to problems '''if border rendering is enabled'''. A workaround is to disable automatic radius estimation and setting the radius manually instead when using border rendering

LuxCoreRender Release Notes v2.4

2020-05-21T20:34:31Z

Byob:

=LuxCore=

===New Features===

* New OpenCL code to evaluate textures and materials. It doesn't require kernel re-compilation anymore
* LuxCoreUI "Fill kernel cache" menu option now pre-compile all possible GPU kernels
* LuxCore API KernelCacheFill() is now available for Python
* New 2-levels Env. Light Visibility Cache (ELVC)
* Added the support for a new ".sharpness" (default value 0.1, range [0.0, 1.0]) Intel OIDN parameter to blend original and denoised output
* Removed LuxRays support for virtual devices and hybrid rendering (old LuxRender GPU doing ray intersections and CPU everything else)
* Geometry vertex and triangle AOVs (arbitrary data associated to mesh vertices and triangle usable by textures)
* Removed the support for Triplanar texture .uvindex (side effect of the above new feature)
* New hitpointvertexaov nad hitpointtriangleaov textures
* Pointiness shape can now assign curvature values to vertex AOV with .aovindex property (a 4294967296 value will force the use of alpha channel instead, default value for compatibility with the past)
* LuxCore API has now SetMeshVertexAOV() and SetMeshTriangleAOV() methods to set geometry vertex and triangle AOV
* Added the support for new Random texture
* Added the support for the new IslandAOV shape
* Added the support for RandomTriangleAOV shape
* Accelerated duplicate vertex detection in pointiness shape (from 6.7 seconds to 0.016 seconds on a 100k vertex mesh)
* LuxRays API reworked to support generic hardware devices (now OpenCL, potentially CUDA, Vulkan, Metal, etc.)
* Added the support for light groups to PhotonGI
* New LuxCore API RenderConfig::HasCachedKernels() method to check if a (long) kernel compilation time is required
* Glossycoating material on GPUs now supports bump mapping exactly like CPU version (issue #307)
* Mix material on GPUs now supports bump mapping exactly like CPU version (issue #307)
* Added processor group support to enable LuxCoreRender to use more than 64 logical processors on Windows
* Added the support for CUDA rendering
* Added the support for out of core CUDA rendering (i.e. to render scenes larger than GPU ram available)
* GPU rendering now uses 64bit image map pixel indices (i.e. removed the limit of 8 * 4GB of scene image maps)
* New cache and out-of-core friendly mode for Random/Sobol samplers
* Added the support for denoising baked light maps with Intel ODIN
* pyluxcoretools merge now supports saving film AOVs via new --aov-output option
* New improved Metropolis sampler warmup period
* Added thin film interference option for many materials
* Added the support for a new color re-mapping image pipeline plug-in using .cube files (issue #81)
* LuxCore API now support unicode UTF-8 strings and files
* luxcore::KernelCacheFill() now supports opencl.devices.select, scene.epsilon.min and scene.epsilon.max properties (issue #374)

===Fixed Bugs===

* Fixed a rendering difference when using/not using geometry negative scale transformations (issue #309)
* Fixed an out of bound access in BAKECPU
* Fixed a problem when using path.forceblackbackground.enable and env. lights
* Fixed a problem with scenes with very hard light paths and Metropolis sampler (issue #312)
* Sampler shared data are now reseted at the end of a scene edit (issue #312)
* Fixed a problem in automatic cache radius estimation of PhotonGI when using Orthographic camera (issue #324)
* Fixed an OpenCL compilation error when using large number of objects on some old GPUs
* Fixed a problem with BlendLuxCore when parsing more than 9 image pipelines (#336)
* Fixed a bug causing fireflies when using light tracing for caustics in some case (#329)

===Changes that break backwards-compatibility===

Due to Glossycoating updated support for bump mapping on GPUs, some old scene using this kind of material/bump map combination may require some fix.

===About Performance on GPUs===

In the past versions, we have been moving from very specialized, scene dependent OpenCL kernels to general-purpose kernels. This development simultaneously has drawbacks and benefits in simple scenes, which are explained below. Complex scenes that use most features and shaders of LuxCore are less affected by the drawbacks, sometimes not at all, while still reaping the full benefits.

* v2.2 is fastest (at samples/sec) because it uses conditional compilation: lots of renderengine features and materials/textures are turned off when not used. Requires kernel re-compilations each time you change rendersettings or material/texture settings. Viewport rendering with OpenCL engines is out of the question, unless all you do is move the camera or other objects around.

* v2.3 is slower because it no longer uses conditional compilation for renderengine features: all of them are active, always. This means that re-compilations are no longer necessary when changing render settings (e.g. clamping value). Materials/textures still use conditional compilation in v2.3, requiring re-compilations on most shader changes, which makes OpenCL engines still unusable for viewport rendering.

* v2.4 is slowest because it has no conditional compilation at all anymore. The kernel is compiled once for each engine type with all features enabled, and materials/textures are now evaluated at runtime using a stack-based method.

Note, the speed difference is more visible the simpler the scene is. This is because with conditional compilation, most features will be disabled in such a scene. The more features your scene uses (meaning, the more complex it is), the less this matters. With a very complex scene using all features, v2.2 will have very similar speed to v2.4.

Also, don't forget that you now save the time for kernel compilation, always (which could range from seconds to minutes). This can actually benefit simpler scenes, if the total rendertime is short (like for animations). If you render 500 frames at 60 sec/frame, saving 20 seconds of kernel compilation can matter a lot.

===Known Problems===

* LuxCore API requires latin locale
* accelerator.bvh.builder.type = EMBREE_MORTON doesn't work with the latest Embree
* Python crashes when calling sys.exit()
* TILEPATHOCL (and RTPATHOCL) count the layers of transparent surfaces as an iteration of the rendering finite state machine so they require to increase the max. path depth to avoid black regions.
* Light emitted by motion blurred triangle lights is approximated using the triangle area of time 0.0 (computing triangle area at runtime would be expansive) so it may be not totally accurate if the motion blur transformation include a scale.
* Variance clamping is not applied to AOVs

=Blender Addon (BlendLuxCore)=

===New Features===

* optimize viewport update checks in scenes with many particles/duplis
* Replaced the Eevee lookdev (which required Cycles materials) with an albedo render mode that is intended as a fast texture preview for both Lux and Cycles node trees
* Node editor quality of life (support for muting nodes and some [https://github.com/LuxCoreRender/BlendLuxCore/issues/407 node wrangler functions])
* when using PhotonGI debug modes, disable light tracing and use an exposure compensated tonemapper
* support for custom split normals, weighted normals etc.
* reworked statistics, added some sub-stats about export time (mesh conversion time, hair conversion time) as well as information about which caches are enabled/disabled
* Use Cycles nodes on linked materials without Lux nodes (so materials on Cycles assets automatically try to use Cycles nodes, unless you create a Lux material on the assets)
* limit max. subdiv in material previews to 1
* add support for principled emission, alpha and transmission sockets to Cycles node reader
* add support for indirect only collection visibility mode
* Support for manta flow smoke export in blender 2.82
* new triplanar normalmap node
* add triplanar projection mode to imagemap node, general rework/polishing of the imagemap node
* Add support for transparency in the denoised result (both viewport and final render)
* Emulate Cycles material UI in Lux material node editor (material and slot dropdown instead of node tree dropdown)
* [https://forums.luxcorerender.org/viewtopic.php?f=5&t=2165 Thin film coating support] for glass and disney materials
* Cycles node reader:
** add support for nested Cycles node groups
** add support for geometry node outputs: position and normal
** add support for object info node outputs: object index, material index, random
** add support for refraction shader
** add support for blackbody texture
* LuxCore Online Library is now integrated in Blender (3D view > N-Panel > LuxCoreOnlineLibrary tab)
* new addon preferences:
** GPU backend (OpenCL/CUDA)
** option to enable/disable image node thumbnails on new nodes by default
** LuxCore Online Library preferences
* support for new sampling patterns and out-of-core rendering
* amount of light tracing samples is now shown in statistics (image editor > N-Panel > LuxCore tab)
* support for COLOR_LUT imagepipeline plugin, allowing to load .cube LUT files
* New material presets:
** Hybrid glass (regular refractive glass with white shadow color, as an alternative to architectural glass)
** Colored smoke
* New interactive render settings guide

===Fixed Bugs===

* fix world volume ui panel drawing
* fix material presets panel not showing without a material
* fix remesh panel in mesh data properties not showing up
* fix bugs in 3D mapping node UI (the controls were disappearing when the selected object was of type "CURVE", "SURFACE" or "FONT")
* fix export of metaballs with shared data
* fix shapes being added to cached meshes over and over in viewport render
* fix check for UV maps on curve, surface and font objects being broken
* fix shapes not working on hair
* fix possible key collision in image exporter after undo (fixes #431)
* fix color tint not working for sky and HDRIs
* put Blender post processing panel in the right place (output props instead of render props)
* fix wrong view layer visibility check
* fix possible config export error if film opencl device was not set

===Known Problems===

* [https://github.com/LuxCoreRender/BlendLuxCore/issues/167 Inserted keyframes in material node graph don't show up in graph editor or anywhere else]
* LuxCore node parameters can not be animated in Blender 2.82. This bug is fixed in Blender 2.83 and later
* Rendering with caches (e.g. PhotonGI, DLSC, Env. light cache) can lead to problems '''if border rendering is enabled'''. A workaround is to disable automatic radius estimation and setting the radius manually instead when using border rendering

LuxCoreRender Release Notes v2.4

2020-05-21T20:32:24Z

Byob: /* LuxCore */

=LuxCore=

===New Features===

* New OpenCL code to evaluate textures and materials. It doesn't require kernel re-compilation anymore
* LuxCoreUI "Fill kernel cache" menu option now pre-compile all possible GPU kernels
* LuxCore API KernelCacheFill() is now available for Python
* New 2-levels Env. Light Visibility Cache (ELVC)
* Added the support for a new ".sharpness" (default value 0.1, range [0.0, 1.0]) Intel OIDN parameter to blend original and denoised output
* Removed LuxRays support for virtual devices and hybrid rendering (old LuxRender GPU doing ray intersections and CPU everything else)
* Geometry vertex and triangle AOVs (arbitrary data associated to mesh vertices and triangle usable by textures)
* Removed the support for Triplanar texture .uvindex (side effect of the above new feature)
* New hitpointvertexaov nad hitpointtriangleaov textures
* Pointiness shape can now assign curvature values to vertex AOV with .aovindex property (a 4294967296 value will force the use of alpha channel instead, default value for compatibility with the past)
* LuxCore API has now SetMeshVertexAOV() and SetMeshTriangleAOV() methods to set geometry vertex and triangle AOV
* Added the support for new Random texture
* Added the support for the new IslandAOV shape
* Added the support for RandomTriangleAOV shape
* Accelerated duplicate vertex detection in pointiness shape (from 6.7 seconds to 0.016 seconds on a 100k vertex mesh)
* LuxRays API reworked to support generic hardware devices (now OpenCL, potentially CUDA, Vulkan, Metal, etc.)
* Added the support for light groups to PhotonGI
* New LuxCore API RenderConfig::HasCachedKernels() method to check if a (long) kernel compilation time is required
* Glossycoating material on GPUs now supports bump mapping exactly like CPU version (issue #307)
* Mix material on GPUs now supports bump mapping exactly like CPU version (issue #307)
* Added processor group support to enable LuxCoreRender to use more than 64 logical processors on Windows
* Added the support for CUDA rendering
* Added the support for out of core CUDA rendering (i.e. to render scenes larger than GPU ram available)
* GPU rendering now uses 64bit image map pixel indices (i.e. removed the limit of 8 * 4GB of scene image maps)
* New cache and out-of-core friendly mode for Random/Sobol samplers
* Added the support for denoising baked light maps with Intel ODIN
* pyluxcoretools merge now supports saving film AOVs via new --aov-output option
* New improved Metropolis sampler warmup period
* Added thin film interference option for many materials
* Added the support for a new color re-mapping image pipeline plug-in using .cube files (issue #81)
* LuxCore API now support unicode UTF-8 strings and files
* luxcore::KernelCacheFill() now supports opencl.devices.select, scene.epsilon.min and scene.epsilon.max properties (issue #374)

===Fixed Bugs===

* Fixed a rendering difference when using/not using geometry negative scale transformations (issue #309)
* Fixed an out of bound access in BAKECPU
* Fixed a problem when using path.forceblackbackground.enable and env. lights
* Fixed a problem with scenes with very hard light paths and Metropolis sampler (issue #312)
* Sampler shared data are now reseted at the end of a scene edit (issue #312)
* Fixed a problem in automatic cache radius estimation of PhotonGI when using Orthographic camera (issue #324)
* Fixed an OpenCL compilation error when using large number of objects on some old GPUs
* Fixed a problem with BlendLuxCore when parsing more than 9 image pipelines (#336)
* Fixed a bug causing fireflies when using light tracing for caustics in some case (#329)

===Changes that break backwards-compatibility===

Due to Glossycoating updated support for bump mapping on GPUs, some old scene using this kind of material/bump map combination may require some fix.

===About Performance on GPUs===

In the past versions, we have been moving from very specialized, scene dependent OpenCL kernels to general-purpose kernels. This development simultaneously has drawbacks and benefits in simple scenes, which are explained below. Complex scenes that use most features and shaders of LuxCore are less affected by the drawbacks, sometimes not at all, while still reaping the full benefits.

* v2.2 is fastest (at samples/sec) because it uses conditional compilation: lots of renderengine features and materials/textures are turned off when not used. Requires kernel re-compilations each time you change rendersettings or material/texture settings. Viewport rendering with OpenCL engines is out of the question, unless all you do is move the camera or other objects around.

* v2.3 is slower because it no longer uses conditional compilation for renderengine features: all of them are active, always. This means that re-compilations are no longer necessary when changing render settings (e.g. clamping value). Materials/textures still use conditional compilation in v2.3, requiring re-compilations on most shader changes, which makes OpenCL engines still unusable for viewport rendering.

* v2.4 is slowest because it has no conditional compilation at all anymore. The kernel is compiled once for each engine type with all features enabled, and materials/textures are now evaluated at runtime using a stack-based method.

Note, the speed difference is more visible the simpler the scene is. This is because with conditional compilation, most features will be disabled in such a scene. The more features your scene uses (meaning, the more complex it is), the less this matters. With a very complex scene using all features, v2.2 will have very similar speed to v2.4.

Also, don't forget that you now save the time for kernel compilation, always (which could range from seconds to minutes). This can actually benefit simpler scenes, if the total rendertime is short (like for animations). If you render 500 frames at 60 sec/frame, saving 20 seconds of kernel compilation can matter a lot.

=Blender Addon (BlendLuxCore)=

===New features===

* optimize viewport update checks in scenes with many particles/duplis
* Replaced the Eevee lookdev (which required Cycles materials) with an albedo render mode that is intended as a fast texture preview for both Lux and Cycles node trees
* Node editor quality of life (support for muting nodes and some [https://github.com/LuxCoreRender/BlendLuxCore/issues/407 node wrangler functions])
* when using PhotonGI debug modes, disable light tracing and use an exposure compensated tonemapper
* support for custom split normals, weighted normals etc.
* reworked statistics, added some sub-stats about export time (mesh conversion time, hair conversion time) as well as information about which caches are enabled/disabled
* Use Cycles nodes on linked materials without Lux nodes (so materials on Cycles assets automatically try to use Cycles nodes, unless you create a Lux material on the assets)
* limit max. subdiv in material previews to 1
* add support for principled emission, alpha and transmission sockets to Cycles node reader
* add support for indirect only collection visibility mode
* Support for manta flow smoke export in blender 2.82
* new triplanar normalmap node
* add triplanar projection mode to imagemap node, general rework/polishing of the imagemap node
* Add support for transparency in the denoised result (both viewport and final render)
* Emulate Cycles material UI in Lux material node editor (material and slot dropdown instead of node tree dropdown)
* [https://forums.luxcorerender.org/viewtopic.php?f=5&t=2165 Thin film coating support] for glass and disney materials
* Cycles node reader:
** add support for nested Cycles node groups
** add support for geometry node outputs: position and normal
** add support for object info node outputs: object index, material index, random
** add support for refraction shader
** add support for blackbody texture
* LuxCore Online Library is now integrated in Blender (3D view > N-Panel > LuxCoreOnlineLibrary tab)
* new addon preferences:
** GPU backend (OpenCL/CUDA)
** option to enable/disable image node thumbnails on new nodes by default
** LuxCore Online Library preferences
* support for new sampling patterns and out-of-core rendering
* amount of light tracing samples is now shown in statistics (image editor > N-Panel > LuxCore tab)
* support for COLOR_LUT imagepipeline plugin, allowing to load .cube LUT files
* New material presets:
** Hybrid glass (regular refractive glass with white shadow color, as an alternative to architectural glass)
** Colored smoke
* New interactive render settings guide

===Fixed Bugs===

* fix world volume ui panel drawing
* fix material presets panel not showing without a material
* fix remesh panel in mesh data properties not showing up
* fix bugs in 3D mapping node UI (the controls were disappearing when the selected object was of type "CURVE", "SURFACE" or "FONT")
* fix export of metaballs with shared data
* fix shapes being added to cached meshes over and over in viewport render
* fix check for UV maps on curve, surface and font objects being broken
* fix shapes not working on hair
* fix possible key collision in image exporter after undo (fixes #431)
* fix color tint not working for sky and HDRIs
* put Blender post processing panel in the right place (output props instead of render props)
* fix wrong view layer visibility check
* fix possible config export error if film opencl device was not set

===Known problems===

* [https://github.com/LuxCoreRender/BlendLuxCore/issues/167 Inserted keyframes in material node graph don't show up in graph editor or anywhere else]
* LuxCore node parameters can not be animated in Blender 2.82. This bug is fixed in Blender 2.83 and later
* Rendering with caches (e.g. PhotonGI, DLSC, Env. light cache) can lead to problems '''if border rendering is enabled'''. A workaround is to disable automatic radius estimation and setting the radius manually instead when using border rendering

LuxCoreRender Release Notes v2.4

2020-05-20T21:58:20Z

Byob: /* Blender Addon (BlendLuxCore) */

=LuxCore=

===New Features===

* New OpenCL code to evaluate textures and materials. It doesn't require kernel re-compilation anymore.
* LuxCoreUI "Fill kernel cache" menu option now pre-compile all possible GPU kernels.
* LuxCore API KernelCacheFill() is now available for Python
* New 2-levels Env. Light Visibility Cache (ELVC)
* Added the support for a new ".sharpness" (default value 0.1, range [0.0, 1.0]) Intel OIDN parameter to blend original and denoised output
* Removed LuxRays support for virtual devices and hybrid rendering (old LuxRender GPU doing ray intersections and CPU everything else)

===Fixed Bugs===

===About Performance on GPUs===

In the past versions, we have been moving from very specialized, scene dependent OpenCL kernels to general-purpose kernels. This development simultaneously has drawbacks and benefits in simple scenes, which are explained below. Complex scenes that use most features and shaders of LuxCore are less affected by the drawbacks, sometimes not at all, while still reaping the full benefits.

* v2.2 is fastest (at samples/sec) because it uses conditional compilation: lots of renderengine features and materials/textures are turned off when not used. Requires kernel re-compilations each time you change rendersettings or material/texture settings. Viewport rendering with OpenCL engines is out of the question, unless all you do is move the camera or other objects around.

* v2.3 is slower because it no longer uses conditional compilation for renderengine features: all of them are active, always. This means that re-compilations are no longer necessary when changing render settings (e.g. clamping value). Materials/textures still use conditional compilation in v2.3, requiring re-compilations on most shader changes, which makes OpenCL engines still unusable for viewport rendering.

* v2.4 is slowest because it has no conditional compilation at all anymore. The kernel is compiled once for each engine type with all features enabled, and materials/textures are now evaluated at runtime using a stack-based method.

Note, the speed difference is more visible the simpler the scene is. This is because with conditional compilation, most features will be disabled in such a scene. The more features your scene uses (meaning, the more complex it is), the less this matters. With a very complex scene using all features, v2.2 will have very similar speed to v2.4.

Also, don't forget that you now save the time for kernel compilation, always (which could range from seconds to minutes). This can actually benefit simpler scenes, if the total rendertime is short (like for animations). If you render 500 frames at 60 sec/frame, saving 20 seconds of kernel compilation can matter a lot.

=Blender Addon (BlendLuxCore)=

===New features===

* optimize viewport update checks in scenes with many particles/duplis
* Replaced the Eevee lookdev (which required Cycles materials) with an albedo render mode that is intended as a fast texture preview for both Lux and Cycles node trees
* Node editor quality of life (support for muting nodes and some [https://github.com/LuxCoreRender/BlendLuxCore/issues/407 node wrangler functions])
* when using PhotonGI debug modes, disable light tracing and use an exposure compensated tonemapper
* support for custom split normals, weighted normals etc.
* reworked statistics, added some sub-stats about export time (mesh conversion time, hair conversion time) as well as information about which caches are enabled/disabled
* Use Cycles nodes on linked materials without Lux nodes (so materials on Cycles assets automatically try to use Cycles nodes, unless you create a Lux material on the assets)
* limit max. subdiv in material previews to 1
* add support for principled emission, alpha and transmission sockets to Cycles node reader
* add support for indirect only collection visibility mode
* Support for manta flow smoke export in blender 2.82
* new triplanar normalmap node
* add triplanar projection mode to imagemap node, general rework/polishing of the imagemap node
* Add support for transparency in the denoised result (both viewport and final render)
* Emulate Cycles material UI in Lux material node editor (material and slot dropdown instead of node tree dropdown)
* [https://forums.luxcorerender.org/viewtopic.php?f=5&t=2165 Thin film coating support] for glass and disney materials
* Cycles node reader:
** add support for nested Cycles node groups
** add support for geometry node outputs: position and normal
** add support for object info node outputs: object index, material index, random
** add support for refraction shader
** add support for blackbody texture
* LuxCore Online Library is now integrated in Blender (3D view > N-Panel > LuxCoreOnlineLibrary tab)
* new addon preferences:
** GPU backend (OpenCL/CUDA)
** option to enable/disable image node thumbnails on new nodes by default
** LuxCore Online Library preferences
* support for new sampling patterns and out-of-core rendering
* amount of light tracing samples is now shown in statistics (image editor > N-Panel > LuxCore tab)
* support for COLOR_LUT imagepipeline plugin, allowing to load .cube LUT files
* New material presets:
** Hybrid glass (regular refractive glass with white shadow color, as an alternative to architectural glass)
** Colored smoke
* New interactive render settings guide

===Fixed Bugs===

* fix world volume ui panel drawing
* fix material presets panel not showing without a material
* fix remesh panel in mesh data properties not showing up
* fix bugs in 3D mapping node UI (the controls were disappearing when the selected object was of type "CURVE", "SURFACE" or "FONT")
* fix export of metaballs with shared data
* fix shapes being added to cached meshes over and over in viewport render
* fix check for UV maps on curve, surface and font objects being broken
* fix shapes not working on hair
* fix possible key collision in image exporter after undo (fixes #431)
* fix color tint not working for sky and HDRIs
* put Blender post processing panel in the right place (output props instead of render props)
* fix wrong view layer visibility check
* fix possible config export error if film opencl device was not set

===Known problems===

* [https://github.com/LuxCoreRender/BlendLuxCore/issues/167 Inserted keyframes in material node graph don't show up in graph editor or anywhere else]
* LuxCore node parameters can not be animated in Blender 2.82. This bug is fixed in Blender 2.83 and later
* Rendering with caches (e.g. PhotonGI, DLSC, Env. light cache) can lead to problems '''if border rendering is enabled'''. A workaround is to disable automatic radius estimation and setting the radius manually instead when using border rendering

LuxCoreRender Release Notes v2.4

2020-05-20T14:34:33Z

Byob: /* LuxCore */

=LuxCore=

===New Features===

* New OpenCL code to evaluate textures and materials. It doesn't require kernel re-compilation anymore.
* LuxCoreUI "Fill kernel cache" menu option now pre-compile all possible GPU kernels.
* LuxCore API KernelCacheFill() is now available for Python
* New 2-levels Env. Light Visibility Cache (ELVC)
* Added the support for a new ".sharpness" (default value 0.1, range [0.0, 1.0]) Intel OIDN parameter to blend original and denoised output
* Removed LuxRays support for virtual devices and hybrid rendering (old LuxRender GPU doing ray intersections and CPU everything else)

===Fixed Bugs===

===About Performance on GPUs===

In the past versions, we have been moving from very specialized, scene dependent OpenCL kernels to general-purpose kernels. This development simultaneously has drawbacks and benefits in simple scenes, which are explained below. Complex scenes that use most features and shaders of LuxCore are less affected by the drawbacks, sometimes not at all, while still reaping the full benefits.

* v2.2 is fastest (at samples/sec) because it uses conditional compilation: lots of renderengine features and materials/textures are turned off when not used. Requires kernel re-compilations each time you change rendersettings or material/texture settings. Viewport rendering with OpenCL engines is out of the question, unless all you do is move the camera or other objects around.

* v2.3 is slower because it no longer uses conditional compilation for renderengine features: all of them are active, always. This means that re-compilations are no longer necessary when changing render settings (e.g. clamping value). Materials/textures still use conditional compilation in v2.3, requiring re-compilations on most shader changes, which makes OpenCL engines still unusable for viewport rendering.

* v2.4 is slowest because it has no conditional compilation at all anymore. The kernel is compiled once for each engine type with all features enabled, and materials/textures are now evaluated at runtime using a stack-based method.

Note, the speed difference is more visible the simpler the scene is. This is because with conditional compilation, most features will be disabled in such a scene. The more features your scene uses (meaning, the more complex it is), the less this matters. With a very complex scene using all features, v2.2 will have very similar speed to v2.4.

Also, don't forget that you now save the time for kernel compilation, always (which could range from seconds to minutes). This can actually benefit simpler scenes, if the total rendertime is short (like for animations). If you render 500 frames at 60 sec/frame, saving 20 seconds of kernel compilation can matter a lot.

=Blender Addon (BlendLuxCore)=

===New features===

* optimize viewport update checks in scenes with many particles/duplis
* Replaced the Eevee lookdev (which required Cycles materials) with an albedo render mode that is intended as a fast texture preview for both Lux and Cycles node trees
* Node editor quality of life (support for muting nodes and some [https://github.com/LuxCoreRender/BlendLuxCore/issues/407 node wrangler functions])
* when using PhotonGI debug modes, disable light tracing and use an exposure compensated tonemapper
* support for custom split normals, weighted normals etc.
* reworked statistics, added some sub-stats about export time (mesh conversion time, hair conversion time) as well as information about which caches are enabled/disabled
* Use Cycles nodes on linked materials without Lux nodes (so materials on Cycles assets automatically try to use Cycles nodes, unless you create a Lux material on the assets)
* limit max. subdiv in material previews to 1
* add support for principled emission, alpha and transmission sockets to Cycles node reader
* add support for indirect only collection visibility mode
* Support for manta flow smoke export in blender 2.82
* new triplanar normalmap node
* add triplanar projection mode to imagemap node, general rework/polishing of the imagemap node
* Add support for transparency in the denoised result (both viewport and final render)
* Emulate Cycles material UI in Lux material node editor (material and slot dropdown instead of node tree dropdown)
* [https://forums.luxcorerender.org/viewtopic.php?f=5&t=2165 Thin film coating support] for glass and disney materials
* Cycles node reader:
** add support for nested Cycles node groups
** add support for geometry node outputs: position and normal
** add support for object info node outputs: object index, material index, random
** add support for refraction shader
** add support for blackbody texture
* new hybrid glass material preset
* LuxCore Online Library is now integrated in Blender (3D view > N-Panel > LuxCoreOnlineLibrary tab)
* new addon preferences:
** GPU backend (OpenCL/CUDA)
** option to enable/disable image node thumbnails on new nodes by default
** LuxCore Online Library preferences
* support for new sampling patterns and out-of-core rendering
* amount of light tracing samples is now shown in statistics (image editor > N-Panel > LuxCore tab)
* support for COLOR_LUT imagepipeline plugin, allowing to load .cube LUT files

===Fixed Bugs===

* fix world volume ui panel drawing
* fix material presets panel not showing without a material
* fix remesh panel in mesh data properties not showing up
* fix bugs in 3D mapping node UI (the controls were disappearing when the selected object was of type "CURVE", "SURFACE" or "FONT")
* fix export of metaballs with shared data
* fix shapes being added to cached meshes over and over in viewport render
* fix check for UV maps on curve, surface and font objects being broken
* fix shapes not working on hair
* fix possible key collision in image exporter after undo (fixes #431)
* fix color tint not working for sky and HDRIs
* put Blender post processing panel in the right place (output props instead of render props)
* fix wrong view layer visibility check
* fix possible config export error if film opencl device was not set

===Known problems===

* [https://github.com/LuxCoreRender/BlendLuxCore/issues/167 Inserted keyframes in material node graph don't show up in graph editor or anywhere else]
* LuxCore node parameters can not be animated in Blender 2.82. This bug is fixed in Blender 2.83 and later
* Rendering with caches (e.g. PhotonGI, DLSC, Env. light cache) can lead to problems '''if border rendering is enabled'''. A workaround is to disable automatic radius estimation and setting the radius manually instead when using border rendering

LuxCoreRender Release Notes v2.4

2020-05-19T15:10:42Z

Byob: /* Blender Addon (BlendLuxCore) */

Render Configuration

2020-05-14T13:01:59Z

Byob: /* Samplers */

= Engines =

The choice of engine decides how lights are traced in the scene. 
LuxCoreRender offers the following engines (integrators):

* '''Path''' (CPU/OpenCL): Unidirectional pathtracer that casts rays from the camera. Samples the whole film progressively. Supports all AOVs.
* '''Tiled Path''' (CPU/OpenCL): Unidirectional pathtracer that is almost the same as '''Path''', but uses a special sampler which iterates over the image in tiles (this leads to a slightly lower RAM usage). The OpenCL version adapts the number of tiles that are rendered at once to the performance of the compute devices (GPUs/CPUs), so the tile size does not matter a lot (if rendering performance is bad due to small tiles, the number of rendered tiles is increased automatically). When the last tile of a pass is reached, it is split among the compute devices. Supports all AOVs.
* '''Bidir''' (CPU only): Bidirectional pathtracer that casts rays from both camera and light sources. Samples the whole film progressively. Supports only a subset of AOVs: RGB, RGBA, ALPHA, DEPTH and SAMPLECOUNT. It is recommended to combine this engine with the '''Metropolis''' sampler.

= Samplers =

The sampler decides how points on the film are chosen (in which area to fire more/less light rays). 
LuxCoreRender offers the following samplers:

* '''Sobol:''' Random sampler with an improved noise pattern. Supports adaptive sampling to spend more samples on noisy areas of the image.
* '''Metropolis: ''' Sampler that spends more samples on bright areas of the image, thus rendering caustics much better than the other samplers. The main disadvantage, especially when rendering on the GPU, is the higher RAM usage than the other samplers. It is not recommended to use this sampler for rendering on GPUs.
* '''Random:''' Simple random sampler. Supports adaptive sampling to spend more samples on noisy areas of the image. In almost all cases, the Sobol sampler is better suited.

= Clamping =

All engines support "variance clamping" of samples. The clamping value has to be chosen to fit the brightness in the scene.

= Caches =

Caches are pre-computed before the rendering of film samples starts. They can accelerate the rendering of their respective area of expertise tremendously. Caches can be saved to disk and re-used, which can for example be used for animations where only the camera moves.

* '''[[ PhotonGI ]] Indirect Light Cache:''' Use this cache if the indirect light in the scene is noisy (for example in indoor scenes)

* '''[[ PhotonGI ]] Caustics Cache:''' Use this cache if there are SDS-caustics in the scene (e.g. caustics in mirror, pool with camera above surface, underwater scene with caustics reflected from water surface, etc.)

* '''Environment light cache:''' Use this cache if direct light from world background is noisy (for example in indoor scenes lit by sky or HDRI through small windows). Do not use it in open scenes, as it can be detrimental to performance in that case. Note that this cache may produce visible artifacts if aggressive (too low) clamping values are used. Raise the clamping value if this happens.

* '''Direct Light Sampling Cache:''' Use this cache in scenes with many light sources, where most of the lights only affect a limited area around them (e.g. a skyscraper with hundreds of rooms, each room lit by one light source). This cache makes direct light sampling in such situations much more efficient. Note that this cache may produce visible artifacts if aggressive (too low) clamping values are used. Raise the clamping value if this happens.

= Light Strategy =

The light strategy controls how much processing power is spent on each light in the scene. 
All lights in the scene can be sampled with the same probability (''uniform'' light strategy), but if some light sources are much brighter than others, the image will be more noisy because a lot of processing power is spent on weak lights that are not contributing much to the lighting. 
The solution to this problem are the ''power'' and ''log power'' light strategies. They dedicate more processing power to lights that are brighter. 

The following light strategies are available:

* Uniform
* Power
* Log Power (default)

The sampling probability of a light can also be influenced with the importance setting of the light source:

'''Importance:''' How much processing power to spend on this light source compared to other light sources.
Used to scale the light importance computed by the light strategy. For instance, if you set a ''uniform'' light strategy, a light with a user importance of 2.0 will be sampled 2 times more often than one with 1.0.
If you use a ''power'' light strategy, the user importance will be multiplied by the light power.

Render Configuration

2020-05-14T13:00:14Z

Byob: /* Caches */

= Engines =

The choice of engine decides how lights are traced in the scene. 
LuxCoreRender offers the following engines (integrators):

* '''Path''' (CPU/OpenCL): Unidirectional pathtracer that casts rays from the camera. Samples the whole film progressively. Supports all AOVs.
* '''Tiled Path''' (CPU/OpenCL): Unidirectional pathtracer that is almost the same as '''Path''', but uses a special sampler which iterates over the image in tiles (this leads to a slightly lower RAM usage). The OpenCL version adapts the number of tiles that are rendered at once to the performance of the compute devices (GPUs/CPUs), so the tile size does not matter a lot (if rendering performance is bad due to small tiles, the number of rendered tiles is increased automatically). When the last tile of a pass is reached, it is split among the compute devices. Supports all AOVs.
* '''Bidir''' (CPU only): Bidirectional pathtracer that casts rays from both camera and light sources. Samples the whole film progressively. Supports only a subset of AOVs: RGB, RGBA, ALPHA, DEPTH and SAMPLECOUNT. It is recommended to combine this engine with the '''Metropolis''' sampler.

= Samplers =

The sampler decides how points on the film are chosen (in which area to fire more/less light rays). 
LuxCoreRender offers the following samplers:

* '''Sobol:''' Random sampler with an improved noise pattern. Supports adaptive sampling to spend more samples on noisy areas of the image.
* '''Metropolis: ''' Sampler that spends more samples on bright areas of the image, thus rendering caustics much better than the other samplers. The main disadvantage, especially when rendering on the GPU, is the higher RAM usage than the other samplers.
* '''Random:''' Simple random sampler. Supports adaptive sampling to spend more samples on noisy areas of the image.

= Clamping =

All engines support "variance clamping" of samples. The clamping value has to be chosen to fit the brightness in the scene.

= Caches =

Caches are pre-computed before the rendering of film samples starts. They can accelerate the rendering of their respective area of expertise tremendously. Caches can be saved to disk and re-used, which can for example be used for animations where only the camera moves.

* '''[[ PhotonGI ]] Indirect Light Cache:''' Use this cache if the indirect light in the scene is noisy (for example in indoor scenes)

* '''[[ PhotonGI ]] Caustics Cache:''' Use this cache if there are SDS-caustics in the scene (e.g. caustics in mirror, pool with camera above surface, underwater scene with caustics reflected from water surface, etc.)

* '''Environment light cache:''' Use this cache if direct light from world background is noisy (for example in indoor scenes lit by sky or HDRI through small windows). Do not use it in open scenes, as it can be detrimental to performance in that case. Note that this cache may produce visible artifacts if aggressive (too low) clamping values are used. Raise the clamping value if this happens.

* '''Direct Light Sampling Cache:''' Use this cache in scenes with many light sources, where most of the lights only affect a limited area around them (e.g. a skyscraper with hundreds of rooms, each room lit by one light source). This cache makes direct light sampling in such situations much more efficient. Note that this cache may produce visible artifacts if aggressive (too low) clamping values are used. Raise the clamping value if this happens.

= Light Strategy =

The light strategy controls how much processing power is spent on each light in the scene. 
All lights in the scene can be sampled with the same probability (''uniform'' light strategy), but if some light sources are much brighter than others, the image will be more noisy because a lot of processing power is spent on weak lights that are not contributing much to the lighting. 
The solution to this problem are the ''power'' and ''log power'' light strategies. They dedicate more processing power to lights that are brighter. 

The following light strategies are available:

* Uniform
* Power
* Log Power (default)

The sampling probability of a light can also be influenced with the importance setting of the light source:

'''Importance:''' How much processing power to spend on this light source compared to other light sources.
Used to scale the light importance computed by the light strategy. For instance, if you set a ''uniform'' light strategy, a light with a user importance of 2.0 will be sampled 2 times more often than one with 1.0.
If you use a ''power'' light strategy, the user importance will be multiplied by the light power.

Render Configuration

2020-05-14T12:52:50Z

Byob: /* Caches */

= Engines =

The choice of engine decides how lights are traced in the scene. 
LuxCoreRender offers the following engines (integrators):

* '''Path''' (CPU/OpenCL): Unidirectional pathtracer that casts rays from the camera. Samples the whole film progressively. Supports all AOVs.
* '''Tiled Path''' (CPU/OpenCL): Unidirectional pathtracer that is almost the same as '''Path''', but uses a special sampler which iterates over the image in tiles (this leads to a slightly lower RAM usage). The OpenCL version adapts the number of tiles that are rendered at once to the performance of the compute devices (GPUs/CPUs), so the tile size does not matter a lot (if rendering performance is bad due to small tiles, the number of rendered tiles is increased automatically). When the last tile of a pass is reached, it is split among the compute devices. Supports all AOVs.
* '''Bidir''' (CPU only): Bidirectional pathtracer that casts rays from both camera and light sources. Samples the whole film progressively. Supports only a subset of AOVs: RGB, RGBA, ALPHA, DEPTH and SAMPLECOUNT. It is recommended to combine this engine with the '''Metropolis''' sampler.

= Samplers =

The sampler decides how points on the film are chosen (in which area to fire more/less light rays). 
LuxCoreRender offers the following samplers:

* '''Sobol:''' Random sampler with an improved noise pattern. Supports adaptive sampling to spend more samples on noisy areas of the image.
* '''Metropolis: ''' Sampler that spends more samples on bright areas of the image, thus rendering caustics much better than the other samplers. The main disadvantage, especially when rendering on the GPU, is the higher RAM usage than the other samplers.
* '''Random:''' Simple random sampler. Supports adaptive sampling to spend more samples on noisy areas of the image.

= Clamping =

All engines support "variance clamping" of samples. The clamping value has to be chosen to fit the brightness in the scene.

= Caches =

* '''[[ PhotonGI ]] Indirect Light Cache:''' Use this cache if the indirect light in the scene is noisy (for example in indoor scenes)

* '''[[ PhotonGI ]] Caustics Cache:''' Use this cache if there are SDS-caustics in the scene (e.g. caustics in mirror, pool with camera above surface, underwater scene with caustics reflected from water surface, etc.)

* '''Environment light cache:''' Use this cache if direct light from world background is noisy (for example in indoor scenes lit by sky or HDRI through small windows). Do not use it in open scenes, as it can be detrimental to performance in that case. Note that this cache may produce visible artifacts if aggressive (too low) clamping values are used. Raise the clamping value if this happens.

* '''Direct Light Sampling Cache:''' Use this cache in scenes with many light sources, where most of the lights only affect a limited area around them (e.g. a skyscraper with hundreds of rooms, each room lit by one light source). This cache makes direct light sampling in such situations much more efficient. Note that this cache may produce visible artifacts if aggressive (too low) clamping values are used. Raise the clamping value if this happens.

= Light Strategy =

The light strategy controls how much processing power is spent on each light in the scene. 
All lights in the scene can be sampled with the same probability (''uniform'' light strategy), but if some light sources are much brighter than others, the image will be more noisy because a lot of processing power is spent on weak lights that are not contributing much to the lighting. 
The solution to this problem are the ''power'' and ''log power'' light strategies. They dedicate more processing power to lights that are brighter. 

The following light strategies are available:

* Uniform
* Power
* Log Power (default)

The sampling probability of a light can also be influenced with the importance setting of the light source:

'''Importance:''' How much processing power to spend on this light source compared to other light sources.
Used to scale the light importance computed by the light strategy. For instance, if you set a ''uniform'' light strategy, a light with a user importance of 2.0 will be sampled 2 times more often than one with 1.0.
If you use a ''power'' light strategy, the user importance will be multiplied by the light power.

Render Configuration

2020-05-14T12:49:08Z

Byob: added clamping and caches sections

= Engines =

The choice of engine decides how lights are traced in the scene. 
LuxCoreRender offers the following engines (integrators):

* '''Path''' (CPU/OpenCL): Unidirectional pathtracer that casts rays from the camera. Samples the whole film progressively. Supports all AOVs.
* '''Tiled Path''' (CPU/OpenCL): Unidirectional pathtracer that is almost the same as '''Path''', but uses a special sampler which iterates over the image in tiles (this leads to a slightly lower RAM usage). The OpenCL version adapts the number of tiles that are rendered at once to the performance of the compute devices (GPUs/CPUs), so the tile size does not matter a lot (if rendering performance is bad due to small tiles, the number of rendered tiles is increased automatically). When the last tile of a pass is reached, it is split among the compute devices. Supports all AOVs.
* '''Bidir''' (CPU only): Bidirectional pathtracer that casts rays from both camera and light sources. Samples the whole film progressively. Supports only a subset of AOVs: RGB, RGBA, ALPHA, DEPTH and SAMPLECOUNT. It is recommended to combine this engine with the '''Metropolis''' sampler.

= Samplers =

The sampler decides how points on the film are chosen (in which area to fire more/less light rays). 
LuxCoreRender offers the following samplers:

* '''Sobol:''' Random sampler with an improved noise pattern. Supports adaptive sampling to spend more samples on noisy areas of the image.
* '''Metropolis: ''' Sampler that spends more samples on bright areas of the image, thus rendering caustics much better than the other samplers. The main disadvantage, especially when rendering on the GPU, is the higher RAM usage than the other samplers.
* '''Random:''' Simple random sampler. Supports adaptive sampling to spend more samples on noisy areas of the image.

= Clamping =

All engines support "variance clamping" of samples. The clamping value has to be chosen to fit the brightness in the scene.

= Caches =

== [[ PhotonGI | PhotonGI Cache]] ==

=== Indirect Light Cache ===

Use this cache if the indirect light in the scene is noisy (for example in indoor scenes)

=== Caustics Cache ===

Use this cache if there are SDS-caustics in the scene (e.g. caustics in mirror, pool with camera above surface, underwater scene with caustics reflected from water surface, etc.)

== Environment light cache ==

Use this cache if direct light from world background is noisy (for example in indoor scenes lit by sky or HDRI through small windows).
Do not use it in open scenes, as it can be detrimental to performance in that case.

Note that this cache may produce visible artifacts if aggressive (too low) clamping values are used. Raise the clamping value if this happens.

== Direct Light Sampling Cache ==

Use this cache in scenes with many light sources, where most of the lights only affect a limited area around them (e.g. a skyscraper with hundreds of rooms, each room lit by one light source). This cache makes direct light sampling in such situations much more efficient.

Note that this cache may produce visible artifacts if aggressive (too low) clamping values are used. Raise the clamping value if this happens.

= Light Strategy =

The light strategy controls how much processing power is spent on each light in the scene. 
All lights in the scene can be sampled with the same probability (''uniform'' light strategy), but if some light sources are much brighter than others, the image will be more noisy because a lot of processing power is spent on weak lights that are not contributing much to the lighting. 
The solution to this problem are the ''power'' and ''log power'' light strategies. They dedicate more processing power to lights that are brighter. 

The following light strategies are available:

* Uniform
* Power
* Log Power (default)

The sampling probability of a light can also be influenced with the importance setting of the light source:

'''Importance:''' How much processing power to spend on this light source compared to other light sources.
Used to scale the light importance computed by the light strategy. For instance, if you set a ''uniform'' light strategy, a light with a user importance of 2.0 will be sampled 2 times more often than one with 1.0.
If you use a ''power'' light strategy, the user importance will be multiplied by the light power.

LuxCoreRender User's Manual

2020-05-14T12:38:16Z

Byob:

LuxCoreRender Tutorials

2020-05-12T13:17:26Z

Byob: /* Blender 2.8x */

== Video Tutorials ==

=== Blender 2.8x ===

{| width="100%"
|
[[File:BlendLuxCore-2.8-Interior-Tutorial.png|thumb|none|300x300px|link=https://youtu.be/XjwCOIWwQo4| [https://youtu.be/XjwCOIWwQo4 BlendLuxCore v2.8 Interior Tutorial] ]]
|
[[File:Shader_tutorial.jpg|thumb|none|300x300px|link=https://youtu.be/xZOdXI9181k| [https://youtu.be/xZOdXI9181k LuxCore Shader Tutorial 1] ]]
|
[[File:Shader_2.jpg|thumb|none|300x300px|link=https://youtu.be/79V_ySn5ZoY| [https://youtu.be/79V_ySn5ZoY LuxCore Shader Tutorial 2] ]]
|}

{| width="100%"
|
[[File:Orange_juice_tutorial.png|thumb|none|300x300px|link=https://youtu.be/R2-u3YNJbHQ| [https://youtu.be/R2-u3YNJbHQ Orange Juice Tutorial] ]]
|
[[File:Caustics_pool_tutorial.png|thumb|none|300x300px|link=https://youtu.be/mHYpWe4KF8I| [https://youtu.be/mHYpWe4KF8I Caustics Pool Tutorial] ]]
|
[[File:Caustics_Master.jpg|thumb|none|300x300px|link=https://youtu.be/gvo9WLBqNVU| [https://youtu.be/gvo9WLBqNVU Caustics & Fog] ]]
|}

{| width="100%"
|
[[File:Displacement_tut.jpg|thumb|none|300x300px|link=https://youtu.be/OrgCGEJL_sk| [https://youtu.be/OrgCGEJL_sk Displacement Tutorial] ]]
|
[[File:Heads.jpg|thumb|none|300x300px|link=https://youtu.be/1COAMA_r1Ao| [https://youtu.be/1COAMA_r1Ao Skin Shader Tutorial] ]]
|
[[File:HAIIRRR.jpg|thumb|none|300x300px|link=https://youtu.be/RMKwv6N4trQ| [https://youtu.be/RMKwv6N4trQ Hair Shader Tutorial] ]]
|}

{| width="100%"
|
[[File:Light Groups2.jpg|thumb|none|300x300px|link=https://youtu.be/Lsz9yx6GM7I| [https://youtu.be/Lsz9yx6GM7I Light Group Tutorial] ]]
|
[[File:Carpaint tut.jpg|thumb|none|300x300px|link=https://youtu.be/KFbk_JxPUj4| [https://youtu.be/KFbk_JxPUj4 Carpaint Tutorial] ]]
|
[[File:Blendluxcore_render_settings_tut_1.jpg|thumb|none|300x300px|link=https://youtu.be/Ron1se5liV8| [https://youtu.be/Ron1se5liV8 BlendLuxCore: Render settings - Tracing method I] ]]
|}

{| width="100%"
|
[[File:Pbr_leaf_texture_tut.jpg|thumb|none|300x300px|link=https://youtu.be/j8TXpqtdcvY| [https://youtu.be/j8TXpqtdcvY PBR Leaf Texture Tutorial] ]]
|}

=== Blender 2.79 ===

{| width="100%"
|
[[File:beginner_tutorial.jpg|thumb|none|300x300px|link=https://youtu.be/-BmXeUDRqSo| [https://youtu.be/-BmXeUDRqSo Introduction to LuxCoreRender in Blender] ]]
|
[[File:DLSC_tutorial_thumbnail.jpg|thumb|none|300x300px|link=https://youtu.be/dIfwr2YPxPw| [https://youtu.be/dIfwr2YPxPw Tutorial about the Direct Light Sampling Cache (DLSC)] ]]
|
[[File:Sss tutorial thumbnail.jpg|thumb|none|300x300px|link=https://youtu.be/gEGDyHMnlkg| [https://youtu.be/gEGDyHMnlkg Subsurface Scattering and Volume Tutorial] ]]
|}

{| width="100%"
|
[[File:Brushed steel thumbnail.png|thumb|none|300x300px|link=https://youtu.be/FGhPAP0oV9k| [https://youtu.be/FGhPAP0oV9k Brushed Steel Tutorial] ]]
|
[[File:Photongi_tutorial.jpg|thumb|none|300x300px|link=https://youtu.be/trkUldfb380| [https://youtu.be/trkUldfb380 PhotonGI Tutorial] ]]
|
[[File:LED_tutorial.png|thumb|none|300x300px|link=https://youtu.be/saGvvLWS4xs| [https://youtu.be/saGvvLWS4xs LED Tutorial] ]]
|}

== General Tutorials ==

These tutorials are not about LuxCoreRender, but about scene composition, lighting etc.

* blenderer.com: [https://www.blendernation.com/2018/06/18/how-to-make-a-beautiful-scene/ What makes a beautiful scene]
* blenderer.com: [https://www.blendernation.com/2018/06/22/how-to-improve-your-interior-scenes/ Secrets to making the best interior scenes]

== Old Tutorials for LuxBlend ==

The tutorials listed here were made with the old LuxBlend addon.

* Create nice beer using Blender and LuxCore: [https://www.youtube.com/watch?v=EtsA7iDK32A Part 1] and [https://www.youtube.com/watch?v=lJliJFKir8Y Part 2]
* [https://youtu.be/GpvHYi8uW1Y Create an interior scene using Blender and LuxCore]

File:Pbr leaf texture tut.jpg

2020-05-12T13:16:12Z

Byob: