BambuStudio学习笔记：stb

本文链接：https://blog.csdn.net/zzzkk2009/article/details/147238715

`stb_dxt` 库分析

1. 概述

stb_dxt 是 Sean Barrett 开发的 stb 单文件公共领域库集合的一部分，专门用于 DXT（S3TC）纹理压缩。DXT 是一种广泛使用的有损纹理压缩格式（如 DXT1/DXT5），可显著减少显存占用，适用于实时图形渲染（如 OpenGL/DirectX 游戏开发）。

2. 核心功能

• 支持的压缩格式：
• DXT1 (BC1)：支持 1-bit Alpha 或完全不透明纹理（4x4 像素块压缩为 8 字节）。
• DXT5 (BC3)：支持独立的 Alpha 通道（4x4 像素块压缩为 16 字节）。
• 实时压缩：提供 CPU 端的快速压缩实现。
• 质量优化：
• 支持基于颜色空间的聚类算法。
• 提供多种压缩质量模式（从快速低质量到慢速高质量）。

3. 优点

• 轻量级：单文件实现，无外部依赖，易于集成到项目中。
• 跨平台：兼容 C/C++，支持 Windows、Linux、macOS 等。
• 灵活性：允许自定义压缩参数（如颜色权重、Alpha 阈值）。
• 开源许可：公共领域（Public Domain）或 MIT 许可，可自由商用。
• 性能平衡：在速度和质量之间提供可调选项。

4. 缺点

• 功能限制：
• 不支持 BC4/BC5 等更新的压缩格式。
• 无 GPU 加速实现，纯 CPU 计算。
• 质量局限：相比专业工具（如 NVIDIA Texture Tools, libsquish），极端低码率下可能产生更明显的压缩伪影。
• 缺乏高级特性：如基于内容的自适应压缩、多线程优化等。

5. 使用示例

#define STB_DXT_IMPLEMENTATION
#include "stb_dxt.h"

// 压缩 DXT1 格式（RGBA 数据输入）
void compress_dxt1(const uint8_t* rgba_pixels, int width, int height, uint8_t* output) {
    for (int y = 0; y < height; y += 4) {
        for (int x = 0; x < width; x += 4) {
            // 提取 4x4 像素块
            uint8_t block[64];
            extract_4x4_rgba_block(rgba_pixels, x, y, width, block);
            
            // 压缩为 DXT1（质量模式：STB_DXT_HIGH）
            stb_compress_dxt_block(output, block, STB_DXT_HIGH | STB_DXT_DITHER_ALPHA);
            output += 8; // DXT1 每个块占 8 字节
        }
    }
}

6. 对比其他库

特性	`stb_dxt`	`libsquish`	NVIDIA Texture Tools
压缩速度	快	中等	慢（但支持 GPU）
压缩质量	中等	高	高
格式支持	DXT1/DXT5	DXT1-5	BC1-7 + 更多
依赖项	无	无	NVIDIA 驱动
适用场景	实时 CPU 压缩	高质量离线压缩	专业级 GPU 加速

7. 应用场景

• 实时纹理压缩：在游戏运行时动态生成压缩纹理（如程序化生成内容）。
• 工具链集成：作为轻量级压缩工具嵌入到图像处理流水线中。
• 内存受限环境：需要减少显存占用的移动端或嵌入式图形应用。

8. 注意事项

• 块状伪影：DXT 压缩在低对比度区域可能产生明显块状伪影，建议对高频细节纹理谨慎使用。
• Alpha 处理：DXT1 的 1-bit Alpha 可能不适用于半透明效果，需改用 DXT5。
• 性能调优：通过调整 STB_DXT_NORMAL/STB_DXT_HIGH 等参数平衡速度和质量。