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

Успадковує: Texture2D < Texture < Resource < RefCounted < Object

Текстура з додатковими нормалями та дзеркальними картами для використання у 2D-візуалізації.

Опис

CanvasTexture є альтернативою ImageTexture для двовимірної візуалізації. Це дозволяє використовувати нормальні карти та дзеркальні карти в будь-якому вузлі, який успадковує CanvasItem. CanvasTexture також дозволяє перевизначати фільтр текстури та режим повторення незалежно від властивостей вузла (або налаштувань проекту).

Примітка: CanvasTexture не можна використовувати в 3D. Він не відображатиметься належним чином, якщо застосовувати до будь-якого VisualInstance3D, наприклад Sprite3D або Decal. Для фізичних матеріалів у 3D замість цього використовуйте BaseMaterial3D.

Посібники

Властивості

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()

Звичайна текстура карти для використання. Має видимий ефект, лише якщо Light2D впливає на цю 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 🔗

Режим фільтрації текстури для використання під час малювання цієї CanvasTexture.


TextureRepeat texture_repeat = 0 🔗

Режим повторення текстури для використання під час малювання цієї CanvasTexture.