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

PortableCompressedTexture2D

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

Забезпечує компресовану текстуру для диска та / або VRAM таким чином, що портативний.

Опис

Даний клас дозволяє зберігати стиснені фактури як самостійні (не імпортні) ресурси.

Для 2D використання (встановлюються на диску, непривабливі на VRAM), рекомендовані режими втрати та без втрат. Для 3D використання (встановлюється на VRAM) залежить від цільової платформи.

Якщо ви хочете використовувати робочий стіл, S3TC або BPTC рекомендується. Для мобільних пристроїв ETC2 рекомендується.

Для портативних, самовживаних 3D текстур, які працюють як на робочому столі, так і на мобільних пристроях, Basis Universal рекомендується (хоча вона має невелику вартість якості і більш тривалий час стиснення як Tradeoff).

Цей ресурс призначений для створення з коду.

Властивості

bool	keep_compressed_buffer	`false`
bool	resource_local_to_scene	`false` (overrides Resource)
Vector2	size_override	`Vector2(0, 0)`

Методи

void	create_from_image(image: Image, compression_mode: CompressionMode, normal_map: bool = false, lossy_quality: float = 0.8)
CompressionMode	get_compression_mode() const
bool	is_keeping_all_compressed_buffers() static
void	set_basisu_compressor_params(uastc_level: int, rdo_quality_loss: float)
void	set_keep_all_compressed_buffers(keep: bool) static

Переліки

enum CompressionMode: 🔗

CompressionMode COMPRESSION_MODE_LOSSLESS = 0

There is currently no description for this enum. Please help us by contributing one!

CompressionMode COMPRESSION_MODE_LOSSY = 1

There is currently no description for this enum. Please help us by contributing one!

CompressionMode COMPRESSION_MODE_BASIS_UNIVERSAL = 2

There is currently no description for this enum. Please help us by contributing one!

CompressionMode COMPRESSION_MODE_S3TC = 3

There is currently no description for this enum. Please help us by contributing one!

CompressionMode COMPRESSION_MODE_ETC2 = 4

There is currently no description for this enum. Please help us by contributing one!

CompressionMode COMPRESSION_MODE_BPTC = 5

There is currently no description for this enum. Please help us by contributing one!

CompressionMode COMPRESSION_MODE_ASTC = 6

There is currently no description for this enum. Please help us by contributing one!

Описи властивостей

bool keep_compressed_buffer = false 🔗

void set_keep_compressed_buffer(value: bool)
bool is_keeping_compressed_buffer()

Якщо true, то під час запуску в редакторі ця текстура зберігатиме стиснуті з джерела дані в пам'яті, дозволяючи даним зберігатися після завантаження. В іншому випадку стиснуті з джерела дані втрачаються після завантаження, і текстуру не можна буде повторно зберегти.

Примітка: Цю властивість потрібно встановити перед create_from_image(), щоб це працювало.

Vector2 size_override = Vector2(0, 0) 🔗

void set_size_override(value: Vector2)
Vector2 get_size_override()

Дозволяє змінити розмір текстури (лише для 2D).

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

void create_from_image(image: Image, compression_mode: CompressionMode, normal_map: bool = false, lossy_quality: float = 0.8) 🔗

Первинує стиснену текстуру з основного зображення. Режим стиснення необхідно надати.

normal_map рекомендується забезпечити оптимальну якість, якщо це зображення буде використовуватися як нормальна карта.

Якщо за запитом про втрату стиснення, налаштування якості може бути додатково. Ця карта для втрати якості стиснення WebP.

CompressionMode get_compression_mode() const 🔗

Повернути режим стиснення, який використовується (оплачується після ініціалізації).

bool is_keeping_all_compressed_buffers() static 🔗

Повертає true, якщо прапорець перевизначено для всіх текстур цього типу.

void set_basisu_compressor_params(uastc_level: int, rdo_quality_loss: float) 🔗

Встановлює параметри компресора для стиснення Basis Universal. Див. також налаштування в ResourceImporterTexture.

Примітка: Цей метод має бути викликаний перед create_from_image(), щоб це спрацювало.

void set_keep_all_compressed_buffers(keep: bool) static 🔗

Якщо keep має значення true, прапорець глобально замінюється для всіх текстур цього типу. Це використовується переважно редактором.