Simulations & Physique 3D
Faites en sorte que les scènes 3D se comportent : les corps tombent, s'empilent, se brisent et réagissent aux clics avec une masse crédible. Cette compétence couvre le choix du moteur, son couplage avec three.js, le maintien des 60fps et le motif d'impulsion au clic utilisé dans les sections héroïques.
Choisir le moteur
- Rapier (
@dimforge/rapier3d-compat) — par défaut. WASM, déterministe, activement maintenu, meilleures performances. Utilisezrapier3d-compat(initialisation WASM asynchrone) pour les bundlers ;rapier3d(synchrone) uniquement pour les balises script simples. - cannon-es — uniquement si le chargement WASM doit être évité (démos file://, CSP strict). Plus lent et moins maintenu.
- Particules GPGPU/FBO — pour la fumée, les essaims, les nuages de particules "IA neuronales" (des milliers et plus). Ce n'est pas un moteur physique ; voir la section GPU ci-dessous.
Chargez Rapier avant de créer des corps :
import RAPIER from '@dimforge/rapier3d-compat';
await RAPIER.init(); // requis une seule fois, avant la création du monde
const world = new RAPIER.World({ x: 0, y: -9.81, z: 0 });
Motif de couplage principal (three.js + Rapier)
La physique possède l'état ; three.js ne fait que le rendre. Ne déplacez jamais un maillage qui a un corps — lisez plutôt le corps dans le maillage à chaque image.
// 1. Corps d'abord
const bodyDesc = RAPIER.RigidBodyDesc.dynamic().setTranslation(0, 5, 0);
const body = world.createRigidBody(bodyDesc);
const colliderDesc = RAPIER.ColliderDesc.cuboid(0.5, 0.5, 0.5).setRestitution(0.4);
world.createCollider(colliderDesc, body);
// 2. Boucle de rendu — synchroniser, ne pas définir
function tick(dt) {
world.timestep = dt;
world.step();
mesh.position.copy(body.translation());
mesh.quaternion.copy(body.rotation());
}
- Utilisez un pas de temps fixe pour la stabilité : accumulez
dt, avancez par incréments de 1/60, limitez à 3 pas/image (protection contre la spirale de la mort). - Corps cinématiques pour les plateformes/mobiles ;
setNextKinematicTranslation()à chaque image. - Les colliders n'héritent pas de l'échelle du maillage — dimensionnez-les explicitement en unités monde.
Motif d'impulsion au clic (sections héroïques)
Lancez un rayon depuis le pointeur, trouvez le corps sous le curseur, frappez-le. C'est l'interaction "pousser l'objet héroïque" des meilleurs sites IA. Voir la compétence threejs-interaction pour les détails du raycaster.
raycaster.setFromCamera(pointerNDC, camera);
const hit = world.castRay(new RAPIER.Ray(origin, dir), 100, true, undefined, undefined, undefined, filterPredicate);
if (hit) {
const body = world.getCollider(hit.colliderHandle).parent();
const dir3 = rayDir.clone().multiplyScalar(6); // force de l'impulsion
body.applyImpulse({ x: dir3.x, y: dir3.y, z: dir3.z }, true);
}
Donnez aux corps cliquables un léger amortissement angulaire (setAngularDamping(0.5)) pour qu'ils tournent de manière crédible au lieu de tournoyer indéfiniment.
Corps nombreux : instancing, budget, sommeil
- Un
THREE.InstancedMeshpar géométrie ; écrivez les transformations des corps dans les matrices d'instance aprèsworld.step(). Jamais un maillage par corps au-delà de ~50 objets. - Budgets : ~200 boîtes/colliders dynamiques OK sur desktop ; ~80 sur mobile. En dessous, simulez (voir "fausse physique" ci-dessous).
- Laissez les corps dormir (par défaut) et réveillez-les uniquement lors d'interactions. Une scène remplie de corps qui ne dorment jamais brûle du CPU inutilement.
- Géométries simples pour les colliders (boîtes/sphères/capsules) ; maillages convexes/composés uniquement si la silhouette compte.
Fausse physique (décidez d'abord)
La plupart des sites marketing n'ont pas besoin de moteur. Demandez : l'effet nécessite-t-il des collisions ou simplement un mouvement crédible ?
- Orbites flottantes réagissant au curseur → calculs de ressorts/amortissement, pas de moteur.
- Confettis de formes 3D dispersés au clic → vitesses précalculées + intégration de la gravité dans un shader ou une boucle, pas de moteur.
- Modèle héroïque déplaçable avec retour → ressort vers la pose de repos (voir la compétence 3d-hero-interactions). N'utilisez Rapier que lorsque les objets doivent entrer en collision, reposer les uns sur les autres ou s'empiler.
Simulation de particules GPU
Pour les nuages de réseaux de neurones, champs d'étoiles, fumée — des milliers de particules mises à jour sur le GPU via des cibles de rendu ping-pong (textures d'état). Détails et modèle fonctionnel : lisez references/gpgpu-particles.md.
Erreurs courantes
- Oublier
await RAPIER.init()→ erreurs WASM cryptiques. - Définir
mesh.positionet laisser le corps le piloter — le corps gagne, le maillage se téléporte. Déplacez les corps, lisez les maillages en retour. - Pas de temps variables d'une image à l'autre → piles saccadées et tunnellisation. Pas de temps fixe + accumulateur.
- Ajouter du travail dans la boucle de rendu à l'intérieur des événements de collision — mettez en file d'attente les effets, appliquez-les après
step(). - Lancer un rayon sur la scène three.js pour la détection physique au lieu de
world.castRay(ou vice versa) — détectez dans le monde qui possède les objets. - Ne pas restaurer le monde lors des transitions de page (les démontages R3F fuient les corps WASM ; supprimez le monde).
Compétences associées
- threejs-fundamentals — scène, renderer, boucle
- threejs-interaction — lancer de rayons et détection de pointeur
- threejs-performance — instancing et budgets
- 3d-hero-interactions — la couche UX par-dessus (états de survol, explosions, curseurs magnétiques)