---
title: Types et constantes
description: Référence rapide des types d'objets, d'assets, de collision shapes et autres constantes de l'addon.
---

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

---

## Types d'objets (nommage)

Utilisés par le [système de nommage](/blender/tutoriels/nommage/) pour catégoriser les objets.

| Valeur | Description |
|---|---|
| `tree` | Arbres, buissons, végétation |
| `building` | Bâtiments, structures |
| `vehicle` | Véhicules |
| `animal` | Animaux |
| `character` | Personnages, piétons |
| `prop` | Accessoires, mobilier urbain |
| `mountain` | Reliefs, montagnes |
| `shape` | Formes / volumes génériques |
| `sign` | Panneaux, signalisation |
| `road` | Routes, trottoirs, voirie |
| `wall` | Murs, clôtures |
| `internal` | Objets internes au système |

<Aside type="note">
Les types `tree`, `prop`, `building`, `character` et `wall` désignent les **objets dynamiques** : ce sont eux qui sont exportés comme [props](/blender/exemples/export-props-road-highway/) (NML + GLTF) plutôt que dans la géométrie composite.
</Aside>

---

## Types d'assets

Définis dans le panneau **Asset & Script** (onglet GS Object), ils déterminent le rôle fonctionnel de l'objet.

| Valeur | Description |
|---|---|
| *(vide)* | Objet standard (Default) |
| `Trigger` | Zone de déclenchement |
| `CollisionShape` | Forme de collision |
| `Track` | Chemin de circulation |
| `LOD` | Niveau de détail (enfant d'un objet) |
| `NMG` | Géométrie importée |
| `NMS` | Objet de scène importé |
| `Material` | Matériau |
| `Camera` | Caméra |
| `Light` | Lumière |
| `Instance` | Instance de sous-scène |

---

## Types de collision shapes

| Type | Forme | Affichage Empty Blender |
|---|---|---|
| `Box` | Parallélépipède rectangle | Cube |
| `Sphere` | Sphère | Sphere |
| `Capsule` | Cylindre arrondi | Sphere |
| `Cylinder` | Cylindre | Cube |
| `Mesh` | Forme libre | Plain Axes |

---

## Modes physiques

| Mode | Comportement moteur | Type de simulation |
|---|---|---|
| `None` | Aucune physique | — |
| `Static` | Immobile, collision | Statique |
| `Kinematic` | Déplaçable, collision | Cinématique |
| `Dynamic` | Simulation complète | Dynamique |
| `Character` | Contrôleur personnage | Cinématique |
| `Vehicle` | Physique véhicule | Dynamique |

---

## Canaux de texture

Types reconnus par le [panneau GS Material](/blender/interface/shader-panel/) et le système d'import/export.

| Canal | Usage |
|---|---|
| `diffuse` | Couleur de base / albedo |
| `normal` | Carte de normales |
| `specular` | Réflexion spéculaire |
| `glossiness` | Brillance |
| `roughness` | Rugosité |
| `opacity` | Transparence |
| `reflection` | Réflexion environnementale |
| `selfillum` | Auto-illumination / émission |
| `light` | Lightmap |
| `ao` | Occlusion ambiante |
| `metallic` | Caractère métallique |
| `colormask` | Masque de couleur |
| `custom` | Canal personnalisé |

---

## Types de route (Tracks)

| Valeur | Label | Usage |
|---|---|---|
| `0` | Route | Route standard |
| `1` | Autoroute | Voie rapide |
| `2` | Ville | Zone urbaine |

---

## Modes de track

| Valeur | Mode | Usage |
|---|---|---|
| `0` | Route | Circulation routière (véhicules) |
| `1` | Animal | Déplacement animal |

---

## États animaux (Tracks)

Presets proposés par défaut dans l'interface :

| État | Description |
|---|---|
| `idle` | Stationnaire |
| `walk` | Marche |
| `run` | Course |
| `graze` | Broutage |

<Aside type="tip">
N'importe quel texte peut être saisi comme état animal — les presets ci-dessus ne sont que des raccourcis. Le moteur GS Framework peut supporter d'autres états définis par votre équipe.
</Aside>

---

## Formats de fichiers

| Extension | Format | Contenu |
|---|---|---|
| `.nms` | Native Model Scene | Scène complète (hiérarchie, objets, instances, lumières, caméras) |
| `.nmg` | Native Model Geometry | Géométrie (mesh, UV, normales, indices) |
| `.nmm` | Native Model Material | Matériau (couleurs, textures, paramètres shader) |
| `.nsa` | Shader definition | Définition de shader pour le moteur |
| `.nut` | Squirrel script | Script d'animation Squirrel |
| `.scene.json` | Manifeste d'export | Description de la scène exportée (GLTF + métadonnées) |

---

## Presets de vitesse (Tracks routiers)

| Vitesse | Usage typique |
|---|---|
| 30 km/h | Zone résidentielle, scolaire |
| 50 km/h | Ville |
| 70 km/h | Départementale |
| 90 km/h | Nationale |
| 110 km/h | Voie rapide |
| 130 km/h | Autoroute |

---

## Système de coordonnées

| Système | Axe haut | X |
|---|---|---|
| **GS Framework** | Y | Inversé |
| **Blender** | Z | Normal |

La conversion est automatique lors de l'import (`Flip X` + `Swap YZ`) et de l'export.
