Aller au contenu
← Tous les articles
Présentation du projet

MistubaVideo : rendre des enregistrements de simulation avec Mitsuba

Écouter en version balado

De la simulation à la vidéo · 2:26 · voix synthétiques, script rédigé avec l’IA

Transcription

Sylvie : Une simulation physique produit des nombres : où les corps se sont déplacés, quelles zones d'une surface ont changé. Comment en faire un film qu'on peut regarder ?

Thierry : Je suppose qu'il faut quelque chose qui dessine tout ça.

Sylvie : C'est MistubaVideo. Il prend les exports d'une simulation et les transforme en images et en vidéo avec Mitsuba 3, un moteur de rendu qui suit les chemins de la lumière pour des images réalistes.

Thierry : Pourquoi séparer le dessin de la simulation ?

Sylvie : Parce qu'une fois la simulation enregistrée, on peut changer la caméra ou l'éclairage sans la relancer. C'est comme filmer une pièce une fois, puis monter depuis tous les angles.

Thierry : Qu'est-ce qu'on lui donne ?

Sylvie : Deux voies. Un moteur par lots traite une séquence de fichiers de maillage O B J, et FFmpeg assemble les images en vidéo ou en GIF. La deuxième voie, c'est un module nommé mitsuba-video, qui rejoue les poses enregistrées des corps et les champs de surface, comme l'usure d'un matériau.

Thierry : C'est quoi, un champ de surface ?

Sylvie : Une image posée sur la surface, dépliée dans un atlas à plat, qui dit à quel point chaque région a changé. Le module lit un manifeste, un petit fichier qui liste corps, maillages, matériaux, poses et images de champs. Un autre simulateur peut écrire ce même format.

Thierry : Et pour chaque image ?

Sylvie : Il applique les poses enregistrées, mélange le matériau de base avec le matériau affecté selon le champ, puis fait le rendu. Il peut ajouter une carte de chaleur, un panneau d'atlas et une courbe de surface couverte, puis encoder un MP4.

Thierry : C'est simple à essayer ?

Sylvie : Trois commandes. Inspect vérifie les entrées, preview vérifie le cadrage, et render produit les images. Il y a des préréglages de qualité nommés preview, draft et paper.

Thierry : Qu'est-ce qu'on obtient ?

Sylvie : Les images de la scène, des images composites, un C S V de surface couverte, et un fichier de configuration avec les paramètres et les temps de calcul, pour refaire une vidéo plus tard. Les images E X R linéaires sont optionnelles.

Thierry : Et c'est testé ?

Sylvie : Le paquet a des tests pytest pour les transformations, le mélange de matériaux, les lecteurs O B J et M T L, et le manifeste.

Thierry : Un enregistrement devient donc une vidéo claire et reproductible. L'article complet a le schéma du pipeline.

Table des matières

MistubaVideo transforme les sorties de simulation en images et vidéos avec Mitsuba 3. Son moteur par lots traite des séquences OBJ. Le module mitsuba-video rejoue les poses des corps et les champs de surface, comme l’usure.

1. La place du rendu

La simulation calcule le mouvement et les changements de surface. Le rendu montre les déplacements, les régions modifiées dans l’atlas UV et l’évolution des matériaux. Un enregistrement permet de changer la caméra ou l’éclairage sans relancer la simulation.

python main.py multi --folder exports traite une séquence OBJ. Les vues, la résolution et les échantillons par pixel règlent le rendu; FFmpeg assemble les images en vidéo ou en GIF. Le rendu de champs ajoute les transformations et textures de chaque image.

Un matériau conducteur rugueux rendu avec Mitsuba.

Illustration de matériau déjà présente dans le rapport. Elle montre l’ombrage, sans représenter un résultat de simulation d’usure.

2. Le module de rendu

ÉtapeDonnées
EntréeMaillages, matériaux, poses enregistrées et champs de surface
TraitementAdaptateur de source, mélange des matériaux et rendu Mitsuba
SortieImages, CSV de surface, paramètres et MP4

Le paquet mitsuba-video lit un manifeste versionné ou un enregistrement TextureFriction grâce à un adaptateur de source. Le manifeste décrit les corps, maillages, matériaux, poses et images de champs. ManifestWriter permet à un autre simulateur de produire ce format.

Pour chaque image sélectionnée, le module applique les poses enregistrées, mélange les matériaux de base et affectés selon le champ de surface, puis effectue le rendu. Il peut ajouter une carte de chaleur, un panneau d’atlas UV et une courbe de surface couverte avant l’encodage MP4.

flowchart TD
  subgraph Inputs[Sorties de simulation]
    R[Enregistrement TextureFriction]
    M[Manifeste : maillages, poses et champs]
  end
  subgraph Helper[Module mitsuba-video]
    A[Adaptateur de source]
    B[Poses et mélange des matériaux]
    C[Tracé de chemins Mitsuba 3]
    D[Atlas et courbe de surface couverte]
  end
  R --> A
  M --> A
  A --> B --> C --> D
  D --> E[Images et MP4]

inspect vérifie les entrées et preview permet de vérifier le cadrage. render produit la séquence; encode modifie l’assemblage vidéo à partir des images existantes. Les préréglages comprennent preview, draft et paper.

mitsuba-video inspect path/to/manifest.json
mitsuba-video preview path/to/manifest.json
mitsuba-video render path/to/manifest.json -q preview

3. Lire les résultats

Les sorties comprennent les images de la scène, les images composites, un CSV de surface couverte et render_config.json, avec les paramètres et temps de calcul. Les images EXR linéaires sont optionnelles. La courbe mesure la surface couverte du champ enregistré. Elle ne mesure pas la surface visible de l’objet à l’écran.

Conservez les paramètres d’affichage pour comparer des vidéos : changer l’échelle de la carte de chaleur peut donner une apparence différente au même champ.

Illustration d’un éclairage ponctuel Mitsuba issue du rapport.

Illustration d’éclairage déjà présente dans le rapport. L’éclairage et le champ de surface enregistré sont deux entrées distinctes.

4. Sources et tests

Le paquet documente des tests pytest pour les transformations, le mélange des matériaux, les lecteurs OBJ et MTL, ainsi que le schéma et le générateur de manifestes. Aucun pourcentage mesuré de couverture n’est fourni ici.

Documentation du module de rendu[1].

Implémentation : interface de source[2], mélange des matériaux[3].

La documentation du projet regroupe le lien source et la terminologie.

Références

  1. ETSim. (). Documentation du module de rendu. [Source file or documentation] github.com.
  2. ETSim. (). interface de source. [Source file or documentation] github.com.
  3. ETSim. (). mélange des matériaux. [Source file or documentation] github.com.
  4. ETSim. (). MistubaVideo. [Software repository] github.com.

Les références utilisent la date de publication de cet article.