ntizar img2threejs — imagen → modelo Three.js procedural
Reconstruye el objeto de una imagen de referencia como modelo Three.js solo con código (paramétrico/procedural), listo para animar. Repo: https://github.com/img2threejs/img2threejs (14k+ ⭐, Apache-2.0, Python 3.10+ stdlib en forge/, TypeScript para el output).
Cuándo usarlo
- Necesitas un 3D "bonito y liviano" de un objeto conocido (vehículo, edificio, mueble) sin descargar assets ni mallas.
- El output debe ser animable y editable por código (ideal para dashboards, demos, World3D).
Flujo
- Clonar el repo y ejecutar el forge CLI con la imagen de referencia:
python forge/(ver README para flags exactos). - El forge genera un módulo TypeScript que construye la escena con primitivas/paramétricas (sin mallas descargadas).
- Iterar contra los quality gates automáticos (silueta, proporciones, colores): el pipeline re-chequea el render contra la imagen y rechaza versiones fuera de tolerancia.
- Integrar el módulo generado en tu escena Three.js; el modelo es code-only → diff-able y versionable en git.
Patrones clave
- Reconstrucción-por-código vs fotogrametría: sin pesos, sin assets binarios, token-efficient para agentes.
- Quality gates iterativos: comparación render↔referencia como bucle de verificación (aplicable a cualquier pipeline generativo visual).
- Output paramétrico: árbol de primitivas con parámetros expuestos → animable por código.
Pitfalls
- No sirve para objetos orgánicos complejos (caras, esculturas): mejor fotogrametría/modelos ML.
- El forge es Python stdlib: no necesita pip, pero requiere Python 3.10+.
- Los quality gates pueden iterar varias veces: presupuesta llamadas de render.
Verificación
- Renderizar el módulo generado en una página Three.js mínima y comprobar silueta vs la imagen original.
- Confirmar que no hay assets binarios en el output (solo TS/JS).