CanvasTexture

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

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

描述

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

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

教程

• 2D 灯光和阴影

属性

属性说明

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 时所使用的纹理重复模式。

Previous Next

© 版权所有 2014-present Juan Linietsky, Ariel Manzur and the Godot community (CC BY 3.0). Revision b1c660f7.

Built with Sphinx using a theme provided by Read the Docs.