Convert Brax pages¶

Turn Brax playback pages into small rollout files that play offline.

A rollout is a recorded robot run that a slide plays in 3D. A Brax playback page carries its whole world inline: every mesh, plus six libraries that it fetches from a CDN when the page opens. As a result, thirty slides with one robot mean thirty copies of that robot, and the deck fails without a network.

Run the converter¶

mkdeck rollout splits each page in two. First, the meshes of one model go into a shared file. Then each run keeps only its poses:

mkdeck rollout runs/*.html -o slides/assets

The command prints one line for each page and then a size summary. The hash in the first line depends on your model:

stage0.html -> stage0.rollout (new meshes cf0f4e5579ed5ecd.meshes)
stage1.html -> stage1.rollout (shared meshes)
X MB of pages became Y MB of rollouts.

The last line shows the size of the pages that mkdeck read and the size of the rollouts that it wrote. It tells you what sharing the meshes saves on your own pages.

What the command writes¶

The converter keeps every triangle, and the poses are the ones that Brax recorded, so the conversion loses nothing.

Options¶

Use --out to choose the folder for the rollouts. It defaults to assets. See CLI: rollout, check, export for every option.

Limits¶

Next: Show a rollout.