bio-viz-film · Vidéo explicative 3D de biologie (v2)
Objectif : un professeur ne peut pas y trouver d'erreur, un étudiant comprend du premier coup, la qualité visuelle est professionnelle. L'exactitude prime sur l'esthétique ; ne pas inventer de données, ne pas falsifier de processus.
Sommaire
template/site2/ ← Moteur actuel (v2)
index.html Disposition explicative (originale : fond sombre académique, titres avec empattement, navigation latérale droite)
engine.js Rendu, caméra, timeline, post-traitement (profondeur de champ + lueur), superposition explicative
lib.js Générateur aléatoire basé sur une graine, construction instanciée, pool dynamique, AO cuite
scene-*.js Scènes procédurales, exporte build(scene, seed) → { anchors, update(t,T), palette }
story-*.js Script narratif : étapes, plans, sous-titres, fenêtres temporelles des processus, légendes, références
vendor/ Three r170 + addons (postprocessing / environments, etc.)
template/site/ ← Ancien moteur v1 (style tableau de bord, cellule/virus ; problèmes scientifiques connus dans references/pitfalls.md, déconseillé)
template/tools/ record.mjs enregistrement image par image · sheet2.py collage d'échantillons · probe.mjs sonde de rayon · hidetest.mjs masquage objet par objet
references/ accuracy-protocol.md (à lire absolument) · techniques.md · new-scene.md · science-checklist.md · pitfalls.md
examples/ secretion : exemple complet du manuel chinois PEP必修1 3.2 « Synthèse et transport des protéines de sécrétion » + 5 rapports de relecture
Formats de sortie (disposition au choix)
?layout= | Effet | Adapté à |
|---|---|---|
clean | Image 3D pure, sans aucun texte ni interface web | Montage secondaire, doublage, fond d'écran |
lecture (par défaut) | Version académique sombre : numéro d'étape + titre avec empattement + phrase du manuel, navigation latérale droite, légendes, référence en bas | Vidéo explicative, publication |
notes | Version claire type fiche : cadre 3D arrondi à gauche, liste complète des étapes à droite (étape courante développée), légendes, données expérimentales, références | Cours, projection en classe |
dashboard | Tableau de bord de suivi : panneau droit affiche en temps réel le nombre de molécules marquées dans chaque compartiment (comptage du modèle, avec mention 'pas des valeurs expérimentales') | Présentation scientifique, démonstration de processus |
bench | Page web style paillasse claire (tendance des tableaux de bord viraux) : barre supérieure (champ de vision, étape, horloge du modèle) + connaissances réelles défilantes + fenêtre 3D encadrée (étiquettes ancrées sur les structures 3D avec réticule, échelle en temps réel) + barres de comptage du modèle + barre d'étape + 3 mini-fiches (courbe typique / courbe de comptage / schéma du manuel). Format vertical 1080×1350 optimal | Twitter, Xiaohongshu, version web |
| Personnalisé | Créer <nom>.js dans layouts/, exporter meta / css / html / mount / update, appeler avec ?layout=<nom> | Par thème ou sur demande |
- Dans le story, on peut écrire
layout: 'notes'pour définir une disposition par défaut ;--size 1080x1920pour une version verticale, les dispositions s'adaptent automatiquement. - Règles pour les nouvelles dispositions :
- Chaque nombre à l'écran doit être réel (provenant d'une source ou de l'état du modèle) ;
- Ne pas copier les vidéos de référence, la disposition doit être conçue spécialement pour le thème ;
- Le sujet 3D utilise
meta.camShiftpour laisser de la place au texte.
Mode Showreel (vidéo virale) — pour le trafic, pour impressionner
Utilise le même contenu scientifique que la version explicative, mais change seulement la présentation. On peut le demander dans le prompt ou via des paramètres :
| Vous dites | Paramètre | Options |
|---|---|---|
| « Fais une vidéo virale / version époustouflante / vidéo courte verticale » | ?story=<sujet>-reel (story explicative compressée par 0.42, plan-séquence) | — |
| « Style lumineux / néon / académique / papier » | look= | vivid bonbon lumineux · neon fond sombre néon · academic sombre académique · paper papier |
| « Palette bonbon / bleu glace / coucher de soleil » | palette= | textbook · candy · ice · sunset · neon |
| « Transition de balayage changeant de couleur » | fx=channels | À chaque étape, un balayage de pixels passe au canal pseudo-couleur suivant (similaire au changement de canal d'un microscope à fluorescence) |
| « Grands titres / style TikTok » | layout=reel | Un accroche par étape en gros titre, avec étiquette de canal pseudo-couleur et brève clause de non-responsabilité |
| « Format vertical » | --size 1080x1920 | En vertical, la caméra recule automatiquement de 1.7× (portraitZoom) |
Règles :
- La pseudo-couleur change seulement la couleur, pas la structure ni le processus ; une mention « les couleurs sont des pseudo-couleurs » doit être visible en permanence à l'écran.
- La version showreel doit aussi passer la relecture scientifique.
Enregistrement :
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 (×1, 30 ips, environ 1/8 du temps) produit un aperçu pour validation par l'utilisateur avant l'enregistrement final. L'enregistreur verrouille le fichier pour éviter deux processus simultanés ; écrit d'abord *.partial.mp4, renomme après fin ; enfin, vérifie image par image automatiquement et signale les erreurs.
--dpr 2 --scale 1920x1080 signifie : rendu d'abord en 2× résolution, puis redimensionné en 1080p, équivalent à un anti-aliasing par suréchantillonnage. Pour une sortie 4K, supprimer --scale.
Processus (aucune étape ne peut être sautée)
1. Table de vérification des faits (avant l'image) — exécuter selon references/accuracy-protocol.md
- Thème de manuel : trouver d'abord la phrase originale du manuel, qui servira de squelette aux sous-titres ; les sous-titres n'écrivent que les conclusions du niveau manuel, les détails de niveau universitaire vont dans les notes de la table.
- Thème d'article : extraire les thèses du résumé et des légendes de figures, chaque plan correspond à une figure, annoter la référence (ex. Fig.2b).
- Livrable :
review/table-des-faits.md, colonnes : Étape | Phrase du sous-titre | Référence (section manuel/DOI) | Statut (vérifié/en attente). Le contenu en attente ne peut pas être affiché. - Écrire en même temps la liste des images interdites, listant les erreurs courantes sur ce thème (ex. « un ribosome entre dans la lumière du RE », « une protéine nue dérive dans le cytoplasme »).
2. Première relecture indépendante (table des faits + conception de scène) : lancer un sous-agent, lui donner seulement la table des faits, le script narratif et la description de scène, lui demander de relever les erreurs une par une.
3. Écrire la scène et l'histoire : voir references/new-scene.md.
- Chaque processus s'écrit comme une fonction pure de t (ex.
update(t, T)), la fenêtre temporelle unifiée dansTdu story. - Les molécules traquées utilisent un matériau lumineux, les autres un matériau sombre ; la signification du « marquage » à l'écran doit correspondre à l'expérience.
- Les tailles ne conservent que l'ordre relatif, et une mention « pas à l'échelle réelle » doit figurer à l'écran. La compression temporelle doit aussi être mentionnée.
4. Auto-vérification des échantillons : utiliser --stills pour produire une image intermédiaire de chaque étape, assembler en collage et vérifier : l'événement clé est-il au centre du cadre, visible, les structures ont-elles des intersections ou des trous ?
- En cas de zones suspectes sombres ou de trous, utiliser
probe.mjs(sonde de rayon) ethidetest.mjs(masquage objet par objet) pour localiser, ne pas deviner.
5. Deuxième relecture indépendante (échantillons de la vidéo finale) : le sous-agent joue le rôle de « professeur de biologie cellulaire + directeur artistique de documentaire scientifique », examine les échantillons, les sous-titres et le code des processus, donne une liste des modifications obligatoires et une conclusion sur l'aptitude à l'enseignement.
- Seulement après avoir corrigé tous les problèmes de type « erreur » et « trompeur », on peut produire la vidéo.
6. Production et livraison :
- Livrables : version vidéo pure + version explicative (deux mp4), ainsi que la table des faits et les deux rapports de relecture.
- Accompagner de textes en chinois et en anglais ; pas de BGM mixé.
Points clés de la version web (bench)
- Dans le story, écrire
layout: 'bench'et fournirbrand / title / sub / notes(connaissances défilantes, doivent être des faits sourcés) /clock(temps pellicule → ms physiologiques) /conv(quel signal est mis en évidence à chaque étape), pour chaque étape écrirechip / badge / call(annotation : point d'ancrage, titre, sous-titre, points clés). - Les nombres à l'écran ne peuvent provenir que de trois sources, avec mention dans le badge de la carte :
MODEL(comptage du scène),TYPICAL(valeur typique de manuel),TEXTBOOK. L'échelle et le champ de vision sont calculés en temps réel par la caméra. Ne pas écrire LIVE / microscopie en temps réel ou tout terme pouvant être confondu avec des données réelles. - L'horloge du modèle doit être cohérente avec les sous-titres et les courbes ; le ralentissement doit mentionner la plage réelle (non linéaire si non linéaire).
Mode « tranche » en gros plan et épaisseur de membrane
STORY.slab(t): deuxième plan de coupe global (ne conserve que z ≥ valeur), en gros plan, découpe la scène en tranches d'environ 50–100 nm d'épaisseur, nettes comme une coupe de microscopie électronique.- La membrane utilise
shell()pour créer une bicouche fermée avec épaisseur (couche externe vers l'extérieur, couche interne vers l'intérieur, 5 nm), matériaucapify, la coupe affiche une bande de couleur pleine ; les événements clés (pore de fusion, fosse de clathrine) sont placés sur le plan de coupe, la caméra presque en vue de dessus, pour que le profil en Ω soit visible. - En plan large, les molécules/ions sont agrandis selon la distance à la caméra (
__camDist), avec mention « molécules agrandies en plan large » en bas de page.
Deux voies de production (détails dans references/two-routes.md)
- Voie rapide : rendu en temps réel Three.js (avec N8AO d'occlusion ambiante), une vidéo de 49 s sort en environ 15 min, pour itération et production quotidienne.
- Voie professionnelle :
export_blender.mjsexporte la scène →blender_build.pyreconstruit dans Blender, rendu par lancer de rayons Cycles →record.mjs --overlay-dirgénère l'interface web, puis superposition. Environ 17–20 s/image sur machine locale, pour la version finale de publication. - Un seul processus Blender à la fois, sinon mémoire insuffisante et plantage.
Style « collier de perles » à l'échelle moléculaire (pas de simplification : structure réelle)
tools/pdb2beads.py <PDB> site2/mol/<PDB>.json [--opm] [--group chaîne]: transforme la structure atomique réelle en modèle de perles. Pour les protéines membranaires, ajouter--opm, utilise l'orientation dans la membrane de la base OPM.- Au niveau supérieur de la scène
await fetch('./mol/*.json'), génère la géométrie avecbeadGeo(). Les perles au-dessus du plan de coupe sont supprimées entièrement, pas de demi-coquille. - Placement avec détection de collision au niveau des perles, garantit 0% d'interpénétration ;
node tools/check.mjs site2 "story=..."pour vérifier. - Les comptages doivent être stœchiométriquement cohérents (ex. : 1 O₂ correspond à PSII absorbant 4 photons, PSI absorbant 4 photons, transférant 4 électrons, 12 H⁺ dans le lumen thylakoïdien, produisant 2 NADPH, environ 2.6 ATP). Les animations continues à titre illustratif doivent être étiquetées ILLUSTRATIVE.
Principes de morphologie (pas de simplification)
- Les organites sont modélisés selon leur forme réelle en microscopie électronique et leurs proportions, pas en géométries régulières. Les dimensions sont d'abord recherchées (comme dans
references/morphology-acinar.md), puis codées. - Sur trois ordres de grandeur (cellule 15 μm → ribosome 25 nm), on ne réduit pas les structures, mais on fait avancer la caméra en continu (interpolation logarithmique de la distance), et on regarde les événements moléculaires en gros plan.
- Les structures fermées (granules, mitochondries, vésicules condensées, noyau) montrent une section pleine (
capify) lors de la coupe, pas de coquille vide.
Principes de disposition
- La disposition est originale selon le thème, ne pas copier les vidéos de référence.
- Le style par défaut est académique sombre : titres avec empattement, texte corps en phrases du manuel, une couleur d'accentuation (celle du traceur).
- Chaque nombre apparaissant à l'écran doit avoir une source. Pas de faux tableaux de bord, faux comptages, fausses courbes.
- Mentions et clauses de non-responsabilité fixes en bas : Animation illustrative · Pas à l'échelle réelle · Temps compressé · Références.
Exemples réalisés
thylakoid: Chloroplaste → granum → réactions photochimiques sur la membrane thylakoïdienne, 9 structures protéiques réelles (PSII-LHCII, b₆f, PSI, ATP synthase, LHCII, PC, Fd, FNR, Rubisco), version web anglaise benchstory=thylakoid-en, produite en voie rapide et professionnelle.synapse: Synapse glutamatergique de l'hippocampe (varicosité axonale → épine dendritique en champignon), échelle réelle 1 unité = 20 nm, potentiel d'action → entrée de Ca²⁺ → fusion complète d'une vésicule → diffusion de ~4000 glutamate → ouverture AMPA, entrée de Na⁺ → recapture par astrocytes → endocytose par clathrine et recharge. Version web anglaise benchstory=synapse-en, environ 50 s. Table des faits et relecture dansexamples/synapse/.secretion: Cellule acineuse pancréatique de cobaye, synthèse de protéine sécrétoire du ribosome libre à l'exocytose complète, environ 75 s, 9 étapes, avec chronologie de l'expérience ³H-leucine (3/17/117 min, données du manuel).