画布项着色器

画布组件着色器用于绘制Godot中的所有二维元素。这包括从画布组件继承的所有节点，以及所有图形用户界面元素。

画布组件着色器比空间着色器包含更少的内置变量和功能，但它们与顶点、片段和光处理器功能保持相同的基本结构。

Render modes

Built-ins

Values marked as “in” are read-only. Values marked as “out” are for optional writing and will not necessarily contain sensible values. Values marked as “inout” provide a sensible default value, and can optionally be written to. Samplers are not subjects of writing and they are not marked.

Global built-ins

Global built-ins are available everywhere, including custom functions.

Vertex built-ins

Vertex data (VERTEX) is presented in local space (pixel coordinates, relative to the camera). If not written to, these values will not be modified and be passed through as they came.

The user can disable the built-in modelview transform (projection will still happen later) and do it manually with the following code:

shader_type canvas_item;
render_mode skip_vertex_transform;
void vertex() {
    VERTEX = (EXTRA_MATRIX * (WORLD_MATRIX * vec4(VERTEX, 0.0, 1.0))).xy;
}

注解

“世界_矩阵”实际上是一个模型视图矩阵。它接受本地空间中的输入，并将其转换为视图空间。

为了得到顶点的世界空间坐标，你必须通过一个定制的统一值，如下所示：

material.set_shader_param("global_transform", get_global_transform())

然后，在你的顶点着色器:

uniform mat4 global_transform;
varying vec2 world_position;
void vertex(){
    world_position = (global_transform * vec4(VERTEX, 0.0, 1.0)).xy;
}

“世界_位置”可用于顶点函数或片段函数。

Other built-ins, such as UV and COLOR, are also passed through to the fragment function if not modified.

对于实例化，INSTANCE_CUSTOM变量包含实例自定义数据。 使用粒子时，此信息通常是:

• ** x**: 以弧度表示的旋转角度。
• ** y**: 寿命期间的相位(0到1)。
• ** z**: 动画帧。

Fragment built-ins

某些节点(例如:ref:精灵 <class_Sprite>)默认情况下显示纹理。但是，当自定义片段函数附加到这些节点时，需要手工完成纹理的查找。Godot在“颜色”内置变量中不提供纹理颜色；要读取这些节点的纹理颜色，请使用：

COLOR = texture(TEXTURE, UV);

This differs from the behavior of the built-in normal map. If a normal map is attached, Godot uses it by default and assigns its value to the built-in NORMAL variable. If you are using a normal map meant for use in 3D, it will appear inverted. In order to use it in your shader, you must assign it to the NORMALMAP property. Godot will handle converting it for use in 2D and overwriting NORMAL.

NORMALMAP = texture(NORMAL_TEXTURE, UV).rgb;

内置灯光

光照处理器功能在二维中与在三维中工作不同。在画布组件着色时，着色器为被绘制的对象调用一次，然后每一束光接触场景中的物体一次。如果您不希望该对象发生任何光传递，请使用渲染_模式中的“无阴影”。如果您只想让光通过该对象，使用渲染_模式中的“仅有_光照”；当您只想让被光覆盖的对象可见时，这是非常有用的。

当着色器处于光通道时，“在_光照_通道”变量将为“真”。