58 lines
2.3 KiB
Python
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]))
|