O que bio-viz-film · Bio 3D Explicador (v2) faz?
Objetivo: Professores não encontram erros, alunos entendem de primeira, e o visual atinge padrão comercial. Precisão acima de estética; não inventar dados, não inventar processos.
Índice
template/site2/ ← Motor atual (v2)
index.html Layout explicativo (original: escuro acadêmico, título serifado, navegação de via à direita)
engine.js Renderizador, câmera, timeline, pós-processamento (profundidade de campo + brilho), sobreposição de explicação
lib.js Aleatoriedade com semente, construção instanciada, pool dinâmico, AO cozida
scene-*.js Cenas programáticas, exporta build(scene, seed) → { anchors, update(t,T), palette }
story-*.js Roteiro da história: etapas, tomadas, legendas, janelas de tempo do processo, legendas, fontes
vendor/ Three r170 + addons (postprocessing / environments etc.)
template/site/ ← Motor antigo v1 (estilo dashboard, célula/vírus; problemas científicos conhecidos em references/pitfalls.md, não recomendado)
template/tools/ record.mjs gravação quadro a quadro · sheet2.py montagem de amostras · probe.mjs sonda de raios · hidetest.mjs inspeção objeto por objeto
references/ accuracy-protocol.md (leitura obrigatória) · techniques.md · new-scene.md · science-checklist.md · pitfalls.md
examples/ secretion: Exemplo completo da seção 3.2 do livro didático chinês (RENJIAO, 1º ano do Ensino Médio) "Síntese e Transporte de Proteínas Secretoras" + registro de cinco rodadas de revisão
Formatos de Saída (Layout opcional)
?layout= | Efeito | Adequado para |
|---|---|---|
clean | Apenas cena 3D, sem qualquer texto ou elemento de página | Edição secundária, narração, fundo |
lecture (padrão) | Versão acadêmica escura: número da etapa + título serifado + frase original do livro didático, navegação de via à direita, legenda, fonte no rodapé | Vídeos explicativos, publicação |
notes | Versão de apostila clara: moldura 3D arredondada à esquerda, à direita lista completa de etapas (etapa atual expandida com frase original), legenda, dados experimentais, fonte | Slides de aula, projetor em sala |
dashboard | Painel de monitoramento: painel direito mostra em tempo real a contagem de moléculas marcadas em cada compartimento (contagem do próprio modelo, com nota "não são valores experimentais") | Apresentação de pesquisa, demonstração de "processo" |
bench | Página web estilo bancada clara (estilo dashboard popular): barra superior (campo de visão, etapa, relógio do modelo) + conhecimento real em marquee + janela 3D com moldura (rótulos com mira fixada em estruturas 3D, escala em tempo real) + barras de contagem do modelo + barra de etapas + três mini cartões (curva típica / curva de contagem do modelo / diagrama do livro didático). Vertical 1080×1350 ideal | Publicação no Twitter/X, Xiaohongshu |
| Personalizado | Crie um arquivo <nome>.js em layouts/, exportando meta / css / html / mount / update quatro itens, use ?layout=<nome> para chamar | Por tema ou requisito personalizado |
- No story pode-se definir
layout: 'notes'para layout padrão;--size 1080x1920para saída vertical, cada layout se adapta automaticamente. - Regras para novos layouts:
- Cada número na tela deve ser real (proveniente de fonte ou estado do modelo);
- Não copiar vídeos de referência; o layout deve ser projetado de acordo com o tema;
- O corpo 3D usa
meta.camShiftpara ceder espaço ao texto.
Modo Showreel (Chamativo) — para atrair atenção e impressionar
Usa o mesmo conteúdo científico da versão explicativa, apenas muda "como mostrar". Pode ser solicitado diretamente no prompt ou via parâmetros:
| Você pode dizer | Parâmetro | Valores possíveis |
|---|---|---|
| "Faça um showreel / versão impressionante / vídeo curto vertical" | ?story=<tema>-reel (story explicativo comprimido em 0,42x, plano-sequência) | — |
| "Estilo claro / neon / acadêmico / papel" | look= | vivid claro e colorido · neon fundo escuro com brilho neon · academic escuro acadêmico · paper papel |
| "Paleta de cores candy / azul gelo / pôr do sol" | palette= | textbook · candy · ice · sunset · neon |
| "Quero transição com varredura de troca de cor" | fx=channels | A cada nova etapa, faz a varredura de pixels mudando para o próximo "canal pseudo-cor" (similar a troca de canal em microscopia de fluorescência) |
| "Título grande / estilo TikTok" | layout=reel | Cada etapa uma frase gancho grande, com etiqueta de canal pseudo-cor e breve aviso de isenção |
| "Vertical" | --size 1080x1920 | No modo vertical a câmera se afasta 1,7x (portraitZoom) |
Regras:
- Pseudo-cor apenas altera a cor, não modifica estrutura ou processo; na tela deve haver sempre "cores são pseudo-cor".
- Versão showreel também passa por revisão científica.
Gravação:
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, ~1/8 do tempo) gera uma prévia para o usuário confirmar, depois grava o vídeo final. O gravador trava para evitar que dois processos escrevam no mesmo arquivo; escreve primeiro *.partial.mp4, renomeia após conclusão; no final decodifica e verifica quadro a quadro automaticamente, reportando erros.
--dpr 2 --scale 1920x1080 significa: renderiza primeiro em resolução 2x, depois redimensiona para 1080p, como supersampling antialiasing. Para saída 4K, remova --scale.
Fluxo (nenhuma etapa pode ser pulada)
1. Tabela de Fatos (antes do visual) — Seguir references/accuracy-protocol.md
- Tema de livro didático: primeiro encontrar as frases originais do livro, usar como espinha dorsal das legendas; legendas escrevem apenas conclusões de nível de livro didático; detalhes de nível universitário vão nas notas da tabela de fatos.
- Tema de artigo: extrair argumentos do resumo e legendas de figuras, cada tomada corresponde a uma Figura, anotar fonte (ex.: Fig.2b).
- Saída:
review/tabela_de_fatos.md, colunas: Etapa | Legenda original | Fonte (seção do livro/DOI) | Status (verificado/pendente). Conteúdo pendente não pode ser exibido. - Ao mesmo tempo, escrever a Lista de Proibições de Cena, listando erros comuns deste tema (ex.: "ribossomo entra no lúmen do RE" "proteína flutuando nua no citoplasma").
2. Primeira Rodada de Revisão Independente (Tabela de Fatos + Design de Cena): Iniciar um subagente, fornecer apenas a tabela de fatos, o roteiro da história e a descrição da cena, pedir que ele aponte erros um por um.
3. Escrever Cena e História: Ver references/new-scene.md.
- Cada processo é escrito como função pura de t (ex.:
update(t, T)), janelas de tempo unificadas noTda história. - Moléculas rastreadas usam material emissivo, outras moléculas usam material escuro; o significado da "marcação" na tela deve ser consistente com o experimento.
- Tamanhos mantêm apenas ordem relativa, e na tela escreve "fora de escala real". Compressão de tempo também deve ser indicada.
4. Autoverificação de Amostras: Usar --stills para gerar quadros intermediários de cada etapa, montar em um mosaico para verificar: eventos-chave estão no centro da tela? São visíveis? Estruturas têm interseções ou buracos?
- Se detectar blocos escuros ou buracos suspeitos, usar
probe.mjs(sonda de raios) ehidetest.mjs(ocultar objetos um a um) para localizar, não adivinhar.
5. Segunda Rodada de Revisão Independente (Amostras do Vídeo Final): Subagente atua como "Professor de Biologia Celular + Diretor de Arte de documentário científico", revisa amostras, legendas e código de processo, fornece lista de correções obrigatórias e conclusão "pode ser usado diretamente para ensino".
- Somente após corrigir todos os problemas de "erro" e "enganoso" pode-se gerar o vídeo final.
6. Geração e Entrega:
- Entregáveis: dois mp4 (versão puramente visual + versão explicativa), mais a tabela de fatos e registros das duas rodadas de revisão.
- Publicação com texto em chinês e inglês; não misturar BGM.
Pontos-chave da Versão Web (bench)
- No story escrever
layout: 'bench', e fornecerbrand / title / sub / notes (marquee, devem ser fatos com fonte) / clock (tempo de filme → milissegundos fisiológicos) / conv (qual sinal é destacado em cada etapa), cada etapa escreverchip / badge / call (anotação: âncora, título, subtítulo, pontos-chave). - Os números na página só podem vir de três fontes, e devem ser identificados com selo no cartão:
MODEL(contagem do censo da cena),TYPICAL(valor típico do livro didático),TEXTBOOK. Não escrever termos como LIVE / MICROSCOPIA EM TEMPO REAL que possam ser confundidos com dados reais. - O relógio do modelo deve ser consistente com legendas e curvas; o fator de desaceleração escrever em faixa real (não linear se for não linear).
Modo "Corte Serial" de Aproximação e Espessura da Membrana
STORY.slab(t): segundo plano de corte global (mantém apenas z ≥ valor), na aproximação corta a cena em fatias de cerca de 50–100 nm de espessura, limpas como corte de microscópio eletrônico.- Membrana usa
shell()para criar bicamada fechada com espessura (camada externa voltada para fora, interna para dentro, 5 nm), materialcapify, corte mostra faixa sólida colorida; eventos-chave (poro de fusão, fosseta de endocitose) colocados no plano de corte, câmera aproximadamente em vista superior, para que o contorno Ω seja visível. - Em visão distante, moléculas/íons são ampliados conforme distância da câmera (
__camDist), com nota no rodapé "moléculas ampliadas em visão distante".
Duas Rotas de Geração (ver detalhes em references/two-routes.md)
- Rota Rápida: Renderização em tempo real Three.js (com N8AO oclusão de ambiente), um vídeo de 49 segundos leva cerca de 15 minutos para gerar, para iteração e geração diária.
- Rota Profissional:
export_blender.mjsexporta cena →blender_build.pyreconstrói no Blender, renderiza com Cycles path tracing →record.mjs --overlay-dirgera camada de interface web e sobrepõe. Localmente cerca de 17–20 segundos por quadro, para versão final de publicação. - Apenas uma tarefa Blender pode ser executada por vez; duas causam falta de memória e falha.
Estilo "Contas" em Nível Molecular (sem simplificar: usar estrutura real)
tools/pdb2beads.py <PDB> site2/mol/<PDB>.json [--opm] [--group chain]: converte estrutura atômica real em modelo de contas. Para proteínas de membrana adicionar--opm, usando orientação na membrana do banco OPM.- Topo da cena
await fetch('./mol/*.json'), usarbeadGeo()para gerar geometria. Contas acima do plano de corte são descartadas inteiramente, sem meia casca vazia. - Ao posicionar, fazer detecção de colisão entre contas para garantir zero intersecção;
node tools/check.mjs site2 "story=..."verificar. - Contagem deve ser autoconsistente estequiometricamente (ex.: 1 O₂ corresponde a PSII absorver 4 fótons, PSI absorver 4 fótons, transferir 4 elétrons, 12 H⁺ entram no lúmen do tilacoide, gerar 2 NADPH, cerca de 2,6 ATP). Animações contínuas ilustrativas devem ser rotuladas separadamente como ILUSTRATIVO.
Princípios Morfológicos (sem simplificar)
- Organelas modeladas conforme morfologia e proporções reais de microscopia eletrônica, não desenhadas como formas geométricas regulares. Tamanhos consultados primeiro em tabela (formato de
references/morphology-acinar.md), depois codificados. - Atravessando três ordens de grandeza (célula 15 μm → ribossomo 25 nm) não escalona estruturas, mas aproxima a câmera continuamente (interpolação logarítmica da distância), eventos moleculares vistos em close.
- Estruturas fechadas (grânulos, mitocôndrias, vacúolos condensados, núcleo) quando seccionadas mostram corte sólido (
capify), sem casca vazia.
Princípios de Layout
- Layout é original por tema, não copia vídeos de referência.
- Estilo padrão é acadêmico escuro: título serifado, corpo de texto com frases originais do livro didático, uma cor de destaque (igual à cor do traçador).
- Cada número que aparece na tela deve ter fonte. Não usar painéis falsos, contagens falsas, curvas falsas.
- Citações e aviso de isenção permanecem no rodapé: Animação ilustrativa · Fora de escala real · Tempo comprimido · Fonte.
Exemplos Concluídos
thylakoid: Cloroplasto → grana → reações de luz na membrana do tilacoide, 9 estruturas proteicas reais (PSII-LHCII, b₆f, PSI, ATP sintase, LHCII, PC, Fd, FNR, Rubisco), versão web bench em inglêsstory=thylakoid-en, gerado por ambas as rotas rápida e profissional.synapse: Sinapse glutamatérgica do hipocampo (varicosidades axonais → espinha dendrítica em cogumelo), escala real 1 unidade = 20 nm, potencial de ação → influxo de Ca²⁺ → fusão completa de vesícula única → ~4000 glutamato difundindo → abertura de AMPA, influxo de Na⁺ → captação por astrócito → endocitose dependente de clatrina e recarga. Versão web bench em inglêsstory=synapse-en, cerca de 50 segundos. Tabela de fatos e revisão emexamples/synapse/.secretion: Célula acinar pancreática de cobaia, processo completo de proteína secretora desde ribossomo livre até exocitose, cerca de 75 segundos, 9 etapas, incluindo timeline do experimento com ³H-leucina (3/17/117 min, dados de livro didático).