Building LuxCoreRender - FAQ - Revision history

Howetuft at 04:47, 11 June 2026

2026-06-11T04:47:40Z

← Older revision		Revision as of 06:47, 11 June 2026
Line 113:		Line 113:

	<pre>export LUX_BUILD_TYPE=Debug # `set LUX_BUILD_TYPE=Debug` would be insufficient</pre>		<pre>export LUX_BUILD_TYPE=Debug # `set LUX_BUILD_TYPE=Debug` would be insufficient</pre>

			== In gdb, how to debug one thread at a time? ==
			<pre>set scheduler-locking step</pre>

Howetuft: /* How can I build a sanitized version of LuxCore? */

2026-06-07T21:12:39Z

How can I build a sanitized version of LuxCore?

← Older revision		Revision as of 23:12, 7 June 2026
Line 105:		Line 105:
	</pre>		</pre>
	* To run Blender with ASAN, see here: https://developer.blender.org/docs/handbook/tooling/asan/		* To run Blender with ASAN, see here: https://developer.blender.org/docs/handbook/tooling/asan/
			This may help:
			<pre>export ASAN_OPTIONS=check_initialization_order=0:protect_shadow_gap=0:verify_asan_link_order=0</pre>

	== In Linux, I try to set an environment variable that should control LuxCore build, but it does not work ==		== In Linux, I try to set an environment variable that should control LuxCore build, but it does not work ==

Howetuft: /* How can I build a sanitized version of LuxCore? */

2026-06-07T20:53:27Z

How can I build a sanitized version of LuxCore?

← Older revision		Revision as of 22:53, 7 June 2026
Line 104:		Line 104:
	what(): CUDA driver API error CUDA_ERROR_NOT_INITIALIZED		what(): CUDA driver API error CUDA_ERROR_NOT_INITIALIZED
	</pre>		</pre>
	* ~~Unfortunately, sanitized version of the wheel will not do~~ with ~~Blender~~, ~~as Blender has special code to control sanitizing and will override ours~~.		* To run Blender with ASAN, see here: https://developer.blender.org/docs/handbook/tooling/asan/

	== In Linux, I try to set an environment variable that should control LuxCore build, but it does not work ==		== In Linux, I try to set an environment variable that should control LuxCore build, but it does not work ==

Howetuft: /* How can I build a sanitized version of LuxCore? */

2026-06-07T20:49:47Z

How can I build a sanitized version of LuxCore?

← Older revision		Revision as of 22:49, 7 June 2026
Line 99:		Line 99:
	2 caveats:		2 caveats:
	* You'll need to export the following before running LuxCore:		* You'll need to export the following before running LuxCore:
	<pre>ASAN_OPTIONS=protect_shadow_gap=0</pre>		<pre>export ASAN_OPTIONS=protect_shadow_gap=0</pre>
	otherwise LuxCore will stop early with the following error message:		otherwise LuxCore will stop early with the following error message:
	<pre>terminate called after throwing an instance of 'std::runtime_error'		<pre>terminate called after throwing an instance of 'std::runtime_error'

Howetuft: /* Can I use git bisect? */

2026-06-06T09:22:06Z

Can I use git bisect?

← Older revision		Revision as of 11:22, 6 June 2026
Line 42:		Line 42:

	<pre>		<pre>
			# We recommend to build in Release type (shorter build time)
			export LUX_BUILD_TYPE=Release

	# Start git bisecting		# Start git bisecting
	git bisect start		git bisect start

Howetuft at 03:22, 28 April 2026

2026-04-28T03:22:34Z

← Older revision		Revision as of 05:22, 28 April 2026
Line 63:		Line 63:

	== Can I generate debug information for dependencies (LuxCoreDeps)? ==		== Can I generate debug information for dependencies (LuxCoreDeps)? ==
	Yes, it's possible, but only for local build~~, at the moment~~.		Yes, it's possible, but only for local build.

	In this context, the build type is controlled by <code>DEPS_BUILD_TYPE</code> environment variable, so set it to your target build type before building:		In this context, the build type is controlled by <code>DEPS_BUILD_TYPE</code> environment variable, so set it to your target build type before building:
Line 69:		Line 69:
	<pre>export DEPS_BUILD_TYPE=Debug</pre>		<pre>export DEPS_BUILD_TYPE=Debug</pre>

			Then you will build the deps with [[Building_LuxCoreRender#Local_Plain_Build\|local plain build]].

	After having built dependencies in local, you may want to inject them in LuxCore build. This can be done with the following:		After having built dependencies in local, you may want to inject them in LuxCore build. This can be done with the following:
Line 75:		Line 76:

	(this replaces <code>make deps</code>)		(this replaces <code>make deps</code>)

			At this stage, you will be able to build LuxCore artifacts, embedding the debug information of dependencies, for instance:
			<pre>
			export LUX_BUILD_TYPE=Debug
			make wheel-test # If the previous steps have been completed, the testing wheel will contain deps' debug info
			</pre>

			Remark: in this scenario, do not build the dependencies with CI local build, as the deps source files should be inaccessible at the end of the build, what should make the deps debug info useless.

	== How can I build a sanitized version of LuxCore? ==		== How can I build a sanitized version of LuxCore? ==

Howetuft: /* How can I build a sanitized version of LuxCore? */

2026-04-26T14:44:07Z

How can I build a sanitized version of LuxCore?

← Older revision		Revision as of 16:44, 26 April 2026
Line 79:		Line 79:

	It is possible to build a sanitized version of LuxCore, including <code>luxcoreui</code>, <code>luxcoreconsole</code>, <code>pyluxcore</code> and the wheels.		It is possible to build a sanitized version of LuxCore, including <code>luxcoreui</code>, <code>luxcoreconsole</code>, <code>pyluxcore</code> and the wheels.
	It just consists in setting the environment variable <code>LUX_SANITIZE</code>:		It just consists in setting the environment variable <code>LUX_SANITIZE</code> before the build:

	<pre>export LUX_SANITIZE=1 # or whatever value you want</pre>		<pre>export LUX_SANITIZE=1 # or whatever value you want</pre>

Howetuft: /* Can I generate debug information for dependencies (LuxCoreDeps)? */

2026-04-26T14:42:31Z

Can I generate debug information for dependencies (LuxCoreDeps)?

← Older revision		Revision as of 16:42, 26 April 2026
Line 70:		Line 70:


	After having built dependencies in local, you may want to inject them in LuxCore. This can be done with the following:		After having built dependencies in local, you may want to inject them in LuxCore build. This can be done with the following:

	<pre>python -m build-system.luxmake.deps --local <path/to/deps> --release test --build-type=Debug</pre>		<pre>python -m build-system.luxmake.deps --local <path/to/deps> --release test --build-type=Debug</pre>

Howetuft: /* How can I build a sanitized version of LuxCore? */

2026-04-26T09:07:17Z

How can I build a sanitized version of LuxCore?

← Older revision		Revision as of 11:07, 26 April 2026
Line 82:		Line 82:

	<pre>export LUX_SANITIZE=1 # or whatever value you want</pre>		<pre>export LUX_SANITIZE=1 # or whatever value you want</pre>

			To come back to unsanitized build, just <code>unset LUX_SANITIZE</code>.

	2 caveats:		2 caveats:
	* To come back to unsanitized build, you must <code>unset LUX_SANITIZE</code>.
	* You'll need to export the following before running LuxCore:		* You'll need to export the following before running LuxCore:
	<pre>ASAN_OPTIONS=protect_shadow_gap=0</pre>		<pre>ASAN_OPTIONS=protect_shadow_gap=0</pre>

Howetuft: /* Can I build a sanitized version of LuxCore? */

2026-04-26T09:06:33Z

Can I build a sanitized version of LuxCore?

← Older revision		Revision as of 11:06, 26 April 2026
Line 76:		Line 76:
	(this replaces <code>make deps</code>)		(this replaces <code>make deps</code>)

	== ~~Can~~ I build a sanitized version of LuxCore? ==		== How can I build a sanitized version of LuxCore? ==

	It is possible to build a sanitized version of LuxCore, including <code>luxcoreui</code>, <code>luxcoreconsole</code>, <code>pyluxcore</code> and the wheels.		It is possible to build a sanitized version of LuxCore, including <code>luxcoreui</code>, <code>luxcoreconsole</code>, <code>pyluxcore</code> and the wheels.
Line 92:		Line 92:
	</pre>		</pre>
	* Unfortunately, sanitized version of the wheel will not do with Blender, as Blender has special code to control sanitizing and will override ours.		* Unfortunately, sanitized version of the wheel will not do with Blender, as Blender has special code to control sanitizing and will override ours.


	== In Linux, I try to set an environment variable that should control LuxCore build, but it does not work ==		== In Linux, I try to set an environment variable that should control LuxCore build, but it does not work ==