#!/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]))