Developing and debugging BlendLuxCore - Revision history

Howetuft: /* Debugging a LuxCore feature */

2026-03-14T10:06:15Z

Debugging a LuxCore feature

← Older revision		Revision as of 12:06, 14 March 2026
Line 148:		Line 148:
	In this case, we would recommended you:		In this case, we would recommended you:
	* to export your Blender scene (BLC filesaver feature)		* to export your Blender scene (BLC filesaver feature)
	* to debug LuxCore using one of the samples, for instance `luxcoreui`, running on the exported scene above.		* to debug LuxCore using one of the samples, for instance <code>luxcoreui</code>, running on the exported scene above.
	* and, when you're done in LuxCore, to extend your test in Blender		* and, when you're done with LuxCore, to extend your test in Blender

	The advantage is that building samples (`make`) is much quicker than building the test wheel (`make wheel-test`).		The advantage is that building samples (`make`) is much quicker than building the test wheel (`make wheel-test`).

Howetuft: /* Debugging a LuxCore feature */

2026-03-14T10:05:28Z

Debugging a LuxCore feature

← Older revision		Revision as of 12:05, 14 March 2026
Line 147:		Line 147:
	Even if the final use case involves Blender, you may face situations where the debugging is essentially about some sheer LuxCore feature.		Even if the final use case involves Blender, you may face situations where the debugging is essentially about some sheer LuxCore feature.
	In this case, we would recommended you:		In this case, we would recommended you:
	- to export your Blender scene (BLC filesaver feature)		* to export your Blender scene (BLC filesaver feature)
	- to debug LuxCore using one of the samples, for instance `luxcoreui`, running on the exported scene above.		* to debug LuxCore using one of the samples, for instance `luxcoreui`, running on the exported scene above.
	- and, when you're done in LuxCore, to extend your test in Blender		* and, when you're done in LuxCore, to extend your test in Blender

	The advantage is that building samples (`make`) is much quicker than building the test wheel (`make wheel-test`).		The advantage is that building samples (`make`) is much quicker than building the test wheel (`make wheel-test`).

Howetuft: /* Tips & Tricks */

2026-03-14T10:05:08Z

Tips & Tricks

← Older revision		Revision as of 12:05, 14 March 2026
Line 142:		Line 142:

	gdb should allow you to debug any call to LuxCore		gdb should allow you to debug any call to LuxCore

			== Debugging a LuxCore feature ==

			Even if the final use case involves Blender, you may face situations where the debugging is essentially about some sheer LuxCore feature.
			In this case, we would recommended you:
			- to export your Blender scene (BLC filesaver feature)
			- to debug LuxCore using one of the samples, for instance `luxcoreui`, running on the exported scene above.
			- and, when you're done in LuxCore, to extend your test in Blender

			The advantage is that building samples (`make`) is much quicker than building the test wheel (`make wheel-test`).

CodeHD: /* Installation of BlendLuxHelper and Setup of BlendLuxCore */

2025-10-07T19:51:03Z

Installation of BlendLuxHelper and Setup of BlendLuxCore

← Older revision		Revision as of 21:51, 7 October 2025
Line 56:		Line 56:

	<b>Step 2 (optional):</b><br>		<b>Step 2 (optional):</b><br>
	Add a new local extension repository for installation of the BLC/BLH development environment.		Add a new local extension repository for installation of the BLC/BLH development environment.<br>
	Suggested name: <code>blc_dbg</code>		Suggested name: <code>blc_dbg</code>

CodeHD: /* Installation of BlendLuxHelper and Setup of BlendLuxCore */

2025-10-07T19:50:50Z

Installation of BlendLuxHelper and Setup of BlendLuxCore

← Older revision		Revision as of 21:50, 7 October 2025
Line 57:		Line 57:
	<b>Step 2 (optional):</b><br>		<b>Step 2 (optional):</b><br>
	Add a new local extension repository for installation of the BLC/BLH development environment.		Add a new local extension repository for installation of the BLC/BLH development environment.
			Suggested name: <code>blc_dbg</code>

	<b>Step 3:</b><br>		<b>Step 3:</b><br>

CodeHD: /* Message "[BLC] skipping pyluxcore installation. Custom wheel matching hash already installed." */

2025-10-07T19:50:09Z

Message "[BLC] skipping pyluxcore installation. Custom wheel matching hash already installed."

← Older revision		Revision as of 21:50, 7 October 2025
Line 126:		Line 126:
	If you think this message is irrelevant, clean the following file:		If you think this message is irrelevant, clean the following file:

	<code>$HOME/.config/blender/<blender-version>/extensions/.user/~~blc_dbg~~/BlendLuxCore/pyluxcore_installation_info.txt</code>		<code>$HOME/.config/blender/<blender-version>/extensions/.user/<repository>/BlendLuxCore/pyluxcore_installation_info.txt</code>

	== Debugging the wheel executing in Blender (Linux) ==		== Debugging the wheel executing in Blender (Linux) ==

CodeHD: /* Statement of problem */

2025-10-07T19:49:32Z

Statement of problem

← Older revision		Revision as of 21:49, 7 October 2025
Line 24:		Line 24:
	In addition, there may be the need to handle some unusual cases, for example performing an offline-installation in restrictive company networks where dependencies cannot be downloaded via pip.		In addition, there may be the need to handle some unusual cases, for example performing an offline-installation in restrictive company networks where dependencies cannot be downloaded via pip.

	To facilitate the configuration of these scenarios, we provide a separate extension, <b>BlendLuxHelper</b>.		To facilitate the configuration of these scenarios, we provide a separate extension, <b>BlendLuxHelper</b> (BLH).

	The setup and usage of BlendLuxCore together with BlendLuxHelper will be explained in detail in the sections below.		The setup and usage of BlendLuxCore together with BlendLuxHelper will be explained in detail in the sections below.

Howetuft: /* Message "[BLC] skipping pyluxcore installation. Custom wheel matching hash already installed." */

2025-10-07T19:22:50Z

Message "[BLC] skipping pyluxcore installation. Custom wheel matching hash already installed."

← Older revision		Revision as of 21:22, 7 October 2025
Line 123:		Line 123:

	== Message "[BLC] skipping pyluxcore installation. Custom wheel matching hash already installed." ==		== Message "[BLC] skipping pyluxcore installation. Custom wheel matching hash already installed." ==

	~~<b>THIS SECTION NEEDS AN UPDATE</b>~~

	If you think this message is irrelevant, clean the following file:		If you think this message is irrelevant, clean the following file:

Howetuft: /* Message "[BLC] skipping pyluxcore installation. Custom wheel matching hash already installed." */

2025-10-07T19:22:38Z

Message "[BLC] skipping pyluxcore installation. Custom wheel matching hash already installed."

← Older revision		Revision as of 21:22, 7 October 2025
Line 126:		Line 126:
	<b>THIS SECTION NEEDS AN UPDATE</b>		<b>THIS SECTION NEEDS AN UPDATE</b>

	If you think this message is irrelevant, clean the following file: <code>$HOME/.config/blender/<blender-version>/extensions/.user/blc_dbg/BlendLuxCore/pyluxcore_installation_info.txt</code>		If you think this message is irrelevant, clean the following file:

			<code>$HOME/.config/blender/<blender-version>/extensions/.user/blc_dbg/BlendLuxCore/pyluxcore_installation_info.txt</code>

	== Debugging the wheel executing in Blender (Linux) ==		== Debugging the wheel executing in Blender (Linux) ==

Howetuft: /* Message "[BLC] skipping pyluxcore installation. Custom wheel matching hash already installed." */

2025-10-07T19:22:26Z

Message "[BLC] skipping pyluxcore installation. Custom wheel matching hash already installed."

← Older revision		Revision as of 21:22, 7 October 2025
Line 126:		Line 126:
	<b>THIS SECTION NEEDS AN UPDATE</b>		<b>THIS SECTION NEEDS AN UPDATE</b>

	If you think this message is irrelevant, clean the following file: <code>$HOME/.config/blender/~~4.2~~/extensions/.user/~~user_default~~/BlendLuxCore/pyluxcore_installation_info.txt</code>		If you think this message is irrelevant, clean the following file: <code>$HOME/.config/blender/<blender-version>/extensions/.user/blc_dbg/BlendLuxCore/pyluxcore_installation_info.txt</code>

	== Debugging the wheel executing in Blender (Linux) ==		== Debugging the wheel executing in Blender (Linux) ==