aba

type Aba struct {
	Header     AbaHeader       // 文件头 / File header
	BlockInfo  BlockAndDirInfo // 压缩块和目录信息 / Compressed block and directory information
	DataReader io.ReadSeeker   // 压缩数据区 reader；各块按需解压 / Compressed data-area reader; blocks are decompressed on demand
	// contains filtered or unexported fields
}

type AbaEntryWriteFunc func(io.Writer) error

type AbaFileEntry struct {
	Name         string            // 文件名，如 "CAB-xxx" / File name such as "CAB-xxx"
	Data         []byte            // 文件数据 / File data
	ReaderAt     io.ReaderAt       // 大型文件的范围读取源，与 Data 互斥 / Range-readable source for a large file, mutually exclusive with Data
	WriteTo      AbaEntryWriteFunc // 可重复调用的流式生成器，与 Data 和 ReaderAt 互斥 / Repeatable streaming generator, mutually exclusive with Data and ReaderAt
	Size         int64             // ReaderAt 或 WriteTo 提供的精确文件大小，使用 Data 时可为零 / Exact size supplied by ReaderAt or WriteTo, or zero when Data is used
	IsSerialized bool              // 是否为序列化 AssetsFile / Whether this entry is a serialized AssetsFile
}

type AbaFileRangeResolver func(name string, offset int64, size int64) ([]byte, error)

type AbaFileResolver func(name string) ([]byte, error)

type AbaHeader struct {
	Signature         string   // 签名，受支持的明文值为 "UnityFS" / Signature, with "UnityFS" as the supported plaintext value
	Version           uint32   // UnityFS 文件格式版本，当前支持 6 至 8 / UnityFS file-format version, currently supporting 6 through 8
	GenerationVersion string   // NUL 结尾的生成版本字符串，如 "5.x.x" / NUL-terminated generation-version string such as "5.x.x"
	EngineVersion     string   // NUL 结尾的 Unity 引擎版本字符串 / NUL-terminated Unity engine-version string
	FSHeader          FSHeader // 文件流头部 / File stream header
}

type AbaWriteOptions struct {
	EngineVersion     string // Unity 引擎版本，默认固定为 2022.3.35f1 / Unity engine version, fixed to 2022.3.35f1 by default
	GenerationVersion string // 生成版本（如 "5.x.x"），默认 "5.x.x" / Generation version such as "5.x.x", default "5.x.x"
	Version           uint32 // 文件格式版本，默认 8 / File format version, default 8
	Compress          bool   // 是否使用 LZ4 压缩数据块 / Whether to compress data blocks with LZ4
}

type AnimationClipCurves struct {
	Name   string              // Unity m_Name / Unity m_Name
	Curves []AnimationTRSCurve // 可导出的 TRS 曲线 / Exportable TRS curves
}

type AnimationCurveProperty uint8

type AnimationTRSCurve struct {
	Path      string                 // 相对于动画根节点的 Transform 路径 / Transform path relative to the animation root
	Property  AnimationCurveProperty // TRS 属性 / TRS property
	Dimension uint8                  // 值分量数量 / Value component count
	Keyframes []AnimationTRSKeyframe // 有序关键帧 / Ordered keyframes
}

type AnimationTRSKeyframe struct {
	Time  float32    // 关键帧时间，单位为秒 / Keyframe time in seconds
	Value [4]float32 // XYZ 或 XYZW 值 / XYZ or XYZW value
}

type AssetBundleContainerEntry struct {
	Name         string // m_Container 键名或加载名 / m_Container key or load name
	PreloadIndex int32  // m_PreloadTable 起始索引 / Start index in m_PreloadTable
	PreloadSize  int32  // m_PreloadTable 引用数量 / Number of referenced preload entries
	FileID       int32  // PPtr 文件 ID，0 表示当前文件 / PPtr file ID, zero means current file
	PathID       int64  // PPtr 路径 ID / PPtr path ID
}

type AssetEntry struct {
	PathId   int64  // SerializedFile 中唯一标识对象的路径 ID / Path ID identifying the object within the SerializedFile
	TypeId   int32  // 类型 ID / Unity class ID
	TypeName string // 内置映射得到的类型名称 / Type name obtained from the built-in mapping
	Name     string // 已知布局中位于开头的 m_Name，无法读取时为空 / Leading m_Name from known layouts, or empty when unavailable
	Size     uint32 // 序列化对象数据的字节数 / Serialized object data size in bytes
	Offset   int64  // 对象数据相对于 SerializedFile 数据区的偏移 / Object-data offset relative to the SerializedFile data section
}

type AssetInfo struct {
	PathId          int64  // 文件内唯一标识资源的路径 ID / Asset PathID unique within the file
	ByteOffset      int64  // 相对于 DataOffset 的偏移 / Offset relative to DataOffset
	ByteSize        uint32 // 资源数据大小 / Asset data size
	TypeIdOrIndex   int32  // Serialized type 标识；v16+ 必须是 TypeTreeTypes 数组索引 / Serialized type identifier; v16+ must index TypeTreeTypes
	TypeId          int32  // 解析后填充的实际类型 ID / Actual class ID filled after parsing
	LegacyClassID   uint16 // v12 至 v15 对象项中显式保存的 class ID / Class ID stored explicitly in v12 through v15 object entries
	ScriptTypeIndex int16  // v12 至 v16 对象项中的脚本类型索引，-1 表示无脚本 / Script type index in v12 through v16 object entries, with -1 meaning no script
	Stripped        byte   // v15 至 v16 对象项中的 stripped 标记 / Stripped marker in v15 through v16 object entries
}

type AssetResolver func(relativeTo *AssetsFile, fileID int32, pathID int64) (*AssetsFile, *AssetInfo, error)

type AssetsFile struct {
	Header   AssetsFileHeader // 文件头 / File header
	Metadata AssetsMetadata   // 包含类型树和资源列表的元数据 / Metadata including type trees and asset list
	Data     []byte           // 用于按偏移读取资源的原始文件数据 / Raw file bytes used to read assets by offset
	// contains filtered or unexported fields
}

type AssetsFileHeader struct {
	MetadataSize       uint32  // 元数据块大小 / Metadata block size
	FileSize           int64   // 整个文件大小 / Total file size
	Version            uint32  // 序列化格式版本，当前支持 12 至 22 / Serialized file format version, currently supporting 12 through 22
	DataOffset         int64   // 资源数据区起始偏移 / Start offset of the asset data area
	Endianness         bool    // true 表示 Big-Endian，false 表示 Little-Endian / true means Big-Endian and false means Little-Endian
	LegacyMetadataSize uint32  // 固定头部中的 32 位元数据大小，v22 起通常为零并由扩展头替代 / 32-bit metadata size in the fixed header, normally zero and superseded by the extended header from v22
	LegacyFileSize     uint32  // 固定头部中的 32 位文件大小，v22 起通常为零并由扩展头替代 / 32-bit file size in the fixed header, normally zero and superseded by the extended header from v22
	LegacyDataOffset   uint32  // 固定头部中的 32 位数据偏移，v22 起通常为零并由扩展头替代 / 32-bit data offset in the fixed header, normally zero and superseded by the extended header from v22
	Reserved           [3]byte // Endianness 后由 Unity 读取并跳过的三个保留字节 / Three reserved bytes Unity reads and skips after Endianness
	LargeFilesUnknown  int64   // v22 扩展头末尾用途未知的 Int64 字段 / Int64 field of unknown purpose at the end of the v22 extended header
}

type AssetsFileRangeResolver func(offset int64, size int64) ([]byte, error)

type AssetsMetadata struct {
	UnityVersion    string                            // Unity 版本字符串 / Unity version string
	TargetPlatform  uint32                            // 目标平台 ID / Target platform ID
	TypeTreeEnabled bool                              // 是否包含类型树 / Whether type tree data is present
	TypeTreeTypes   []TypeTreeType                    // 类型树定义列表 / Type tree definition list
	BigIDEnabled    int32                             // v7-v13 的 64 位 PathID 开关；保留原始 int32 wire 值 / v7-v13 64-bit PathID switch; preserves the original int32 wire value
	AssetInfos      []AssetInfo                       // 资源信息列表 / Asset metadata list
	ScriptTypes     []LocalSerializedObjectIdentifier // 本地脚本对象引用 / Local script object identifiers
	ExternalFiles   []ExternalFile                    // 外部文件引用 / External file references
	RefTypes        []TypeTreeType                    // 引用类型定义 / Referenced serialized type definitions
	UserInformation string                            // metadata 尾部用户信息 / User-information string at the metadata tail
}

type BlockAndDirInfo struct {
	Hash           [16]byte        // 16 字节哈希 / 16-byte hash
	BlockInfos     []BlockInfo     // 数据压缩块信息列表 / Data block info list
	DirectoryInfos []DirectoryInfo // 文件目录条目列表 / File directory entry list
}

type BlockInfo struct {
	DecompressedSize uint32 // 解压后大小 / Decompressed size
	CompressedSize   uint32 // 压缩后大小，未压缩时与 DecompressedSize 相同 / Compressed size, equal to DecompressedSize when uncompressed
	Flags            uint16 // 标志位：低 6 位为压缩类型，bit6 表示是否为流式块 / Flags, low 6 bits are compression type and bit6 marks streamed blocks
}

type DirectoryInfo struct {
	Offset           int64  // 相对于数据区起始的偏移量 / Offset relative to the data area start
	DecompressedSize int64  // 解压后大小 / Decompressed size
	Flags            uint32 // 目录条目标志，0x04 表示序列化 AssetsFile / Directory-entry flags, with 0x04 denoting a serialized AssetsFile
	Name             string // 文件名 / File name
}

type ExternalFile struct {
	AssetPath string   // 缓存资源虚拟路径 / Virtual cached-asset path
	Guid      [16]byte // 外部文件 GUID / External file GUID
	Type      int32    // 引用类型 / Reference type
	PathName  string   // 路径名 / Path name
}

type FSHeader struct {
	TotalFileSize    int64  // 整个文件的总大小 / Total file size
	CompressedSize   uint32 // BlockAndDirInfo 压缩后的字节大小 / Compressed size of BlockAndDirInfo
	DecompressedSize uint32 // BlockAndDirInfo 解压后的字节大小 / Decompressed size of BlockAndDirInfo
	Flags            uint32 // 组合压缩类型与布局位的标志 / Flags combining compression type and layout bits
}

type LocalSerializedObjectIdentifier struct {
	LocalSerializedFileIndex int32 // 本地序列化文件索引 / Local serialized-file index
	LocalIdentifierInFile    int64 // 文件内对象 ID / Local object identifier in the file
}

type MeshGeometry struct {
	Name         string                             // Unity m_Name / Unity m_Name
	Positions    [][3]float32                       // 顶点位置 / Vertex positions
	Normals      [][3]float32                       // 可选顶点法线 / Optional vertex normals
	Tangents     [][4]float32                       // 可选顶点切线 / Optional vertex tangents
	Colors       [][4]float32                       // 可选顶点颜色 / Optional vertex colors
	TexCoords    [MeshTexCoordSetCount][][2]float32 // 可选纹理坐标组，索引即 UV 组序号 / Optional texture-coordinate sets indexed by UV set number
	SkinCounts   []uint8                            // 每顶点骨骼影响数量，未蒙皮时为 nil / Bone influence count per vertex, nil when unskinned
	SkinIndices  []uint32                           // 按顶点顺序扁平化的骨骼索引 / Bone indices flattened in vertex order
	SkinWeights  []float32                          // 按顶点顺序扁平化的骨骼权重 / Bone weights flattened in vertex order
	BindPoses    [][16]float32                      // 可选骨骼绑定姿势矩阵，按 e00 到 e33 的行主序 / Optional bone bind-pose matrices in row-major e00 through e33 order
	MorphTargets []MeshMorphTarget                  // 可选内嵌 BlendShape 目标 / Optional embedded blend-shape targets
	Primitives   []MeshPrimitive                    // SubMesh 图元 / SubMesh primitives
}

type MeshMorphTarget struct {
	Name           string       // BlendShape 名称 / Blend-shape name
	FrameWeight    float32      // 帧权重，通常为一百 / Frame weight, normally one hundred
	DeltaPositions [][3]float32 // 顶点位置差分，长度等于顶点数 / Vertex position deltas with one entry per vertex
	DeltaNormals   [][3]float32 // 可选法线差分 / Optional normal deltas
	DeltaTangents  [][3]float32 // 可选切线差分 / Optional tangent deltas
}

type MeshPrimitive struct {
	Mode    MeshPrimitiveMode // 图元拓扑 / Primitive topology
	Indices []uint32          // 已应用 baseVertex 的顶点索引 / Vertex indices with baseVertex applied
}

type MeshPrimitiveMode uint8

type NativeUnityObject struct {
	ClassID   int32        // Unity ClassID / Unity ClassID
	BigEndian bool         // 对象正文是否使用大端字节序 / Whether the object payload uses big-endian byte order
	TypeTree  TypeTreeType // 解码和重编码正文所需的完整 TypeTree / Complete TypeTree required to decode and re-encode the payload
	Data      []byte       // Unity 序列化对象正文 / Unity serialized object payload
}

type NativeUnityObjectHeader struct {
	ClassID    int32        // Unity ClassID / Unity ClassID
	BigEndian  bool         // 对象正文是否使用大端字节序 / Whether the object payload uses big-endian byte order
	TypeTree   TypeTreeType // 解码和重编码正文所需的完整 TypeTree / Complete TypeTree required to decode and re-encode the payload
	DataOffset int64        // 对象正文相对于文件开头的偏移 / Object payload offset relative to the beginning of the file
	DataSize   uint32       // 对象正文在线格式字节数 / Object payload byte size on the wire
}

type PPtrRemapFunc func(fileID int32, pathID int64) (newFileID int32, newPathID int64, err error)

type SerializedFileWriter struct {
	UnityVersion    string // Unity 版本字符串，默认固定为 2022.3.35f1 / Unity version string, fixed to 2022.3.35f1 by default
	TargetPlatform  uint32 // 目标平台 ID，19 表示 Windows Standalone 64 位 / Target platform ID, with 19 meaning 64-bit Windows Standalone
	AssetBundleName string // 写入容器对象 m_AssetBundleName 的包名，官方文件形如 name.aba / Bundle name written to the container's m_AssetBundleName, shaped like name.aba in official files
	// contains filtered or unexported fields
}

type SerializedObjectDataSource struct {
	Size    uint32                    // 对象在线格式字节数 / Object byte size on the wire
	Prefix  []byte                    // 用于读取稳定基类字段的对象前缀 / Object prefix used to inspect stable base fields
	WriteTo SerializedObjectWriteFunc // 每次调用都写出恰好 Size 字节的回调 / Callback that writes exactly Size bytes on every call
}

type SerializedObjectWriteFunc func(io.Writer) error

type SpriteExport struct {
	Name        string         // Sprite 名称 / Sprite name
	Texture     *Texture2DData // 源 Texture2D 数据 / Source Texture2D data
	Rect        SpriteRect     // 裁剪矩形 / Crop rectangle
	SettingsRaw uint32         // Unity SpriteSettings 原始位标志 / Raw Unity SpriteSettings flags
}

type SpriteRect struct {
	X      float32 // 左下角 X 坐标 / Lower-left X coordinate
	Y      float32 // 左下角 Y 坐标 / Lower-left Y coordinate
	Width  float32 // 宽度 / Width
	Height float32 // 高度 / Height
}

type StreamingInfo struct {
	Offset int64  // sidecar 文件内偏移 / Offset inside the sidecar file
	Size   uint64 // 数据大小，AudioClip 在线格式使用 UInt64 / Payload size, stored as UInt64 by the AudioClip wire format
	Path   string // sidecar 文件路径 / Sidecar file path
}

type Texture2DData struct {
	Name          string        // 贴图名称 / Texture name
	Width         int32         // 贴图宽度 / Texture width
	Height        int32         // 贴图高度 / Texture height
	TextureFormat int32         // Unity TextureFormat 枚举值 / Unity TextureFormat enum value
	MipCount      int32         // mipmap 层数 / Mipmap count
	ImageData     []byte        // 原始编码图像数据 / Raw encoded image data
	StreamData    StreamingInfo // 外部流式数据引用 / External streamed data reference
}

type TypeTreeNode struct {
	Version     uint16 // 节点版本 / Node version
	Level       byte   // 层级深度 / Tree depth level
	TypeFlags   byte   // 类型标志，0x01 表示 IsArray / Type flags, with 0x01 meaning IsArray
	TypeStrOff  uint32 // 类型名在字符串缓冲区中的偏移 / Offset of the type name in the string buffer
	NameStrOff  uint32 // 字段名在字符串缓冲区中的偏移 / Offset of the field name in the string buffer
	ByteSize    int32  // 字段字节大小，-1 表示可变长度 / Field byte size, with -1 meaning variable length
	Index       int32  // 在父节点中的索引 / Index within the parent node
	MetaFlags   uint32 // 元标志，0x4000 表示 AlignBytes / Metadata flags, with 0x4000 meaning AlignBytes
	RefTypeHash uint64 // v19+ 引用类型哈希 / Referenced-type hash in v19+
}

type TypeTreeType struct {
	TypeId           int32          // 类型 ID，如 28=Texture2D、49=TextAsset / Class ID such as 28=Texture2D and 49=TextAsset
	IsStrippedType   bool           // 是否被剥离 / Whether this type is stripped
	ScriptTypeIndex  int16          // 脚本类型索引，-1 表示无脚本 / Script type index, with -1 meaning no script
	ScriptIdHash     [16]byte       // v13+ 脚本类型按条件保存的脚本 ID 哈希 / Conditionally stored script ID hash for script types in v13+
	TypeHash         [16]byte       // 类型哈希 / Type hash
	Nodes            []TypeTreeNode // 仅在 TypeTreeEnabled 为 true 时保存的类型树节点 / Type-tree nodes stored only when TypeTreeEnabled is true
	StringBuffer     []byte         // 字符串缓冲区 / String buffer
	TypeDependencies []int32        // v21+ 且启用 TypeTree 时的普通类型依赖 / Ordinary type dependencies for v21+ with TypeTree enabled
	ClassName        string         // 引用类型类名 / Referenced type class name
	Namespace        string         // 引用类型命名空间 / Referenced type namespace
	AssemblyName     string         // 引用类型程序集名 / Referenced type assembly name
}

type TypeTreeValue struct {
	TypeName   string           // Unity 类型名 / Unity type name
	Name       string           // 字段名或节点名 / Field or node name
	Value      interface{}      // 原始标量值或字节数组 / Raw scalar value or byte array
	Children   []*TypeTreeValue // 子节点列表 / Child node list
	NodeIndex  int64            // 对应 TypeTree 节点索引 / Corresponding TypeTree node index
	ByteOffset int64            // 值在对象数据中的起始偏移 / Start offset of the value in object data
	ByteSize   int64            // 值及其尾部对齐占用的字节数 / Byte count occupied by the value and trailing alignment
}