bio-viz-film · Video Explicativo 3D de Biología (v2)
Objetivo: Que un profesor no pueda encontrar errores, que un estudiante lo entienda a la primera y que la calidad visual sea comercial. La precisión es más importante que la estética; no se inventan datos ni procesos.
Índice
template/site2/ ← Motor actual (v2)
index.html Diseño de presentación (original: estilo académico oscuro, títulos con serifa, navegación de vías a la derecha)
engine.js Renderizador, cámara, línea de tiempo, postprocesado (desenfoque de profundidad + resplandor), capa de presentación
lib.js Semilla aleatoria, construcción por instancias, pool dinámico, AO horneado
scene-*.js Escenas programáticas, exportan build(scene, seed) → { anchors, update(t,T), palette }
story-*.js Guión de la historia: pasos, tomas, subtítulos, ventanas de tiempo de proceso, leyendas, fuentes
vendor/ Three r170 + addons (postprocessing / environments, etc.)
template/site/ ← Motor anterior v1 (estilo panel de control, célula/virus; problemas científicos conocidos en references/pitfalls.md, no recomendado)
template/tools/ record.mjs grabación cuadro a cuadro · sheet2.py collage de muestras · probe.mjs sonda de rayos · hidetest.mjs inspección objeto por objeto
references/ accuracy-protocol.md (lectura obligatoria) · techniques.md · new-scene.md · science-checklist.md · pitfalls.md
examples/ secretion: ejemplo completo del capítulo 3.2 de Biología de bachillerato "Síntesis y transporte de proteínas secretoras" + registro de cinco rondas de revisión
Formatos de salida (diseño seleccionable)
?layout= | Efecto | Ideal para |
|---|---|---|
clean | Solo animación 3D, sin ningún texto ni interfaz web | Reedición, doblaje, fondos |
lecture (por defecto) | Versión académica oscura: número de paso + título con serifa + texto original del libro, navegación de vías a la derecha, leyendas, fuentes en pie | Videos explicativos, publicación |
notes | Versión de apuntes en fondo claro: marco redondeado 3D a la izquierda, lado derecho con lista completa de pasos (paso actual expandido con texto original), leyendas, datos experimentales, fuentes | Diapositivas, proyección en clase |
dashboard | Panel de control de seguimiento: panel derecho muestra en tiempo real el recuento de moléculas marcadas en cada compartimento (procedente del propio modelo, con nota de que no son valores experimentales) | Presentaciones de investigación, demostración de "procesos" |
bench | Página web de banco de trabajo en fondo claro (estilo panel de control moderno): barra superior (campo de visión, paso, reloj del modelo) + conocimientos reales en marquee + ventana 3D con marco (etiquetas fijadas con cruceta sobre estructuras 3D, escala en tiempo real) + barras de recuento del modelo + barra de pasos + tres tarjetas pequeñas (curva típica / curva de recuento del modelo / ilustración del libro). Formato vertical 1080×1350 óptimo | Publicaciones en Twitter, Xiaohongshu |
| Personalizado | Crea <nombre>.js en layouts/, exporta meta / css / html / mount / update cuatro elementos, usa ?layout=<nombre> | Personalización por tema o requisito |
- En el story se puede escribir
layout: 'notes'para establecer el diseño por defecto;--size 1080x1920produce versión vertical, y cada diseño se reajusta automáticamente. - Reglas para nuevos diseños:
- Cada número en pantalla debe ser real (procedente de una fuente o del estado del modelo);
- No copiar videos de referencia, el diseño debe ser original según el tema;
- El sujeto 3D debe usar
meta.camShiftpara dejar espacio al texto.
Modo Espectáculo (Showreel) — Para viralizar, para impresionar
Usa el mismo contenido científico que la versión explicativa, solo cambia "cómo se muestra". Se puede indicar directamente en el prompt o con parámetros:
| Tú dices | Parámetro | Valores |
|---|---|---|
| "Haz un espectáculo / versión impresionante / video corto vertical" | ?story=<tema>-reel (la historia explicativa se comprime al 0.42 del tiempo, plano secuencia) | — |
| "Estilo brillante / neón / académico / papel" | look= | vivid colores brillantes tipo caramelo · neon neón sobre fondo oscuro · academic académico oscuro · paper papel |
| "Cambia la paleta a caramelo / azul hielo / atardecer" | palette= | textbook · candy · ice · sunset · neon |
| "Quiero transiciones de barrido de cambio de color" | fx=channels | Cada nuevo paso, un barrido de píxeles cambia al siguiente "pseudocanal de color" (similar al cambio de canal en microscopía de fluorescencia) |
| "Títulos grandes / estilo TikTok" | layout=reel | Un título gancho grande por paso, más etiquetas de pseudocanal y un breve descargo de responsabilidad |
| "Versión vertical" | --size 1080x1920 | La cámara se aleja automáticamente 1.7x en vertical (portraitZoom) |
Reglas:
- Los pseudocolores solo cambian el color, no alteran la estructura ni el proceso; debe aparecer permanentemente un texto que indique "color es pseudocolor".
- La versión espectáculo también debe pasar la revisión científica.
Grabación:
node tools/record.mjs site2 out/x_clean.mp4 --size 1920x1080 --dpr 2 --scale 1920x1080 --query "story=secretion&layout=clean"
node tools/record.mjs site2 out/x_lecture.mp4 --size 1920x1080 --dpr 2 --scale 1920x1080 --query "story=secretion"
--draft (1x, 30fps, aproximadamente 1/8 del tiempo) para obtener una vista previa y que el usuario confirme, luego grabar la versión final. El grabador bloquea para evitar que dos procesos escriban en el mismo archivo simultáneamente; primero escribe *.partial.mp4, y solo renombra al finalizar; luego decodifica y verifica automáticamente cuadro a cuadro, reportando errores si los hay.
--dpr 2 --scale 1920x1080 significa: renderizar primero al doble de resolución y luego reducir a 1080p, lo que equivale a supermuestreo antialiasing. Para obtener 4K final, quita --scale.
Flujo de trabajo (ningún paso puede saltarse)
1. Mesa de hechos (antes de la animación) — Seguir references/accuracy-protocol.md
- Para temas de libro de texto: encontrar primero el texto original del libro, que servirá como columna vertebral de los subtítulos; los subtítulos solo escriben conclusiones a nivel de libro de texto; los detalles a nivel universitario van en las notas de la mesa de hechos.
- Para temas de artículo de investigación: extraer los argumentos del resumen y los pies de figura, cada toma corresponde a una Figura, indicando la fuente (ej. Fig.2b).
- Producto:
review/mesa_de_hechos.md, con columnas: Paso | Texto del subtítulo | Base (sección del libro/DOI) | Estado (verificado/pendiente). El contenido pendiente no puede mostrarse en pantalla. - Al mismo tiempo, escribir una lista de imágenes prohibidas, con los errores comunes de este tema (por ejemplo "el ribosoma entra en el retículo endoplasmático" "la proteína flota desnuda en el citoplasma").
2. Primera ronda de revisión independiente (mesa de hechos + diseño de escena): Crear un subagente, darle solo la mesa de hechos, el guión de la historia y la descripción de la escena, pedirle que encuentre errores uno por uno.
3. Escribir la escena y la historia: Ver references/new-scene.md.
- Cada proceso se escribe como una función pura de t (ej.
update(t, T)), con las ventanas de tiempo unificadas en elTde la historia. - Las moléculas rastreadas se representan con material brillante, las demás moléculas con material oscuro; el significado del "marcaje" en pantalla debe coincidir con el experimento.
- El tamaño solo conserva el orden relativo, y debe indicarse en pantalla "no a escala real". La compresión del tiempo también debe indicarse.
4. Autoverificación de muestras: Usar --stills para generar un fotograma intermedio de cada paso, componer un collage y revisar: si los eventos clave están en el centro del encuadre, si son visibles, si hay estructuras que se intersectan o huecos.
- Si se detectan manchas oscuras o huecos sospechosos, usar
probe.mjs(sonda de rayos) yhidetest.mjs(ocultar objetos uno por uno) para localizarlos, no adivinar.
5. Segunda ronda de revisión independiente (muestras del video final): El subagente interpreta el rol de "profesor de biología celular + director artístico de documental científico", revisa las muestras, los subtítulos y el código de proceso, y proporciona una lista de cambios obligatorios y una conclusión sobre si "puede usarse directamente para docencia".
- Solo después de corregir todos los problemas de nivel "error" y "engañoso" se puede producir el video.
6. Producción y entrega:
- Entregables: dos videos mp4 (versión limpia + versión explicativa), además de la mesa de hechos y los registros de las dos rondas de revisión.
- Publicar con textos en chino e inglés; no mezclar música de fondo.
Puntos clave de la versión web (bench)
- En el story escribir
layout: 'bench', y proporcionarbrand / title / sub / notes(marquee, deben ser hechos con fuente) /clock(segundos de película → milisegundos fisiológicos) /conv(qué señal se resalta en cada paso), en cada paso escribirchip / badge / call(anotación: punto de anclaje, título, subtítulo, puntos clave). - Los números en la página solo pueden tener tres fuentes, y debe indicarse en la esquina de la tarjeta:
MODEL(recuento del censo de la escena),TYPICAL(valor típico de libro de texto),TEXTBOOK. No escribir términos como LIVE / en vivo / microscopía en tiempo real que puedan confundirse con datos reales. - El reloj del modelo debe coincidir con los subtítulos y las curvas; el factor de ralentización debe escribirse en valores reales (si es no lineal, indicarlo).
Modo "rebanada" de primeros planos y espesor de membrana
STORY.slab(t): segundo plano de recorte global (solo conserva z ≥ valor), en primeros planos corta la escena en una rebanada de aproximadamente 50–100 nm de espesor, limpia como una sección de microscopio electrónico.- La membrana se hace con
shell()para formar una bicapa cerrada con espesor (capa externa hacia afuera, interna hacia adentro, 5 nm), materialcapify, el corte muestra una banda de color sólido; los eventos clave (poro de fusión, hoyo de endocitosis) se colocan en el plano de corte, la cámara se aproxima a una vista casi cenital, para que el contorno en Ω sea visible. - En planos generales, las moléculas/iones se amplían según la distancia a la cámara (
__camDist), con un pie de página que indica "moléculas ampliadas en plano general".
Dos rutas de producción (ver detalles en references/two-routes.md)
- Ruta rápida: renderizado en tiempo real con Three.js (más N8AO de oclusión ambiental), un video de 49 segundos se produce en unos 15 minutos, para iteración y producción diaria.
- Ruta profesional:
export_blender.mjsexporta la escena →blender_build.pyla reconstruye en Blender, renderiza con Cycles path tracing →record.mjs --overlay-dirgenera la capa de interfaz web y la superpone. Aproximadamente 17–20 segundos por fotograma en local, para la versión de publicación final. - Solo se puede ejecutar una tarea de Blender a la vez; dos agotarían la memoria y provocarían un bloqueo.
Estilo "cuentas" a nivel molecular (sin simplificar: estructura real)
tools/pdb2beads.py <PDB> site2/mol/<PDB>.json [--opm] [--group chain]: convierte estructuras atómicas reales en modelos de cuentas. Para proteínas de membrana, añadir--opm, usando la orientación en membrana de la base de datos OPM.- La escena carga
await fetch('./mol/*.json')en el nivel superior y usabeadGeo()para generar la geometría. Las cuentas por encima del plano de corte se descartan por completo, sin dejar cáscaras vacías. - Al colocar, se realiza detección de colisiones a nivel de cuentas para garantizar 0 intersecciones; usar
node tools/check.mjs site2 "story=..."para verificar. - El recuento debe ser químicamente consistente (ej.: 1 O₂ corresponde a PSII que absorbe 4 fotones, PSI absorbe 4 fotones, transfiere 4 electrones, el lumen del tilacoide recibe 12 H⁺, genera 2 NADPH, aproximadamente 2.6 ATP). Las animaciones continuas ilustrativas deben etiquetarse como ILUSTRATIVAS.
Principios de morfología (sin simplificar)
- Los orgánulos se modelan según la morfología y proporciones reales de microscopía electrónica, no como formas geométricas regulares. Las dimensiones se consultan primero en tablas (como en
references/morphology-acinar.md), luego se codifican. - Al cruzar tres órdenes de magnitud (célula 15 μm → ribosoma 25 nm), no se escala la estructura, sino que la cámara se acerca continuamente (interpolación logarítmica de distancia), y los eventos moleculares se ven en primer plano.
- Las estructuras cerradas (gránulos, mitocondrias, vesículas de condensación, núcleo) al ser seccionadas muestran un corte macizo (
capify), sin dejar cáscaras vacías.
Principios de diseño
- El diseño es original según el tema, no se copian videos de referencia.
- El estilo por defecto es académico oscuro: títulos con serifa, el cuerpo de texto es el texto original del libro, se usa un color de énfasis (igual al color del trazador).
- Cada número que aparece en pantalla debe tener una fuente. No se usan paneles de control falsos, recuentos falsos ni curvas falsas.
- Las citas y los descargos de responsabilidad están siempre presentes en el pie: Animación ilustrativa · No a escala real · Tiempo comprimido · Fuente.
Ejemplos completados
thylakoid: Cloroplasto → Grana → Reacciones luminosas en la membrana del tilacoide, 9 estructuras proteicas reales (PSII-LHCII, b₆f, PSI, ATP sintasa, LHCII, PC, Fd, FNR, Rubisco), versión web en inglésstory=thylakoid-en, producido en ambas rutas rápida y profesional.synapse: Sinapsis glutamatérgica del hipocampo (varicosidades del axón → espina dendrítica en forma de hongo), escala real 1 unidad = 20 nm, potencial de acción → entrada de Ca²⁺ → fusión completa de una sola vesícula → difusión de ~4,000 glutamatos → apertura de AMPA, entrada de Na⁺ → captación por astrocitos → endocitosis mediada por clatrina y recarga. Versión web en inglésstory=synapse-en, aproximadamente 50 segundos. Mesa de hechos y revisión enexamples/synapse/.secretion: Célula acinar pancreática de cobaya, proceso completo de la proteína secretora desde el ribosoma libre hasta la exocitosis, aproximadamente 75 segundos, 9 pasos, incluye línea de tiempo del experimento con ³H-leucina (3/17/117 min, datos de libro de texto).