---
title: Exporter road_highway (composite)
description: Exemple pas à pas — exporter la scène road_highway en scène composite GLTF vers le simulateur.
---

import { Aside, Steps } from '@astrojs/starlight/components';

Ce guide reprend, étape par étape, l'export complet de la scène **road_highway** vers le simulateur. C'est un exemple concret : suivez-le tel quel pour cette scène, ou adaptez les chemins et le nom pour une autre.

<Aside type="note">
Dans tout ce guide, **`<simu>`** désigne le dossier d'installation du simulateur. Par défaut il s'agit de :

```
C:/Users/simulateur/Desktop/Simulateur-Develter
```

Le dossier `app/` (vers lequel pointe le **Dossier Projet** dans les préférences de l'addon) se trouve directement à l'intérieur.
</Aside>

---

## Ce que vous allez produire

L'export composite découpe la scène en **sous-scènes GLTF** (une par collection) et écrit un fichier **manifeste** `.scene.json` qui décrit l'assemblage. À la fin, le dossier de destination contiendra :

```
app/scenes/safety_driving/road_highway/
├── road_highway.scene.json   ← le manifeste (porte le nom de la scène)
├── subscenes/                ← un GLTF par collection
└── textures/                 ← textures partagées (déduplication activée)
```

---

## 1. Ouvrir la scène

<Steps>

1. Ouvrez le fichier `.blend` de la scène **road_highway** dans Blender.

2. Vérifiez que le **Dossier Projet** est bien configuré sur le `app/` du simulateur dans **Edit → Preferences → Add-ons → Blender-GS**. Sans ça, les textures originales ne seront pas retrouvées (voir [Configuration](/blender/getting-started/configuration/)).

</Steps>

---

## 2. Ouvrir la console

Avant de lancer l'export, ouvrez la **console système** : c'est elle qui affiche la progression de l'export et les éventuelles erreurs (textures manquantes, fichiers verrouillés, etc.).

<Steps>

1. Menu **Window → Toggle System Console**.

2. Une fenêtre noire s'ouvre à côté de Blender. Laissez-la ouverte pendant tout l'export.

</Steps>

![Window → Toggle System Console et la console ouverte](../../../../assets/road-highway-console.png)

<Aside type="tip">
L'export d'une grande scène peut prendre plusieurs minutes. Tant que des lignes défilent dans la console, l'addon travaille — ne fermez pas Blender.
</Aside>

---

## 3. Lancer l'export composite

Deux accès équivalents, au choix :

- **File → Export → Composite Scene (.gltf + .scene.json)**
- ou, dans la sidebar du viewport 3D (touche `N`), onglet **GS Scene** → panneau **Export de Scène** → bouton **Export Composite Scene**.

Un navigateur de fichiers s'ouvre.

---

## 4. Choisir la destination et le nom

<Steps>

1. Dans le navigateur de fichiers, naviguez jusqu'au dossier :

   ```
   <simu>/app/scenes/safety_driving/road_highway/
   ```

2. Dans le champ **nom de fichier** (en bas du navigateur), saisissez :

   ```
   road_highway
   ```

3. Dans le panneau d'options à droite (**Export Options**), repérez le champ **Scene Name** et saisissez **exactement la même chose** :

   ```
   road_highway
   ```

</Steps>

<Aside type="caution" title="Le nom doit être « road_highway »">
Le **nom de fichier (save)** *et* le champ **Scene Name** doivent tous les deux contenir `road_highway` (avec l'underscore, comme le nom du dossier). C'est ce nom que le simulateur utilise pour charger la scène : une faute de frappe ici et la scène ne sera pas trouvée côté moteur.
</Aside>

---

## 5. Régler les options d'export

Dans le panneau **Export Options** à droite, configurez :

| Option | État | Pourquoi |
|---|---|---|
| **Apply Modifiers** | ✅ Activé | Fige les modifiers (Array, Mirror, Subdivision…) dans le GLTF, comme dans le viewport. Vos objets Blender ne sont pas modifiés. |
| **Deduplicate Textures** | ✅ Activé | Regroupe les textures identiques dans un dossier `textures/` partagé au lieu de les copier dans chaque sous-scène. Indispensable pour ne pas exploser la taille de l'export. |
| **Keep Original Texture Files** | ✅ Activé | Remet les fichiers de texture **d'origine** (DDS, TGA…) à la place des PNG ré-encodés par Blender, et corrige les liens dans les GLTF. Préserve la compression et les mipmaps que Blender perdrait sinon. |

Laissez les autres options sur leur valeur par défaut (décochées) : **Convert Textures to DDS**, **Single Subscene Mode**, **Skip Unchanged Subscenes**, **Include Dynamic Objects in GLTF**.

<Aside type="note">
**Apply Modifiers** est coché par défaut — vérifiez simplement qu'il l'est toujours. Les deux autres cases (**Deduplicate Textures** et **Keep Original Texture Files**) sont décochées par défaut : c'est à vous de les activer.
</Aside>

<Aside type="caution">
**Include Dynamic Objects in GLTF** doit rester **décoché**. Les arbres, props et autres objets dynamiques de road_highway ne font pas partie de l'export composite : ils sont exportés séparément (voir [Exporter les props de road_highway](/blender/exemples/export-props-road-highway/)). S'il est coché, ces objets seraient figés dans le GLTF et exportés en double.
</Aside>

Une fois le dossier, le nom et les options réglés, le dialogue ressemble à ceci :

![Dialogue d'export composite configuré pour road_highway](../../../../assets/road-highway-composite-dialog.png)

---

## 6. Exporter

Cliquez sur **Export Composite Scene**.

Suivez la progression dans la console. À la fin, vous obtenez dans `app/scenes/safety_driving/road_highway/` :

- le manifeste `road_highway.scene.json` (nommé d'après le champ Scene Name) ;
- le dossier `subscenes/` avec un GLTF par collection ;
- le dossier `textures/` avec les textures partagées.

<Aside type="tip">
Si vous relancez l'export plus tard et que rien n'apparaît à l'écran, supprimez l'ancien `road_highway.scene.json` puis recommencez — le manifeste sert aussi de cache pour l'option *Skip Unchanged Subscenes*.
</Aside>

---

## Étape suivante

Les objets statiques de la scène sont exportés. Il reste à exporter les **props dynamiques** (arbres, mobilier, décor) qui ne font pas partie de la géométrie composite :

➡️ [Exporter les props de road_highway](/blender/exemples/export-props-road-highway/)
