summaryrefslogtreecommitdiff
path: root/doc/classes/WorldEnvironment.xml
blob: ed8f0b9a0456b5b8507fb5c23d9a510f8a1f1493 (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
<?xml version="1.0" encoding="UTF-8" ?>
<class name="WorldEnvironment" inherits="Node" version="4.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../class.xsd">
	<brief_description>
		Default environment properties for the entire scene (post-processing effects, lighting and background settings).
	</brief_description>
	<description>
		The [WorldEnvironment] node is used to configure the default [Environment] for the scene.
		The parameters defined in the [WorldEnvironment] can be overridden by an [Environment] node set on the current [Camera3D]. Additionally, only one [WorldEnvironment] may be instantiated in a given scene at a time.
		The [WorldEnvironment] allows the user to specify default lighting parameters (e.g. ambient lighting), various post-processing effects (e.g. SSAO, DOF, Tonemapping), and how to draw the background (e.g. solid color, skybox). Usually, these are added in order to improve the realism/color balance of the scene.
	</description>
	<tutorials>
		<link title="Environment and post-processing">$DOCS_URL/tutorials/3d/environment_and_post_processing.html</link>
		<link title="3D Material Testers Demo">https://godotengine.org/asset-library/asset/123</link>
		<link title="2D HDR Demo">https://godotengine.org/asset-library/asset/110</link>
		<link title="Third Person Shooter Demo">https://godotengine.org/asset-library/asset/678</link>
	</tutorials>
	<members>
		<member name="camera_effects" type="CameraEffects" setter="set_camera_effects" getter="get_camera_effects">
			The [CameraEffects] resource used by this [WorldEnvironment], defining the default properties. This [CameraEffects] resource will be used by all [Camera3D]s that do not define their own [CameraEffects].
		</member>
		<member name="environment" type="Environment" setter="set_environment" getter="get_environment">
			The [Environment] resource used by this [WorldEnvironment], defining the default properties.
		</member>
	</members>
</class>