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 — это альтернатива ImageTexture для 2D-рендеринга. Она позволяет использовать карты нормалей и карты отражений в любом узле, который наследует от CanvasItem. CanvasTexture также позволяет переопределять фильтр текстуры и режим повторения независимо от свойств узла (или настроек проекта).

Примечание: CanvasTexture нельзя использовать в 3D. Она не будет отображаться правильно при применении к любому VisualInstance3D, например Sprite3D или Decal. Для физически обоснованных материалов в 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(value: Texture2D)
Texture2D get_diffuse_texture()

Диффузная (цветная) текстура для использования. Это основная текстура, которую вы хотите установить в большинстве случаев.

Texture2D normal_texture 🔗

void set_normal_texture(value: Texture2D)
Texture2D get_normal_texture()

Текстура карты нормалей для использования. Имеет видимый эффект, только если Light2Ds влияют на эту CanvasTexture.

Примечание: Godot ожидает, что карта нормалей будет использовать координаты X+, Y+ и Z+. См. эту страницу для сравнения координат карты нормалей, ожидаемых популярными движками.

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

void set_specular_color(value: Color)
Color get_specular_color()

Множитель для цветов зеркального отражения. Цвет Light2D также учитывается при определении цвета отражения. Имеет видимый эффект только в том случае, если Light2D влияют на эту CanvasTexture.

float specular_shininess = 1.0 🔗

void set_specular_shininess(value: float)
float get_specular_shininess()

Зеркальный показатель для зеркальных отражений Light2D. Более высокие значения приводят к более глянцевому/"мокрому" виду, при этом отражения становятся более локализованными и менее заметными в целом. Значение по умолчанию 1.0 полностью отключает зеркальные отражения. Оказывает видимый эффект, только если Light2D влияют на эту CanvasTexture.

Texture2D specular_texture 🔗

void set_specular_texture(value: Texture2D)
Texture2D get_specular_texture()

Карта отражений, используемая для зеркальных отражений Light2D. Это должна быть текстура в оттенках серого или цветная, с более яркими областями, дающими более высокое значение specular_shininess. Использование цветной specular_texture позволяет управлять зеркальным блеском на основе каждого канала. Имеет видимый эффект, только если Light2D влияют на эту CanvasTexture.

TextureFilter texture_filter = 0 🔗

void set_texture_filter(value: TextureFilter)
TextureFilter get_texture_filter()

Режим фильтрации текстуры, используемый при рисовании CanvasTexture.

TextureRepeat texture_repeat = 0 🔗

void set_texture_repeat(value: TextureRepeat)
TextureRepeat get_texture_repeat()

Режим повторения текстуры, используемый при рисовании CanvasTexture.