summaryrefslogtreecommitdiff
path: root/doc/classes/VisualShaderNodeTexture.xml
blob: 38fa98b21eb0d0513ad5875d4cfd28befaeec9a1 (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
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
<?xml version="1.0" encoding="UTF-8" ?>
<class name="VisualShaderNodeTexture" inherits="VisualShaderNode" version="4.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../class.xsd">
	<brief_description>
		Performs a 2D texture lookup within the visual shader graph.
	</brief_description>
	<description>
		Performs a lookup operation on the provided texture, with support for multiple texture sources to choose from.
	</description>
	<tutorials>
	</tutorials>
	<members>
		<member name="source" type="int" setter="set_source" getter="get_source" enum="VisualShaderNodeTexture.Source" default="0">
			Determines the source for the lookup. See [enum Source] for options.
		</member>
		<member name="texture" type="Texture2D" setter="set_texture" getter="get_texture">
			The source texture, if needed for the selected [member source].
		</member>
		<member name="texture_type" type="int" setter="set_texture_type" getter="get_texture_type" enum="VisualShaderNodeTexture.TextureType" default="0">
			Specifies the type of the texture if [member source] is set to [constant SOURCE_TEXTURE]. See [enum TextureType] for options.
		</member>
	</members>
	<constants>
		<constant name="SOURCE_TEXTURE" value="0" enum="Source">
			Use the texture given as an argument for this function.
		</constant>
		<constant name="SOURCE_SCREEN" value="1" enum="Source">
			Use the current viewport's texture as the source.
		</constant>
		<constant name="SOURCE_2D_TEXTURE" value="2" enum="Source">
			Use the texture from this shader's texture built-in (e.g. a texture of a [Sprite2D]).
		</constant>
		<constant name="SOURCE_2D_NORMAL" value="3" enum="Source">
			Use the texture from this shader's normal map built-in.
		</constant>
		<constant name="SOURCE_DEPTH" value="4" enum="Source">
			Use the depth texture captured during the depth prepass. Only available when the depth prepass is used (i.e. in spatial shaders and in the forward_plus or gl_compatibility renderers).
		</constant>
		<constant name="SOURCE_PORT" value="5" enum="Source">
			Use the texture provided in the input port for this function.
		</constant>
		<constant name="SOURCE_3D_NORMAL" value="6" enum="Source">
			Use the normal buffer captured during the depth prepass. Only available when the normal-roughness buffer is available (i.e. in spatial shaders and in the forward_plus renderer).
		</constant>
		<constant name="SOURCE_ROUGHNESS" value="7" enum="Source">
			Use the roughness buffer captured during the depth prepass. Only available when the normal-roughness buffer is available (i.e. in spatial shaders and in the forward_plus renderer).
		</constant>
		<constant name="SOURCE_MAX" value="8" enum="Source">
			Represents the size of the [enum Source] enum.
		</constant>
		<constant name="TYPE_DATA" value="0" enum="TextureType">
			No hints are added to the uniform declaration.
		</constant>
		<constant name="TYPE_COLOR" value="1" enum="TextureType">
			Adds [code]hint_albedo[/code] as hint to the uniform declaration for proper sRGB to linear conversion.
		</constant>
		<constant name="TYPE_NORMAL_MAP" value="2" enum="TextureType">
			Adds [code]hint_normal[/code] as hint to the uniform declaration, which internally converts the texture for proper usage as normal map.
		</constant>
		<constant name="TYPE_MAX" value="3" enum="TextureType">
			Represents the size of the [enum TextureType] enum.
		</constant>
	</constants>
</class>