Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

CanvasTexture

继承： Texture2D < Texture < Resource < RefCounted < Object

用于 2D 渲染的纹理，带有可选的法线和镜面贴图。

描述

CanvasTexture 是用于 2D 渲染的 ImageTexture 的替代品。它允许在任何继承自 CanvasItem 的节点中使用法线贴图和镜面贴图。CanvasTexture 还允许独立于节点的属性（或项目设置）覆盖纹理的过滤模式和重复模式。

注意：CanvasTexture 不能用于 3D 渲染。对于 3D 中基于物理的材质，请使用 BaseMaterial3D 来代替。

教程

• 2D 灯光和阴影

属性

Texture2D	diffuse_texture
Texture2D	normal_texture
bool	resource_local_to_scene	false (overrides Resource)
Color	specular_color	Color(1, 1, 1, 1)
float	specular_shininess	1.0
Texture2D	specular_texture
TextureFilter	texture_filter	0
TextureRepeat	texture_repeat	0

---

属性说明

Texture2D diffuse_texture

• void set_diffuse_texture ( Texture2D value )

• Texture2D get_diffuse_texture ( )

要使用的漫反射（颜色）纹理。这是你在大多数情况下要设置的主要纹理。

---

Texture2D normal_texture

• void set_normal_texture ( Texture2D value )

• Texture2D get_normal_texture ( )

要使用的法线贴图纹理。仅在有 Light2D 影响该 CanvasTexture 时才有可见的效果。

注意：Godot 期望法线贴图使用 X+、Y+、Z+ 坐标系。比较流行的引擎所期望的法线贴图坐标系见这个页面。

---

Color specular_color = Color(1, 1, 1, 1)

• void set_specular_color ( Color value )

• Color get_specular_color ( )

镜面反射颜色的乘数。在确定反射颜色时，Light2D 的颜色也会被考虑在内。只有在 Light2D 影响到这个 CanvasTexture 时才有可见的效果。

---

float specular_shininess = 1.0

• void set_specular_shininess ( float value )

• float get_specular_shininess ( )

用于 Light2D 镜面反射的镜面指数。更高的值会产生更有光泽或更加“湿润”的外观，反射变得更局部，且整体上不太明显。默认值为 1.0 ，将完全禁用镜面反射。只有在 Light2D 影响到这个 CanvasTexture 时才会有可见的效果。

---

Texture2D specular_texture

• void set_specular_texture ( Texture2D value )

• Texture2D get_specular_texture ( )

用于 Light2D 镜面反射的镜面贴图。这应该是一个灰度或彩色纹理，更亮的区域会产生更高的 specular_shininess 值。使用彩色 specular_texture 允许在每个通道的基础上控制镜面反射光泽度。仅当 Light2D 影响该 CanvasTexture 时才有可见的效果。

---

TextureFilter texture_filter = 0

• void set_texture_filter ( TextureFilter value )

• TextureFilter get_texture_filter ( )

绘制该 CanvasTexture 时所使用的纹理过滤模式。

---

TextureRepeat texture_repeat = 0

• void set_texture_repeat ( TextureRepeat value )

• TextureRepeat get_texture_repeat ( )

绘制该 CanvasTexture 时所使用的纹理重复模式。