LuxCoreRender Wiki - User contributions [en]

LuxCore SDL Reference Manual v2.6

2021-12-27T12:29:32Z

Dade: 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 define multiple image pipelines at the same time by using the '''film.imagepipelines.<pipeline #>.''' properties prefix. Each image pipeline takes as input the raw rendering and is a chain off image pipeline plugins. Each plugin receives previous plugin output and produces a new output.

====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===

{| 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

2021-12-27T12:29:17Z

Dade:

Reference manual for:

* [[LuxCore_SDL_Reference_Manual_v2.6|v2.6]]
* [[LuxCore_SDL_Reference_Manual_v2.5|v2.5]]
* [[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]]

LuxCore SDL Reference Manual

2021-12-27T12:28:54Z

Dade:

Reference manual for:

* [[LuxCore_SDL_Reference_Manual_v2.5|v2.6]]
* [[LuxCore_SDL_Reference_Manual_v2.5|v2.5]]
* [[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 Release Notes v2.6

2021-12-27T12:27:30Z

Dade:

__TOC__

=LuxCore=

===New Features===

* BIDIRCPU can now use PhotonGI caustic cache to render SDS paths
* Optimized the parsing of mesh light sources and it is now about 3x faster
* Introduced (partial) multi-thread support in pre-processing of Light sources
* Integrated OpenColorIO v2.0
* Added the support for new TONEMAP_OPENCOLORIO tone mapper
* Added the support for color spaces (Nop, LuxCore and OpenColorIO) to image maps
* Added the support for color spaces (Nop, LuxCore and OpenColorIO) to constant textures
* Added the support for color spaces (Nop, LuxCore and OpenColorIO) to implicit definitions of constant textures
* Added the support for color spaces (Nop, LuxCore and OpenColorIO) to materials
* Added the support for color spaces (Nop, LuxCore and OpenColorIO) to light sources
* FILESAVER avoids to save the internal random image map (used by randomized tiling)
* Updated to Intel Embree v3.12.2
* Updated to Intel OIDN v1.3.0
* Updated to OpenImageIO v2.2.13.1
* Regularize coordinate system to solve some anisotropic related issue with glossy material (pull request #521)
* UVRandomMapping2D now supports optional random rotation step parameter (issue #528)
* LocalRandomMapping3D now supports optional random rotation step parameter (issue #528)
* Introduced the concept of Scene texture image maps resize policy and the support for NONE and FIXED policies
* Reworked the way alpha channel is computed for transmitted paths
* Introduced the MINMEM Scene texture image maps resize policy
* Updated to Intel OIDN v1.4.0
* Added the support for Intel OIDN auxiliary buffers pre-filtering
* Added the support for new pyluxcoretools MakeTX
* Introduced the MIPMAPMEM Scene texture image maps resize policy
* GPU out-of-core rendering now automatically disable Film GPU image pipeline to save more memory
* Added the support for Film-only out-of-core rendering (CUDA-only) with property opencl.outofcore.film.enable
* Added a safety check for infinite light source when HDR with invalid values (NaN, Inf, etc.) is used
* Added the support to Intel OIDN plugin for enabling/diasbling prefiltering with .prefilter.enable property
* Disney glossiness evaluation (for PGI, Albedo AOV, etc.) now checks metal and specular parameters
* Disney glossiness evaluation uses now the square root of the value to align with the roughness of Glossy2, Metal, etc.
* Added the support for image map filtering nearest, linear was the only mode available before (issue #545)
* Albedo AOV reflections and transmissions can now be configured (mostly for denoising)
* Avg. Shading Normal AOV is now coherent with Albedo AOV reflections and transmissions settings
* Intel OIDN plugin now pre-filters Avg. Shading Normal AOV too
* Added the support for Albedo and Normal AOV warmup for improved denoising with BIDIRCPU
* Added the support for camera projection UV shape
* Added the support for OpenColorIO Looks to TONEMAP_OPENCOLORIO color space mode
* Added the support for OpenColorIO Looks to TONEMAP_OPENCOLORIO display mode
* It is now possible to set the light source volume like with camera (for BiDir)

===Fixed Bugs===

===Known Problems===

* Fixed the reading of IES files on system with not-US locale
* Fixed a problem with Python and Property objects initialized as double even if they were int
* Python Property object now consider int data type always as a 64 bit value
* Fixed a bug rendering black baked maps when using bump mapping and COMBINED type with BAKECPU rendering engine
* Fixed a bug when rendering caustics over volumes with Caustic cache (issue #533)
* Fixed a problem causing the initialization of multiple dataset accelerators in some case
* Fixed a problem with incorrect alpha AOV values (issue #536)
* Fixed a problem when using Add/Subtract textures with bump mapping (issue #689)
* GlossyCoating is now a delta material if the base material is
* Fixed a crash when editing light source emission
* Added a work around to pyluxcoretools with PySide2 causing a std::bad_cast
* Fixed a possible crash when editing a scene
* Fixed glTF export to work with Python base64.b64decode()
* Fixed a bug in Disney material causing bright edges
* Fixed a problem with not-NULL transparent surfaces when the interior and the exterior volumes are the same
* Fixed a cut&paste error in ImageMapStorage::GetDuv() (issue #560)
* Fixed a problem with indirect light going trough objects with white shadow transparency in BIDIRCPU
* Fixed a possible crash when editing a scene

= BlendLuxCore =

===New Features===

===Fixed Bugs===

===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

LuxCore SDL Reference Manual v2.4

2021-07-30T19:24:45Z

Dade:

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===

{| 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

2021-07-30T19:24:15Z

Dade:

LuxCoreRender Release Notes v2.6

2021-04-10T14:19:00Z

Dade: Created page with "__TOC__ =LuxCore= ===New Features=== * BIDIRCPU can now use PhotonGI caustic cache to render SDS paths * Optimized the parsing of mesh light sources and it is now about 3x..."

LuxCoreRender Release Notes

2021-04-10T14:17:37Z

Dade:

Release notes for:

* [[LuxCoreRender_Release_Notes_v2.6|v2.6 (under development)]]
* [[LuxCoreRender_Release_Notes_v2.5|v2.5]]
* [[LuxCoreRender_Release_Notes_v2.4|v2.4]]
* [[LuxCoreRender_Release_Notes_v2.3|v2.3]]
* [[LuxCoreRender_Release_Notes_v2.2|v2.2]]
* [[LuxCoreRender_Release_Notes_v2.1|v2.1]]
* [[LuxCoreRender_Release_Notes_v2.0|v2.0]]

LuxCoreRender Release Notes v2.5

2021-04-10T14:16:34Z

Dade: /* 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)

Beta1 released

* Removed the cap to opencl.task.count parameter

RC1 released

===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)

Beta1 released

* Fixed a crash when using Subdivision shape with vertex colors (issue #469)
* Fixed a possible crash when using multiple GPUs with PhotonGI
* Fixed a deadlock when using multiple renders at the same time in Blender (issue #575)
* Fixed a bug in the support for material .bumpsamplingdistance property
* Fixed a discrepancy in reflected area lights on glossy surfaces between CPU and GPU rendering when light tracing is enabled (issue #470)
* Avoid to return CUDA_ERROR_NO_DEVICE error if CUDA is installed but there are no NVIDIA GPUs installed
* Fixed compilation when CUDA is disabled but OpenCL is still enabled
* Now disabling CUDA for any error during the cuInit() like when an external GPU is unplugged (issue #493)
* Compiling the code with LUXCORE_DISABLE_OIDN defined will disable Intel OIDN (for platforms where it is not available like Apple M1)
* Fixed halt condition rendering stop code when using both eye and light tracing parameters (issue #497)
* Change sphere light implementation to provide an alternative to the point light fallback (issue #443)
* Fixed a compiler error when running with CUDA on Ampere GPUs (issue BlendLuxCore#626)
* Fixed a crash when using an image pipeline with only NOP plugin
* CPU code now rejects NaN/Inf sample values for AOVs like GPU code
* Avoid to generate NaN volume transmittance if the segment is infinite

RC1 released

* Fixed a problem when using the DIRECT_DIFFUSE_REFLECT AOV (issue #517)
* Fixed a crash when using CPU-only image pipeline plugins but image pipeline GPU support is still enabled
* Fixed a problem with BIDIRCPU and RADIANCE_GROUP AOV
* Fixed a problem when using chain of shapes with mesh vertex/triangle AOVs (issue #659)

===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-04-10T14:16:08Z

Dade: /* 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)

Beta1 released

* Removed the cap to opencl.task.count parameter

RC1 released

===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

LuxCore SDL Reference Manual v2.5

2021-03-03T10:08:11Z

Dade: /* Image pipeline */

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 define multiple image pipelines at the same time by using the '''film.imagepipelines.<pipeline #>.''' properties prefix. Each image pipeline takes as input the raw rendering and is a chain off image pipeline plugins. Each plugin receives previous plugin output and produces a new output.

====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
|}

LuxCoreRender Release Notes v2.5

2020-11-16T11:05:39Z

Dade: /* LuxCore */

LuxCoreRender Release Notes v2.4

2020-06-28T09:42:42Z

Dade: /* Known Problems */

=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

===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-28T09:42:33Z

Dade: /* 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===

* 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-28T09:42:04Z

Dade: /* 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 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)

===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-03-14T09:59:30Z

Dade: Created page with "=LuxCore= ===New Features=== * New OpenCL code to evaluate textures and materials. It doesn't require kernel re-compilation anymore. * LuxCoreUI "Fill kernel cache" menu opt..."

=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===

=Blender Addon (BlendLuxCore)=

===New features===

===Fixed Bugs===

===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]
* 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

2020-03-14T09:56:28Z

Dade:

Release notes for:

* [[LuxCoreRender_Release_Notes_v2.4|v2.4 (under development)]]
* [[LuxCoreRender_Release_Notes_v2.3|v2.3]]
* [[LuxCoreRender_Release_Notes_v2.2|v2.2]]
* [[LuxCoreRender_Release_Notes_v2.1|v2.1]]
* [[LuxCoreRender_Release_Notes_v2.0|v2.0]]

LuxCoreRender Release Notes v2.3

2020-03-14T09:55:34Z

Dade:

=LuxCore=

===New Features===

* LuxCoreUI now shows eye and light pass counters if light tracing is enabled
* FILESAVER now expands inline exported constant texture values
* PhotonGI caustic scene re-factored to work with Vertex Merging (i.e. SPPM in this case)
* It is now possible to use light tracing for normal caustics and PhotonGI cache for SDS paths
* Added the support for shadow rays transparency for path tracers (aka hybrid glass, issue #233)
* Added the support for Basu and Owen's low discrepancy triangle light sampling (pull request #246)
* Added an option to normalize BlackBody texture output
* Pointiness shape is now able to handle duplicate/similar vertices like if they were the same
* Added the support for Subdivison shape (base don OpenSubdiv)
* Added the support for Displacement shape
* Added the support for vector displacement to Displacement shape
* New image pipeline plugin: White balance
* Using/Not using bump/normal mapping doesn't require OpenCL compilation anymore (removed PARAM_HAS_BUMPMAPS conditional OpenCL compilation)
* Large rework of internal light interface. Fixed several instance/motion blur and lights related problems. Triangle light motion blur now works as expected in OpenCL.
* Large rework of internal mesh interface. Improved the performance of instanced and motion blur meshes.
* Changed object and material ID for background to 0 (from 0xffffffff)
* Added the support for screen space subdivision limit to SubdivShape
* Using/Not using any type of transparency doesn't require OpenCL compilation anymore (removed PARAM_HAS_PASSTHROUGH conditional OpenCL compilation)
* Added an Harlequin shape (mostly to debug meshes)
* Added a Simplify shape (to decimate the number of triangles in a mesh with the smaller possible error)
* Reduced the default number of OpenCL threads from 512k to 256k (to save about 150MB of GPU RAM at 1-2% performance cost)
* Changing max. path and/or Russian Roulette parameters doesn't require OpenCL compilation anymore (removed PARAM_MAX_PATH_DEPTH, PARAM_MAX_PATH_DEPTH_DIFFUSE, PARAM_MAX_PATH_DEPTH_GLOSSY, PARAM_MAX_PATH_DEPTH_SPECULAR, PARAM_RR_DEPTH and PARAM_RR_CAPPARAM_HAS_BUMPMAPS conditional OpenCL compilation)
* Added the support the definition of meshes with multiple UVs, Colors and Alphas (issue #134)
* Added the BAKECPU engine (LuxCore API only)
* Added the glTF v2.0 FILESAVER support (LuxCore API only)
* Changing hybrid backward/forward path tracing settings doesn't require OpenCL compilation anymore (removed PARAM_HYBRID_BACKFORWARD and PARAM_HYBRID_BACKFORWARD_GLOSSINESSTHRESHOLD conditional OpenCL compilation)
* Changing PhotonGI settings doesn't require OpenCL compilation anymore (removed PARAM_PGIC_ENABLED, PARAM_PGIC_INDIRECT_ENABLED, PARAM_PGIC_CAUSTIC_ENABLED, etc.)
* Changing force black background flag doesn't require OpenCL compilation anymore (removed PARAM_FORCE_BLACK_BACKGROUND)
* Changing variance clamping settings doesn't require OpenCL compilation anymore (removed PARAM_SQRT_VARIANCE_CLAMP_MAX_VALUE)
* Changing LIGHT_WORLD_RADIUS_SCALE doesn't require OpenCL compilation anymore (removed PARAM_RADIUS)
* Removed HitPoint struct variable size related to PARAM_ENABLE_TEX_HITPOINTCOLOR, PARAM_ENABLE_TEX_HITPOINTGREY, PARAM_ENABLE_TEX_HITPOINTALPHA and PARAM_TRIANGLE_LIGHT_HAS_VERTEX_COLOR to avoid OpenCL re-compilation
* Enabling/disabling volumes doesn't require OpenCL compilation anymore (removed PARAM_HAS_VOLUMES and SCENE_DEFAULT_VOLUME_INDEX)
* Added the support for triplanar mapping
* Enabling/disabling camera clipping and/or OculusRift barrel doesn't require OpenCL compilation anymore (removed PARAM_CAMERA_ENABLE_CLIPPING_PLANE and PARAM_CAMERA_ENABLE_OCULUSRIFT_BARREL)
* Changing any pixel filter related parameter doesn't require OpenCL compilation anymore (removed all PARAM_IMAGE_FILTER_*)
* Disney material now accepts values > 1.0 for sheen parameter
* Changing camera type doesn't require OpenCL compilation anymore (removed PARAM_CAMERA_TYPE)
* Changing any image map related settings doesn't require OpenCL compilation anymore (removed all PARAM_HAS_IMAGEMAPS_*)
* Added the support for UV-less bump mapping with triplanar mapping
* Changing the number of light groups used doesn't require OpenCL compilation anymore (removed PARAM_FILM_RADIANCE_GROUP_*)
* Reduced (again) the default number of OpenCL threads from 256k to 128k
* Added the support for .normalizebycolor emission property
* Using a GPU memory block larger than CL_DEVICE_MAX_MEM_ALLOC_SIZE now triggers only a warning. Some driver/hardware (i.e. NVIDIA) is able to allocate larger blocks.
* Enabling/disabling BCD denoiser doesn't require OpenCL compilation anymore (removed PARAM_FILM_DENOISER)
* Changing RTPATHOCL rendering parameters doesn't require OpenCL compilation anymore (removed PARAM_RTPATHOCL_*)
* Rework of OpenCL samplers code to not require OpenCL compilation anymore when changing sampler (removed PARAM_SAMPLER_*)
* Changing AOVs used doesn't require OpenCL compilation anymore (removed PARAM_FILM_CHANNELS_*)
* Adding/Removing a new light source type doesn't require OpenCL compilation anymore (removed PARAM_HAS_*LIGHT)

''Beta1 released''

* Improved light map sampling in BAKECPU
* Added the support for transparencies and shadowcatcher to BAKECPU
* Fixed and optimized the execution on CPU with high thread count (24+)

''Beta2 released''

* OUTPUT_SWITCHER image pipeline plugin now supports MATERIAL_ID_COLOR, ALBEDO, AVG_SHADING_NORMAL and USER_IMPORTANCE too

''RC1 released''

* Added the support for baked light maps rendering

===Fixed Bugs===

* Fixed triangle lights back face emission when using an IES or image map profile
* Fixed OpenCL code for rotate triangle light when using IES or image map profile (BlendLuxCore iusse #310)
* Fixed light tracing when using orthographic camera
* Fixed a light intensity problem with OpenCL rendering when using a mix of materials with emission
* Fixed the support for wrap mode in image maps loaded from files
* Fixed a brightness problem when rendering large images with Metropolis sampler
* Fixed a brightness problem when rendering caustics with PhotonGI caustic cache
* Fixed a bug in Mix material OpenCL code when mixing transparent and not transparent materials
* Fixed a crash when rendering an empty scene with OpenCL and EnvLightVisibilityCache
* Fixed a problem with mesh light sources when deleting an object with LuxCore API (issue #290)
* Fixed a bug when evaluating complex tree of bump mapping nodes (issue #198)

''Beta1 released''

* BAKECPU now correctly includes the dot product of shading normal and light direction in light maps
* Fixed the generation of material/object/volume default random ID (issue #296)
* Fixed bump mapping when using a transformation with negative scale on Z (issue #300)

''Beta2 released''

* Fixed a bug in pyluxcoretools ui code causing a runtime error with PySide2 5.14.x
* Volume .photongi.enable property is now parsed/exported and supported
* Fixed a problem in RTPATHOCL preview phase (issue #305)

''RC1 released''

* Fixed a numerical precision problem on some very large scene (issue #308)
* Fixed weights of direct and indirect light maps in BAKECPU

=Blender Addon (BlendLuxCore)=

===New features===

* OpenVDB node
* Support for new shadow color feature
* Support for new white balance image pipeline plugin
* Area lights now have UV coordinates
* Image sequence support
* Triplanar mapping node (+ triplanar bump node)
* Rework of caustic cache settings
* Only disable imgpipeline plugins in viewport because of denoiser when necessary (only for contour lines and color aberration)
* Support for blackbody normalize option
* New "exclude from render" flag for objects, to make it possible to have them visible in other render engines but invisible in LuxCore
* Support for LuxCore shape pipeline and new shape modifiers: OpenSubDiv, Displacement, Vector Displacement, Simplify
* Sun lights are now by default invisible to indirect specular rays when using the Path engine, because these paths would only generate fireflies anyway
* New TimeInfo node
* Allow values > 1 in disney sheen parameter
* Accelerated export of instances and particles (in a scene with 100,000 particles: from 33 seconds in v2.2 to 1.3 seconds total export time in v2.3)
* Improved status messages in the UI during export of complex scenes
* Added camera invisible support for hair
* Hair on instances is now duplicated correctly
* Float node sockets now show 3 instead of 2 decimal places
* Make it possible to enable/disable PhotonGI in materials even if PhotonGI is disabled globally
* Support for environment light cache persistent file
* Support for direct light cache persistent file

''Beta1 released''

* BlendLuxCore can now read some basic Cycles world and light settings. For more info see https://github.com/LuxCoreRender/BlendLuxCore/issues/272
* Added option to normalize distant light (enabled by default)
* Objects that are completely invisible in Cycles (via ray visibility flags) are not exported by LuxCore anymore
* Allow to set light tracing partition even with OpenCL engine (so it's possible to use the CPU not only for light tracing)
* Added a button that allows to create a light object from an HDRI world (for free transformation)

''Beta2 released''

* use Cycles DOF properties
* sun and sky now use a separate gain property with default 0.00002 to prevent overexposion with default tonemapper settings
* add operator that converts old scenes to v2.3
* PhotonGI on volumes is now disabled by default. Warnings are shown if a volume with enabled PhotonGI is used as world volume
* More physically based light units

''RC1 released''

===Fixed Bugs===

* Fixed bugs in smoke export
* Show camera background image panel
* Fixed film refresh not happening at the promised time because it was waiting for the next statistic update
* Fixed instancer being shown in final render even if disabled
* Fixed smoke export to match cycles render by translate the grid by 1/4*cell_size
* Fixed light emission when Power or Efficacy = 0
* Support for multiple UV maps and multiple Vertex color channels
* Fixed UV offset being off by 1 in some node setups due to a correction factor being applied twice

''Beta1 released''

* Fixed view layer override material not working
* Fixed instancer sometimes visible in final render despite disabled visibility
* Fixed packed image temp files not being closed before removal

''Beta2 released''

* support more than 8 render slots (fixes #377)
* remove cloned Cycles camera panels without modifications
* show Cycles node panel for lights, if Cycles settings are used
* fix some UI issues in light/world properties
* fix (harmless) console errors when toggling the use_cycles_nodes option without an open node editor
* fix bug in hair export causing motion blur to fail if hair failed to export
* prevent absorption depth from ever being zero to avoid division by zero
* show the new fluid/smoke system panels (in Blender 2.82)

''RC1 released''

* fix export of just one instance (fixes #391)
* fix object made invisible only in viewport not being exported in final render (fixes #392)
* fix not hair not being rendered when Show Emitter is unchecked (fixes #388)
* fix LuxCore material viewport color panel not being visible (preventing users from turning off automatic coloring)
* fix collection instances, particles and other duplis getting duplicated when moving them in a running viewport render (fixes #366)
* fix several bugs regarding hair on instances/duplis
* fix material viewport update not being triggered on node connection change reliably
* fix wrong dupli export in some rare cases, caused by a key collision during final render export

===Changes that break backwards-compatibility===

Old scenes created with v2.2 will need to be updated manually in the areas listed below to make them look the same in v2.3:

* The ImagePipeline tonemapper default settings were changed: auto brightness is now disabled by default (was enabled), gain is now 1.0 by default (was 0.5)
* Lights now have two modes for choosing the brightness: "artistic" and "power". Default is now "artistic". This means that the light settings of old scenes have to be changed manually to make them look identical to v2.2.
* It is now no longer possible to tint the sun and the sky color

''Beta1 released''

* Sun lights in "distant" mode are now normalized by default. To make old scenes appear the same, disable the "Normalize" option in the light settings
* Camera clipping is now enabled by default. When loading old scenes, you'll have to disable it to get the same behaviour (although the difference is probably not visible in most scenes)
* The blackbody texture is now normalized by default. For scenes created in older versions, disable the normalize option to get the same result

''Beta2 released''

* Sun and sky now have a separate gain property with default 0.00002 to prevent overexposion with default tonemapper settings. In old scenes, you will have to copy-paste the old gain value, e.g. by switching to another light type and back to sun or sky.

''RC1 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]
* 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.

Previous Version

2020-02-21T11:37:38Z

Dade:

==Previous version (LuxRender "classic") downloads==

LuxCoreRender has replaced the previous LuxRender software. The last version of "classic" LuxRender is the 1.6, released in 2016.

You can download the binaries and source code of the previous version from the GitHub repository :

https://github.com/LuxCoreRender/LuxCore/releases/tag/luxrender_v1.6

{|class="wikitable"
!style=width:200px;text-align:left"|OS
!Download
|-
|Windows 64 bits - OpenCL
|[https://github.com/LuxCoreRender/LuxCore/releases/download/luxrender_v1.6/LuxRender.1.6.x64.OpenCL.Setup.exe LuxRender.1.6.x64.OpenCL.Setup.exe]
|-
|Windows 64 bits - No OpenCL
|[https://github.com/LuxCoreRender/LuxCore/releases/download/luxrender_v1.6/LuxRender.1.6.x64.NoOpenCL.Setup.exe LuxRender.1.6.x64.NoOpenCL.Setup.exe]
|-
|Windows 32 bits - OpenCL
|[https://github.com/LuxCoreRender/LuxCore/releases/download/luxrender_v1.6/LuxRender.1.6.x86.OpenCL.Setup.exe LuxRender.1.6.x86.OpenCL.Setup.exe]
|-
|Windows 32 bits - No OpenCL
|[https://github.com/LuxCoreRender/LuxCore/releases/download/luxrender_v1.6/LuxRender.1.6.x86.NoOpenCL.Setup.exe LuxRender.1.6.x86.NoOpenCL.Setup.exe]
|-
|MacOS
|[https://github.com/LuxCoreRender/LuxCore/releases/download/luxrender_v1.6/LuxRender_1.6_OSXIntel_64bit.dmg LuxRender_1.6_OSXIntel_64bit.dmg]
|-
|Linux 64 bits - OpenCL
|[https://github.com/LuxCoreRender/LuxCore/releases/download/luxrender_v1.6/lux-v1.6-x86_64-sse2-OpenCL.tar.bz2 lux-v1.6-x86_64-sse2-OpenCL.tar.bz2]
|-
|Linux 64 bits - No OpenCL
|[https://github.com/LuxCoreRender/LuxCore/releases/download/luxrender_v1.6/lux-v1.6-x86_64-sse2-NoOpenCL.tar.bz2 lux-v1.6-x86_64-sse2-NoOpenCL.tar.bz2]
|}

For other downloads, the LuxRender website was archived by [https://archive.org/ Archive.org] and you can browse it using the WayBack Machine.

This is a copy of the website that was online on March 11 2018 :

https://web.archive.org/web/20180220011904/http://www.luxrender.net/en_GB/index

You can download from there any older version.

----

Please remember that LuxRender is not actively developed anymore. The links provided here are for users that may need to use a previous version, for example to render an older scene file. It is encouraged to adapt your files for newer versions of LuxCoreRender to benefit from the new features and performance.

==LuxRender "classic" sources==

LuxRender "classic" sources are preserved at https://github.com/LuxRender

LuxCoreRender Release Notes v2.3

2020-02-16T23:53:21Z

Dade:

=LuxCore=

===New Features===

* LuxCoreUI now shows eye and light pass counters if light tracing is enabled
* FILESAVER now expands inline exported constant texture values
* PhotonGI caustic scene re-factored to work with Vertex Merging (i.e. SPPM in this case)
* It is now possible to use light tracing for normal caustics and PhotonGI cache for SDS paths
* Added the support for shadow rays transparency for path tracers (aka hybrid glass, issue #233)
* Added the support for Basu and Owen's low discrepancy triangle light sampling (pull request #246)
* Added an option to normalize BlackBody texture output
* Pointiness shape is now able to handle duplicate/similar vertices like if they were the same
* Added the support for Subdivison shape (base don OpenSubdiv)
* Added the support for Displacement shape
* Added the support for vector displacement to Displacement shape
* New image pipeline plugin: White balance
* Using/Not using bump/normal mapping doesn't require OpenCL compilation anymore (removed PARAM_HAS_BUMPMAPS conditional OpenCL compilation)
* Large rework of internal light interface. Fixed several instance/motion blur and lights related problems. Triangle light motion blur now works as expected in OpenCL.
* Large rework of internal mesh interface. Improved the performance of instanced and motion blur meshes.
* Changed object and material ID for background to 0 (from 0xffffffff)
* Added the support for screen space subdivision limit to SubdivShape
* Using/Not using any type of transparency doesn't require OpenCL compilation anymore (removed PARAM_HAS_PASSTHROUGH conditional OpenCL compilation)
* Added an Harlequin shape (mostly to debug meshes)
* Added a Simplify shape (to decimate the number of triangles in a mesh with the smaller possible error)
* Reduced the default number of OpenCL threads from 512k to 256k (to save about 150MB of GPU RAM at 1-2% performance cost)
* Changing max. path and/or Russian Roulette parameters doesn't require OpenCL compilation anymore (removed PARAM_MAX_PATH_DEPTH, PARAM_MAX_PATH_DEPTH_DIFFUSE, PARAM_MAX_PATH_DEPTH_GLOSSY, PARAM_MAX_PATH_DEPTH_SPECULAR, PARAM_RR_DEPTH and PARAM_RR_CAPPARAM_HAS_BUMPMAPS conditional OpenCL compilation)
* Added the support the definition of meshes with multiple UVs, Colors and Alphas (issue #134)
* Added the BAKECPU engine (LuxCore API only)
* Added the glTF v2.0 FILESAVER support (LuxCore API only)
* Changing hybrid backward/forward path tracing settings doesn't require OpenCL compilation anymore (removed PARAM_HYBRID_BACKFORWARD and PARAM_HYBRID_BACKFORWARD_GLOSSINESSTHRESHOLD conditional OpenCL compilation)
* Changing PhotonGI settings doesn't require OpenCL compilation anymore (removed PARAM_PGIC_ENABLED, PARAM_PGIC_INDIRECT_ENABLED, PARAM_PGIC_CAUSTIC_ENABLED, etc.)
* Changing force black background flag doesn't require OpenCL compilation anymore (removed PARAM_FORCE_BLACK_BACKGROUND)
* Changing variance clamping settings doesn't require OpenCL compilation anymore (removed PARAM_SQRT_VARIANCE_CLAMP_MAX_VALUE)
* Changing LIGHT_WORLD_RADIUS_SCALE doesn't require OpenCL compilation anymore (removed PARAM_RADIUS)
* Removed HitPoint struct variable size related to PARAM_ENABLE_TEX_HITPOINTCOLOR, PARAM_ENABLE_TEX_HITPOINTGREY, PARAM_ENABLE_TEX_HITPOINTALPHA and PARAM_TRIANGLE_LIGHT_HAS_VERTEX_COLOR to avoid OpenCL re-compilation
* Enabling/disabling volumes doesn't require OpenCL compilation anymore (removed PARAM_HAS_VOLUMES and SCENE_DEFAULT_VOLUME_INDEX)
* Added the support for triplanar mapping
* Enabling/disabling camera clipping and/or OculusRift barrel doesn't require OpenCL compilation anymore (removed PARAM_CAMERA_ENABLE_CLIPPING_PLANE and PARAM_CAMERA_ENABLE_OCULUSRIFT_BARREL)
* Changing any pixel filter related parameter doesn't require OpenCL compilation anymore (removed all PARAM_IMAGE_FILTER_*)
* Disney material now accepts values > 1.0 for sheen parameter
* Changing camera type doesn't require OpenCL compilation anymore (removed PARAM_CAMERA_TYPE)
* Changing any image map related settings doesn't require OpenCL compilation anymore (removed all PARAM_HAS_IMAGEMAPS_*)
* Added the support for UV-less bump mapping with triplanar mapping
* Changing the number of light groups used doesn't require OpenCL compilation anymore (removed PARAM_FILM_RADIANCE_GROUP_*)
* Reduced (again) the default number of OpenCL threads from 256k to 128k
* Added the support for .normalizebycolor emission property
* Using a GPU memory block larger than CL_DEVICE_MAX_MEM_ALLOC_SIZE now triggers only a warning. Some driver/hardware (i.e. NVIDIA) is able to allocate larger blocks.
* Enabling/disabling BCD denoiser doesn't require OpenCL compilation anymore (removed PARAM_FILM_DENOISER)
* Changing RTPATHOCL rendering parameters doesn't require OpenCL compilation anymore (removed PARAM_RTPATHOCL_*)
* Rework of OpenCL samplers code to not require OpenCL compilation anymore when changing sampler (removed PARAM_SAMPLER_*)
* Changing AOVs used doesn't require OpenCL compilation anymore (removed PARAM_FILM_CHANNELS_*)
* Adding/Removing a new light source type doesn't require OpenCL compilation anymore (removed PARAM_HAS_*LIGHT)

''Beta1 released''

* Improved light map sampling in BAKECPU
* Added the support for transparencies and shadowcatcher to BAKECPU
* Fixed and optimized the execution on CPU with high thread count (24+)

''Beta2 released''

===Fixed Bugs===

* Fixed triangle lights back face emission when using an IES or image map profile
* Fixed OpenCL code for rotate triangle light when using IES or image map profile (BlendLuxCore iusse #310)
* Fixed light tracing when using orthographic camera
* Fixed a light intensity problem with OpenCL rendering when using a mix of materials with emission
* Fixed the support for wrap mode in image maps loaded from files
* Fixed a brightness problem when rendering large images with Metropolis sampler
* Fixed a brightness problem when rendering caustics with PhotonGI caustic cache
* Fixed a bug in Mix material OpenCL code when mixing transparent and not transparent materials
* Fixed a crash when rendering an empty scene with OpenCL and EnvLightVisibilityCache
* Fixed a problem with mesh light sources when deleting an object with LuxCore API (issue #290)
* Fixed a bug when evaluating complex tree of bump mapping nodes (issue #198)

''Beta1 released''

* BAKECPU now correctly includes the dot product of shading normal and light direction in light maps
* Fixed the generation of material/object/volume default random ID (issue #296)
* Fixed bump mapping when using a transformation with negative scale on Z (issue #300)

''Beta2 released''

=Blender Addon (BlendLuxCore)=

===New features===

* OpenVDB node
* Support for new shadow color feature
* Support for new white balance image pipeline plugin
* Area lights now have UV coordinates
* Image sequence support
* Triplanar mapping node (+ triplanar bump node)
* Rework of caustic cache settings
* Only disable imgpipeline plugins in viewport because of denoiser when necessary (only for contour lines and color aberration)
* Support for blackbody normalize option
* New "exclude from render" flag for objects, to make it possible to have them visible in other render engines but invisible in LuxCore
* Support for LuxCore shape pipeline and new shape modifiers: OpenSubDiv, Displacement, Vector Displacement, Simplify
* Sun lights are now by default invisible to indirect specular rays when using the Path engine, because these paths would only generate fireflies anyway
* New TimeInfo node
* Allow values > 1 in disney sheen parameter
* Accelerated export of instances and particles (in a scene with 100,000 particles: from 33 seconds in v2.2 to 1.3 seconds total export time in v2.3)
* Improved status messages in the UI during export of complex scenes
* Added camera invisible support for hair
* Hair on instances is now duplicated correctly
* Float node sockets now show 3 instead of 2 decimal places
* Make it possible to enable/disable PhotonGI in materials even if PhotonGI is disabled globally
* Support for environment light cache persistent file
* Support for direct light cache persistent file

''Beta1 released''

* BlendLuxCore can now read some basic Cycles world and light settings. For more info see https://github.com/LuxCoreRender/BlendLuxCore/issues/272
* Added option to normalize distant light (enabled by default)
* Objects that are completely invisible in Cycles (via ray visibility flags) are not exported by LuxCore anymore
* Allow to set light tracing partition even with OpenCL engine (so it's possible to use the CPU not only for light tracing)
* Added a button that allows to create a light object from an HDRI world (for free transformation)

===Fixed Bugs===

* Fixed bugs in smoke export
* Show camera background image panel
* Fixed film refresh not happening at the promised time because it was waiting for the next statistic update
* Fixed instancer being shown in final render even if disabled
* Fixed smoke export to match cycles render by translate the grid by 1/4*cell_size
* Fixed light emission when Power or Efficacy = 0
* Support for multiple UV maps and multiple Vertex color channels
* Fixed UV offset being off by 1 in some node setups due to a correction factor being applied twice

''Beta1 released''

* Fixed view layer override material not working
* Fixed instancer sometimes visible in final render despite disabled visibility
* Fixed packed image temp files not being closed before removal

===Changes that break backwards-compatibility===

Old scenes created with v2.2 will need to be updated manually in the areas listed below to make them look the same in v2.3:

* The ImagePipeline tonemapper default settings were changed: auto brightness is now disabled by default (was enabled), gain is now 1.0 by default (was 0.5)
* Lights now have two modes for choosing the brightness: "artistic" and "power". Default is now "artistic". This means that the light settings of old scenes have to be changed manually to make them look identical to v2.2.
* It is now no longer possible to tint the sun and the sky color

''Beta1 released''

* Sun lights in "distant" mode are now normalized by default. To make old scenes appear the same, disable the "Normalize" option in the light settings
* Camera clipping is now enabled by default. When loading old scenes, you'll have to disable it to get the same behaviour (although the difference is probably not visible in most scenes)
* The blackbody texture is now normalized by default. For scenes created in older versions, disable the normalize option to get the same result
* The distant light is now normalized by default. For scenes created in older versions, disable the normalize option to get the same result

===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]
* 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.3

2020-01-28T15:32:29Z

Dade: /* LuxCore */

LuxCore SDL Reference Manual v2.3

2019-10-12T12:48:10Z

Dade: /* Type: blackbody */

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", "QBVH", "MQBVH", "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 || ? || ?
|}

===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.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.
|-
|}

=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.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)
|}

===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: 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]
|}

===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
|}

===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
|}

==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
|}

LuxMark v4

2019-10-08T09:59:05Z

Dade: /* Render engines */

= LuxMark v4.x =

LuxMark is a OpenCL cross-platform benchmark tool and has become, over past years, one of the most used (if not the most used) OpenCL benchmark. It is intended as a promotional tool for [http://www.luxcorerender.org LuxCoreRender] and it is now based on [[LuxCore_API | LuxCore API]], the LuxCoreRender v2.x C++ or Python API available under Apache Licence v2.0 and freely usable in open source and commercial applications.

== Render engines ==

This release is based on [https://github.com/LuxCoreRender/LuxCore/releases/tag/luxcorerender_v2.2 LuxCoreRender v2.2] and includes benchmarks with the following rendering engines:

* A micro-kernel based OpenCL path tracer with/without Global Illumination cache;
* A C++ path tracer with/without Global Illumination cache. Ray intersection C++ code uses state-of-the-art Intel [https://embree.github.io Embree];
* An hybrid OpenCL for GPUs and C++ for CPUs path tracer with/without Global Illumination cache;
* A C++ Bidirectional path tracer with a [https://en.wikipedia.org/wiki/Metropolis%E2%80%93Hastings_algorithm Metropolis–Hastings] sampler.

== Denoiser ==

LuxMark includes [https://github.com/OpenImageDenoise/oidn Intel OpenImageDenoise]. A comparison between raw and denoised image is shown at the end of the benchmark or during the stress test. However Intel OpenImageDenoise is a CPU-only task and '''it is not part of the benchmark result'''.

<div align="center">[[Image:LuxMark-v4-denoise.jpg|640px]]</div>

== Stress mode ==

Aside from benchmarking modes, it is also available a stress mode to check the reliability of the hardware under heavy load. Hybrid OpenCL GPUs + C++ CPUs is well suited to put the maximum load possible on the system.

== Benchmark Result Validation ==

LuxMark includes a validation of the rendered image by using the same technology used for [http://pdiff.sourceforge.net pdiff] in order to check if the benchmarked result is valid or something has gone wrong. It has also a validation of the scene sources used (i.e. hash of scene files).

== Benchmark Scenes ==

=== Brute force path tracing (OpenCL, C++ and Hybrid) ===

The main LuxMark benchmark is a brute force path tracer (i.e. no cache used).

<div align="center">[[Image:LuxMark-v4-bench1.png|640px]]</div>

=== Path tracing with GI cache (OpenCL, C++ and Hybrid) ===

The second LuxMark benchmark is a path tracer with global illumination cache. This rendering mode slightly simpler than pure brute force and may work better on some GPU.

<div align="center">[[Image:LuxMark-v4-bench2.png|640px]]</div>

=== Bidirectional path tracing with Metropolis sampler (C++ only) ===

The last LuxMark benchmark is a bidirectional path tracer with a [https://en.wikipedia.org/wiki/Metropolis%E2%80%93Hastings_algorithm Metropolis–Hastings] sampler. Due to its complexity and the serialize nature of Metropolis, this rendering mode is available only for CPUs.

<div align="center">[[Image:LuxMark-v4-bench3.png|640px]]</div>

== Command line options ==

Usage: ./bin/luxmark [options]
--help (display this help and exit)
--scene=FOOD|HALLBENCH|WALLPAPER (select the scene to use)
--mode=BENCHMARK_OCL_GPU|BENCHMARK_OCL_CPUGPU|BENCHMARK_OCL_CPU|BENCHMARK_OCL_CUSTOM|BENCHMARK_HYBRID|BENCHMARK_HYBRID_CUSTOM|BENCHMARK_NATIVE|STRESSTEST_OCL_GPU|STRESSTEST_OCL_CPUGPU|STRESSTEST_OCL_CPU|STRESSTEST_HYBRID|STRESSTEST_NATIVE|DEMO_LUXCOREUI|PAUSE (select the mode to use)
--devices=<a string of 1 or 0 to enable/disable each OpenCL device in CUSTOM modes>
--single-run (run the benchmark, print the result to the stdout and exit)
--ext-info (print scene and image verification too with --single-run)

== Binaries ==

- Windows 64bit: https://github.com/LuxCoreRender/LuxMark/releases/download/luxmark_v4.0alpha0/luxmark-v4.0alpha0-win64.zip ('''Note: you have to install the [https://aka.ms/vs/15/release/vc_redist.x64.exe Microsoft Visual C++ Redistributable for Visual Studio 2017] in order to run the Windows executable''')

- Linux 64bit: https://github.com/LuxCoreRender/LuxMark/releases/download/luxmark_v4.0alpha0/luxmark-v4.0alpha0-linux64.tar.bz2 ('''Note: You have to install Qt5 from your distribution in order to run the Linux executable''')

== Compile from sources ==

Some note to compile LuxMark:

- the sources are available here: https://github.com/LuxCoreRender/LuxMark (tag: luxmark_v4.0)

- LuxMark can be compiled exactly like LuxCoreRender. It has exactly the same dependencies (i.e. LuxCore, LuxRays, etc.). The procedure described in [https://github.com/LuxCoreRender/WindowsCompile|Windows repository] and [https://github.com/LuxCoreRender/LinuxCompile|Linux repository] can be used to compile LuxMark too.

- the complete scenes directory is available here: https://github.com/LuxCoreRender/LuxMark/releases/download/luxmark_v4.0alpha0/scenes.tgz

LuxMark v4

2019-10-08T09:56:54Z

Dade: /* Compile from sources */

= LuxMark v4.x =

LuxMark is a OpenCL cross-platform benchmark tool and has become, over past years, one of the most used (if not the most used) OpenCL benchmark. It is intended as a promotional tool for [http://www.luxcorerender.org LuxCoreRender] and it is now based on [[LuxCore_API | LuxCore API]], the LuxCoreRender v2.x C++ or Python API available under Apache Licence v2.0 and freely usable in open source and commercial applications.

== Render engines ==

This release is based on [https://github.com/LuxCoreRender/LuxCore/releases/tag/luxcorerender_v2.2 LuxCoreRender v2.2] and includes benchmarks with the following rendering engines:

* A micro-kernel based OpenCL path tracer with/without Global Illumination cache;
* A C++ path tracer with/without Global Illumination cache;
* An hybrid OpenCL for GPUs and C++ for CPUs path tracer with/without Global Illumination cache;
* A C++ Bidirectional path tracer with a [https://en.wikipedia.org/wiki/Metropolis%E2%80%93Hastings_algorithm Metropolis–Hastings] sampler.

== Denoiser ==

LuxMark includes [https://github.com/OpenImageDenoise/oidn Intel OpenImageDenoise]. A comparison between raw and denoised image is shown at the end of the benchmark or during the stress test. However Intel OpenImageDenoise is a CPU-only task and '''it is not part of the benchmark result'''.

<div align="center">[[Image:LuxMark-v4-denoise.jpg|640px]]</div>

== Stress mode ==

Aside from benchmarking modes, it is also available a stress mode to check the reliability of the hardware under heavy load. Hybrid OpenCL GPUs + C++ CPUs is well suited to put the maximum load possible on the system.

== Benchmark Result Validation ==

LuxMark includes a validation of the rendered image by using the same technology used for [http://pdiff.sourceforge.net pdiff] in order to check if the benchmarked result is valid or something has gone wrong. It has also a validation of the scene sources used (i.e. hash of scene files).

== Benchmark Scenes ==

=== Brute force path tracing (OpenCL, C++ and Hybrid) ===

The main LuxMark benchmark is a brute force path tracer (i.e. no cache used).

<div align="center">[[Image:LuxMark-v4-bench1.png|640px]]</div>

=== Path tracing with GI cache (OpenCL, C++ and Hybrid) ===

The second LuxMark benchmark is a path tracer with global illumination cache. This rendering mode slightly simpler than pure brute force and may work better on some GPU.

<div align="center">[[Image:LuxMark-v4-bench2.png|640px]]</div>

=== Bidirectional path tracing with Metropolis sampler (C++ only) ===

The last LuxMark benchmark is a bidirectional path tracer with a [https://en.wikipedia.org/wiki/Metropolis%E2%80%93Hastings_algorithm Metropolis–Hastings] sampler. Due to its complexity and the serialize nature of Metropolis, this rendering mode is available only for CPUs.

<div align="center">[[Image:LuxMark-v4-bench3.png|640px]]</div>

== Command line options ==

Usage: ./bin/luxmark [options]
--help (display this help and exit)
--scene=FOOD|HALLBENCH|WALLPAPER (select the scene to use)
--mode=BENCHMARK_OCL_GPU|BENCHMARK_OCL_CPUGPU|BENCHMARK_OCL_CPU|BENCHMARK_OCL_CUSTOM|BENCHMARK_HYBRID|BENCHMARK_HYBRID_CUSTOM|BENCHMARK_NATIVE|STRESSTEST_OCL_GPU|STRESSTEST_OCL_CPUGPU|STRESSTEST_OCL_CPU|STRESSTEST_HYBRID|STRESSTEST_NATIVE|DEMO_LUXCOREUI|PAUSE (select the mode to use)
--devices=<a string of 1 or 0 to enable/disable each OpenCL device in CUSTOM modes>
--single-run (run the benchmark, print the result to the stdout and exit)
--ext-info (print scene and image verification too with --single-run)

== Binaries ==

- Windows 64bit: https://github.com/LuxCoreRender/LuxMark/releases/download/luxmark_v4.0alpha0/luxmark-v4.0alpha0-win64.zip ('''Note: you have to install the [https://aka.ms/vs/15/release/vc_redist.x64.exe Microsoft Visual C++ Redistributable for Visual Studio 2017] in order to run the Windows executable''')

- Linux 64bit: https://github.com/LuxCoreRender/LuxMark/releases/download/luxmark_v4.0alpha0/luxmark-v4.0alpha0-linux64.tar.bz2 ('''Note: You have to install Qt5 from your distribution in order to run the Linux executable''')

== Compile from sources ==

Some note to compile LuxMark:

- the sources are available here: https://github.com/LuxCoreRender/LuxMark (tag: luxmark_v4.0)

- LuxMark can be compiled exactly like LuxCoreRender. It has exactly the same dependencies (i.e. LuxCore, LuxRays, etc.). The procedure described in [https://github.com/LuxCoreRender/WindowsCompile|Windows repository] and [https://github.com/LuxCoreRender/LinuxCompile|Linux repository] can be used to compile LuxMark too.

- the complete scenes directory is available here: https://github.com/LuxCoreRender/LuxMark/releases/download/luxmark_v4.0alpha0/scenes.tgz

LuxMark v4

2019-10-08T09:46:34Z

Dade: /* Binaries */

= LuxMark v4.x =

LuxMark is a OpenCL cross-platform benchmark tool and has become, over past years, one of the most used (if not the most used) OpenCL benchmark. It is intended as a promotional tool for [http://www.luxcorerender.org LuxCoreRender] and it is now based on [[LuxCore_API | LuxCore API]], the LuxCoreRender v2.x C++ or Python API available under Apache Licence v2.0 and freely usable in open source and commercial applications.

== Render engines ==

This release is based on [https://github.com/LuxCoreRender/LuxCore/releases/tag/luxcorerender_v2.2 LuxCoreRender v2.2] and includes benchmarks with the following rendering engines:

* A micro-kernel based OpenCL path tracer with/without Global Illumination cache;
* A C++ path tracer with/without Global Illumination cache;
* An hybrid OpenCL for GPUs and C++ for CPUs path tracer with/without Global Illumination cache;
* A C++ Bidirectional path tracer with a [https://en.wikipedia.org/wiki/Metropolis%E2%80%93Hastings_algorithm Metropolis–Hastings] sampler.

== Denoiser ==

LuxMark includes [https://github.com/OpenImageDenoise/oidn Intel OpenImageDenoise]. A comparison between raw and denoised image is shown at the end of the benchmark or during the stress test. However Intel OpenImageDenoise is a CPU-only task and '''it is not part of the benchmark result'''.

<div align="center">[[Image:LuxMark-v4-denoise.jpg|640px]]</div>

== Stress mode ==

Aside from benchmarking modes, it is also available a stress mode to check the reliability of the hardware under heavy load. Hybrid OpenCL GPUs + C++ CPUs is well suited to put the maximum load possible on the system.

== Benchmark Result Validation ==

LuxMark includes a validation of the rendered image by using the same technology used for [http://pdiff.sourceforge.net pdiff] in order to check if the benchmarked result is valid or something has gone wrong. It has also a validation of the scene sources used (i.e. hash of scene files).

== Benchmark Scenes ==

=== Brute force path tracing (OpenCL, C++ and Hybrid) ===

The main LuxMark benchmark is a brute force path tracer (i.e. no cache used).

<div align="center">[[Image:LuxMark-v4-bench1.png|640px]]</div>

=== Path tracing with GI cache (OpenCL, C++ and Hybrid) ===

The second LuxMark benchmark is a path tracer with global illumination cache. This rendering mode slightly simpler than pure brute force and may work better on some GPU.

<div align="center">[[Image:LuxMark-v4-bench2.png|640px]]</div>

=== Bidirectional path tracing with Metropolis sampler (C++ only) ===

The last LuxMark benchmark is a bidirectional path tracer with a [https://en.wikipedia.org/wiki/Metropolis%E2%80%93Hastings_algorithm Metropolis–Hastings] sampler. Due to its complexity and the serialize nature of Metropolis, this rendering mode is available only for CPUs.

<div align="center">[[Image:LuxMark-v4-bench3.png|640px]]</div>

== Command line options ==

Usage: ./bin/luxmark [options]
--help (display this help and exit)
--scene=FOOD|HALLBENCH|WALLPAPER (select the scene to use)
--mode=BENCHMARK_OCL_GPU|BENCHMARK_OCL_CPUGPU|BENCHMARK_OCL_CPU|BENCHMARK_OCL_CUSTOM|BENCHMARK_HYBRID|BENCHMARK_HYBRID_CUSTOM|BENCHMARK_NATIVE|STRESSTEST_OCL_GPU|STRESSTEST_OCL_CPUGPU|STRESSTEST_OCL_CPU|STRESSTEST_HYBRID|STRESSTEST_NATIVE|DEMO_LUXCOREUI|PAUSE (select the mode to use)
--devices=<a string of 1 or 0 to enable/disable each OpenCL device in CUSTOM modes>
--single-run (run the benchmark, print the result to the stdout and exit)
--ext-info (print scene and image verification too with --single-run)

== Binaries ==

- Windows 64bit: https://github.com/LuxCoreRender/LuxMark/releases/download/luxmark_v4.0alpha0/luxmark-v4.0alpha0-win64.zip ('''Note: you have to install the [https://aka.ms/vs/15/release/vc_redist.x64.exe Microsoft Visual C++ Redistributable for Visual Studio 2017] in order to run the Windows executable''')

- Linux 64bit: https://github.com/LuxCoreRender/LuxMark/releases/download/luxmark_v4.0alpha0/luxmark-v4.0alpha0-linux64.tar.bz2 ('''Note: You have to install Qt5 from your distribution in order to run the Linux executable''')

== Compile from sources ==

Some note to compile LuxMark:

- the sources are available here: https://github.com/LuxCoreRender/LuxMark (tag: luxmark_v3.1)

- LuxMark can be compiled exactly like LuxCoreRender. It has exactly the same dependencies (i.e. LuxCore, LuxRays, etc.). The procedure described in [https://github.com/LuxCoreRender/WindowsCompile|Windows repository] and [https://github.com/LuxCoreRender/LinuxCompile|Linux repository] can be used to compile LuxMark too.

- the complete scenes directory is available here: https://github.com/LuxCoreRender/LuxMark/releases/download/luxmark_v4.0alpha0/scenes.tgz

LuxMark v4

2019-10-08T09:44:39Z

Dade: /* Binaries */

= LuxMark v4.x =

LuxMark is a OpenCL cross-platform benchmark tool and has become, over past years, one of the most used (if not the most used) OpenCL benchmark. It is intended as a promotional tool for [http://www.luxcorerender.org LuxCoreRender] and it is now based on [[LuxCore_API | LuxCore API]], the LuxCoreRender v2.x C++ or Python API available under Apache Licence v2.0 and freely usable in open source and commercial applications.

== Render engines ==

This release is based on [https://github.com/LuxCoreRender/LuxCore/releases/tag/luxcorerender_v2.2 LuxCoreRender v2.2] and includes benchmarks with the following rendering engines:

* A micro-kernel based OpenCL path tracer with/without Global Illumination cache;
* A C++ path tracer with/without Global Illumination cache;
* An hybrid OpenCL for GPUs and C++ for CPUs path tracer with/without Global Illumination cache;
* A C++ Bidirectional path tracer with a [https://en.wikipedia.org/wiki/Metropolis%E2%80%93Hastings_algorithm Metropolis–Hastings] sampler.

== Denoiser ==

LuxMark includes [https://github.com/OpenImageDenoise/oidn Intel OpenImageDenoise]. A comparison between raw and denoised image is shown at the end of the benchmark or during the stress test. However Intel OpenImageDenoise is a CPU-only task and '''it is not part of the benchmark result'''.

<div align="center">[[Image:LuxMark-v4-denoise.jpg|640px]]</div>

== Stress mode ==

Aside from benchmarking modes, it is also available a stress mode to check the reliability of the hardware under heavy load. Hybrid OpenCL GPUs + C++ CPUs is well suited to put the maximum load possible on the system.

== Benchmark Result Validation ==

LuxMark includes a validation of the rendered image by using the same technology used for [http://pdiff.sourceforge.net pdiff] in order to check if the benchmarked result is valid or something has gone wrong. It has also a validation of the scene sources used (i.e. hash of scene files).

== Benchmark Scenes ==

=== Brute force path tracing (OpenCL, C++ and Hybrid) ===

The main LuxMark benchmark is a brute force path tracer (i.e. no cache used).

<div align="center">[[Image:LuxMark-v4-bench1.png|640px]]</div>

=== Path tracing with GI cache (OpenCL, C++ and Hybrid) ===

The second LuxMark benchmark is a path tracer with global illumination cache. This rendering mode slightly simpler than pure brute force and may work better on some GPU.

<div align="center">[[Image:LuxMark-v4-bench2.png|640px]]</div>

=== Bidirectional path tracing with Metropolis sampler (C++ only) ===

The last LuxMark benchmark is a bidirectional path tracer with a [https://en.wikipedia.org/wiki/Metropolis%E2%80%93Hastings_algorithm Metropolis–Hastings] sampler. Due to its complexity and the serialize nature of Metropolis, this rendering mode is available only for CPUs.

<div align="center">[[Image:LuxMark-v4-bench3.png|640px]]</div>

== Command line options ==

Usage: ./bin/luxmark [options]
--help (display this help and exit)
--scene=FOOD|HALLBENCH|WALLPAPER (select the scene to use)
--mode=BENCHMARK_OCL_GPU|BENCHMARK_OCL_CPUGPU|BENCHMARK_OCL_CPU|BENCHMARK_OCL_CUSTOM|BENCHMARK_HYBRID|BENCHMARK_HYBRID_CUSTOM|BENCHMARK_NATIVE|STRESSTEST_OCL_GPU|STRESSTEST_OCL_CPUGPU|STRESSTEST_OCL_CPU|STRESSTEST_HYBRID|STRESSTEST_NATIVE|DEMO_LUXCOREUI|PAUSE (select the mode to use)
--devices=<a string of 1 or 0 to enable/disable each OpenCL device in CUSTOM modes>
--single-run (run the benchmark, print the result to the stdout and exit)
--ext-info (print scene and image verification too with --single-run)

== Binaries ==

- Windows 64bit: https://github.com/LuxCoreRender/LuxMark/releases/download/luxmark_v4.0alpha0/luxmark-v4.0alpha0-win64.zip ('''Note: you have to install the [https://aka.ms/vs/15/release/vc_redist.x64.exe Microsoft Visual C++ Redistributable for Visual Studio 2017]''')

- Linux 64bit: https://github.com/LuxCoreRender/LuxMark/releases/download/luxmark_v4.0alpha0/luxmark-v4.0alpha0-linux64.tar.bz2 ('''Note: You have to install Qt5 from your distribution in order to run the Linux executable''')

== Compile from sources ==

Some note to compile LuxMark:

- the sources are available here: https://github.com/LuxCoreRender/LuxMark (tag: luxmark_v3.1)

- LuxMark can be compiled exactly like LuxCoreRender. It has exactly the same dependencies (i.e. LuxCore, LuxRays, etc.). The procedure described in [https://github.com/LuxCoreRender/WindowsCompile|Windows repository] and [https://github.com/LuxCoreRender/LinuxCompile|Linux repository] can be used to compile LuxMark too.

- the complete scenes directory is available here: https://github.com/LuxCoreRender/LuxMark/releases/download/luxmark_v4.0alpha0/scenes.tgz

LuxMark v4

2019-10-08T09:41:50Z

Dade: /* Bidirectional path tracing with GI cache (C++ only) */

= LuxMark v4.x =

LuxMark is a OpenCL cross-platform benchmark tool and has become, over past years, one of the most used (if not the most used) OpenCL benchmark. It is intended as a promotional tool for [http://www.luxcorerender.org LuxCoreRender] and it is now based on [[LuxCore_API | LuxCore API]], the LuxCoreRender v2.x C++ or Python API available under Apache Licence v2.0 and freely usable in open source and commercial applications.

== Render engines ==

This release is based on [https://github.com/LuxCoreRender/LuxCore/releases/tag/luxcorerender_v2.2 LuxCoreRender v2.2] and includes benchmarks with the following rendering engines:

* A micro-kernel based OpenCL path tracer with/without Global Illumination cache;
* A C++ path tracer with/without Global Illumination cache;
* An hybrid OpenCL for GPUs and C++ for CPUs path tracer with/without Global Illumination cache;
* A C++ Bidirectional path tracer with a [https://en.wikipedia.org/wiki/Metropolis%E2%80%93Hastings_algorithm Metropolis–Hastings] sampler.

== Denoiser ==

LuxMark includes [https://github.com/OpenImageDenoise/oidn Intel OpenImageDenoise]. A comparison between raw and denoised image is shown at the end of the benchmark or during the stress test. However Intel OpenImageDenoise is a CPU-only task and '''it is not part of the benchmark result'''.

<div align="center">[[Image:LuxMark-v4-denoise.jpg|640px]]</div>

== Stress mode ==

Aside from benchmarking modes, it is also available a stress mode to check the reliability of the hardware under heavy load. Hybrid OpenCL GPUs + C++ CPUs is well suited to put the maximum load possible on the system.

== Benchmark Result Validation ==

LuxMark includes a validation of the rendered image by using the same technology used for [http://pdiff.sourceforge.net pdiff] in order to check if the benchmarked result is valid or something has gone wrong. It has also a validation of the scene sources used (i.e. hash of scene files).

== Benchmark Scenes ==

=== Brute force path tracing (OpenCL, C++ and Hybrid) ===

The main LuxMark benchmark is a brute force path tracer (i.e. no cache used).

<div align="center">[[Image:LuxMark-v4-bench1.png|640px]]</div>

=== Path tracing with GI cache (OpenCL, C++ and Hybrid) ===

The second LuxMark benchmark is a path tracer with global illumination cache. This rendering mode slightly simpler than pure brute force and may work better on some GPU.

<div align="center">[[Image:LuxMark-v4-bench2.png|640px]]</div>

=== Bidirectional path tracing with Metropolis sampler (C++ only) ===

The last LuxMark benchmark is a bidirectional path tracer with a [https://en.wikipedia.org/wiki/Metropolis%E2%80%93Hastings_algorithm Metropolis–Hastings] sampler. Due to its complexity and the serialize nature of Metropolis, this rendering mode is available only for CPUs.

<div align="center">[[Image:LuxMark-v4-bench3.png|640px]]</div>

== Command line options ==

Usage: ./bin/luxmark [options]
--help (display this help and exit)
--scene=FOOD|HALLBENCH|WALLPAPER (select the scene to use)
--mode=BENCHMARK_OCL_GPU|BENCHMARK_OCL_CPUGPU|BENCHMARK_OCL_CPU|BENCHMARK_OCL_CUSTOM|BENCHMARK_HYBRID|BENCHMARK_HYBRID_CUSTOM|BENCHMARK_NATIVE|STRESSTEST_OCL_GPU|STRESSTEST_OCL_CPUGPU|STRESSTEST_OCL_CPU|STRESSTEST_HYBRID|STRESSTEST_NATIVE|DEMO_LUXCOREUI|PAUSE (select the mode to use)
--devices=<a string of 1 or 0 to enable/disable each OpenCL device in CUSTOM modes>
--single-run (run the benchmark, print the result to the stdout and exit)
--ext-info (print scene and image verification too with --single-run)

== Binaries ==

- Windows 64bit: https://github.com/LuxCoreRender/LuxMark/releases/download/luxmark_v4.0alpha0/luxmark-v4.0alpha0-win64.zip ('''Note: you have to install the [https://aka.ms/vs/15/release/vc_redist.x64.exe Microsoft Visual C++ Redistributable for Visual Studio 2017].)

- Linux 64bit: https://github.com/LuxCoreRender/LuxMark/releases/download/luxmark_v4.0alpha0/luxmark-v4.0alpha0-linux64.tar.bz2 ('''Note: You have to install Qt5 from your distribution in order to run the Linux executable''')

== Compile from sources ==

Some note to compile LuxMark:

- the sources are available here: https://github.com/LuxCoreRender/LuxMark (tag: luxmark_v3.1)

- LuxMark can be compiled exactly like LuxCoreRender. It has exactly the same dependencies (i.e. LuxCore, LuxRays, etc.). The procedure described in [https://github.com/LuxCoreRender/WindowsCompile|Windows repository] and [https://github.com/LuxCoreRender/LinuxCompile|Linux repository] can be used to compile LuxMark too.

- the complete scenes directory is available here: https://github.com/LuxCoreRender/LuxMark/releases/download/luxmark_v4.0alpha0/scenes.tgz

LuxMark v4

2019-10-08T09:41:00Z

Dade: /* Render engines */

= LuxMark v4.x =

LuxMark is a OpenCL cross-platform benchmark tool and has become, over past years, one of the most used (if not the most used) OpenCL benchmark. It is intended as a promotional tool for [http://www.luxcorerender.org LuxCoreRender] and it is now based on [[LuxCore_API | LuxCore API]], the LuxCoreRender v2.x C++ or Python API available under Apache Licence v2.0 and freely usable in open source and commercial applications.

== Render engines ==

This release is based on [https://github.com/LuxCoreRender/LuxCore/releases/tag/luxcorerender_v2.2 LuxCoreRender v2.2] and includes benchmarks with the following rendering engines:

* A micro-kernel based OpenCL path tracer with/without Global Illumination cache;
* A C++ path tracer with/without Global Illumination cache;
* An hybrid OpenCL for GPUs and C++ for CPUs path tracer with/without Global Illumination cache;
* A C++ Bidirectional path tracer with a [https://en.wikipedia.org/wiki/Metropolis%E2%80%93Hastings_algorithm Metropolis–Hastings] sampler.

== Denoiser ==

LuxMark includes [https://github.com/OpenImageDenoise/oidn Intel OpenImageDenoise]. A comparison between raw and denoised image is shown at the end of the benchmark or during the stress test. However Intel OpenImageDenoise is a CPU-only task and '''it is not part of the benchmark result'''.

<div align="center">[[Image:LuxMark-v4-denoise.jpg|640px]]</div>

== Stress mode ==

Aside from benchmarking modes, it is also available a stress mode to check the reliability of the hardware under heavy load. Hybrid OpenCL GPUs + C++ CPUs is well suited to put the maximum load possible on the system.

== Benchmark Result Validation ==

LuxMark includes a validation of the rendered image by using the same technology used for [http://pdiff.sourceforge.net pdiff] in order to check if the benchmarked result is valid or something has gone wrong. It has also a validation of the scene sources used (i.e. hash of scene files).

== Benchmark Scenes ==

=== Brute force path tracing (OpenCL, C++ and Hybrid) ===

The main LuxMark benchmark is a brute force path tracer (i.e. no cache used).

<div align="center">[[Image:LuxMark-v4-bench1.png|640px]]</div>

=== Path tracing with GI cache (OpenCL, C++ and Hybrid) ===

The second LuxMark benchmark is a path tracer with global illumination cache. This rendering mode slightly simpler than pure brute force and may work better on some GPU.

<div align="center">[[Image:LuxMark-v4-bench2.png|640px]]</div>

=== Bidirectional path tracing with GI cache (C++ only) ===

The last LuxMark benchmark is a bidirectional path tracer with a [https://en.wikipedia.org/wiki/Metropolis%E2%80%93Hastings_algorithm Metropolis–Hastings] sampler. Due to its complexity and the serialize nature of Metropolis, this rendering mode is available only for CPUs.

<div align="center">[[Image:LuxMark-v4-bench3.png|640px]]</div>

== Command line options ==

Usage: ./bin/luxmark [options]
--help (display this help and exit)
--scene=FOOD|HALLBENCH|WALLPAPER (select the scene to use)
--mode=BENCHMARK_OCL_GPU|BENCHMARK_OCL_CPUGPU|BENCHMARK_OCL_CPU|BENCHMARK_OCL_CUSTOM|BENCHMARK_HYBRID|BENCHMARK_HYBRID_CUSTOM|BENCHMARK_NATIVE|STRESSTEST_OCL_GPU|STRESSTEST_OCL_CPUGPU|STRESSTEST_OCL_CPU|STRESSTEST_HYBRID|STRESSTEST_NATIVE|DEMO_LUXCOREUI|PAUSE (select the mode to use)
--devices=<a string of 1 or 0 to enable/disable each OpenCL device in CUSTOM modes>
--single-run (run the benchmark, print the result to the stdout and exit)
--ext-info (print scene and image verification too with --single-run)

== Binaries ==

- Windows 64bit: https://github.com/LuxCoreRender/LuxMark/releases/download/luxmark_v4.0alpha0/luxmark-v4.0alpha0-win64.zip ('''Note: you have to install the [https://aka.ms/vs/15/release/vc_redist.x64.exe Microsoft Visual C++ Redistributable for Visual Studio 2017].)

- Linux 64bit: https://github.com/LuxCoreRender/LuxMark/releases/download/luxmark_v4.0alpha0/luxmark-v4.0alpha0-linux64.tar.bz2 ('''Note: You have to install Qt5 from your distribution in order to run the Linux executable''')

== Compile from sources ==

Some note to compile LuxMark:

- the sources are available here: https://github.com/LuxCoreRender/LuxMark (tag: luxmark_v3.1)

- LuxMark can be compiled exactly like LuxCoreRender. It has exactly the same dependencies (i.e. LuxCore, LuxRays, etc.). The procedure described in [https://github.com/LuxCoreRender/WindowsCompile|Windows repository] and [https://github.com/LuxCoreRender/LinuxCompile|Linux repository] can be used to compile LuxMark too.

- the complete scenes directory is available here: https://github.com/LuxCoreRender/LuxMark/releases/download/luxmark_v4.0alpha0/scenes.tgz

LuxMark v4

2019-10-08T09:33:20Z

Dade: /* Binaries */

= LuxMark v4.x =

LuxMark is a OpenCL cross-platform benchmark tool and has become, over past years, one of the most used (if not the most used) OpenCL benchmark. It is intended as a promotional tool for [http://www.luxcorerender.org LuxCoreRender] and it is now based on [[LuxCore_API | LuxCore API]], the LuxCoreRender v2.x C++ or Python API available under Apache Licence v2.0 and freely usable in open source and commercial applications.

== Render engines ==

This release is based on [https://github.com/LuxCoreRender/LuxCore/releases/tag/luxcorerender_v2.2 LuxCoreRender v2.2] and includes benchmarks with the following rendering engines:

* A micro-kernel based OpenCL path tracer with/without Global Illumination cache;
* A C++ path tracer with/without Global Illumination cache;
* An hybrid OpenCL for GPUs and C++ for CPUs path tracer with/without Global Illumination cache;
* A C++ Bidirectional path tracer with a [https://en.wikipedia.org/wiki/Metropolis%E2%80%93Hastings_algorithm Metropolis–Hastings] sampler;

== Denoiser ==

LuxMark includes [https://github.com/OpenImageDenoise/oidn Intel OpenImageDenoise]. A comparison between raw and denoised image is shown at the end of the benchmark or during the stress test. However Intel OpenImageDenoise is a CPU-only task and '''it is not part of the benchmark result'''.

<div align="center">[[Image:LuxMark-v4-denoise.jpg|640px]]</div>

== Stress mode ==

Aside from benchmarking modes, it is also available a stress mode to check the reliability of the hardware under heavy load. Hybrid OpenCL GPUs + C++ CPUs is well suited to put the maximum load possible on the system.

== Benchmark Result Validation ==

LuxMark includes a validation of the rendered image by using the same technology used for [http://pdiff.sourceforge.net pdiff] in order to check if the benchmarked result is valid or something has gone wrong. It has also a validation of the scene sources used (i.e. hash of scene files).

== Benchmark Scenes ==

=== Brute force path tracing (OpenCL, C++ and Hybrid) ===

The main LuxMark benchmark is a brute force path tracer (i.e. no cache used).

<div align="center">[[Image:LuxMark-v4-bench1.png|640px]]</div>

=== Path tracing with GI cache (OpenCL, C++ and Hybrid) ===

The second LuxMark benchmark is a path tracer with global illumination cache. This rendering mode slightly simpler than pure brute force and may work better on some GPU.

<div align="center">[[Image:LuxMark-v4-bench2.png|640px]]</div>

=== Bidirectional path tracing with GI cache (C++ only) ===

The last LuxMark benchmark is a bidirectional path tracer with a [https://en.wikipedia.org/wiki/Metropolis%E2%80%93Hastings_algorithm Metropolis–Hastings] sampler. Due to its complexity and the serialize nature of Metropolis, this rendering mode is available only for CPUs.

<div align="center">[[Image:LuxMark-v4-bench3.png|640px]]</div>

== Command line options ==

Usage: ./bin/luxmark [options]
--help (display this help and exit)
--scene=FOOD|HALLBENCH|WALLPAPER (select the scene to use)
--mode=BENCHMARK_OCL_GPU|BENCHMARK_OCL_CPUGPU|BENCHMARK_OCL_CPU|BENCHMARK_OCL_CUSTOM|BENCHMARK_HYBRID|BENCHMARK_HYBRID_CUSTOM|BENCHMARK_NATIVE|STRESSTEST_OCL_GPU|STRESSTEST_OCL_CPUGPU|STRESSTEST_OCL_CPU|STRESSTEST_HYBRID|STRESSTEST_NATIVE|DEMO_LUXCOREUI|PAUSE (select the mode to use)
--devices=<a string of 1 or 0 to enable/disable each OpenCL device in CUSTOM modes>
--single-run (run the benchmark, print the result to the stdout and exit)
--ext-info (print scene and image verification too with --single-run)

== Binaries ==

- Windows 64bit: https://github.com/LuxCoreRender/LuxMark/releases/download/luxmark_v4.0alpha0/luxmark-v4.0alpha0-win64.zip ('''Note: you have to install the [https://aka.ms/vs/15/release/vc_redist.x64.exe Microsoft Visual C++ Redistributable for Visual Studio 2017].)

- Linux 64bit: https://github.com/LuxCoreRender/LuxMark/releases/download/luxmark_v4.0alpha0/luxmark-v4.0alpha0-linux64.tar.bz2 ('''Note: You have to install Qt5 from your distribution in order to run the Linux executable''')

== Compile from sources ==

Some note to compile LuxMark:

- the sources are available here: https://github.com/LuxCoreRender/LuxMark (tag: luxmark_v3.1)

- LuxMark can be compiled exactly like LuxCoreRender. It has exactly the same dependencies (i.e. LuxCore, LuxRays, etc.). The procedure described in [https://github.com/LuxCoreRender/WindowsCompile|Windows repository] and [https://github.com/LuxCoreRender/LinuxCompile|Linux repository] can be used to compile LuxMark too.

- the complete scenes directory is available here: https://github.com/LuxCoreRender/LuxMark/releases/download/luxmark_v4.0alpha0/scenes.tgz

LuxMark v4

2019-10-08T09:28:23Z

Dade:

= LuxMark v4.x =

LuxMark is a OpenCL cross-platform benchmark tool and has become, over past years, one of the most used (if not the most used) OpenCL benchmark. It is intended as a promotional tool for [http://www.luxcorerender.org LuxCoreRender] and it is now based on [[LuxCore_API | LuxCore API]], the LuxCoreRender v2.x C++ or Python API available under Apache Licence v2.0 and freely usable in open source and commercial applications.

== Render engines ==

This release is based on [https://github.com/LuxCoreRender/LuxCore/releases/tag/luxcorerender_v2.2 LuxCoreRender v2.2] and includes benchmarks with the following rendering engines:

* A micro-kernel based OpenCL path tracer with/without Global Illumination cache;
* A C++ path tracer with/without Global Illumination cache;
* An hybrid OpenCL for GPUs and C++ for CPUs path tracer with/without Global Illumination cache;
* A C++ Bidirectional path tracer with a [https://en.wikipedia.org/wiki/Metropolis%E2%80%93Hastings_algorithm Metropolis–Hastings] sampler;

== Denoiser ==

LuxMark includes [https://github.com/OpenImageDenoise/oidn Intel OpenImageDenoise]. A comparison between raw and denoised image is shown at the end of the benchmark or during the stress test. However Intel OpenImageDenoise is a CPU-only task and '''it is not part of the benchmark result'''.

<div align="center">[[Image:LuxMark-v4-denoise.jpg|640px]]</div>

== Stress mode ==

Aside from benchmarking modes, it is also available a stress mode to check the reliability of the hardware under heavy load. Hybrid OpenCL GPUs + C++ CPUs is well suited to put the maximum load possible on the system.

== Benchmark Result Validation ==

LuxMark includes a validation of the rendered image by using the same technology used for [http://pdiff.sourceforge.net pdiff] in order to check if the benchmarked result is valid or something has gone wrong. It has also a validation of the scene sources used (i.e. hash of scene files).

== Benchmark Scenes ==

=== Brute force path tracing (OpenCL, C++ and Hybrid) ===

The main LuxMark benchmark is a brute force path tracer (i.e. no cache used).

<div align="center">[[Image:LuxMark-v4-bench1.png|640px]]</div>

=== Path tracing with GI cache (OpenCL, C++ and Hybrid) ===

The second LuxMark benchmark is a path tracer with global illumination cache. This rendering mode slightly simpler than pure brute force and may work better on some GPU.

<div align="center">[[Image:LuxMark-v4-bench2.png|640px]]</div>

=== Bidirectional path tracing with GI cache (C++ only) ===

The last LuxMark benchmark is a bidirectional path tracer with a [https://en.wikipedia.org/wiki/Metropolis%E2%80%93Hastings_algorithm Metropolis–Hastings] sampler. Due to its complexity and the serialize nature of Metropolis, this rendering mode is available only for CPUs.

<div align="center">[[Image:LuxMark-v4-bench3.png|640px]]</div>

== Command line options ==

Usage: ./bin/luxmark [options]
--help (display this help and exit)
--scene=FOOD|HALLBENCH|WALLPAPER (select the scene to use)
--mode=BENCHMARK_OCL_GPU|BENCHMARK_OCL_CPUGPU|BENCHMARK_OCL_CPU|BENCHMARK_OCL_CUSTOM|BENCHMARK_HYBRID|BENCHMARK_HYBRID_CUSTOM|BENCHMARK_NATIVE|STRESSTEST_OCL_GPU|STRESSTEST_OCL_CPUGPU|STRESSTEST_OCL_CPU|STRESSTEST_HYBRID|STRESSTEST_NATIVE|DEMO_LUXCOREUI|PAUSE (select the mode to use)
--devices=<a string of 1 or 0 to enable/disable each OpenCL device in CUSTOM modes>
--single-run (run the benchmark, print the result to the stdout and exit)
--ext-info (print scene and image verification too with --single-run)

== Binaries ==

- Windows 64bit: https://github.com/LuxCoreRender/LuxMark/releases/download/luxmark_v3.1/luxmark-windows64-v3.1.zip (note: you may have to install VisualStudio 2013 C++ runtime => https://www.microsoft.com/en-US/download/details.aspx?id=40784)

- Linux 64bit: https://github.com/LuxCoreRender/LuxMark/releases/download/luxmark_v3.1/luxmark-linux64-v3.1.tar.bz2

== Compile from sources ==

Some note to compile LuxMark:

- the sources are available here: https://github.com/LuxCoreRender/LuxMark (tag: luxmark_v3.1)

- LuxMark can be compiled exactly like LuxCoreRender. It has exactly the same dependencies (i.e. LuxCore, LuxRays, etc.). The procedure described in [https://github.com/LuxCoreRender/WindowsCompile|Windows repository] and [https://github.com/LuxCoreRender/LinuxCompile|Linux repository] can be used to compile LuxMark too.

- the complete scenes directory is available here: https://github.com/LuxCoreRender/LuxMark/releases/download/luxmark_v4.0alpha0/scenes.tgz

File:LuxMark-v4-bench3.png

2019-10-08T09:26:16Z

Dade:

LuxMark v4

2019-10-08T09:22:34Z

Dade:

= LuxMark v4.x =

LuxMark is a OpenCL cross-platform benchmark tool and has become, over past years, one of the most used (if not the most used) OpenCL benchmark. It is intended as a promotional tool for [http://www.luxcorerender.org LuxCoreRender] and it is now based on [[LuxCore_API | LuxCore API]], the LuxCoreRender v2.x C++ or Python API available under Apache Licence v2.0 and freely usable in open source and commercial applications.

== Render engines ==

This release is based on [https://github.com/LuxCoreRender/LuxCore/releases/tag/luxcorerender_v2.2 LuxCoreRender v2.2] and includes benchmarks with the following rendering engines:

* A micro-kernel based OpenCL path tracer with/without Global Illumination cache;
* A C++ path tracer with/without Global Illumination cache;
* An hybrid OpenCL for GPUs and C++ for CPUs path tracer with/without Global Illumination cache;
* A C++ Bidirectional path tracer;

== Denoiser ==

LuxMark includes [https://github.com/OpenImageDenoise/oidn Intel OpenImageDenoise]. A comparison between raw and denoised image is shown at the end of the benchmark or during the stress test. However Intel OpenImageDenoise is a CPU-only task and '''it is not part of the benchmark result'''.

<div align="center">[[Image:LuxMark-v4-denoise.jpg|640px]]</div>

== Stress mode ==

Aside from benchmarking modes, it is also available a stress mode to check the reliability of the hardware under heavy load. Hybrid OpenCL GPUs + C++ CPUs is well suited to put the maximum load possible on the system.

== Benchmark Result Validation ==

LuxMark includes a validation of the rendered image by using the same technology used for [http://pdiff.sourceforge.net pdiff] in order to check if the benchmarked result is valid or something has gone wrong. It has also a validation of the scene sources used (i.e. hash of scene files).

== Benchmark Scenes ==

=== Brute force path tracing (OpenCL, C++ and Hybrid) ===

The main LuxMark benchmark is a brute force path tracer (i.e. no cache used).

<div align="center">[[Image:LuxMark-v4-bench1.png|640px]]</div>

=== Path tracing with GI cache (OpenCL, C++ and Hybrid) ===

The second LuxMark benchmark is a path tracer with global illumination cache. this rendering mode slightly simpler than pure brute force and may work better on some GPU.

<div align="center">[[Image:LuxMark-v4-bench2.png|640px]]</div>

== Command line options ==

Usage: luxmark [options]
--help (display this help and exit)
--scene=LUXBALL_HDR|MICROPHONE|HOTEL (select the scene to use)
--mode=BENCHMARK_OCL_GPU|BENCHMARK_OCL_CPUGPU|BENCHMARK_OCL_CPU|BENCHMARK_NATIVE|STRESSTEST_OCL_GPU|
STRESSTEST_OCL_CPUGPU|STRESSTEST_OCL_CPU|DEMO_LUXVR|PAUSE (select the mode to use)
--single-run (run the benchmark, print the result to the stdout and exit)
--ext-info (print scene and image verification too with --single-run)

== Binaries ==

- Windows 64bit: https://github.com/LuxCoreRender/LuxMark/releases/download/luxmark_v3.1/luxmark-windows64-v3.1.zip (note: you may have to install VisualStudio 2013 C++ runtime => https://www.microsoft.com/en-US/download/details.aspx?id=40784)

- MacOS 64bit: https://github.com/LuxCoreRender/LuxMark/releases/download/luxmark_v3.1/luxmark-macos64-v3.1.zip

- Linux 64bit: https://github.com/LuxCoreRender/LuxMark/releases/download/luxmark_v3.1/luxmark-linux64-v3.1.tar.bz2

== Compile from sources ==

Some note to compile LuxMark:

- the sources are available here: https://github.com/LuxCoreRender/LuxMark (tag: luxmark_v3.1)

- LuxMark can be compiled exactly like LuxCoreRender. It has exactly the same dependencies (i.e. LuxCore, LuxRays, etc.). The procedure described in [https://github.com/LuxCoreRender/WindowsCompile|Windows repository] and [https://github.com/LuxCoreRender/LinuxCompile|Linux repository] can be used to compile LuxMark too.

- the complete scenes directory is available here: https://github.com/LuxCoreRender/LuxMark/releases/download/luxmark_v4.0alpha0/scenes.tgz

File:LuxMark-v4-bench2.png

2019-10-08T09:21:45Z

Dade:

File:LuxMark-v4-bench1.png

2019-10-08T09:17:27Z

Dade:

File:LuxMark-v4-denoise.jpg

2019-10-08T09:13:25Z

Dade:

LuxMark v4

2019-10-08T09:04:28Z

Dade: Created page with "= LuxMark v4.x = LuxMark is a OpenCL cross-platform benchmark tool and has become, over past years, one of the most used (if not the most used) OpenCL benchmark. It is intend..."

= LuxMark v4.x =

LuxMark is a OpenCL cross-platform benchmark tool and has become, over past years, one of the most used (if not the most used) OpenCL benchmark. It is intended as a promotional tool for [http://www.luxcorerender.org LuxCoreRender] and it is now based on [[LuxCore_API | LuxCore API]], the LuxCoreRender v2.x C++ or Python API available under Apache Licence v2.0 and freely usable in open source and commercial applications.

== Render engines ==

This release is based on [https://github.com/LuxCoreRender/LuxCore/releases/tag/luxcorerender_v2.2|LuxCoreRender v2.2] and includes benchmarks with the following rendering engines:

* A micro-kernel based OpenCL path tracer with/without Global Illumination cache;
* A C++ path tracer with/without Global Illumination cache;
* An hybrid OpenCL for GPUs and C++ for CPUs path tracer with/without Global Illumination cache;
* A C++ Bidirectional path tracer;

== Denoiser ==

LuxMark includes [https://github.com/OpenImageDenoise/oidn|Intel OpenImageDenoise]. A comparison between raw and denoised image is shown at the end of the benchmark or during the stress test. However Intel OpenImageDenoise is a CPU-only task and '''it is not part of the benchmark result'''.

== Stress mode ==

Aside from benchmarking modes, it is also available a stress mode to check the reliability of the hardware under heavy load. Hybrid OpenCL GPUs + C++ CPUs is well suited to put the maximum load possible on the system.

== Benchmark Result Validation ==

LuxMark includes a validation of the rendered image by using the same technology used for [http://pdiff.sourceforge.net pdiff] in order to check if the benchmarked result is valid or something has gone wrong. It has also a validation of the scene sources used (i.e. hash of scene files).

== Benchmark Scenes ==

3 brand new scenes are included. The simple benchmark is the usual ''"LuxBall HDR"'' (217K triangles):

<div align="center">[[Image:Luxmark01.jpg|640px]]</div>

The medium scene is the ''"Neumann TLM-102 Special Edition (with EA-4 shock mount)"'' (1769K traingles) designed by Vlad "SATtva" Miller (http://vladmiller.info/blog/index.php?comment=308):

<div align="center">[[Image:Luxmark02.jpg|640px]]</div>

The complex scene is the ''"Hotel Lobby"'' (4973K) designed by Peter "Piita" Sandbacka:

<div align="center">[[Image:Luxmark03.jpg|640px]]</div>

== Command line options ==

Usage: luxmark [options]
--help (display this help and exit)
--scene=LUXBALL_HDR|MICROPHONE|HOTEL (select the scene to use)
--mode=BENCHMARK_OCL_GPU|BENCHMARK_OCL_CPUGPU|BENCHMARK_OCL_CPU|BENCHMARK_NATIVE|STRESSTEST_OCL_GPU|
STRESSTEST_OCL_CPUGPU|STRESSTEST_OCL_CPU|DEMO_LUXVR|PAUSE (select the mode to use)
--single-run (run the benchmark, print the result to the stdout and exit)
--ext-info (print scene and image verification too with --single-run)

== Binaries ==

- Windows 64bit: https://github.com/LuxCoreRender/LuxMark/releases/download/luxmark_v3.1/luxmark-windows64-v3.1.zip (note: you may have to install VisualStudio 2013 C++ runtime => https://www.microsoft.com/en-US/download/details.aspx?id=40784)

- MacOS 64bit: https://github.com/LuxCoreRender/LuxMark/releases/download/luxmark_v3.1/luxmark-macos64-v3.1.zip

- Linux 64bit: https://github.com/LuxCoreRender/LuxMark/releases/download/luxmark_v3.1/luxmark-linux64-v3.1.tar.bz2

== Compile from sources ==

Some note to compile LuxMark:

- the sources are available here: https://github.com/LuxCoreRender/LuxMark (tag: luxmark_v3.1)

- LuxMark can be compiled exactly like LuxCoreRender. It has exactly the same dependencies (i.e. LuxCore, LuxRays, etc.). The procedure described in [https://github.com/LuxCoreRender/WindowsCompile|Windows repository] and [https://github.com/LuxCoreRender/LinuxCompile|Linux repository] can be used to compile LuxMark too.

- the complete scenes directory is available here: https://github.com/LuxCoreRender/LuxMark/releases/download/luxmark_v4.0alpha0/scenes.tgz

LuxMark

2019-10-08T08:43:55Z

Dade:

Versions:

* [[LuxMark_v4|v4.x (under development)]]
* [[LuxMark_v3|v3.x]]
* [[LuxMark_v2|v2.x]]

LuxMark

2019-10-07T09:48:39Z

Dade: Replaced content with "Versions: * v3.x * v2.x"

Versions:

* [[LuxMark_v3|v3.x]]
* [[LuxMark_v2|v2.x]]

LuxMark v3

2019-10-07T09:46:25Z

Dade: Created page with "= LuxMark v3.x = LuxMark is a OpenCL cross-platform benchmark tool and has become, over past years, one of the most used (if not the most used) OpenCL benchmark. It is intend..."

= LuxMark v3.x =

LuxMark is a OpenCL cross-platform benchmark tool and has become, over past years, one of the most used (if not the most used) OpenCL benchmark. It is intended as a promotional tool for [http://www.luxcorerender.org LuxCoreRender] and it is now based on [[LuxCore_API | LuxCore API]], the LuxCoreRender v2.x C++ or Python API available under Apache Licence v2.0 and freely usable in open source and commercial applications.

== OpenCL render engine ==

A brand new micro-kernel based OpenCL path tracer is used as rendering mode for the benchmark.

== C++ render engine ==

This release includes the come back of a benchmarking mode not requiring OpenCL (i.e. a render engine written only in C++ like in LuxMark v1.x). Ray intersection C++ code uses state-of-the-art Intel [https://embree.github.io Embree].

== Stress mode ==

Aside from benchmarking modes, it is also available a stress mode to check the reliability of the hardware under heavy load.

== Benchmark Result Validation ==

LuxMark now includes a validation of the rendered image by using the same technology used for [http://pdiff.sourceforge.net pdiff] in order to check if the benchmarked result is valid or something has gone wrong. It has also a validation of the scene sources used (i.e. hash of scene files). While it will still possible to submit fake results to the LuxMark result database, it will make this task harder.

== LuxVR ==

[http://youtu.be/JrvyjqYX6o8 LuxVR] is included as demo too and replaces the old "Interactive" LuxMark mode.

== A brand new web site ==

There is now a brand new web site dedicated to LuxMark result: http://www.luxmark.org. It includes many new features compared the old results database.

== Benchmark Scenes ==

3 brand new scenes are included. The simple benchmark is the usual ''"LuxBall HDR"'' (217K triangles):

<div align="center">[[Image:Luxmark01.jpg|640px]]</div>

The medium scene is the ''"Neumann TLM-102 Special Edition (with EA-4 shock mount)"'' (1769K traingles) designed by Vlad "SATtva" Miller (http://vladmiller.info/blog/index.php?comment=308):

<div align="center">[[Image:Luxmark02.jpg|640px]]</div>

The complex scene is the ''"Hotel Lobby"'' (4973K) designed by Peter "Piita" Sandbacka:

<div align="center">[[Image:Luxmark03.jpg|640px]]</div>

== Command line options ==

Usage: luxmark [options]
--help (display this help and exit)
--scene=LUXBALL_HDR|MICROPHONE|HOTEL (select the scene to use)
--mode=BENCHMARK_OCL_GPU|BENCHMARK_OCL_CPUGPU|BENCHMARK_OCL_CPU|BENCHMARK_NATIVE|STRESSTEST_OCL_GPU|
STRESSTEST_OCL_CPUGPU|STRESSTEST_OCL_CPU|DEMO_LUXVR|PAUSE (select the mode to use)
--single-run (run the benchmark, print the result to the stdout and exit)
--ext-info (print scene and image verification too with --single-run)

== What is new in v3.1 ? ==

- The new LuxRender v1.5 render engine. Among other features, it includes some OpenCL optimization suggested by NVIDIA to LuxRender project. Because of the general score improvements in v3.1, it is not fair to compare LuxMark v3.0 results with LuxMark v3.1;

- OpenCL "overclocking" (OpenCL C compiler options: -cl-fast-relaxed-math -cl-mad-enable -cl-no-signed-zeros);

- a new "OpenCL Compiler Options" menu in order to allow the user to enable/disable single compiler options. By default, the following options are enabled: "-cl-fast-relaxed-math -cl-mad-enable -cl-no-signed-zeros". "-cl-strict-aliasing" is not enabled by default because Intel compiler is broken and it doesn't support this standard option.

- a new command line --ext-info option (http://www.luxrender.net/forum/viewtopic.php?f=8&t=12278#p115645);

- a fix for OpenCL device with weird names (http://www.luxrender.net/forum/viewtopic.php?f=34&t=11585&start=50#p115646);

== Binaries ==

- Windows 64bit: https://github.com/LuxCoreRender/LuxMark/releases/download/luxmark_v3.1/luxmark-windows64-v3.1.zip (note: you may have to install VisualStudio 2013 C++ runtime => https://www.microsoft.com/en-US/download/details.aspx?id=40784)

- MacOS 64bit: https://github.com/LuxCoreRender/LuxMark/releases/download/luxmark_v3.1/luxmark-macos64-v3.1.zip

- Linux 64bit: https://github.com/LuxCoreRender/LuxMark/releases/download/luxmark_v3.1/luxmark-linux64-v3.1.tar.bz2

== Compile from sources ==

Some note to compile LuxMark:

- the sources are available here: https://github.com/LuxCoreRender/LuxMark (tag: luxmark_v3.1)

- LuxMark can be compiled exactly like LuxCoreRender. It has exactly the same dependencies (i.e. LuxCore, LuxRays, etc.)

- it requires LuxRays be compiled (tag: luxmark_v3.1)

- the complete scenes directory is available here: https://github.com/LuxCoreRender/LuxMark/releases/download/luxmark_v3.1/scenes-v3.1.zip

= LuxMark v3.0 =

- Windows 64bit: https://github.com/LuxCoreRender/LuxMark/releases/download/luxmark_v3.0/luxmark-windows64-v3.0.3.zip (note: you may have to install VisualStudio 2013 C++ runtime => https://www.microsoft.com/en-US/download/details.aspx?id=40784)

LuxCoreRender Release Notes v2.0

2019-10-04T08:08:25Z

Dade: Removed links to old forums

New features:

* LuxCoreUI: new image view tool
* RTPATHCPU: new CPU rendering engine with fast scene editing support
* Mist image pipeline plugin
* Environment camera
* Embree accelerated BVH building for OpenCL too
* Reduced the number of times OpenCL kernel re-compilation is triggered
* New BIASPATHOCL with OpenCL micro-kernels
* Better support for light sources defined by many triangles
* Save/resume rendering
* New convergence test code
* Render engine unification (TILEPATH replaces BIASPATH, etc.)
* Abstract API
* Binary SDK
* Area lights with variable directional light
* Embree [https://github.com/Dade916/embree custom version] integrated back in the main Intel project. Using again standard Embree. Updated to the latest version.
* Added the support for saving all scene information in a single binary file
* Added the support for saving all render configuration information in a single binary file
* All LuxCore objects now keep the original names used in LuxCore SDL (visible when using FILESAVER engine for instance)
* Can now save and resume the rendering from a single file (a binary file with RenderConfig+Scene+RenderState+Film information)
* TILEPATH tiles initialization is now done using multi-threading
* Now .bpy serialized mesh file can be used in any place where it was only possible to use a .ply file
* Changed the default min. epsilon from 1e-9f to 1e-5f
* Python unit test now automatically run at any commit thanks to [https://travis-ci.org travis-ci.org]
* [https://forums.luxcorerender.org/viewtopic.php?f=6&t=19#p319 Added the support for glass dispersion]
* [https://github.com/LuxCoreRender/LuxCore/issues/24 Added the support for image map wrapping modes]
* [https://forums.luxcorerender.org/viewtopic.php?f=5&t=19&p=336#p336 Added the support for glass dispersion]
* [https://github.com/LuxCoreRender/LuxCore/issues/33 Added the support for dynamic edit of halt rendering conditions]
* [https://github.com/LuxCoreRender/LuxCore/issues/32 Added the support for periodic save and "safe save" for Film outputs]
* [https://github.com/LuxCoreRender/LuxCore/issues/32 Added the support for periodic save and "safe save" for Film file]
* [https://github.com/LuxCoreRender/LuxCore/issues/32 Added the support for periodic save and "safe save" for resume rendering file]
* Added the pyluxcoreconsole tool
* Added the pyluxcoremerge tool
* [https://forums.luxcorerender.org/viewtopic.php?f=5&t=32#p508 Added a fast path for duplicating many objects]. Mostly useful for particles.
* [https://forums.luxcorerender.org/viewtopic.php?f=2&t=45&p=605#p604 Improved glass and archglass sampling strategy]
* Added the support for Embree multi-segments motion blur
* [https://forums.luxcorerender.org/viewtopic.php?f=5&t=62 New RANDOM and SOBOL samplers to avoid regolar patterns in the early rendering stages]
* [https://forums.luxcorerender.org/viewtopic.php?f=5&t=62 New TILEPATHSAMPLER base on Sobol sequence (was plain random before)]
* Added the support for scene.camera.volume and scene.camera.autovolume.enable properties
* Added the support for new SAMPLECOUNT and CONVERGENCE AOVs
* [https://forums.luxcorerender.org/viewtopic.php?p=1189#p1184 Added the support for convergence based adaptive sampling to RANDOM and SOBOL samplers]
* [https://forums.luxcorerender.org/viewtopic.php?f=5&t=93 Visibility driven sampling of env. light sources (aka portals without portals)]
* [https://forums.luxcorerender.org/viewtopic.php?f=5&t=100 OpenCL/C++ hybrid rendering]
* [https://forums.luxcorerender.org/viewtopic.php?f=5&t=112 Camera invisible objects]
* [https://forums.luxcorerender.org/viewtopic.php?f=5&t=110 LuxCoreRender is now available as Python Wheel]
* [https://forums.luxcorerender.org/viewtopic.php?f=4&t=102#p1873 Added the support for rotations to UVmapping2D]
* [https://forums.luxcorerender.org/viewtopic.php?f=5&t=145 Added the support for Sphere and MapSphere light source]
* [https://forums.luxcorerender.org/viewtopic.php?f=5&t=16&start=30#p2407 New heterogeneous volume rendering code]
* [https://forums.luxcorerender.org/viewforum.php?f=5 Variance Clamping support in BIDIRCPU]

Fixed bugs:

* Fixed a bug in Glossy2 material (Fresnel reflection related code)
* Fixed NaNs in Metal2 material
* Fixed NaNs in Scale texture bump mapping code
* Fixed a bug when saving light sources defined with an old deprecated syntax
* Fixed a memory leak in convergence test
* Fixed a problem in the computation of scene bounding sphere triggering wrong rendering with infinite lights and large scenes
* [https://github.com/LuxCoreRender/LuxCore/issues/11 Fixed PATHOCL+METROPOLIS output difference with PATHOCL+RANDOM/SOBOL]

Known problems:

* [https://github.com/LuxCoreRender/LuxCore/issues/103 LuxCore API requires latin locale]
* [https://github.com/LuxCoreRender/LuxCore/issues/2 accelerator.bvh.builder.type = EMBREE_MORTON doesn't work with the latest Embree]
* [https://github.com/LuxCoreRender/LuxCore/issues/29 Python crashes when calling sys.exit()]

LuxCoreRender Release Notes v2.3

2019-10-01T10:31:13Z

Dade:

=LuxCore=

===New Features===

* Path space regularization can now be used to render SDS paths with hybrid backward/forward path tracing
* LuxCoreUI now shows eye and light pass counters if light tracing is enabled
* FILESAVER now expands inline exported constant texture values
* PhotonGI caustic scene re-factored to work with Vertex Merging (i.e. SPPM in this case)
* It is now possible to use light tracing for normal caustics and PhotonGI cache for SDS paths

===Fixed Bugs===

* None

=Blender Addon (BlendLuxCore)=

===New features===

===Fixed Bugs===

===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]
* 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.

LuxCore SDL Reference Manual v2.3

2019-09-30T10:22:46Z

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" or "LOG_POWER" || 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.

==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", "QBVH", "MQBVH", "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 || ? || ?
|}

===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.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.
|-
|}

=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
|}

===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.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)
|}

===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: 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]
|}

===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
|}

===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
|}

==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

2019-09-30T10:22:25Z

Dade:

Reference manual for:

* [[LuxCore_SDL_Reference_Manual_v2.3|v2.3 (under development)]]
* [[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 Release Notes v2.3

2019-09-30T09:44:32Z

Dade: Created page with "=LuxCore= ===New Features=== * Path space regularization can now be used to render SDS paths with hybrid backward/forward path tracing * LuxCoreUI now shows eye and light pa..."

=LuxCore=

===New Features===

* Path space regularization can now be used to render SDS paths with hybrid backward/forward path tracing
* LuxCoreUI now shows eye and light pass counters if light tracing is enabled
* FILESAVER now expands inline exported constant texture values
* PhotonGI caustic scene re-factored to work with Vertex Merging (i.e. SPPM in this case)
* It is now possible to use light tracing for normal caustics and PhotonGI cache for SDS paths

===Fixed Bugs===

* None

=Blender Addon (BlendLuxCore)=

===New features===

===Fixed Bugs===

===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]
* [https://github.com/LuxCoreRender/BlendLuxCore/issues/148 Blender crashes when Ctrl+C is pressed to copy an object with a material]
* 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.2

2019-09-30T09:39:37Z

Dade: /* LuxCore */

=LuxCore=

===New Features===

* [https://forums.luxcorerender.org/viewtopic.php?f=5&t=840 PhotonGI cache]
* Added ALBEDO AOV
* Added to BiDir the support for shading normal, geometry normal, position, material ID, UV, object ID, material ID color and Albedo AOVs
* Added AVG_SHADING_NORMAL AOV
* [https://forums.luxcorerender.org/viewtopic.php?f=5&t=872 Integrated Intel Open Image Denoiser (Oidn)]

''Alpha0 released''

* Added a new way to blend brute force path tracing and cache in PhotonGI. Cache is now used more often on glossy surfaces
* Introduced a new PhotonGI debug mode to show the mix between brute force and cached paths
* Added the support for automatic PhotonGI indirect cache best radius estimation
* Added the support for automatic PhotonGI indirect cache size by using convergence error estimation
* [https://forums.luxcorerender.org/viewtopic.php?f=5&t=984 Front and back material transparency (aka light invisible object)]
* Added PhotonGI support for volumes cache entries
* LXS parser now supports instance definitions
* Added the support for new "directx2opengl_normalmap" image map channel selection
* Added new textures: Power, Less Than, Greater Than, Dot Product, Position, Shading Normal

''Alpha1 released''

* Saving/resuming the rendering now includes all PhotonGI cache information and entries
* Added the support for new shape "group"
* Added the support for nested groups to LXS parser
* Added the support for persistent PhotonGI cache on file
* Added the support for using persistent PhotonGI cache across multiple frames for fly-through animations
* DLSC now automatically estimated the best radius if lightstrategy.entry.radius is set to 0.0
* New improved Random/Sobol sampler adaptive code
* LXS parser now supports halttime and haltspp film halt conditions
* LXS parser now supports volumes
* Shadow catcher is now easier to use with multiple light sources of any type

''Beta1 released''

* Added the support for tiled denoising to save a huge amount of ram
* Added the support for new visual map cache for infinitelight, constantinfinite and sky2 light sources
* Added the support for new Disney BRDF material from Siggraph 2012 paper
* Upgraded Intel Oidn to v0.9.0
* Metal material uses a more accurate Albedo value (for Intel OIDN)
* Added "rounding" texture
* Added "modulo" texture
* Improved tiling feature of OIDN imagepipeline plugin
* Fix a bug in ToProperties code of "blender blend" texture when "halo" progression type was used

''Beta2 released''
* Added the support for periodic PhotonGI caustic cache update (aka SPPM without radius reduction)
* PathTracer class now support eye and light path tracing. LIGHTCPU now uses PathTracer class too.
* Added Hybrid Back/Forward path tracing support
* Added the support for glossy caustics rendering to Hybrid Back/Forward
* Reworked the support for new visibility map cache for infinitelight, constantinfinite and sky2 light sources
* Transparent light sources are now rendered with the correct intensity
* New env. visibility map cache now supports persistent cache on file

''Beta3 released''

* Improved shading with interpolated normals
* Added the support for Shadow Terminator avoidance factor when using bump mapping
* Upgraded Intel Oidn to v1.0
* Reworked Direct Light Sampling Cache
* Direct Light Sampling Cache now supports persistent cache on file

''Beta4 released''

''RC1 released''

* Disney material glossiness is now computed as the square root of the previous value to match Glossy2/Metal roughness

===Fixed Bugs===

* Fixed rendering resume feature

''Alpha0 released''

* Fixed a problem with infinite lights and BiDir or PhotonGI
* Fixed a bug when using radiance groups with variance clamping and OpenCL
* Fixed camera invisible objects usage with volumes
* Fixed TASK_EMIT of LightStrategyPower
* Fixed a crash when using RTPATHOCL and editing area lights (issue #173)
* Fixed a bug when using radiance groups with variance clamping and OpenCL

''Alpha1 released''

* Fixed a crash when using negative material emission values (issue #177)
* Fixed LXS parsing in pyluxcoretools
* Fixed a problem when mixing transparent and solid materials with Mix (issue #183)
* Fix a bug when using glossy coating with any specular material
* Fixed LXS parsing of point light source position
* Fixed object ID not being saved by FILESAVER engine
* Fixed a major bug in carpaint material (issue #186)
* Fixed spelling mistake in cloth material "wool gabardine" preset
* Fixed Scene::RemoveUnusedMeshes()
* Fixed a bug in Mix material when working with specular materials (issue #187)
* Fixed an overflow problem when using an heterogenous volume on very large segments
* Sun relative size has now a lower bound of 1.0 to avoid numerical precision problems
* Fixed a problem with Scene::ToProperties() after editing a scene
* Fixed a self-shadow problem with area light sources

''Beta1 released''

* Fix ToProperties() of mapspherelight and spherelight
* Fixed a problem with caustic cache size when both PhotonGI caches were enabled and automatic stop condition for indirect cache was used
* PhotonGI Metropolis will now focus on caustic cache when indirect is done (and vice versa)
* Fixed the access to an uninitialized variable when using PhotonGI caustic cache alone
* Fixed the access to an uninitialized variable in ProjectionLight::Preprocess()
* Fixed a crash when trying to render a scene without light sources with PATHOCL (issue #202)
* Fixed DLSC to work with Front and back material transparency (aka light invisible object)
* Fixed a problem in BIDIRCPU with camera PDF
* Fixed a bug in Mix material transparency support (issue #210)
* Added a workaround to an AMD OpenCL compiler bug in DirectLight_BSDFSampling()

''Beta2 released''

* Fixed a problem in the random number generator of PhotonGI
* Fixed wrong theta being saved in ToProperties() of distant light
* Fixed a compilation error in RoughMatte OpenCL code (issue #218)
* Fixed a problem with Disney material specular tint
* Fixed a TILEPATH bug causing black renderings
* Fixed BIDIRCPU and LIGHTCPU camera motion blur
* Fixed a bug related to initial camera volume in PATHOCL
* Fixed light tracing camera motion blur and arbitrary clipping plane support
* Fixed a bug in the OpenCL code of the splitfloat3 texture
* Fixed normal mapping
* Fixed a problem when saving ALBEDO AOV
* Fixed RoughGlass event types returned by material evaluation
* Evaluated best radius in PhotonGI, ELVC and DLSC is not affected any more by border rendering
* Fixed a crash when resuming scene rendering without PhotonGI enabled
* Fixed a NaNs problem when using area lights with zero area
* Fixed the export of material emission.directlightsampling.type property

''Beta3 released''

* Solved a self-shadow problem on edges with interpolated normals
* UV scale doesn't affect anymore bump map strength
* Fixed an out of bound memory access in automatic lookup radius code
* Fixed a problem with Disney material, hybrid backward/forward path tracing and low roughness values
* Fixed bump mapping black halo for large scale values

''Beta4 released''

* Fixed the allocation of light tracing sampler shared data in hybrid backward/forward path tracing
* Fixed a problem when using flat instances and OpenCL rendering
* Fixed/Enabled PhotonGI cache on Mix and GlossyCoatting materials when possible
* Fixed a regression in BIDIRCPU causing dark edges on glancing surfaces
* Fixed a crash when PhotonGI caustic cache is enabled but empty (issue #236)

''RC1 released''

* Removed a workaround for Glossy roughness values < sqrt(.0001) for AMD OpenCL driver
* Fixed the shift of one pixel on light tracing pass of LIGHTCPU, BIDIRCPU and Hybrid Path (issue #237)
* Fixed a crash when re-defining light source (from constantinfinite to infinite) (issue #238)
* Fixed pyluxcoretool CLI not working without pyside (issue #131)
* Fixed a problem with the fix of the issue #237 (issue #239)

===Known Problems===

* [https://github.com/LuxCoreRender/LuxCore/issues/103 LuxCore API requires latin locale]
* [https://github.com/LuxCoreRender/LuxCore/issues/2 accelerator.bvh.builder.type = EMBREE_MORTON doesn't work with the latest Embree]
* [https://github.com/LuxCoreRender/LuxCore/issues/29 Python crashes when calling sys.exit()]
* [https://github.com/LuxCoreRender/LuxCore/issues/124 TILEPATHOCL (and RTPATHOCL) count the layers of transparent surfaces as an iteration of the rendering finite state machine so they requires to increase the max. path depth to avoid black regions.]

=Blender Addon (BlendLuxCore)=

===New features===

* Support for new PhotonGI cache
* Support for Intel OIDN denoiser
* OIDN denoises the viewport once it pauses (enabled by default, pause after 10 seconds by default)

''Alpha0 released''

* Show number of users in material UI
* Add support for normal map orientation setting (opengl or directx)
* Add a new front/back opacity node (material category) to control opacity on both sides of a face separately
* Hitpoint Info node that offers position and shading normal vectors
* Dot Product node
* New math operations:
** Power
** Greater Than
** Less Than

''Alpha1 released''

* Add a Vector Math node
* User can now set a custom object ID
* User can now choose a custom viewport color for materials (used in the OpenGL viewport, optional)
* make volume socket export of material output more generic. This means users can now directly plug volumes into the interior/exterior volume sockets, without the need for a pointer node.
* expose volume nodes in material node tree add menu
* add new "colored glass" node preset with inlined volume for simple glasses with volumetric absorption
* add a filter to the pointer node selection menu (so the user can list only materials, only volumes etc.)
* Expose uvmapping3d (available in the 3D mapping node, can be used to map procedural 3D textures with a UV mapping)
* add a debug option to print config and scene properties (in hidden debug menu, search for "Toggle LuxCore Debug Options" in Blender's operator search)
* expose storage property of background image to allow higher precision if necessary
* show button to select problematic object in error log
* implement a workaround to have "delete and reconnect" functionality in the node editor
* add support for improved adaptive sampling, as well as the new NOISE AOV
* add support for automatic radius estimation of DLSC
* add shadow catcher option to only consider shadows from infinite lights (sky, HDRI, flat background color)

''Beta1 released''

* new texture nodes: split RGB/combine RGB
* exposed new visibility map cache ("automatic portals")
* disable most imagepipeline plugins in viewport when viewport denoising is enabled, to avoid artifacts
* new material: Disney (aka principled shader)
* New math textures:
** Rounding
** Modulo (fmod)
* add support for tiled OIDN denoising to reduce RAM usage

''Beta2 released''

* switch to LuxCore material node tree when a node tree is first created (makes it easier for new users to find the LuxCore node tree)
* disable intel integrated graphics OpenCL devices by default because using them can lead to crashes

===Fixed Bugs===

* Fix Tool panel in blender reporting eye paths and light paths wrong
* Fix Point light size draw function using location without constraints
* Show noise halt threshold settings for Bidir engine
* Fix some bugs in group instance visiblity
* Fix missing srgb/linear conversion in HSV input of constant color node
* Fix volume priority not being exported
* Fix bug: pointiness was not working if the last material slot did not contain a pointiness node
* Improve viewport startup in complex scenes by ignoring materials touched by the export process when evaluating future updates
* Fix viewport denoiser not working without a camera
* Fix auto-updater not copying permission bits (this was a problem only for the OIDN standalone binary, which was not executable for this reason)

''Alpha0 released''

* Fix bug: area light was not removed during viewport render when its layer was made invisible
* BlendLuxCore AOV settings no longer affect Cycles/BI pass settings

''Alpha1 released''

* fix albedo and avg. shading normal AOVs being used in final render when OIDN was only enabled for viewport
* fix area light not being deleted when its type was switched to laser

''Beta1 released''

* fix some bugs in the node editor

''Beta2 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]
* [https://github.com/LuxCoreRender/BlendLuxCore/issues/148 Blender crashes when Ctrl+C is pressed to copy an object with a material]
* 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

2019-09-30T09:37:05Z

Dade:

Release notes for:

* [[LuxCoreRender_Release_Notes_v2.3|v2.3 (under development)]]
* [[LuxCoreRender_Release_Notes_v2.2|v2.2]]
* [[LuxCoreRender_Release_Notes_v2.1|v2.1]]
* [[LuxCoreRender_Release_Notes_v2.0|v2.0]]

LuxCoreRender Tutorials

2019-08-24T13:19:21Z

Dade: /* Video Tutorials */

== Video Tutorials ==

[[File:beginner_tutorial.jpg|thumb|none|300px|link=https://youtu.be/-BmXeUDRqSo| [https://youtu.be/-BmXeUDRqSo Introduction to LuxCoreRender in Blender] ]]

[[File:DLSC_tutorial_thumbnail.jpg|thumb|none|300px|link=https://youtu.be/dIfwr2YPxPw| [https://youtu.be/dIfwr2YPxPw Tutorial about the Direct Light Sampling Cache (DLSC)] ]]

[[File:Sss tutorial thumbnail.jpg|thumb|none|300px|link=https://youtu.be/gEGDyHMnlkg| [https://youtu.be/gEGDyHMnlkg Subsurface Scattering and Volume Tutorial] ]]

[[File:Brushed steel thumbnail.png|thumb|none|300px|link=https://youtu.be/FGhPAP0oV9k| [https://youtu.be/FGhPAP0oV9k Brushed Steel Tutorial ] ]]

[[File:BlendLuxCore-2.8-Interior-Tutorial.png|thumb|none|300px|link=https://youtu.be/XjwCOIWwQo4| [https://youtu.be/XjwCOIWwQo4 BlendLuxCore v2.8 Interior Tutorial ] ]]

== Text Tutorials ==

* [[Denoiser_Strength | Denoiser strength]]

== 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:BlendLuxCore-2.8-Interior-Tutorial.png

2019-08-24T13:18:34Z

Dade: BlendLuxCore 2.8 Interior Tutorial

== Summary ==
BlendLuxCore 2.8 Interior Tutorial

LuxCoreRender Release Notes v2.2

2019-08-07T18:33:31Z

Dade: /* LuxCore */

=LuxCore=

===New Features===

* [https://forums.luxcorerender.org/viewtopic.php?f=5&t=840 PhotonGI cache]
* Added ALBEDO AOV
* Added to BiDir the support for shading normal, geometry normal, position, material ID, UV, object ID, material ID color and Albedo AOVs
* Added AVG_SHADING_NORMAL AOV
* [https://forums.luxcorerender.org/viewtopic.php?f=5&t=872 Integrated Intel Open Image Denoiser (Oidn)]

''Alpha0 released''

* Added a new way to blend brute force path tracing and cache in PhotonGI. Cache is now used more often on glossy surfaces
* Introduced a new PhotonGI debug mode to show the mix between brute force and cached paths
* Added the support for automatic PhotonGI indirect cache best radius estimation
* Added the support for automatic PhotonGI indirect cache size by using convergence error estimation
* [https://forums.luxcorerender.org/viewtopic.php?f=5&t=984 Front and back material transparency (aka light invisible object)]
* Added PhotonGI support for volumes cache entries
* LXS parser now supports instance definitions
* Added the support for new "directx2opengl_normalmap" image map channel selection
* Added new textures: Power, Less Than, Greater Than, Dot Product, Position, Shading Normal

''Alpha1 released''

* Saving/resuming the rendering now includes all PhotonGI cache information and entries
* Added the support for new shape "group"
* Added the support for nested groups to LXS parser
* Added the support for persistent PhotonGI cache on file
* Added the support for using persistent PhotonGI cache across multiple frames for fly-through animations
* DLSC now automatically estimated the best radius if lightstrategy.entry.radius is set to 0.0
* New improved Random/Sobol sampler adaptive code
* LXS parser now supports halttime and haltspp film halt conditions
* LXS parser now supports volumes
* Shadow catcher is now easier to use with multiple light sources of any type

''Beta1 released''

* Added the support for tiled denoising to save a huge amount of ram
* Added the support for new visual map cache for infinitelight, constantinfinite and sky2 light sources
* Added the support for new Disney BRDF material from Siggraph 2012 paper
* Upgraded Intel Oidn to v0.9.0
* Metal material uses a more accurate Albedo value (for Intel OIDN)
* Added "rounding" texture
* Added "modulo" texture
* Improved tiling feature of OIDN imagepipeline plugin
* Fix a bug in ToProperties code of "blender blend" texture when "halo" progression type was used

''Beta2 released''
* Added the support for periodic PhotonGI caustic cache update (aka SPPM without radius reduction)
* PathTracer class now support eye and light path tracing. LIGHTCPU now uses PathTracer class too.
* Added Hybrid Back/Forward path tracing support
* Added the support for glossy caustics rendering to Hybrid Back/Forward
* Reworked the support for new visibility map cache for infinitelight, constantinfinite and sky2 light sources
* Transparent light sources are now rendered with the correct intensity
* New env. visibility map cache now supports persistent cache on file

''Beta3 released''

===Fixed Bugs===

* Fixed rendering resume feature

''Alpha0 released''

* Fixed a problem with infinite lights and BiDir or PhotonGI
* Fixed a bug when using radiance groups with variance clamping and OpenCL
* Fixed camera invisible objects usage with volumes
* Fixed TASK_EMIT of LightStrategyPower
* Fixed a crash when using RTPATHOCL and editing area lights (issue #173)
* Fixed a bug when using radiance groups with variance clamping and OpenCL

''Alpha1 released''

* Fixed a crash when using negative material emission values (issue #177)
* Fixed LXS parsing in pyluxcoretools
* Fixed a problem when mixing transparent and solid materials with Mix (issue #183)
* Fix a bug when using glossy coating with any specular material
* Fixed LXS parsing of point light source position
* Fixed object ID not being saved by FILESAVER engine
* Fixed a major bug in carpaint material (issue #186)
* Fixed spelling mistake in cloth material "wool gabardine" preset
* Fixed Scene::RemoveUnusedMeshes()
* Fixed a bug in Mix material when working with specular materials (issue #187)
* Fixed an overflow problem when using an heterogenous volume on very large segments
* Sun relative size has now a lower bound of 1.0 to avoid numerical precision problems
* Fixed a problem with Scene::ToProperties() after editing a scene
* Fixed a self-shadow problem with area light sources

''Beta1 released''

* Fix ToProperties() of mapspherelight and spherelight
* Fixed a problem with caustic cache size when both PhotonGI caches were enabled and automatic stop condition for indirect cache was used
* PhotonGI Metropolis will now focus on caustic cache when indirect is done (and vice versa)
* Fixed the access to an uninitialized variable when using PhotonGI caustic cache alone
* Fixed the access to an uninitialized variable in ProjectionLight::Preprocess()
* Fixed a crash when trying to render a scene without light sources with PATHOCL (issue #202)
* Fixed DLSC to work with Front and back material transparency (aka light invisible object)
* Fixed a problem in BIDIRCPU with camera PDF
* Fixed a bug in Mix material transparency support (issue #210)
* Added a workaround to an AMD OpenCL compiler bug in DirectLight_BSDFSampling()

''Beta2 released''

* Fixed a problem in the random number generator of PhotonGI
* Fixed wrong theta being saved in ToProperties() of distant light
* Fixed a compilation error in RoughMatte OpenCL code (issue #218)
* Fixed a problem with Disney material specular tint
* Fixed a TILEPATH bug causing black renderings
* Fixed BIDIRCPU and LIGHTCPU camera motion blur
* Fixed a bug related to initial camera volume in PATHOCL
* Fixed light tracing camera motion blur and arbitrary clipping plane support
* Fixed a bug in the OpenCL code of the splitfloat3 texture
* Fixed normal mapping
* Fixed a problem when saving ALBEDO AOV
* Fixed RoughGlass event types returned by material evaluation
* Evaluated best radius in PhotonGI, ELVC and DLSC is not affected any more by border rendering
* Fixed a crash when resuming scene rendering without PhotonGI enabled
* Fixed a NaNs problem when using area lights with zero area
* Fixed the export of material emission.directlightsampling.type property

''Beta3 released''

===Known Problems===

* [https://github.com/LuxCoreRender/LuxCore/issues/103 LuxCore API requires latin locale]
* [https://github.com/LuxCoreRender/LuxCore/issues/2 accelerator.bvh.builder.type = EMBREE_MORTON doesn't work with the latest Embree]
* [https://github.com/LuxCoreRender/LuxCore/issues/29 Python crashes when calling sys.exit()]
* [https://github.com/LuxCoreRender/LuxCore/issues/124 TILEPATHOCL (and RTPATHOCL) count the layers of transparent surfaces as an iteration of the rendering finite state machine so they requires to increase the max. path depth to avoid black regions.]
* [https://github.com/LuxCoreRender/LuxCore/issues/158 There may be artifacts when rendering glossy surface with high roughness values and DLSC]

=Blender Addon (BlendLuxCore)=

===New features===

* Support for new PhotonGI cache
* Support for Intel OIDN denoiser
* OIDN denoises the viewport once it pauses (enabled by default, pause after 10 seconds by default)

''Alpha0 released''

* Show number of users in material UI
* Add support for normal map orientation setting (opengl or directx)
* Add a new front/back opacity node (material category) to control opacity on both sides of a face separately
* Hitpoint Info node that offers position and shading normal vectors
* Dot Product node
* New math operations:
** Power
** Greater Than
** Less Than

''Alpha1 released''

* Add a Vector Math node
* User can now set a custom object ID
* User can now choose a custom viewport color for materials (used in the OpenGL viewport, optional)
* make volume socket export of material output more generic. This means users can now directly plug volumes into the interior/exterior volume sockets, without the need for a pointer node.
* expose volume nodes in material node tree add menu
* add new "colored glass" node preset with inlined volume for simple glasses with volumetric absorption
* add a filter to the pointer node selection menu (so the user can list only materials, only volumes etc.)
* Expose uvmapping3d (available in the 3D mapping node, can be used to map procedural 3D textures with a UV mapping)
* add a debug option to print config and scene properties (in hidden debug menu, search for "Toggle LuxCore Debug Options" in Blender's operator search)
* expose storage property of background image to allow higher precision if necessary
* show button to select problematic object in error log
* implement a workaround to have "delete and reconnect" functionality in the node editor
* add support for improved adaptive sampling, as well as the new NOISE AOV
* add support for automatic radius estimation of DLSC
* add shadow catcher option to only consider shadows from infinite lights (sky, HDRI, flat background color)

''Beta1 released''

* new texture nodes: split RGB/combine RGB
* exposed new visibility map cache ("automatic portals")
* disable most imagepipeline plugins in viewport when viewport denoising is enabled, to avoid artifacts
* new material: Disney (aka principled shader)
* New math textures:
** Rounding
** Modulo (fmod)
* add support for tiled OIDN denoising to reduce RAM usage

''Beta2 released''

* switch to LuxCore material node tree when a node tree is first created (makes it easier for new users to find the LuxCore node tree)
* disable intel integrated graphics OpenCL devices by default because using them can lead to crashes

===Fixed Bugs===

* Fix Tool panel in blender reporting eye paths and light paths wrong
* Fix Point light size draw function using location without constraints
* Show noise halt threshold settings for Bidir engine
* Fix some bugs in group instance visiblity
* Fix missing srgb/linear conversion in HSV input of constant color node
* Fix volume priority not being exported
* Fix bug: pointiness was not working if the last material slot did not contain a pointiness node
* Improve viewport startup in complex scenes by ignoring materials touched by the export process when evaluating future updates
* Fix viewport denoiser not working without a camera
* Fix auto-updater not copying permission bits (this was a problem only for the OIDN standalone binary, which was not executable for this reason)

''Alpha0 released''

* Fix bug: area light was not removed during viewport render when its layer was made invisible
* BlendLuxCore AOV settings no longer affect Cycles/BI pass settings

''Alpha1 released''

* fix albedo and avg. shading normal AOVs being used in final render when OIDN was only enabled for viewport
* fix area light not being deleted when its type was switched to laser

''Beta1 released''

* fix some bugs in the node editor

''Beta2 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]
* [https://github.com/LuxCoreRender/BlendLuxCore/issues/148 Blender crashes when Ctrl+C is pressed to copy an object with a material]
* 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.

LuxCore SDL Reference Manual v2.2

2019-07-18T08:20:52Z

Dade: /* Film Outputs (aka AOVs) */

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" or "LOG_POWER" || 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.

==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", "QBVH", "MQBVH", "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 || ? || ?
|}

===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.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.
|-
|}

=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
|}

===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.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)
|}

===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: 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]
|}

===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
|}

===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
|}

==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
|}