Raylib项目中的大端系统GLB/GLTF模型加载问题解析

问题背景

Raylib是一个流行的跨平台游戏开发库，但在大端序(Big Endian)系统上加载GLB/GLTF模型文件时会出现解析和渲染问题。这个问题在PlayStation 3(PS3)和Wii/GameCube等大端序平台上尤为明显。

问题表现

当尝试在大端序系统上加载GLB/GLTF模型时，会出现以下症状：

1. GLB文件无法加载，因为cgltf.h使用了与端序相关的代码
2. GLTF文件虽然能被解析，但网格顶点、法线和索引数据加载不正确
3. 渲染结果出现严重变形，模型无法正确显示

根本原因分析

问题的根源在于GLB/GLTF文件格式采用小端序(Little Endian)存储数据，而大端序系统在解析这些数据时没有进行必要的字节序转换。

具体来说，存在两个主要问题点：

1. cgltf.h中的魔法数字检查：该文件直接比较内存中的32位值与预定义的魔法数字，没有考虑端序差异。

2. rmodels.c中的属性加载宏：LOAD_ATTRIBUTE_CAST宏直接将小端序数据读入大端序系统，导致浮点数和短整型数据的字节顺序错误。

解决方案

针对这些问题，可以采取以下解决方案：

1. 魔法数字检查修复： 在比较GLB文件头魔法数字时，需要先将读取的值从小端序转换为大端序系统所需的格式。

2. 属性加载宏修改： 修改LOAD_ATTRIBUTE_CAST宏，使其能够正确处理浮点数和短整型数据的字节序转换。具体实现可以添加条件判断，对float和unsigned short类型数据进行特殊处理。

3. 字节序转换函数： 使用系统提供的字节序转换函数(如__builtin_bswap32、__builtin_bswap16)或实现自定义的转换逻辑。

实现示例

以下是修改后的LOAD_ATTRIBUTE_CAST宏示例实现：

#define LOAD_ATTRIBUTE_CAST(accesor, numComp, srcType, dstPtr, dstType) \
{ \
    int n = 0; \
    srcType *buffer = (srcType *)accesor->buffer_view->buffer->data + \
                     accesor->buffer_view->offset/sizeof(srcType) + \
                     accesor->offset/sizeof(srcType); \
    char *dst_type_str = #dstType; \
    bool is_dst_float = false;\
    bool is_dst_ushort = false;\
    if (strcmp(dst_type_str, "float") == 0 ) {is_dst_float = true;} \
    if (strcmp(dst_type_str, "unsigned short") == 0 ) {is_dst_ushort = true;} \
    for (unsigned int k = 0; k < accesor->count; k++) \
    {\
        for (int l = 0; l < numComp; l++) \
        {\
            dstPtr[numComp*k + l] = (dstType)buffer[n + l];\
            if (is_dst_float)\
            {\
                union { uint32_t u; float f ;} x ;\
                x.f = dstPtr[numComp*k + l];\
                x.u = __builtin_bswap32(x.u);\
                dstPtr[numComp*k + l] = x.f;\
            }\
            if (is_dst_ushort)\
            {\
                dstPtr[numComp*k + l] = __builtin_bswap16(dstPtr[numComp*k + l]);\
            }\
        }\
        n += (int)(accesor->stride/sizeof(srcType));\
    }\
}

注意事项

1. 目前Raylib官方尚未全面支持大端序系统，因此在使用时需要注意其他可能存在的端序相关问题。

2. 纹理格式等其他资源在大端序系统上可能也存在类似问题，需要单独测试和处理。

3. 不同平台提供的字节序转换函数可能不同，需要根据目标平台进行调整。

结论

虽然Raylib官方尚未全面支持大端序系统，但通过针对性的修改，特别是对GLB/GLTF加载逻辑的调整，可以在大端序平台上实现基本的3D模型加载和渲染功能。开发者在使用时需要特别注意数据字节序的处理，确保跨平台兼容性。