godot/doc/classes/Shader.xml

<?xml version="1.0" encoding="UTF-8" ?>
<class name="Shader" inherits="Resource" version="4.0">
	<brief_description>
		A custom shader program.
	</brief_description>
	<description>
		This class allows you to define a custom shader program that can be used by a [ShaderMaterial]. Shaders allow you to write your own custom behavior for rendering objects or updating particle information. For a detailed explanation and usage, please see the tutorials linked below.
	</description>
	<tutorials>
		<link title="Shaders documentation index">https://docs.godotengine.org/en/latest/tutorials/shaders/index.html</link>
	</tutorials>
	<methods>
		<method name="get_default_texture_param" qualifiers="const">
			<return type="Texture2D" />
			<argument index="0" name="param" type="StringName" />
			<description>
				Returns the texture that is set as default for the specified parameter.
				[b]Note:[/b] [code]param[/code] must match the name of the uniform in the code exactly.
			</description>
		</method>
		<method name="get_mode" qualifiers="const">
			<return type="int" enum="Shader.Mode" />
			<description>
				Returns the shader mode for the shader, either [constant MODE_CANVAS_ITEM], [constant MODE_SPATIAL] or [constant MODE_PARTICLES].
			</description>
		</method>
		<method name="has_param" qualifiers="const">
			<return type="bool" />
			<argument index="0" name="name" type="StringName" />
			<description>
				Returns [code]true[/code] if the shader has this param defined as a uniform in its code.
				[b]Note:[/b] [code]param[/code] must match the name of the uniform in the code exactly.
			</description>
		</method>
		<method name="set_default_texture_param">
			<return type="void" />
			<argument index="0" name="param" type="StringName" />
			<argument index="1" name="texture" type="Texture2D" />
			<description>
				Sets the default texture to be used with a texture uniform. The default is used if a texture is not set in the [ShaderMaterial].
				[b]Note:[/b] [code]param[/code] must match the name of the uniform in the code exactly.
			</description>
		</method>
	</methods>
	<members>
		<member name="code" type="String" setter="set_code" getter="get_code" default="&quot;&quot;">
			Returns the shader's code as the user has written it, not the full generated code used internally.
		</member>
	</members>
	<constants>
		<constant name="MODE_SPATIAL" value="0" enum="Mode">
			Mode used to draw all 3D objects.
		</constant>
		<constant name="MODE_CANVAS_ITEM" value="1" enum="Mode">
			Mode used to draw all 2D objects.
		</constant>
		<constant name="MODE_PARTICLES" value="2" enum="Mode">
			Mode used to calculate particle information on a per-particle basis. Not used for drawing.
		</constant>
		<constant name="MODE_SKY" value="3" enum="Mode">
			Mode used for drawing skies. Only works with shaders attached to [Sky] objects.
		</constant>
		<constant name="MODE_FOG" value="4" enum="Mode">
			Mode used for setting the color and density of volumetric fog effect.
		</constant>
	</constants>
</class>
Changed the doc class generation to individual files per class. It is also possible to save module files in module directories and the build system will recognize them. 2017-09-13 04:42:36 +08:00			`<?xml version="1.0" encoding="UTF-8" ?>`
Update docs to version 4.0 2020-02-01 09:03:48 +08:00			`<class name="Shader" inherits="Resource" version="4.0">`
Changed the doc class generation to individual files per class. It is also possible to save module files in module directories and the build system will recognize them. 2017-09-13 04:42:36 +08:00			`<brief_description>`
Added some quick info on shaders to the docs 2018-05-26 10:08:34 +08:00			`A custom shader program.`
Changed the doc class generation to individual files per class. It is also possible to save module files in module directories and the build system will recognize them. 2017-09-13 04:42:36 +08:00			`</brief_description>`
			`<description>`
Finish up docs for materials 2020-01-21 08:28:03 +08:00			`This class allows you to define a custom shader program that can be used by a [ShaderMaterial]. Shaders allow you to write your own custom behavior for rendering objects or updating particle information. For a detailed explanation and usage, please see the tutorials linked below.`
Changed the doc class generation to individual files per class. It is also possible to save module files in module directories and the build system will recognize them. 2017-09-13 04:42:36 +08:00			`</description>`
			`<tutorials>`
doc: Update links to latest documentation after content reorganization 2021-10-06 19:48:48 +08:00			`<link title="Shaders documentation index">https://docs.godotengine.org/en/latest/tutorials/shaders/index.html</link>`
Changed the doc class generation to individual files per class. It is also possible to save module files in module directories and the build system will recognize them. 2017-09-13 04:42:36 +08:00			`</tutorials>`
			`<methods>`
			`<method name="get_default_texture_param" qualifiers="const">`
doc: Use self-closing tags for `return` and `argument` For the time being we don't support writing a description for those, preferring having all details in the method's description. Using self-closing tags saves half the lines, and prevents contributors from thinking that they should write the argument or return documentation there. 2021-07-30 21:28:05 +08:00			`<return type="Texture2D" />`
			`<argument index="0" name="param" type="StringName" />`
Changed the doc class generation to individual files per class. It is also possible to save module files in module directories and the build system will recognize them. 2017-09-13 04:42:36 +08:00			`<description>`
Finish up docs for materials 2020-01-21 08:28:03 +08:00			`Returns the texture that is set as default for the specified parameter.`
			`[b]Note:[/b] [code]param[/code] must match the name of the uniform in the code exactly.`
Changed the doc class generation to individual files per class. It is also possible to save module files in module directories and the build system will recognize them. 2017-09-13 04:42:36 +08:00			`</description>`
			`</method>`
			`<method name="get_mode" qualifiers="const">`
doc: Use self-closing tags for `return` and `argument` For the time being we don't support writing a description for those, preferring having all details in the method's description. Using self-closing tags saves half the lines, and prevents contributors from thinking that they should write the argument or return documentation there. 2021-07-30 21:28:05 +08:00			`<return type="int" enum="Shader.Mode" />`
Changed the doc class generation to individual files per class. It is also possible to save module files in module directories and the build system will recognize them. 2017-09-13 04:42:36 +08:00			`<description>`
doc: Misc updates for AnimationNode* and others - Add some missing descriptions. - Add links to tutorials for ARVR and AnimationTree. - Style fixes. - Engine changes: * Make `AnimationNodeTransition.input_<number>` properties internal so that they don't appear in the docs. They still appear in the inspector based on the actual number of inputs requested. * Drop unimplemented `CPUParticles.flatness`. It's only used for 3D particles in `ParticlesMaterial`, and thus only relevant for `CPUParticles3D`. 2020-01-23 18:14:14 +08:00			`Returns the shader mode for the shader, either [constant MODE_CANVAS_ITEM], [constant MODE_SPATIAL] or [constant MODE_PARTICLES].`
Changed the doc class generation to individual files per class. It is also possible to save module files in module directories and the build system will recognize them. 2017-09-13 04:42:36 +08:00			`</description>`
			`</method>`
			`<method name="has_param" qualifiers="const">`
doc: Use self-closing tags for `return` and `argument` For the time being we don't support writing a description for those, preferring having all details in the method's description. Using self-closing tags saves half the lines, and prevents contributors from thinking that they should write the argument or return documentation there. 2021-07-30 21:28:05 +08:00			`<return type="bool" />`
			`<argument index="0" name="name" type="StringName" />`
Changed the doc class generation to individual files per class. It is also possible to save module files in module directories and the build system will recognize them. 2017-09-13 04:42:36 +08:00			`<description>`
Finish up docs for materials 2020-01-21 08:28:03 +08:00			`Returns [code]true[/code] if the shader has this param defined as a uniform in its code.`
			`[b]Note:[/b] [code]param[/code] must match the name of the uniform in the code exactly.`
Changed the doc class generation to individual files per class. It is also possible to save module files in module directories and the build system will recognize them. 2017-09-13 04:42:36 +08:00			`</description>`
			`</method>`
			`<method name="set_default_texture_param">`
doc: Use self-closing tags for `return` and `argument` For the time being we don't support writing a description for those, preferring having all details in the method's description. Using self-closing tags saves half the lines, and prevents contributors from thinking that they should write the argument or return documentation there. 2021-07-30 21:28:05 +08:00			`<return type="void" />`
			`<argument index="0" name="param" type="StringName" />`
			`<argument index="1" name="texture" type="Texture2D" />`
Changed the doc class generation to individual files per class. It is also possible to save module files in module directories and the build system will recognize them. 2017-09-13 04:42:36 +08:00			`<description>`
Finish up docs for materials 2020-01-21 08:28:03 +08:00			`Sets the default texture to be used with a texture uniform. The default is used if a texture is not set in the [ShaderMaterial].`
			`[b]Note:[/b] [code]param[/code] must match the name of the uniform in the code exactly.`
Changed the doc class generation to individual files per class. It is also possible to save module files in module directories and the build system will recognize them. 2017-09-13 04:42:36 +08:00			`</description>`
			`</method>`
			`</methods>`
Update docs [ci skip] 2018-01-12 06:38:35 +08:00			`<members>`
doc: Add default values to all properties Thanks to @bojidar-bg's impressive work in #29380. 2019-06-29 18:38:01 +08:00			`<member name="code" type="String" setter="set_code" getter="get_code" default="""">`
Finish up docs for materials 2020-01-21 08:28:03 +08:00			`Returns the shader's code as the user has written it, not the full generated code used internally.`
Update docs [ci skip] 2018-01-12 06:38:35 +08:00			`</member>`
			`</members>`
Changed the doc class generation to individual files per class. It is also possible to save module files in module directories and the build system will recognize them. 2017-09-13 04:42:36 +08:00			`<constants>`
doc: Fix enum tags thanks to 2bc6db6 2017-11-25 06:16:30 +08:00			`<constant name="MODE_SPATIAL" value="0" enum="Mode">`
Finish up docs for materials 2020-01-21 08:28:03 +08:00			`Mode used to draw all 3D objects.`
Changed the doc class generation to individual files per class. It is also possible to save module files in module directories and the build system will recognize them. 2017-09-13 04:42:36 +08:00			`</constant>`
doc: Fix enum tags thanks to 2bc6db6 2017-11-25 06:16:30 +08:00			`<constant name="MODE_CANVAS_ITEM" value="1" enum="Mode">`
Finish up docs for materials 2020-01-21 08:28:03 +08:00			`Mode used to draw all 2D objects.`
Changed the doc class generation to individual files per class. It is also possible to save module files in module directories and the build system will recognize them. 2017-09-13 04:42:36 +08:00			`</constant>`
doc: Fix enum tags thanks to 2bc6db6 2017-11-25 06:16:30 +08:00			`<constant name="MODE_PARTICLES" value="2" enum="Mode">`
Finish up docs for materials 2020-01-21 08:28:03 +08:00			`Mode used to calculate particle information on a per-particle basis. Not used for drawing.`
Changed the doc class generation to individual files per class. It is also possible to save module files in module directories and the build system will recognize them. 2017-09-13 04:42:36 +08:00			`</constant>`
Working sky shader implementation 2020-03-20 08:32:19 +08:00			`<constant name="MODE_SKY" value="3" enum="Mode">`
			`Mode used for drawing skies. Only works with shaders attached to [Sky] objects.`
			`</constant>`
Addition of FogVolumes, FogShaders, FogMaterial, and overhaul of VolumetricFog Co-authored-by: Brian Semrau <brian.semrau@gmail.com> 2021-10-03 19:28:55 +08:00			`<constant name="MODE_FOG" value="4" enum="Mode">`
			`Mode used for setting the color and density of volumetric fog effect.`
			`</constant>`
Changed the doc class generation to individual files per class. It is also possible to save module files in module directories and the build system will recognize them. 2017-09-13 04:42:36 +08:00			`</constants>`
			`</class>`