Skip to content

v0.1.0 — Model-Prep Core

Choose a tag to compare

View all tags
@0xxCool 0xxCool released this 15 Jul 11:16
v0.1.0
13aacc3

First public release of zer0one-cinema — the deterministic Blender pipeline
that turns any vehicle GLB into a rigged, sanitized, render-ready .blend file.

What's in v0.1.0

Deterministic model-prep pipeline (idempotent, testable without Blender):

  • Wheel detection — 6-stage K-Means pipeline (bit-reproducible with fixed seed). Handles cars, SUVs, trucks, monster-trucks (wheelbase-to-wheel-diameter ratio 0.03–0.50).
  • Ground anchor — vehicle's lowest point placed at world z=0. Correct scene-AABB (all bbox corners of all meshes), not the sampled-subset bug from RS6-v3.
  • Origin fix — wheel object-origins moved to axle centers so rotation animations spin in place (fixes RS6-turntable-v2 wheel-fly-off).
  • Body group — non-wheel meshes grouped with a centroid; wheelbase-based environment filter (sky spheres, ground planes automatically excluded).
  • Material sanitize — 12-class PBR classifier (car-paint / chrome / glass / tire / brake / carbon / headlight / taillight / rim / interior / leather / default). Whitelist-only, unknowns pass through. Hard fixes for the two most common Sketchfab bugs: emission-accidentally-set-on-body and alpha=0.99.

Real-world verified

GLB Result Time
kenney_sedan.glb ✅ 4 wheels FL/FR/RL/RR @ 90 % confidence 2.5 s
kenney_monster_truck.glb ✅ 4 wheels @ 90 % (needed a threshold fix — now committed) 1.9 s
khronos_toy_car.glb ⚠️ known-limitation (merged-mesh export; v0.2 will handle it) —

Quality gates

  • 148 tests green, 5 s total wall-clock
  • ruff clean, mypy strict clean (17 source files)
  • 81 % total coverage; all core modules ≥ 94 % (bbox_utils / body_group / caliper_filter / ground_anchor / origin_fix / rolling_axis / context = 100 %, material_sanitize 97 %, wheel_detect 94 %)
  • CLI verified inside Blender 4.2.11 LTS on Ubuntu

Install

# Blender 4.2 LTS required — download from https://download.blender.org
BLENDER=~/opt/blender-4.2/blender

# Install deps into Blender's bundled Python:
"$BLENDER"/../4.2/python/bin/python3.11 -m pip install --user \
    click numpy pillow pyyaml scikit-learn

# Clone repo (pip install zer0one-cinema will land with the next release):
git clone https://github.com/0xxCool/zer0one-cinema
cd zer0one-cinema

# Run:
"$BLENDER" -b -P scripts/run_zocinema.py -- model-prep \
    my_car.glb --output my_car_prepped.blend --report report.json

See README.md for the full quickstart.

Not in v0.1 (roadmap)

  • v0.2 — Preflight & Verify (test frame + 6-gate CGVF + auto-fix loop)
  • v0.3 — Preset Library (5 looks × 5 cameras) + Cycles rendering
  • v0.4 — CLI + Blender Add-on + Docker serverless
  • v0.5 — Public launch + case studies
  • v1.0 — First customer case study live on zer0onelab.com

Built by ZER0ONELAB as part of our cloud-render platform for DACH studios doing brand work.

Assets 4
Loading