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...

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
void	set_image(image: Image)
void	set_size_override(size: Vector2i)
void	update(image: Image)

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

ImageTexture create_from_image(image: Image) static 🔗

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

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(), якщо вам потрібно оновити фактуру часто, що швидше, ніж виділення додаткової пам'яті для нової текстури кожного разу.