---
title: Import NMG (Géométrie)
description: Importer un fichier de géométrie NMG dans Blender.
---

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

Le format **NMG** (Native Model Geometry) contient les données de géométrie d'un modèle 3D : vertices, normales, UV maps, indices de faces et références aux matériaux. C'est le format de base pour importer un mesh isolé depuis GS Framework.

**Menu** : File → Import → **NMG Geometry (.nmg)**

{/* ![Boîte de dialogue d'import NMG](../../../assets/placeholder-import-nmg-dialog.png) */}

---

## Options d'import

| Option | Par défaut | Description |
|---|---|---|
| **Project Folder** | (préférences) | Dossier racine du projet, utilisé pour résoudre les chemins des matériaux et textures. Si laissé vide, la valeur des préférences est utilisée. |
| **Scale** | `1.0` | Facteur d'échelle appliqué à la géométrie importée. Plage : 0.001 à 1000. |
| **Flip X** | ✅ Activé | Inverse l'axe X. Le moteur GS Framework utilise un axe X inversé par rapport à Blender. |
| **Swap YZ** | ✅ Activé | Échange les axes Y et Z. GS Framework utilise un système Y-up, Blender utilise Z-up. |
| **Import Materials** | ✅ Activé | Importe automatiquement les matériaux (.nmm) référencés par la géométrie. |

---

## Détail des options

### Scale

Le facteur d'échelle multiplie toutes les coordonnées de la géométrie. Utilisez-le si votre scène GS Framework est dans une échelle très différente de celle de Blender.

<Aside type="tip">
En règle générale, laissez l'échelle à `1.0`. Modifiez-la uniquement si les objets importés apparaissent démesurément grands ou petits.
</Aside>

### Flip X et Swap YZ

Ces deux options gèrent la conversion du système de coordonnées entre GS Framework et Blender :

- **GS Framework** : Y vers le haut, X inversé
- **Blender** : Z vers le haut

**Gardez les deux options activées** dans la grande majorité des cas. Ne les désactivez que si vous travaillez volontairement dans le système de coordonnées natif de GS Framework (rare).

### Import Materials

Quand cette option est activée, l'addon :

1. Lit les références de matériaux contenues dans le fichier NMG
2. Recherche les fichiers `.nmm` correspondants dans le dossier projet
3. Importe chaque matériau (textures, paramètres shader, couleurs)
4. Assigne les matériaux aux faces correspondantes du mesh

Si l'option est désactivée, le mesh est importé sans matériaux — vous pouvez les ajouter manuellement plus tard.

<Aside type="caution">
Si les matériaux ne sont pas trouvés, vérifiez que le **Project Folder** est correctement configuré. Activez le [Verbose Logging](/getting-started/configuration/) pour voir les chemins de recherche tentés.
</Aside>

---

## Ce qui est importé

Un fichier NMG produit dans Blender :

- Un **objet mesh** avec la géométrie complète (vertices, faces, normales)
- Les **UV maps** du modèle (autant de layers UV que le fichier en contient)
- Les **matériaux** assignés (si l'option est activée)
- Des **propriétés custom** sur l'objet :
  - `asset_type` : "NMG"
  - `asset_file` : chemin du fichier source
  - `nmg_vertices` : nombre de vertices
  - `nmg_polygons` : nombre de polygones
  - `nmg_uv_channels` : nombre de layers UV
  - `nmg_has_normals` : présence de normales
  - `nmg_materials` : liste JSON des chemins de matériaux référencés

---

## Cas d'usage

- **Vérifier un modèle** : importer un NMG seul pour inspecter la géométrie d'un asset
- **Remplacer un mesh** : importer la géométrie pour la modifier, puis réexporter
- **Assemblage manuel** : importer plusieurs NMG individuellement pour construire une scène à la main
