summaryrefslogtreecommitdiff
path: root/doc/classes/FogMaterial.xml
blob: 7428d6169a79a47f3ca5a669394ea988f41ff178 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
<?xml version="1.0" encoding="UTF-8" ?>
<class name="FogMaterial" inherits="Material" version="4.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../class.xsd">
	<brief_description>
		[Material] used with a [FogVolume] to draw things with the volumetric fog effect.
	</brief_description>
	<description>
		A [Material] resource that can be used by [FogVolume]s to draw volumetric effects.
		If you need more advanced effects, use a custom [url=$DOCS_URL/tutorials/shaders/shader_reference/fog_shader.html]fog shader[/url].
	</description>
	<tutorials>
	</tutorials>
	<members>
		<member name="albedo" type="Color" setter="set_albedo" getter="get_albedo" default="Color(1, 1, 1, 1)">
			The single-scattering [Color] of the [FogVolume]. Internally, [member albedo] is converted into single-scattering, which is additively blended with other [FogVolume]s and the [member Environment.volumetric_fog_albedo].
		</member>
		<member name="density" type="float" setter="set_density" getter="get_density" default="1.0">
			The density of the [FogVolume]. Denser objects are more opaque, but may suffer from under-sampling artifacts that look like stripes. Negative values can be used to subtract fog from other [FogVolume]s or global volumetric fog.
		</member>
		<member name="density_texture" type="Texture3D" setter="set_density_texture" getter="get_density_texture">
			The 3D texture that is used to scale the [member density] of the [FogVolume]. This can be used to vary fog density within the [FogVolume] with any kind of static pattern. For animated effects, consider using a custom [url=$DOCS_URL/tutorials/shaders/shader_reference/fog_shader.html]fog shader[/url].
		</member>
		<member name="edge_fade" type="float" setter="set_edge_fade" getter="get_edge_fade" default="0.1">
			The hardness of the edges of the [FogVolume]. A higher value will result in softer edges, while a lower value will result in harder edges.
		</member>
		<member name="emission" type="Color" setter="set_emission" getter="get_emission" default="Color(0, 0, 0, 1)">
			The [Color] of the light emitted by the [FogVolume]. Emitted light will not cast light or shadows on other objects, but can be useful for modulating the [Color] of the [FogVolume] independently from light sources.
		</member>
		<member name="height_falloff" type="float" setter="set_height_falloff" getter="get_height_falloff" default="0.0">
			The rate by which the height-based fog decreases in density as height increases in world space. A high falloff will result in a sharp transition, while a low falloff will result in a smoother transition. A value of [code]0.0[/code] results in uniform-density fog. The height threshold is determined by the height of the associated [FogVolume].
		</member>
	</members>
</class>