DDS/KTX 文件读取器项目教程

1. 项目的目录结构及介绍

该项目包含以下主要文件和目录：

• README.md：项目的说明文件，包含了项目的基本信息和如何使用该项目。
• dds-ktx.h：单一头文件，包含了DDS/KTX文件读取器的所有实现。
• LICENSE：项目的许可证文件，本项目采用BSD-2-Clause协议。
• ctexview.c：一个简单的DDS/KTX文件查看器示例程序。
• .gitignore：Git忽略文件，指定了Git应该忽略的文件和目录。

项目的核心是dds-ktx.h，它是一个无需额外分配内存的单头文件库，用于读取DDS和KTX格式的图像文件。

2. 项目的启动文件介绍

项目的启动文件是ctexview.c，这是一个用于演示如何使用dds-ktx.h来加载和查看DDS或KTX图像文件的简单程序。以下是编译和使用ctexview的步骤：

编译

根据操作系统，使用以下命令编译ctexview.c：

• Windows:

  cl ctexview.c /O2
  

• Linux:

  gcc ctexview.c -O2 -lGL -ldl -lX11 -lXi -lXcursor -lm -o ctexview
  

• MacOS:

  clang -framework Foundation -framework CoreServices -framework CoreFoundation -O2 -fobjc-arc -x objective-c -fmodules -x objective-c ctexview.c -o ./ctexview
  

使用

编译成功后，通过以下命令查看图像：

ctexview [dds_or_ktx_image_file_path]

功能键

• UP/DOWN：更改当前 mip 层。
• Apostrophe：更改文本颜色。
• F：下一个立方体贴图面。
• R/G/B：切换红/绿/蓝通道。
• A：切换 Alpha 通道。

3. 项目的配置文件介绍

本项目不需要额外的配置文件。所有的设置都是通过在代码中定义宏来实现。例如，在示例程序ctexview.c中，通过定义DDSKTX_IMPLEMENT宏来包含dds-ktx.h头文件，然后使用load_file函数加载图像文件。

以下是一个基本的示例，展示如何在你的程序中使用dds-ktx.h：

#define DDSKTX_IMPLEMENT
#include "dds-ktx.h"

int size;
void* dds_data = load_file("test.dds", &size);
assert(dds_data);

ddsktx_texture_info tc = {0};
GLuint tex = 0;
if (ddsktx_parse(&tc, dds_data, size, NULL)) {
    assert(tc.depth == 1);
    assert(!(tc.flags & STC_TEXTURE_FLAG_CUBEMAP));
    assert(tc.num_layers == 1);

    // 创建 GPU 纹理
    glGenTextures(1, &tex);
    glActiveTexture(GL_TEXTURE0);
    glBindTexture(tc.gl_target, tex);
    for (int mip = 0; mip < tc.num_mips; mip++) {
        ddsktx_sub_data sub_data;
        ddsktx_get_sub(&tc, &sub_data, dds_data, size, 0, 0, mip);
        // 填充/设置纹理子资源数据（此处为 mip 层）
        if (ddsktx_format_compressed(tc.format))
            glCompressedTexImage2D(...);
        else
            glTexImage2D(...);
    }
    // 现在可以删除文件数据
    free(dds_data);
}

请根据你的项目需求，调整上述代码中的图像加载和纹理创建部分。