LuxCore SDL Reference Manual v2.11 - Revision history

CodeHD: /* Camera */

2026-06-07T10:51:37Z

Camera

CodeHD: /* Camera */

2026-06-07T10:20:09Z

Camera

← Older revision		Revision as of 12:20, 7 June 2026
Line 1,292:		Line 1,292:
	==Camera==		==Camera==

	~~General parameters:~~
	{\| class="wikitable" cellspacing="2"		{\| class="wikitable" cellspacing="2"
	!Property name		!Property name

CodeHD: /* Camera */ reformat table

2026-06-07T10:19:57Z

Camera: reformat table

← Older revision		Revision as of 12:19, 7 June 2026
Line 1,321:		Line 1,321:
	\|'''scene.camera.clipyon''' \|\| float \|\| 1e30 \|\| TBD		\|'''scene.camera.clipyon''' \|\| float \|\| 1e30 \|\| TBD
	\|-		\|-
	\|}		\|'''scene.camera.screenwindow''' \|\| list (float float float float) \|\| 0.0 1.0 0.0 1.0 \|\| <xstart> <xstop> <ystart> <ystop><br>(Only for "perspective"/"orthographic"/"environment")

	~~Parameters only applicable if~~ scene.camera.~~type ==~~ "~~orthographic~~" or "~~perspective~~" or "environment"

	~~{\| class="wikitable" cellspacing="2"~~
	~~!Property name~~
	~~!Property type~~
	~~!Default value~~
	~~!Description~~
	\|-		\|-
	\|'''scene.camera.~~screenwindow~~''' \|\| ~~list (float float float float)~~ \|\| ~~0.0 1.0 0.0 1.0~~ \|\| <~~xstart> <xstop> <ystart> <ystop~~>		\|'''scene.camera.bokeh.distribution.type''' \|\| string \|\| NONE \|\| "NONE", "UNIFORM", "EXPONENTIAL", "INVERSEEXPONENTIAL", "GAUSSIAN", "INVERSEGAUSSIAN", "TRIANGULAR", "CUSTOM"<br>(Only for "perspective")
	\|-		\|-
	\|}		\|'''scene.camera.bokeh.blades''' \|\| int \|\| 0 \|\| Number of aperture blades<br>(Only for "perspective")

	~~Parameters only applicable if~~ scene.camera.~~type ==~~ "perspective"

	~~{\| class="wikitable" cellspacing="2"~~
	~~!Property name~~
	~~!Property type~~
	~~!Default value~~
	~~!Description~~
	\|-		\|-
	\|'''scene.camera.bokeh.~~distribution.type~~''' \|\| ~~string~~ \|\| ~~NONE~~ \|\| ~~"NONE", "UNIFORM"~~, "EXPONENTIAL", "INVERSEEXPONENTIAL"~~, "GAUSSIAN", "INVERSEGAUSSIAN", "TRIANGULAR",~~ "~~CUSTOM~~"		\|'''scene.camera.bokeh.power''' \|\| int \|\| 3 \|\| Distribution factor, only for "EXPONENTIAL" and "INVERSEEXPONENTIAL" types<br>(Only for "perspective")
	\|-		\|-
	\|'''scene.camera.bokeh.~~blades~~''' \|\| ~~int~~ \|\| 0 \|\| ~~Number of aperture blades~~		\|'''scene.camera.bokeh.distribution.image''' \|\| string \|\| "image.png" \|\| only if type == "CUSTOM"<br>(Only for "perspective")
	\|-		\|-
	\|'''scene.camera.bokeh.~~power~~''' \|\| ~~int~~ \|\| 3 \|\| ~~Distribution factor, only~~ for "~~EXPONENTIAL~~" ~~and "INVERSEEXPONENTIAL" types~~		\|'''scene.camera.bokeh.scalex''' \|\| float \|\| 1.0 \|\| TBD<br>(Only for "perspective")
	\|-		\|-
	~~\|'''scene.camera.bokeh.distribution.image''' \|\| string \|\| "image.png" \|\| only if type == "CUSTOM"~~		\|'''scene.camera.bokeh.scaley''' \|\| float \|\| 1.0 \|\| TBD<br>(Only for "perspective")
	\|-
	~~\|'''scene.camera.bokeh.scalex''' \|\| float \|\| 1.0 \|\| TBD~~
	\|-
	\|'''scene.camera.bokeh.scaley''' \|\| float \|\| 1.0 \|\| TBD
	\|-
	\|}

	~~Parameters only applicable if scene.camera.type == "stereo"~~

	~~{\| class="wikitable" cellspacing=~~"2"
	~~!Property name~~
	~~!Property type~~
	~~!Default value~~
	~~!Description~~
	\|-		\|-
	\|'''scene.camera.stereo.type''' \|\| string \|\| "perspective" \|\| "perspective", "environment_180", "environment_360"		\|'''scene.camera.stereo.type''' \|\| string \|\| "perspective" \|\| "perspective", "environment_180", "environment_360"
	\|-		\|-
	\|'''scene.camera.eyesdistance''' \|\| float \|\| 0.0626 \|\| TBD		\|'''scene.camera.eyesdistance''' \|\| float \|\| 0.0626 \|\| TBD<br>(Only for "stereo")
	\|-
	~~\|'''scene.camera.lensdistance''' \|\| float \|\| 0.2779 \|\| TBD~~
	\|-
	\|}

	~~Parameters only applicable if scene.camera.type == "perspective" or~~ "stereo"

	~~{\| class="wikitable" cellspacing="2"~~
	~~!Property name~~
	~~!Property type~~
	~~!Default value~~
	~~!Description~~
	\|-
	~~\|'''scene.camera.oculusrift.barrelpostpro.enable''' \|\| bool \|\| false \|\| TBD~~
	\|-		\|-
	\|}		\|'''scene.camera.lensdistance''' \|\| float \|\| 0.2779 \|\| TBD<br>(Only for "stereo")

	~~Parameters only applicable if~~ scene.camera.~~type == "environment"~~

	{\| ~~class="wikitable" cellspacing=~~"2"
	~~!Property name~~
	~~!Property type~~
	~~!Default value~~
	~~!Description~~
	\|-		\|-
	\|'''scene.camera.~~environment~~.~~degrees~~''' \|\| ~~float~~ \|\| ~~360.0~~ \|\| TBD		\|'''scene.camera.oculusrift.barrelpostpro.enable''' \|\| bool \|\| false \|\| TBD<br>(Only for "perspective"/"stereo")
	\|-		\|-
	\|}		\|'''scene.camera.environment.degrees''' \|\| float \|\| 360.0 \|\| TBD<br>(Only for "environment")

	~~Parameters only applicable if~~ scene.camera.~~type != "~~environment"

	{\| ~~class=~~"~~wikitable" cellspacing="2~~"
	~~!Property name~~
	~~!Property type~~
	~~!Default value~~
	~~!Description~~
	\|-		\|-
	\|'''scene.camera.lensradius''' \|\| float \|\| 0.0 \|\| TBD		\|'''scene.camera.lensradius''' \|\| float \|\| 0.0 \|\| TBD<br>(Only for "perspective"/"orthographic"/"stereo")
	\|-		\|-
	\|'''scene.camera.focaldistance''' \|\| float \|\| 10.0 \|\| TBD		\|'''scene.camera.focaldistance''' \|\| float \|\| 10.0 \|\| TBD<br>(Only for "perspective"/"orthographic"/"stereo")
	\|-		\|-
	\|'''scene.camera.autofocus.enable''' \|\| bool \|\| false \|\| TBD		\|'''scene.camera.autofocus.enable''' \|\| bool \|\| false \|\| TBD<br>(Only for "perspective"/"orthographic"/"stereo")
	\|-		\|-
	\|'''scene.camera.clippingplane.enable''' \|\| bool \|\| false \|\| TBD		\|'''scene.camera.clippingplane.enable''' \|\| bool \|\| false \|\| TBD<br>(Only for "perspective"/"orthographic"/"stereo")
	\|-		\|-
	\|'''scene.camera.clippingplane.center''' \|\| point (float float float) \|\| 0.0 0.0 0.0 \|\| TBD		\|'''scene.camera.clippingplane.center''' \|\| point (float float float) \|\| 0.0 0.0 0.0 \|\| TBD<br>(Only for "perspective"/"orthographic"/"stereo")
	\|-		\|-
	\|'''scene.camera.clippingplane.normal''' \|\| vector (float float float) \|\| 0.0 0.0 0.0 \|\| TBD		\|'''scene.camera.clippingplane.normal''' \|\| vector (float float float) \|\| 0.0 0.0 0.0 \|\| TBD<br>(Only for "perspective"/"orthographic"/"stereo")
	\|-		\|-
	\|}		\|}

CodeHD: /* Camera */

2026-06-07T09:22:23Z

Camera

← Older revision		Revision as of 11:22, 7 June 2026
Line 1,331:		Line 1,331:
	!Description		!Description
	\|-		\|-
	\|'''scene.camera.screenwindow''' \|\| ~~vector~~ \|\| 0.0 1.0 0.0 1.0 \|\| <xstart> <xstop> <ystart> <ystop>		\|'''scene.camera.screenwindow''' \|\| list (float float float float) \|\| 0.0 1.0 0.0 1.0 \|\| <xstart> <xstop> <ystart> <ystop>
	\|-		\|-
	\|}		\|}
Line 1,351:		Line 1,351:
	\|'''scene.camera.bokeh.distribution.image''' \|\| string \|\| "image.png" \|\| only if type == "CUSTOM"		\|'''scene.camera.bokeh.distribution.image''' \|\| string \|\| "image.png" \|\| only if type == "CUSTOM"
	\|-		\|-
	\|'''scene.camera.bokeh.scalex''' \|\| ~~double~~ \|\| 1.0 \|\| TBD		\|'''scene.camera.bokeh.scalex''' \|\| float \|\| 1.0 \|\| TBD
	\|-		\|-
	\|'''scene.camera.bokeh.scaley''' \|\| ~~double~~ \|\| 1.0 \|\| TBD		\|'''scene.camera.bokeh.scaley''' \|\| float \|\| 1.0 \|\| TBD
	\|-		\|-
	\|}		\|}
Line 1,367:		Line 1,367:
	\|'''scene.camera.stereo.type''' \|\| string \|\| "perspective" \|\| "perspective", "environment_180", "environment_360"		\|'''scene.camera.stereo.type''' \|\| string \|\| "perspective" \|\| "perspective", "environment_180", "environment_360"
	\|-		\|-
	\|'''scene.camera.eyesdistance''' \|\| 0.0626 ~~\|\| NONE~~ \|\| TBD		\|'''scene.camera.eyesdistance''' \|\| float \|\| 0.0626 \|\| TBD
	\|-		\|-
	\|'''scene.camera.lensdistance''' \|\| 0.2779 ~~\|\| NONE~~ \|\| TBD		\|'''scene.camera.lensdistance''' \|\| float \|\| 0.2779 \|\| TBD
	\|-		\|-
	\|}		\|}
Line 1,393:		Line 1,393:
	!Description		!Description
	\|-		\|-
	\|'''scene.camera.environment.degrees''' \|\| ~~double~~ \|\| 360.0 \|\| TBD		\|'''scene.camera.environment.degrees''' \|\| float \|\| 360.0 \|\| TBD
	\|-		\|-
	\|}		\|}
Line 1,405:		Line 1,405:
	!Description		!Description
	\|-		\|-
	\|'''scene.camera.lensradius''' \|\| ~~double~~ \|\| 0.0 \|\| TBD		\|'''scene.camera.lensradius''' \|\| float \|\| 0.0 \|\| TBD
	\|-		\|-
	\|'''scene.camera.focaldistance''' \|\| ~~double~~ \|\| 10.0 \|\| TBD		\|'''scene.camera.focaldistance''' \|\| float \|\| 10.0 \|\| TBD
	\|-		\|-
	\|'''scene.camera.autofocus.enable''' \|\| bool \|\| false \|\| TBD		\|'''scene.camera.autofocus.enable''' \|\| bool \|\| false \|\| TBD
Line 1,413:		Line 1,413:
	\|'''scene.camera.clippingplane.enable''' \|\| bool \|\| false \|\| TBD		\|'''scene.camera.clippingplane.enable''' \|\| bool \|\| false \|\| TBD
	\|-		\|-
	\|'''scene.camera.clippingplane.center''' \|\| 0.0 0.0 0~~.0 \|\| 360~~.0 \|\| TBD		\|'''scene.camera.clippingplane.center''' \|\| point (float float float) \|\| 0.0 0.0 0.0 \|\| TBD
	\|-		\|-
	\|'''scene.camera.clippingplane.normal''' \|\| 0.0 0.0 0~~.0 \|\| 360~~.0 \|\| TBD		\|'''scene.camera.clippingplane.normal''' \|\| vector (float float float) \|\| 0.0 0.0 0.0 \|\| TBD
	\|-		\|-
	\|}		\|}

CodeHD: /* Camera */ add missing parameters (need better grouping and descriptions)

2026-06-06T15:32:47Z

Camera: add missing parameters (need better grouping and descriptions)

@@ Line 1,292: / Line 1,292: @@
 ==Camera==
 {| class="wikitable"  cellspacing="2"
 !Property name
@@ Line 1,307: / Line 1,308: @@
 |-
 |'''scene.camera.fieldofview''' || float || 45.0 || field of view
 |-
 |'''scene.camera.shutteropen''' || float || 0.0 || camera shutter open time (used for motion blur)
@@ Line 1,317: / Line 1,316: @@
 |-
 |'''scene.camera.volume''' || string ||  || the initial volume rays will travel in
 |}

CodeHD: /* Camera */

2026-06-06T14:51:43Z

Camera

← Older revision		Revision as of 16:51, 6 June 2026
Line 1,298:		Line 1,298:
	!Description		!Description
	\|-		\|-
	\|'''scene.camera.type''' \|\| string \|\| "perspective" \|\| "perspective", "orthographic" or "environment" (360° panorama <br> mapped in latlong format)		\|'''scene.camera.type''' \|\| string \|\| "perspective" \|\| "perspective", "orthographic", "environment" (360° panorama <br> mapped in latlong format) or "stereo"
	\|-		\|-
	\|'''scene.camera.lookat.orig''' \|\| point (float float float) \|\| 0.0 10.0 0.0 \|\| camera location		\|'''scene.camera.lookat.orig''' \|\| point (float float float) \|\| 0.0 10.0 0.0 \|\| camera location

Howetuft: /* Type: subdiv */

2025-05-25T11:16:54Z

Type: subdiv

← Older revision		Revision as of 13:16, 25 May 2025
Line 3,218:		Line 3,218:
	\|-		\|-
	\|'''scene.shapes.<shape name>.maxedgescreensize''' \|\| float \|\| 0.0 \|\| maximum edge screen size		\|'''scene.shapes.<shape name>.maxedgescreensize''' \|\| float \|\| 0.0 \|\| maximum edge screen size
			\|-
			\|'''scene.shapes.<shape name>.adaptive''' \|\| bool \|\| 1 \|\| Adaptive refinement / Uniform refinement
	\|}		\|}

Howetuft: 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 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 tha..."

2025-05-25T11:15:13Z

Created page with "The scene description language (SDL) is used to configure the renderer and to define objects, materials, textures etc. in the scene.<br> 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.<br> 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 tha..."

Show changes

← Older revision		Revision as of 12:51, 7 June 2026
Line 1,316:		Line 1,316:
	\|'''scene.camera.volume''' \|\| string \|\| \|\| the initial volume rays will travel in		\|'''scene.camera.volume''' \|\| string \|\| \|\| the initial volume rays will travel in
	\|-		\|-
	\|'''scene.camera.cliphither''' \|\| float \|\| 1e-3 \|\| ~~TBD~~		\|'''scene.camera.cliphither''' \|\| float \|\| 1e-3 \|\| Near clipping distance
	\|-		\|-
	\|'''scene.camera.clipyon''' \|\| float \|\| 1e30 \|\| ~~TBD~~		\|'''scene.camera.clipyon''' \|\| float \|\| 1e30 \|\| Far clipping distance
	\|-		\|-
	\|'''scene.camera.screenwindow''' \|\| list (float float float float) \|\| 0.0 1.0 0.0 1.0 \|\| <xstart> <xstop> <ystart> <ystop><br>(Only for "perspective"/"orthographic"/"environment")		\|'''scene.camera.screenwindow''' \|\| list (float float float float) \|\| 0.0 1.0 0.0 1.0 \|\| <xstart> <xstop> <ystart> <ystop><br>(Only for "perspective"/"orthographic"/"environment")
Line 1,330:		Line 1,330:
	\|'''scene.camera.bokeh.distribution.image''' \|\| string \|\| "image.png" \|\| only if type == "CUSTOM"<br>(Only for "perspective")		\|'''scene.camera.bokeh.distribution.image''' \|\| string \|\| "image.png" \|\| only if type == "CUSTOM"<br>(Only for "perspective")
	\|-		\|-
	\|'''scene.camera.bokeh.scalex''' \|\| float \|\| 1.0 \|\| ~~TBD~~<br>(Only for "perspective")		\|'''scene.camera.bokeh.scalex''' \|\| float \|\| 1.0 \|\| Horizontal scale of the Bokeh<br>(Only for "perspective")
	\|-		\|-
	\|'''scene.camera.bokeh.scaley''' \|\| float \|\| 1.0 \|\| ~~TBD~~<br>(Only for "perspective")		\|'''scene.camera.bokeh.scaley''' \|\| float \|\| 1.0 \|\| Vertical scale of the Bokeh<br>(Only for "perspective")
	\|-		\|-
	\|'''scene.camera.stereo.type''' \|\| string \|\| "perspective" \|\| "perspective", "environment_180", "environment_360"		\|'''scene.camera.stereo.type''' \|\| string \|\| "perspective" \|\| "perspective", "environment_180", "environment_360"
	\|-		\|-
	\|'''scene.camera.eyesdistance''' \|\| float \|\| 0.0626 \|\| ~~TBD~~<br>(Only for "stereo")		\|'''scene.camera.eyesdistance''' \|\| float \|\| 0.0626 \|\| Distance between the individual cameras<br>(Only for "stereo")
	\|-		\|-
	\|'''scene.camera.lensdistance''' \|\| float \|\| 0.2779 \|\| TBD<br>(Only for "stereo")		\|'''scene.camera.lensdistance''' \|\| float \|\| 0.2779 \|\| TBD<br>(Only for "stereo")
Line 1,344:		Line 1,344:
	\|'''scene.camera.environment.degrees''' \|\| float \|\| 360.0 \|\| TBD<br>(Only for "environment")		\|'''scene.camera.environment.degrees''' \|\| float \|\| 360.0 \|\| TBD<br>(Only for "environment")
	\|-		\|-
	\|'''scene.camera.lensradius''' \|\| float \|\| 0.0 \|\| ~~TBD~~<br>(Only for "perspective"/"orthographic"/"stereo")		\|'''scene.camera.lensradius''' \|\| float \|\| 0.0 \|\| Radius of the lens aperture, used for bokeh calculation<br>(Only for "perspective"/"orthographic"/"stereo")
	\|-		\|-
	\|'''scene.camera.focaldistance''' \|\| float \|\| 10.0 \|\| ~~TBD~~<br>(Only for "perspective"/"orthographic"/"stereo")		\|'''scene.camera.focaldistance''' \|\| float \|\| 10.0 \|\| Distance to the lens focus point, used for bokeh calculation<br>(Only for "perspective"/"orthographic"/"stereo")
	\|-		\|-
	\|'''scene.camera.autofocus.enable''' \|\| bool \|\| false \|\| ~~TBD~~<br>(Only for "perspective"/"orthographic"/"stereo")		\|'''scene.camera.autofocus.enable''' \|\| bool \|\| false \|\| Apply autofocus, automatically determines "focaldistance"<br>(Only for "perspective"/"orthographic"/"stereo")
	\|-		\|-
	\|'''scene.camera.clippingplane.enable''' \|\| bool \|\| false \|\| ~~TBD~~<br>(Only for "perspective"/"orthographic"/"stereo")		\|'''scene.camera.clippingplane.enable''' \|\| bool \|\| false \|\| Activates clipping plane<br>(Only for "perspective"/"orthographic"/"stereo")
	\|-		\|-
	\|'''scene.camera.clippingplane.center''' \|\| point (float float float) \|\| 0.0 0.0 0.0 \|\| ~~TBD~~<br>(Only for "perspective"/"orthographic"/"stereo")		\|'''scene.camera.clippingplane.center''' \|\| point (float float float) \|\| 0.0 0.0 0.0 \|\| Specifies one point in the clipping plane<br>(Only for "perspective"/"orthographic"/"stereo")
	\|-		\|-
	\|'''scene.camera.clippingplane.normal''' \|\| vector (float float float) \|\| 0.0 0.0 0.0 \|\| ~~TBD~~<br>(Only for "perspective"/"orthographic"/"stereo")		\|'''scene.camera.clippingplane.normal''' \|\| vector (float float float) \|\| 0.0 0.0 0.0 \|\| Specififes the normal vector of the clipping plane<br>(Only for "perspective"/"orthographic"/"stereo")
	\|-		\|-
	\|}		\|}