87 lines
3.6 KiB
Plaintext
87 lines
3.6 KiB
Plaintext
---
|
|
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)**
|
|
|
|
{/*  */}
|
|
|
|
---
|
|
|
|
## 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
|