PortableCompressedTexture2D

继承： Texture2D < Texture < Resource < RefCounted < Object

为磁盘和/或显存提供可移植的压缩纹理。

描述

这个类能够将压缩纹理存储为自包含的资源（与导入资源相对）。

用于 2D 时（在磁盘上压缩、在显存中不压缩）推荐使用有损和无损模式。用于 3D 时（在显存中压缩）则取决于目标平台。

如果你只想用于桌面平台，则推荐使用 S3TC 或 BPTC。如果只用于移动平台，则推荐使用 ETC2。

如果要实现可移植、自包含的 3D 纹理，让这种纹理能同时在桌面和移动平台使用，则推荐 Basis Universal（尽管代价是有较小的质量损耗和更长的压缩时间）。

这个资源应使用代码创建。

属性

方法

枚举

enum CompressionMode: 🔗

CompressionMode COMPRESSION_MODE_LOSSLESS = 0

该枚举目前没有描述，请帮我们贡献一个吧！

CompressionMode COMPRESSION_MODE_LOSSY = 1

该枚举目前没有描述，请帮我们贡献一个吧！

CompressionMode COMPRESSION_MODE_BASIS_UNIVERSAL = 2

该枚举目前没有描述，请帮我们贡献一个吧！

CompressionMode COMPRESSION_MODE_S3TC = 3

该枚举目前没有描述，请帮我们贡献一个吧！

CompressionMode COMPRESSION_MODE_ETC2 = 4

该枚举目前没有描述，请帮我们贡献一个吧！

CompressionMode COMPRESSION_MODE_BPTC = 5

该枚举目前没有描述，请帮我们贡献一个吧！

属性说明

PackedByteArray _data = PackedByteArray() 🔗

该属性目前没有描述，请帮我们贡献一个吧！

bool keep_compressed_buffer = false 🔗

• void set_keep_compressed_buffer(value: bool)

• bool is_keeping_compressed_buffer()

在编辑器中运行时，这个类会将来源压缩数据保持在内存中。否则加载资源后来源压缩数据就会丢失，资源也无法重新保存。

如果你要在加载后再次进行持久化，这个标志能够让压缩数据保持在内存中。

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 🔗

返回使用的压缩模式（初始化后有效）。

Format get_format() const 🔗

返回使用的图像格式（初始化后有效）。

bool is_keeping_all_compressed_buffers() static 🔗

返回是否为所有该类型的纹理覆盖该标志。

void set_keep_all_compressed_buffers(keep: bool) static 🔗

为该类型的所有纹理全局覆盖该标志。主要由编辑器使用。