36 lines
1.9 KiB
Markdown
36 lines
1.9 KiB
Markdown
# Environmental field snapshot v1
|
|
|
|
All integers explicit little endian; signed coordinates use two's-complement u64
|
|
encoding. No struct padding. Unknown formats/units/material versions reject.
|
|
|
|
| Offset | Type | Meaning |
|
|
|---:|---|---|
|
|
| 0 | 8 bytes | ASCII AEVOFLD1 |
|
|
| 8 | u32 | format=1 |
|
|
| 12 | u32 | total length including checksum |
|
|
| 16,24 | u64 each | nonzero world, frame |
|
|
| 32,36 | u32 each | environmental units=1, material table=1 |
|
|
| 40,48 | u64 each | nonzero opening provenance, last transfer command (initially 0) |
|
|
| 56 | u32 | sites, 1..4096 |
|
|
| 60 | u32 | presence bits 0..9 only, enum order in fields.hpp |
|
|
| 64 | 3*u64 | water capacities in fg for material 0,1,2 |
|
|
| 88 | site_count*74 bytes | sorted site records |
|
|
| following | present_count*site_count*u64 | scalar logical arrays, increasing channel order |
|
|
| final 8 | u64 | FNV-1a of all preceding bytes; corruption detection only |
|
|
|
|
Each site: signed X/Y/Z (24 bytes), box origin X/Y/Z and width/height/depth in um
|
|
(48 bytes), material ID u16. Strictly increasing voxel addresses; valid one-voxel
|
|
box and material 0..2. No duplicate habitat in a voxel. Field arrays contain finite
|
|
per-site quantities, including repeated uniform values; absent differs from zero.
|
|
Water capacity and global per-energy/element sums are validated on restore.
|
|
|
|
Length must equal `96 + sites*(74 + 8*present)` (maximum 630880), also bounded by
|
|
the API's 1 MiB envelope. All structural counts/lengths are checked before staging
|
|
allocations. Canonical encoding omits storage layout, byte budget and pointers.
|
|
No rates/residuals exist in v1: incident energy is finite stock only. Adding rate
|
|
sources requires explicit versioned persistence, not default construction on restore.
|
|
M5 world snapshots are a distinct format and cannot stand in for missing fields.
|
|
|
|
Codec buffers do not publish durable state. Field/terrain/biology consistency and
|
|
recovery bundles remain later gates; LocalWorldFiles handles M5 terrain only.
|