Cómo movemos tus modelos: de STL a GLB, a la web y a Oasis
Resumen simple de nuestra cadena: limpiamos STL/OBJ, convertimos a GLB optimizado, generamos miniaturas, servimos por web estática y anunciamos en el PUB Oasis para replicación. Todo ligero, auditable y resistente.
- STL/OBJ → GLB
- Thumbnails
- Catálogo JSON
- Nginx estático
- Oasis / SSB
Pipeline básico (alto nivel)
[1] Ingesta [2] Limpieza [3] Conversión [4] Thumbs
STL / OBJ / STEP --> escala/ejes/normales --> GLB optimizado --> JPG/WEBP 512px
[5] Catálogo [6] Web estática [7] Anuncio Oasis
JSON (metadatos) --> Nginx / CDN --> PUB: hash + URL/refs
1) Ingesta & limpieza
- Validamos licencia y autoría.
- Normalizamos unidades (mm) y ejes (Y-up → Z-up si procede).
- Recalculamos normales, soldamos vértices duplicados.
2) Conversión a GLB
Usamos herramientas reproducibles (ej. Blender CLI / gltfpack) para un GLB ligero y web-friendly.
# Ejemplo (alto nivel)
blender -b -P scripts/stl2glb.py -- --in model.stl --out model.glb
gltfpack -i model.glb -o model.glb -cc -tc # compresión + tangentes3) Miniaturas
- Render rápido con cámara fija →
/sub/thumbs/*.webp. - Nombres consistentes:
nombre.glb↔nombre.webp.
4) Catálogo & publicación
- Metadatos en
catalog.json(autor, tema, material, complejidad, tags). - Web estática servida por Nginx.
- Mensaje en Oasis/SSB con hash de contenido y referencias públicas.
Demo visor 3D — snh_base.glb
Previsualización rápida con <model-viewer>. Mueve, rota y haz zoom sin plugins.
Topología mínima de despliegue
Navegador ──HTTPS──► Nginx (RP)
│
├──► / (estático: HTML/CSS/GLB/WEBP)
└──► /app (si hay backend/API)
Gossip (SSB) ──TCP/7724──► PUB Oasis
La web es estática para rapidez y resiliencia. Oasis se usa para anunciar y replicar referencias de modelos/contenidos.
Conceptos claros
- GLB: formato web binario (gltf) con mejor carga que STL/OBJ.
- Offline-first: puedes navegar la web estática sin depender del PUB.
- PUB Oasis: nodo público para descubrimiento/replicación (no SPOF).
- Auditable: herramientas CLI, ficheros estáticos y hashes verificables.
FAQ
¿Por qué convertís a GLB?
Porque reduce peso, empaqueta materiales y es el estándar de facto para la web (cargas rápidas y consistentes).
¿Qué se replica exactamente en Oasis?
Metadatos y referencias (hash/URL) de los modelos, para que otros nodos puedan descubrirlos/verificarlos.
¿Se puede usar sin JavaScript?
La web funciona; sin JS no verás el visor interactivo, pero podrás descargar GLB/WEBP desde la galería.