Up to date

This page is up to date for Godot 4.2. If you still find outdated information, please open an issue.

CompressedTexture2D

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

二维纹理，可选择压缩。

描述

一种从 .ctex 文件加载的纹理。这种文件格式是 Godot 内部使用的；它是通过导入系统导入其他图像格式创建的。CompressedTexture2D 可以使用 4 种压缩方法中的一种（包括没有任何压缩）：

  • 无损（WebP 或 PNG，在 GPU 上不压缩）

  • 有损（WebP，在 GPU 上不压缩）

  • VRAM 压缩（在 GPU 上压缩）

  • VRAM 未压缩（在 GPU 上不压缩）

  • Basis Universal（在 GPU 上压缩。与 VRAM 压缩相比，文件更小，但压缩速度更慢、质量更低）

只有 VRAM 压缩实际上减少了 GPU 上的内存使用。无损和有损压缩方法将减少磁盘上所需的存储空间，但它们不会减少 GPU 上的内存使用，因为纹理未经压缩地被发送到 GPU。

使用 VRAM 压缩还可以缩短加载时间，因为与使用无损或有损压缩的纹理相比，VRAM 压缩的纹理加载速度更快。VRAM 压缩会表现出明显的伪影，并且它旨在用于 3D 渲染，而不是 2D。

属性

String

load_path

""

bool

resource_local_to_scene

false (overrides Resource)

方法

Error

load ( String path )

属性说明

String load_path = ""

该 CompressedTexture2D 的文件路径，指向 .ctex 文件。

方法说明

Error load ( String path )

从指定的路径 path 加载纹理。