传奇游戏外观系统核心技术解析（一）

39传奇素材网

传奇采用独有的资源存储体系，其核心是WZL/WIL格式的图形包：

[backcolor=var(--ds-md-code-block-banner-wrap-background-color)][backcolor=var(--ds-md-code-block-banner-wrap-background-color)]一、外观系统基础架构解析
（一）资源存储的精密设计
c
/*
* WZL文件头结构解析
* 用途：定义游戏资源文件的基本结构
* 调用时机：游戏启动加载资源时
* 参数说明：
*   magic: 文件标识符（"WZL!"表示合法文件）
*   version: 文件格式版本号
*   count: 包含的图片数量
*/
struct WzlHeader {
    char magic[4];      // 文件标识
    uint16_t version;   // 版本号
    uint32_t count;     // 图片总数
    uint32_t index[0];  // 图片偏移数组（动态长度）
};


/*
* 图片元信息结构
* 用途：描述单张图片的属性信息
* 调用时机：加载具体图片资源时
* 参数说明：
*   width/height: 图片宽高
*   format: 像素格式（0=RGB565,1=RGBA4444）
*   dataSize: 压缩数据大小
*   dataOffset: 文件内数据偏移量
*/
struct ImageEntry {
    uint16_t width;     // 宽度
    uint16_t height;    // 高度
    uint8_t format;     // 像素格式
    uint8_t reserved[3];
    uint32_t dataSize;  // 压缩数据大小
    uint32_t dataOffset;// 数据偏移
};