summaryrefslogtreecommitdiff
path: root/doc/classes/VisualShaderNodeTextureParameter.xml
blob: 333226dc58e9e1b4c0e63697357bbf8d52846431 (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
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
<?xml version="1.0" encoding="UTF-8" ?>
<class name="VisualShaderNodeTextureParameter" inherits="VisualShaderNodeParameter" version="4.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../class.xsd">
	<brief_description>
		Performs a uniform texture lookup within the visual shader graph.
	</brief_description>
	<description>
		Performs a lookup operation on the texture provided as a uniform for the shader.
	</description>
	<tutorials>
	</tutorials>
	<members>
		<member name="color_default" type="int" setter="set_color_default" getter="get_color_default" enum="VisualShaderNodeTextureParameter.ColorDefault" default="0">
			Sets the default color if no texture is assigned to the uniform.
		</member>
		<member name="texture_filter" type="int" setter="set_texture_filter" getter="get_texture_filter" enum="VisualShaderNodeTextureParameter.TextureFilter" default="0">
			Sets the texture filtering mode. See [enum TextureFilter] for options.
		</member>
		<member name="texture_repeat" type="int" setter="set_texture_repeat" getter="get_texture_repeat" enum="VisualShaderNodeTextureParameter.TextureRepeat" default="0">
			Sets the texture repeating mode. See [enum TextureRepeat] for options.
		</member>
		<member name="texture_type" type="int" setter="set_texture_type" getter="get_texture_type" enum="VisualShaderNodeTextureParameter.TextureType" default="0">
			Defines the type of data provided by the source texture. See [enum TextureType] for options.
		</member>
	</members>
	<constants>
		<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]source_color[/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_ANISOTROPY" value="3" enum="TextureType">
			Adds [code]hint_anisotropy[/code] as hint to the uniform declaration to use for a flowmap.
		</constant>
		<constant name="TYPE_MAX" value="4" enum="TextureType">
			Represents the size of the [enum TextureType] enum.
		</constant>
		<constant name="COLOR_DEFAULT_WHITE" value="0" enum="ColorDefault">
			Defaults to fully opaque white color.
		</constant>
		<constant name="COLOR_DEFAULT_BLACK" value="1" enum="ColorDefault">
			Defaults to fully opaque black color.
		</constant>
		<constant name="COLOR_DEFAULT_TRANSPARENT" value="2" enum="ColorDefault">
			Defaults to fully transparent black color.
		</constant>
		<constant name="COLOR_DEFAULT_MAX" value="3" enum="ColorDefault">
			Represents the size of the [enum ColorDefault] enum.
		</constant>
		<constant name="FILTER_DEFAULT" value="0" enum="TextureFilter">
			Sample the texture using the filter determined by the node this shader is attached to.
		</constant>
		<constant name="FILTER_NEAREST" value="1" enum="TextureFilter">
			The texture filter reads from the nearest pixel only. The simplest and fastest method of filtering, but the texture will look pixelized.
		</constant>
		<constant name="FILTER_LINEAR" value="2" enum="TextureFilter">
			The texture filter blends between the nearest four pixels. Use this for most cases where you want to avoid a pixelated style.
		</constant>
		<constant name="FILTER_NEAREST_MIPMAP" value="3" enum="TextureFilter">
			The texture filter reads from the nearest pixel in the nearest mipmap. This is the fastest way to read from textures with mipmaps.
		</constant>
		<constant name="FILTER_LINEAR_MIPMAP" value="4" enum="TextureFilter">
			The texture filter blends between the nearest 4 pixels and between the nearest 2 mipmaps. Use this for non-pixel art textures that may be viewed at a low scale (e.g. due to [Camera2D] zoom), as mipmaps are important to smooth out pixels that are smaller than on-screen pixels.
		</constant>
		<constant name="FILTER_NEAREST_MIPMAP_ANISOTROPIC" value="5" enum="TextureFilter">
			The texture filter reads from the nearest pixel, but selects a mipmap based on the angle between the surface and the camera view. This reduces artifacts on surfaces that are almost in line with the camera. The anisotropic filtering level can be changed by adjusting [member ProjectSettings.rendering/textures/default_filters/anisotropic_filtering_level].
			[b]Note:[/b] This texture filter is rarely useful in 2D projects. [constant FILTER_LINEAR_MIPMAP] is usually more appropriate.
		</constant>
		<constant name="FILTER_LINEAR_MIPMAP_ANISOTROPIC" value="6" enum="TextureFilter">
			The texture filter blends between the nearest 4 pixels and selects a mipmap based on the angle between the surface and the camera view. This reduces artifacts on surfaces that are almost in line with the camera. This is the slowest of the filtering options, but results in the highest quality texturing. The anisotropic filtering level can be changed by adjusting [member ProjectSettings.rendering/textures/default_filters/anisotropic_filtering_level].
			[b]Note:[/b] This texture filter is rarely useful in 2D projects. [constant FILTER_LINEAR_MIPMAP] is usually more appropriate.
		</constant>
		<constant name="FILTER_MAX" value="7" enum="TextureFilter">
			Represents the size of the [enum TextureFilter] enum.
		</constant>
		<constant name="REPEAT_DEFAULT" value="0" enum="TextureRepeat">
			Sample the texture using the repeat mode determined by the node this shader is attached to.
		</constant>
		<constant name="REPEAT_ENABLED" value="1" enum="TextureRepeat">
			Texture will repeat normally.
		</constant>
		<constant name="REPEAT_DISABLED" value="2" enum="TextureRepeat">
			Texture will not repeat.
		</constant>
		<constant name="REPEAT_MAX" value="3" enum="TextureRepeat">
			Represents the size of the [enum TextureRepeat] enum.
		</constant>
	</constants>
</class>