---
title: Exporter les props de road_highway
description: Exemple pas à pas — exporter les props dynamiques de road_highway en NML + GLTF vers le simulateur.
---

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

Ce guide reprend l'export des **props** de la scène **road_highway** : les objets dynamiques (arbres, mobilier, décor) qui ne font **pas** partie de la géométrie composite. Il fait suite à l'[export composite de road_highway](/blender/exemples/export-road-highway/).

<Aside type="note">
**`<simu>`** désigne le dossier d'installation du simulateur, par défaut :

```
C:/Users/simulateur/Desktop/Simulateur-Develter
```
</Aside>

---

## Props : c'est quoi ?

Les **props** sont les objets dynamiques de la scène — typiquement les arbres, les murs, le mobilier et les éléments de décor (les objets de type `tree`, `prop`, `building`, `character`, `wall`). L'addon les exporte à part :

- un fichier **NML** (`props.nml`) qui contient le **placement** de chaque prop (position, rotation, échelle) et une référence vers sa géométrie ;
- un dossier **`props_gltf/`** qui contient les **géométries uniques** (regroupées en fichiers GLTF) et leurs textures.

Plusieurs props identiques partagent la même géométrie : elle n'est exportée qu'une seule fois.

---

## 1. Ouvrir la scène et la console

<Steps>

1. Ouvrez le fichier `.blend` de **road_highway** (le même que pour l'export composite).

2. Ouvrez la console système : **Window → Toggle System Console**. Gardez-la ouverte pour suivre la progression.

</Steps>

---

## 2. Lancer l'export des props

<Steps>

1. Ouvrez la sidebar du viewport 3D (touche `N`) et allez dans l'onglet **GS Scene**.

2. Dépliez le panneau **Export Props**. Il affiche un récapitulatif :
   - **Prop objects** : nombre total de props détectés dans la scène
   - **Unique geometries** : nombre de géométries distinctes à exporter

3. Cliquez sur le bouton **Export Props NML + GLTF**.

</Steps>

<Aside type="note">
Si le bouton est grisé, c'est qu'aucun prop n'a été détecté dans la scène. Vérifiez que vos objets dynamiques sont bien typés (`tree`, `prop`, etc.) via le [système de nommage](/blender/tutoriels/nommage/).
</Aside>

---

## 3. Régler les options

Un navigateur de fichiers s'ouvre avec, à droite, les options d'export. Configurez-les ainsi :

| Option | Valeur | Détail |
|---|---|---|
| **Export GLTF Geometry/Materials** | ✅ Activé (défaut) | Exporte bien la géométrie et les matériaux, pas seulement le placement. |
| **Geometries per GLTF** | **200** | Nombre de géométries uniques regroupées par fichier GLTF. Par défaut `10` → passez-le à `200`. Moins de fichiers, export plus rapide. |
| **Dynamic Texture Sizing** | ✅ **Activez-la** | C'est le « scaling » des textures : chaque texture est redimensionnée à la résolution juste nécessaire selon la taille des objets qui l'utilisent. Décochée par défaut. |
| **Min Size** | **512** | Plancher de résolution. Par défaut `128` → passez-le à `512` pour garder une qualité minimale correcte sur les props. |
| **Max Size** | 1024 (défaut) | Plafond de résolution. Laissez tel quel. |
| **Texel Density** | 48 (défaut) | Pixels par mètre utilisés pour calculer la résolution cible. Laissez tel quel. |

Laissez **Convert Textures to DDS (BC7)** décoché.

<Aside type="tip">
**Geometries per GLTF** et le « scaling » sont indépendants : le premier regroupe les fichiers, le second optimise le poids des textures. On active les deux ici pour un export propre et léger.
</Aside>

<Aside type="caution">
Les champs **Min Size**, **Max Size** et **Texel Density** ne sont modifiables que si **Dynamic Texture Sizing** est cochée. Activez d'abord la case, puis réglez **Min Size** sur `512`.
</Aside>

Le dialogue d'export, options réglées et fichier nommé `props.nml` dans `…/scenes/trees/road_highway/` :

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

---

## 4. Choisir la destination

<Steps>

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

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

   (créez le sous-dossier `road_highway` s'il n'existe pas encore)

2. Dans le champ **nom de fichier**, saisissez :

   ```
   props.nml
   ```

3. Cliquez sur **Export Props NML + GLB**.

</Steps>

---

## 5. Résultat

Suivez la progression dans la console. À la fin, le dossier contient :

```
app/scenes/trees/road_highway/
├── props.nml          ← placement des props + références de géométrie
└── props_gltf/        ← géométries uniques (par paquets de 200) + textures
    ├── ....gltf / .bin
    └── textures/
```

Le dossier `props_gltf/` est toujours créé **à côté** du fichier `props.nml`, peu importe le nom que vous donnez au NML.

<Aside type="tip">
Si vous corrigez seulement le placement des props (sans toucher à la géométrie), vous pouvez relancer l'export en **décochant** *Export GLTF Geometry/Materials* : seul le `props.nml` est réécrit, ce qui est bien plus rapide.
</Aside>

---

## Récapitulatif road_highway

Une fois les deux exports faits, le simulateur dispose de tout pour road_highway :

| Étape | Sortie |
|---|---|
| [Export composite](/blender/exemples/export-road-highway/) | `app/scenes/safety_driving/road_highway/` (manifeste + sous-scènes) |
| Export des props (ce guide) | `app/scenes/trees/road_highway/` (`props.nml` + `props_gltf/`) |
