Tom Boullay
43 lines
2.0 KiB
Markdown
43 lines
2.0 KiB
Markdown
# Galerie des modèles
|
|
|
|
La galerie est disponible sur `/gallery`. Elle permet de parcourir les modèles 3D présents dans `public/models/` sans lancer la boucle de gameplay principale.
|
|
|
|
## Objectif
|
|
|
|
Cette page sert à remercier et valoriser le travail des designers du projet La Fabrik. Chaque modèle est affiché dans un canvas dédié, avec la même skybox que l'expérience principale pour garder une ambiance visuelle cohérente.
|
|
|
|
## Utilisation
|
|
|
|
1. Ouvrir `/gallery`.
|
|
2. Utiliser les flèches en bas de l'écran pour passer au modèle précédent ou suivant.
|
|
3. Tourner autour du modèle avec la souris ou le doigt.
|
|
4. Lire le diagnostic texture discret pour savoir si le modèle chargé semble correct côté textures.
|
|
|
|
## Fonctionnement
|
|
|
|
- La liste des modèles est déclarée dans `src/data/galleryModels.ts`.
|
|
- Le viewer utilise `@react-three/fiber` et `@react-three/drei`.
|
|
- `OrbitControls` permet de manipuler la caméra autour du modèle.
|
|
- `Bounds` et `Center` recadrent automatiquement le modèle actif.
|
|
- `SkyModel` réutilise la skybox du jeu.
|
|
- Les animations GLTF présentes dans un modèle sont lancées automatiquement.
|
|
- Un diagnostic simple inspecte les matériaux chargés pour signaler les textures absentes ou non exploitables.
|
|
|
|
## Ajouter un modèle
|
|
|
|
1. Ajouter le dossier du modèle dans `public/models/{nom}`.
|
|
2. Vérifier que le modèle possède un fichier chargeable, par exemple `model.gltf`, `model.glb` ou un nom explicite comme `potager.gltf`.
|
|
3. Ajouter une entrée dans `src/data/galleryModels.ts` avec un `id`, un `name` et un `path`.
|
|
|
|
Exemple :
|
|
|
|
```ts
|
|
{ id: "nouveau-modele", name: "Nouveau modèle", path: "/models/nouveau-modele/model.gltf" }
|
|
```
|
|
|
|
## Limites connues
|
|
|
|
- Le navigateur ne liste pas automatiquement les dossiers de `public/models/`, donc la liste reste déclarative.
|
|
- Les modèles très lourds peuvent prendre du temps à charger.
|
|
- La galerie est un viewer simple : elle ne remplace pas les outils d'inspection avancée comme Blender ou le viewer d'upload.
|