Light Properties - Revision history

Bikerdude: /* Parallel-sky light */

2024-02-08T18:25:26Z

Parallel-sky light

← Older revision		Revision as of 18:25, 8 February 2024
Line 45:		Line 45:
	The main problem with parallel light is that: while it does not radiate light rays from the light origin, the origin still matters when engine flows light rays through visportals. An ordinary parallel light always works properly in the visleaf where its origin is located. In addition to that, it takes effect in all the other visleafs which can be reached from the starting visleaf through visportals by travelling along the direction of the light. So in order to create a global moon/sun light which will light many outdoor areas, one has to create a separate visleaf above the outdoor areas, which would contain the light and have portals leading down to every outdoor area below. It is quite complicated.		The main problem with parallel light is that: while it does not radiate light rays from the light origin, the origin still matters when engine flows light rays through visportals. An ordinary parallel light always works properly in the visleaf where its origin is located. In addition to that, it takes effect in all the other visleafs which can be reached from the starting visleaf through visportals by travelling along the direction of the light. So in order to create a global moon/sun light which will light many outdoor areas, one has to create a separate visleaf above the outdoor areas, which would contain the light and have portals leading down to every outdoor area below. It is quite complicated.

	In TDM 2.08, a new spawnarg '''parallelSky''' was added. If you add it to a parallel light and set value "1", then the light will emanate from every visleaf containing surfaces with textures/smf/portal_sky material. This usually includes all outdoors area automatically. Note that other (i.e. indoors) areas are also included if they can be reached from outdoors areas through open visportals, so the light should work correctly indoors if someone opens a door.		In TDM 2.08, a new spawnarg '''parallelSky''' was added. If you add it to a parallel light (see visual example below) and set value "1", then the light will emanate from every visleaf containing surfaces with textures/smf/portal_sky material. This usually includes all outdoors area automatically. Note that other (i.e. indoors) areas are also included if they can be reached from outdoors areas through open visportals, so the light should work correctly indoors if someone opens a door.

	~~Visual example~~
	[[Image:Parallelsky light example.jpg‎]]		[[Image:Parallelsky light example.jpg‎]]

Bikerdude: /* Parallel-sky light */

2024-02-08T18:24:48Z

Parallel-sky light

← Older revision		Revision as of 18:24, 8 February 2024
Line 47:		Line 47:
	In TDM 2.08, a new spawnarg '''parallelSky''' was added. If you add it to a parallel light and set value "1", then the light will emanate from every visleaf containing surfaces with textures/smf/portal_sky material. This usually includes all outdoors area automatically. Note that other (i.e. indoors) areas are also included if they can be reached from outdoors areas through open visportals, so the light should work correctly indoors if someone opens a door.		In TDM 2.08, a new spawnarg '''parallelSky''' was added. If you add it to a parallel light and set value "1", then the light will emanate from every visleaf containing surfaces with textures/smf/portal_sky material. This usually includes all outdoors area automatically. Note that other (i.e. indoors) areas are also included if they can be reached from outdoors areas through open visportals, so the light should work correctly indoors if someone opens a door.

	Visual example -		Visual example
	[[~~File~~:Parallelsky light example.~~jpg\|thumb\|parallelsky light example~~]]		[[Image:Parallelsky light example.jpg‎]]

	==== Troubleshooting Parallel Lights ====		==== Troubleshooting Parallel Lights ====

Bikerdude: /* Parallel-sky light */

2024-02-08T18:20:49Z

Parallel-sky light

← Older revision		Revision as of 18:20, 8 February 2024
Line 46:		Line 46:

	In TDM 2.08, a new spawnarg '''parallelSky''' was added. If you add it to a parallel light and set value "1", then the light will emanate from every visleaf containing surfaces with textures/smf/portal_sky material. This usually includes all outdoors area automatically. Note that other (i.e. indoors) areas are also included if they can be reached from outdoors areas through open visportals, so the light should work correctly indoors if someone opens a door.		In TDM 2.08, a new spawnarg '''parallelSky''' was added. If you add it to a parallel light and set value "1", then the light will emanate from every visleaf containing surfaces with textures/smf/portal_sky material. This usually includes all outdoors area automatically. Note that other (i.e. indoors) areas are also included if they can be reached from outdoors areas through open visportals, so the light should work correctly indoors if someone opens a door.

			Visual example -
			[[File:Parallelsky light example.jpg\|thumb\|parallelsky light example]]

	==== Troubleshooting Parallel Lights ====		==== Troubleshooting Parallel Lights ====

Datiswous: /* Volumetric light ( new 2.10 ) */

2023-12-24T00:58:35Z

Volumetric light ( new 2.10 )

← Older revision		Revision as of 00:58, 24 December 2023
Line 194:		Line 194:
	* '''volumetric_light''' = 0: Set to 1 to enable volumetric light.		* '''volumetric_light''' = 0: Set to 1 to enable volumetric light.
	* '''volumetric_dust''' = 0.002: How strong the volumetric effect is (reduce it if too bright).		* '''volumetric_dust''' = 0.002: How strong the volumetric effect is (reduce it if too bright).
	* '''volumetric_noshadows''': How volumetric light handles shadows (see below) ~~--- useless in TDM 2.11~~.		* '''volumetric_noshadows''': How volumetric light handles shadows (see below).

	The spawnarg <tt>volumetric_noshadows</tt> only affects the volumetric effect, and has three different values (default value is taken from <tt>noshadows</tt> spawnarg):		The spawnarg <tt>volumetric_noshadows</tt> only affects the volumetric effect, and has three different values (default value is taken from <tt>noshadows</tt> spawnarg):
	* '''= 0''': Shadows must be respected. If that's not possible, then the whole volumetric effect must be disabled.		* '''= 0''': Shadows must be respected. If that's not possible, then the whole volumetric effect must be disabled.
	* '''= 1''': Shadows must be ignored.		* '''= 1''': Shadows must be ignored.
	* '''= -1''': Shadows should be respected. But if that's not possible, then shadows can be ignored as well.		* '''= -1''': Shadows should be respected. But if that's not possible, then shadows can be ignored as well. {{red\|--- useless in TDM 2.11}}

	There are several reasons why engine can fail to support shadows in volumetric light:		There are several reasons why engine can fail to support shadows in volumetric light:

Datiswous: Undo revision 30931 by Datiswous (talk)

2023-12-24T00:51:32Z

Undo revision 30931 by Datiswous (talk)

Datiswous: /* Volumetric light ( new 2.10 ) */ - hiding volumetric_noshadows text

2023-12-01T09:42:43Z

Volumetric light ( new 2.10 ): - hiding volumetric_noshadows text

Thebigh: /* AreaLock ( new 2.08 ) */ - typo

2023-06-06T04:56:59Z

AreaLock ( new 2.08 ): - typo

← Older revision		Revision as of 04:56, 6 June 2023
Line 293:		Line 293:
	=== AreaLock ( new 2.08 ) ===		=== AreaLock ( new 2.08 ) ===

	Forces the light to stop rendering when the visleaf that contains ~~it's~~ origin is closed.		Forces the light to stop rendering when the visleaf that contains its origin is closed.

	== Chandeliers ==		== Chandeliers ==

Nbohr1more: /* Light Settings */

2023-04-04T17:12:13Z

Light Settings

← Older revision		Revision as of 17:12, 4 April 2023
Line 267:		Line 267:

	Specular Lighting refers to a texture's specular map, wherein a flat surface (such as a wall) is painted with a texture that has a specular component. This causes a surface to have shinier and duller parts on a flat surface based on the darkness of the corresponding location on the specular map. Not all textures have specular maps. Checking this option could improve performance or remove the effect if it is not wanted. [https://modwiki.dhewm3.org/Texturing#specular-maps]		Specular Lighting refers to a texture's specular map, wherein a flat surface (such as a wall) is painted with a texture that has a specular component. This causes a surface to have shinier and duller parts on a flat surface based on the darkness of the corresponding location on the specular map. Not all textures have specular maps. Checking this option could improve performance or remove the effect if it is not wanted. [https://modwiki.dhewm3.org/Texturing#specular-maps]

	~~=== Skip Diffuse Lighting ===~~

	Like Specular lighting, diffuse lighting also references an attribute of a texture, the Diffuse Map. Diffuse Maps determine the intensity and color of the light reflected off of the different elements of a texture (an example being the difference between bricks and the mortar in between, as well as different bricks having different properties as well giving a less bland appearance).
	~~[https://modwiki.dhewm3.org/Texturing#diffuse-maps]~~

	=== Spectrum ===		=== Spectrum ===

Nbohr1more: /* Volumetric light ( new 2.10 ) */

2023-04-02T19:02:39Z

Volumetric light ( new 2.10 )

← Older revision		Revision as of 19:02, 2 April 2023
Line 206:		Line 206:
	# Shadows were disabled on the light itself (<tt>noshadows</tt>).		# Shadows were disabled on the light itself (<tt>noshadows</tt>).
	{{Clear}}		{{Clear}}
	~~<br>~~<br>		<br>

	== '''Light Settings''' ==		== '''Light Settings''' ==

Nbohr1more: /* Volumetric light ( new 2.10 ) */

2023-04-02T19:01:35Z

Volumetric light ( new 2.10 )

← Older revision		Revision as of 19:01, 2 April 2023
Line 206:		Line 206:
	# Shadows were disabled on the light itself (<tt>noshadows</tt>).		# Shadows were disabled on the light itself (<tt>noshadows</tt>).
	{{Clear}}		{{Clear}}
			<br><br>

	== '''Light Settings''' ==		== '''Light Settings''' ==

← Older revision		Revision as of 00:51, 24 December 2023
Line 194:		Line 194:
	* '''volumetric_light''' = 0: Set to 1 to enable volumetric light.		* '''volumetric_light''' = 0: Set to 1 to enable volumetric light.
	* '''volumetric_dust''' = 0.002: How strong the volumetric effect is (reduce it if too bright).		* '''volumetric_dust''' = 0.002: How strong the volumetric effect is (reduce it if too bright).
	* '''volumetric_noshadows''': How volumetric light handles shadows (see below) ~~{{red\|~~--- useless in TDM 2.11 }}.		* '''volumetric_noshadows''': How volumetric light handles shadows (see below) --- useless in TDM 2.11.

	~~<div class="toccolours mw-collapsible mw-collapsed" style="width:80em; overflow:auto;">~~
	The spawnarg <tt>volumetric_noshadows</tt> only affects the volumetric effect, and has three different values (default value is taken from <tt>noshadows</tt> spawnarg):		The spawnarg <tt>volumetric_noshadows</tt> only affects the volumetric effect, and has three different values (default value is taken from <tt>noshadows</tt> spawnarg):
	* '''= 0''': Shadows must be respected. If that's not possible, then the whole volumetric effect must be disabled.		* '''= 0''': Shadows must be respected. If that's not possible, then the whole volumetric effect must be disabled.
	* '''= 1''': Shadows must be ignored.		* '''= 1''': Shadows must be ignored.
	* '''= -1''': Shadows should be respected. But if that's not possible, then shadows can be ignored as well.		* '''= -1''': Shadows should be respected. But if that's not possible, then shadows can be ignored as well.
	~~</div>~~
	There are several reasons why ~~the~~ engine can fail to support shadows in volumetric light:		There are several reasons why engine can fail to support shadows in volumetric light:
	# ~~The player~~ <s>uses stencil shadows (<tt>r_shadows 1</tt>) or </s>([https://bugs.thedarkmod.com/view.php?id=5880#c15076 fixed in TDM 2.11]) disabled volumetric light sampling (<tt>r_volumetricSamples 0</tt>).		# Player <s>uses stencil shadows (<tt>r_shadows 1</tt>) or </s>([https://bugs.thedarkmod.com/view.php?id=5880#c15076 fixed in TDM 2.11]) disabled volumetric light sampling (<tt>r_volumetricSamples 0</tt>).
	# Shadow maps are not yet supported for the particular light. This happens for large lights, for instance.		# Shadow maps are not yet supported for the particular light. This happens for large lights, for instance.
	# Shadows were disabled on the light itself (<tt>noshadows</tt>).		# Shadows were disabled on the light itself (<tt>noshadows</tt>).

← Older revision		Revision as of 09:42, 1 December 2023
Line 194:		Line 194:
	* '''volumetric_light''' = 0: Set to 1 to enable volumetric light.		* '''volumetric_light''' = 0: Set to 1 to enable volumetric light.
	* '''volumetric_dust''' = 0.002: How strong the volumetric effect is (reduce it if too bright).		* '''volumetric_dust''' = 0.002: How strong the volumetric effect is (reduce it if too bright).
	* '''volumetric_noshadows''': How volumetric light handles shadows (see below) --- useless in TDM 2.11.		* '''volumetric_noshadows''': How volumetric light handles shadows (see below) {{red\|--- useless in TDM 2.11 }}.

			<div class="toccolours mw-collapsible mw-collapsed" style="width:80em; overflow:auto;">
	The spawnarg <tt>volumetric_noshadows</tt> only affects the volumetric effect, and has three different values (default value is taken from <tt>noshadows</tt> spawnarg):		The spawnarg <tt>volumetric_noshadows</tt> only affects the volumetric effect, and has three different values (default value is taken from <tt>noshadows</tt> spawnarg):
	* '''= 0''': Shadows must be respected. If that's not possible, then the whole volumetric effect must be disabled.		* '''= 0''': Shadows must be respected. If that's not possible, then the whole volumetric effect must be disabled.
	* '''= 1''': Shadows must be ignored.		* '''= 1''': Shadows must be ignored.
	* '''= -1''': Shadows should be respected. But if that's not possible, then shadows can be ignored as well.		* '''= -1''': Shadows should be respected. But if that's not possible, then shadows can be ignored as well.
			</div>
	There are several reasons why engine can fail to support shadows in volumetric light:		There are several reasons why the engine can fail to support shadows in volumetric light:
	# ~~Player~~ <s>uses stencil shadows (<tt>r_shadows 1</tt>) or </s>([https://bugs.thedarkmod.com/view.php?id=5880#c15076 fixed in TDM 2.11]) disabled volumetric light sampling (<tt>r_volumetricSamples 0</tt>).		# The player <s>uses stencil shadows (<tt>r_shadows 1</tt>) or </s>([https://bugs.thedarkmod.com/view.php?id=5880#c15076 fixed in TDM 2.11]) disabled volumetric light sampling (<tt>r_volumetricSamples 0</tt>).
	# Shadow maps are not yet supported for the particular light. This happens for large lights, for instance.		# Shadow maps are not yet supported for the particular light. This happens for large lights, for instance.
	# Shadows were disabled on the light itself (<tt>noshadows</tt>).		# Shadows were disabled on the light itself (<tt>noshadows</tt>).