ImageTexture

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

Texture2D на основі Image.

Опис

Texture2D на основі Image. Щоб зображення було відображено, з нього потрібно створити ImageTexture за допомогою методу create_from_image():

Image.load_from_file("res://icon.svg")
var texture = ImageTexture.create_from_image(image)
$Sprite2D.texture = текстура

Таким чином текстури можна створювати під час виконання, завантажуючи зображення як із редактора, так і ззовні.

Попередження: краще завантажувати імпортовані текстури за допомогою @GDScript.load(), а не динамічно завантажувати їх із файлової системи за допомогою Image.load(), оскільки це може не працювати в експортованих проектах:

var texture = load("res://icon.svg")
$Sprite2D.texture = текстура

Це пояснюється тим, що зображення потрібно імпортувати як CompressedTexture2D, щоб завантажити їх за допомогою @GDScript.load(). Якщо ви все одно хочете завантажити файл зображення, як і будь-який інший Resource, імпортуйте його як ресурс Image, а потім завантажте його звичайним способом за допомогою методу @GDScript.load().

Примітка. Зображення можна отримати з імпортованої текстури за допомогою методу Texture2D.get_image(), який повертає копію зображення:

var texture = load("res://icon.svg")
var image = texture.get_image()

ImageTexture не призначений для безпосереднього керування з інтерфейсу редактора, і він здебільшого корисний для динамічного відтворення зображень на екрані за допомогою коду. Якщо вам потрібно процедурно генерувати зображення з редактора, розгляньте можливість збереження та імпорту зображень як користувальницьких текстурних ресурсів за допомогою нового EditorImportPlugin.

Примітка: Максимальний розмір текстури становить 16384 × 16384 пікселів через обмеження графічного обладнання.

Посібники

Властивості

bool

resource_local_to_scene

false (overrides Resource)

Методи

ImageTexture

create_from_image(image: Image) static

Format

get_format() const

void

set_image(image: Image)

void

set_size_override(size: Vector2i)

void

update(image: Image)

Описи методів

ImageTexture create_from_image(image: Image) static 🔗

Створює нові ImageTexture і ініціалізує його шляхом виділення та налаштування даних з Image.

Format get_format() const 🔗

Повертає формат текстури.

void set_image(image: Image) 🔗

Замінює дані текстури з новим Image. Це перетворить нову пам'ять для текстури.

Якщо ви хочете оновити зображення, але не потрібно змінити його параметри (формат, розмір), скористайтеся update() замість кращої продуктивності.

void set_size_override(size: Vector2i) 🔗

Зменшення текстури до зазначених розмірів.

void update(image: Image) 🔗

Замінює дані текстури з новим Image.

Примітка: Текстура повинна бути створена за допомогою create_from_image() або ініціалізованого першого з методом set_image() до його можна оновити. Налаштування нових розмірів зображень, форматів та mipmaps повинна відповідати існуючій конфігурації зображення текстури.

Використовуйте цей метод над set_image(), якщо вам потрібно оновити фактуру часто, що швидше, ніж виділення додаткової пам'яті для нової текстури кожного разу.