Lanzainc 存档数据格式

出于对 Lanzainc 系列产品的联动、兼容及其它功能的考虑，现设计在系列范围内通用的存档封装

下文中，Lanzainc 存档数据格式统一简称为 LSD

概述

LSD 采用和 PNG 文件相同的结构，以 PNG 数据块为基础组成部分，即：

名称	设计尺寸	说明
PNG 标识符	8 字节	89 50 4E 47 0D 0A 1A 0A
PNG 数据块	不定长	任意数据块，可以是图像数据，也可以是自定义数据
……	……	……
PNG 结尾块	12 字节	标识为 `IEND` 的数据块，不持有实际数据

数据块结构

顺位	名称	设计尺寸	说明
1	长度(大端序)	4 字节	该数据块中存储实际数据的长度
2	类型	4 字节	4 字节长的 ASCII 字符组，标识该数据块的类型
3	实际数据	不定长	该数据块中存储的实际数据
4	CRC(大端序)	4 字节	校验值

数据块类型

现存有意义的数据块类型

下列的数据块类型，在当前 PNG 结构中很常见，并发挥一定的作用；

它们不会（也不应）影响 LSD 的行为，在读写时保持其原样存在即可

类型	说明	数目	位置
`IHDR`	文件头数据块	1 个	第一块
`cHRM`	基色和白色点数据块	至多 1 个	在 `PLTE` 和 `IDAT` 之前
`gAMA`	图像 γ 数据块	至多 1 个	在 `PLTE` 和 `IDAT` 之前
`sBIT`	样本有效位数据块	至多 1 个	在 `PLTE` 和 `IDAT` 之前
`PLTE`	调色板数据块	至多 1 个	在 `IDAT` 之前
`bKGD`	背景颜色数据块	至多 1 个	在 `PLTE` 之后；`IDAT` 之前
`hIST`	图像直方图数据块	至多 1 个	在 `PLTE` 之后；`IDAT` 之前
`tRNS`	图像透明数据块	至多 1 个	在 `PLTE` 之后；`IDAT` 之前
`oFFs`	(专用公共数据块)	至多 1 个	在 `IDAT` 之前
`pHYs`	物理像素尺寸数据块	至多 1 个	在 `IDAT` 之前
`sCAL`	(专用公共数据块)	至多 1 个	在 `IDAT` 之前
`IDAT`	图像数据块	至少 1 个	和其它 `IDAT` 连续
`tIME`	图像最后修改时间数据块	至多 1 个	任意
`tEXt`	文本信息数据块	任意个	任意
`zTXt`	压缩文本数据块	任意个	任意
`fRAc`	(专用公共数据块)	任意个	任意
`glFg`	(专用公共数据块)	任意个	任意
`glFt`	(专用公共数据块)	任意个	任意
`glFx`	(专用公共数据块)	任意个	任意
`IEND`	文件尾数据块	1 个	最后一块

`LSD` 定义的数据块类型

下列的数据块类型，是真正组成 LSD 的部分

类型	说明	数目	位置
`.LSD`	`LSD` 元数据块	至多 1 个	任意
`.LDT`	`LSD` 普通数据块	任意个	在 `.LSD` 之后
`.LRF`	`LSD` 运行时文件数据块	任意个	在 `.LSD` 之后
`.LOM`	`LSD` ROM 数据块	任意个	在 `.LSD` 之后

特殊数据块结构

`.LSD` 元数据块

只有此数据块存在时，此 PNG 文件才被视为 LSD

元数据块应有如下的标准结构：

顺位	名称	设计尺寸	说明
1	产品标识码	8 字节	8 字节长的 ASCII 字符组，标识该文件存储的是源于哪个系列产品的数据
2	版本信息	8 字节	8 字节长的 ASCII 字符组，标识该文件存储的数据版本，可用于兼容性判断等
3	端序标记	1 字节	表示最后保存数据时使用的字节序 `0x0A` 为大端序；`0x0C` 为小端序
4	保留（填充）字段 0	3 字节	暂无使用场景
5	保留（填充）字段 1	4 字节	暂无使用场景
6	保留（填充）字段 2	8 字节	暂无使用场景

`.LDT` 普通数据块(`LSD` Data)

一般来说，此数据块都是自定义的数据，可以根据元数据块的信息决定解析的方式；这也应该是最通用的数据部分

`.LRF` 运行时文件数据块(`LSD` Runtime File)

此数据块存储在运行时进行释放的文件数据；即：读档时，此数据块的全部内容会被释放到 目标目录 下，存档时，这些内容也应以此数据块的形式存入存档中；游戏结束时，这些文件需被清理

典型的应用场景为数据库

本数据块应有如下的标准结构：

顺位	名称	设计尺寸	说明
1	目标目录类型	1 字节	`0x3A` 为用户目录；`0x5A` 为临时文件目录
2	压缩类型	1 字节	`0x1A` 为不压缩；`0x1F` 为 `deflate`；`0x22` 为 `LZ4`
3	保留（填充）字段	2 字节	暂无使用场景
4	相对路径	不定长	说明此运行时文件的释放路径
5	文件数据	不定长	此文件的存储数据，其长度就是此数据块的剩余长度

`.LOM` ROM 数据块(`LSD` Rom)

在特殊的系列作品中，此数据块会被映射为某种内存区域，通过寻址方式来访问；然而，真正访问文件的效率必然不高，所以通常此数据块的内容会被读入另准备的 ROM 缓冲区，再做处理