# MistubaVideo : rendre des enregistrements de simulation avec Mitsuba

> Des poses et champs de surface enregistrés aux images, cartes de chaleur et vidéos.

- Page HTML: https://antoineboucher.info/CV/blog/fr/posts/mistubavideo-rendered-video/
- Langue: fr
- Traduction (en): https://antoineboucher.info/CV/blog/posts/mistubavideo-rendered-video/index.md
- Publié: 2026-10-24
- Mis à jour: 2026-10-24
- Tags: Mitsuba, Vidéo
- Auteur: Antoine Boucher (https://antoineboucher.info/CV/index-en.html)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.

## 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.](https://antoineboucher.info/CV/blog/posts/mistubavideo-rendered-video/images/roughconductor.png)

## Le module de rendu

| Étape | Données |
| --- | --- |
| Entrée | Maillages, matériaux, poses enregistrées et champs de surface |
| Traitement | Adaptateur de source, mélange des matériaux et rendu Mitsuba |
| Sortie | Images, 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.

```mermaid
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`.

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

## 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.](https://antoineboucher.info/CV/blog/posts/mistubavideo-rendered-video/images/spotlight.png)

## 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](https://github.com/ETSim/MistubaVideo/tree/main/packages/mitsuba_video).

Implémentation : [interface de source](https://github.com/ETSim/MistubaVideo/blob/main/packages/mitsuba_video/src/mitsuba_video/source.py), [mélange des matériaux](https://github.com/ETSim/MistubaVideo/blob/main/packages/mitsuba_video/src/mitsuba_video/blend.py).

La [documentation du projet](https://antoineboucher.info/CV/blog/fr/projects/notes/mistubavideo/) regroupe le lien source et la terminologie.

- [MistubaVideo sur GitHub](https://github.com/ETSim/MistubaVideo)