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.

CanvasTexture

Hereda: Texture2D < Texture < Resource < RefCounted < Object

Textura con mapas normales y especulares opcionales para su uso en renderizado 2D.

Descripción

CanvasTexture es una alternativa a ImageTexture para renderizado 2D. Permite usar mapas normales y mapas especulares en cualquier nodo que herede de CanvasItem. CanvasTexture también permite sobrescribir el modo de filtro y repetición de la textura independientemente de las propiedades del nodo (o project settings).

Nota: CanvasTexture no se puede usar en 3D. No se mostrará correctamente al aplicarse a cualquier VisualInstance3D, como Sprite3D o Decal. Para materiales basados en física en 3D, usa BaseMaterial3D en su lugar.

Tutoriales

Propiedades

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


Descripciones de Propiedades

Texture2D diffuse_texture 🔗

La textura difusa (color) a usar. Esta es la textura principal que querrás establecer en la mayoría de los casos.


Texture2D normal_texture 🔗

The normal map texture to use. Only has a visible effect if Light2Ds are affecting this CanvasTexture.

Note: Godot expects the normal map to use X+, Y+, and Z+ coordinates. See this page for a comparison of normal map coordinates expected by popular engines.


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

  • void set_specular_color(value: Color)

  • Color get_specular_color()

El multiplicador para los colores de reflexión especular. El color de Light2D también se tiene en cuenta al determinar el color de reflexión. Solo tiene un effect visible si los Light2D afectan a este CanvasTexture.


float specular_shininess = 1.0 🔗

  • void set_specular_shininess(value: float)

  • float get_specular_shininess()

El exponente especular para los reflejos especulares de Light2D. Los values más altos resultan en un aspecto más lustroso/"húmedo", con los reflejos volviéndose más localizados y menos visibles en general. El value predeterminado de 1.0 desactiva los reflejos especulares por completo. Solo tiene un effect visible si los Light2D están afectando a este CanvasTexture.


Texture2D specular_texture 🔗

El mapa especular a usar para los reflejos especulares de Light2D. Debe ser una textura en escala de grises o coloreada, con áreas más brillantes que resulten en un specular_shininess value más alto. Usar un specular_texture coloreado permite controlar el brillo especular por canal. Solo tiene un effect visible si los Light2D están afectando a este CanvasTexture.


TextureFilter texture_filter = 0 🔗

El modo de filtrado de textura a utilizar al dibujar esta CanvasTexture.


TextureRepeat texture_repeat = 0 🔗

El modo de repetición de textura a utilizar al dibujar esta CanvasTexture.