PortableCompressedTexture2D

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

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

描述

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

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

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

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

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

属性

PackedByteArray

_data

PackedByteArray()

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, CompressionMode compression_mode, bool normal_map=false, float lossy_quality=0.8 )

CompressionMode

get_compression_mode ( ) const

Format

get_format ( ) const

bool

is_keeping_all_compressed_buffers ( ) static

void

set_keep_all_compressed_buffers ( bool keep ) static


枚举

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 ( bool value )

  • bool is_keeping_compressed_buffer ( )

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

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


Vector2 size_override = Vector2(0, 0)

  • void set_size_override ( Vector2 value )

  • Vector2 get_size_override ( )

允许覆盖纹理大小(仅限 2D)。


方法说明

void create_from_image ( Image image, CompressionMode compression_mode, bool normal_map=false, float lossy_quality=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 ( bool keep ) static

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

Previous Next


© 版权所有 2014-present Juan Linietsky, Ariel Manzur and the Godot community (CC BY 3.0). Revision b1c660f7.

Built with Sphinx using a theme provided by Read the Docs.