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

Format

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

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

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

Примітка: Щоб це набуло чинності, його потрібно встановити перед create_from_image().


Vector2 size_override = Vector2(0, 0) 🔗

Дозвольте переносити фактуру розміром (для 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 🔗

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


Format get_format() const 🔗

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


bool is_keeping_all_compressed_buffers() static 🔗

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


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 🔗

На відміну від прапора глобально для всіх текстур цього типу. Це використовується в першу чергу редактором.