Files
VibemakerSandbox/app/scripts/import-microban-visuals.py

58 lines
2.3 KiB
Python

#!/usr/bin/env python3
"""Import the user-supplied, self-contained Microban visual GLBs only.
Usage: python3 app/scripts/import-microban-visuals.py /path/to/microban2.zip
Does not modify MJCF, policies or the reviewed body transforms in robot.json.
"""
import hashlib
import json
from pathlib import Path
import struct
import sys
import zipfile
def import_visuals(archive):
target = Path(__file__).resolve().parents[1] / "public/robots/microban"
links = ["BASE", *(f"LINK{i}" for i in range(1, 20))]
names = [f"{link}__visual_0__{link}.glb" for link in links]
with zipfile.ZipFile(archive) as source:
if sorted(source.namelist()) != sorted(names):
raise ValueError("Expected exactly BASE and LINK1..LINK19 GLBs")
files = {name: source.read(name) for name in names}
# Validate everything before copying any file. Never extract ZIP paths.
for name, data in files.items():
magic, version, length, json_length, chunk_type = struct.unpack_from(
"<5I", data
)
if (magic, version, length, chunk_type) != (
0x46546C67, 2, len(data), 0x4E4F534A
):
raise ValueError(f"{name}: invalid GLB")
gltf = json.loads(data[20:20 + json_length])
for asset in [*gltf.get("buffers", []), *gltf.get("images", [])]:
if "uri" in asset and not asset["uri"].startswith("data:"):
raise ValueError(f"{name}: external buffer/image is unsupported")
(target / "visuals").mkdir(exist_ok=True)
records = []
for name, data in files.items():
(target / "visuals" / name).write_bytes(data)
records.append({
"file": f"visuals/{name}",
"sha256": hashlib.sha256(data).hexdigest(),
})
manifest = {
"source": f"User-provided {archive.name} (textured visual replacement)",
"archive_sha256": hashlib.sha256(archive.read_bytes()).hexdigest(),
"license": "Not supplied in the archive; confirm redistribution rights with the asset owner.",
"files": records,
}
(target / "visual-source-manifest.json").write_text(
json.dumps(manifest, indent=2) + "\n"
)
print(f"Imported {len(records)} visual GLBs; physics/policy files unchanged")
if __name__ == "__main__":
import_visuals(Path(sys.argv[1]))