feat(editor): add WOL JSON round-trip authoring workflow

Two new commands enable a hand-edit authoring loop for the
binary .wol format:

  • --export-wol-json <wol-base> [out.json]
        Dumps a .wol to a human-readable JSON sidecar
        (defaults to <base>.wol.json). Preserves every
        keyframe's time, ambient/directional/fog colors,
        directional vector, and fog distances.

  • --import-wol-json <json-path> [out-base]
        Reads a JSON sidecar and writes back binary .wol.
        Validates schema strictly — missing keyframes /
        wrong field types fail with a clear error message.

Workflow: --gen-light → --export-wol-json → hand-edit values
in any text editor → --import-wol-json → use in renderer.

Round-trip verified byte-for-byte identical on the existing
sunny.wol fixture: re-import produces the same 4 keyframes
with the same colors, fog distances, and zone name.
This commit is contained in:
Kelsi 2026-05-09 14:18:14 -07:00
parent 35a5a9d09f
commit 6c2f5cf9ca
3 changed files with 134 additions and 0 deletions

View file

@ -795,6 +795,10 @@ void printUsage(const char* argv0) {
std::printf(" Emit a single-keyframe .wol with warm torchlit ambient + medium fog (dungeon / crypt interior)\n");
std::printf(" --gen-light-night <wol-base> [zoneName]\n");
std::printf(" Emit a single-keyframe .wol with moonlit directional + far fog (always-night zone / shadow realm)\n");
std::printf(" --export-wol-json <wol-base> [out.json]\n");
std::printf(" Export binary .wol to a human-editable JSON sidecar (defaults to <base>.wol.json)\n");
std::printf(" --import-wol-json <json-path> [out-base]\n");
std::printf(" Import a .wol.json sidecar back into binary .wol (round-trip with --export-wol-json)\n");
std::printf(" --info-wow <wow-base> [--json]\n");
std::printf(" Print WOW weather entries (zone + per-state type / intensity / weight / duration) and exit\n");
std::printf(" --validate-wow <wow-base> [--json]\n");