> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://documentation.celestory.io/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 🟧 Scène

# 🟧 Scène

![Scène](https://celestory-docs-illustrations.netlify.app/fr/Scene_FR.svg)

Le bloc Scène permet de préparer le décor d'un moment de votre Visual Novel : une image de fond, un nombre d'emplacements pour placer des personnages, et un nombre de plans pour donner de la profondeur à l'affichage.

Ce bloc regroupe en un seul endroit tous les réglages visuels d'un lieu de votre histoire (fond, positionnement des personnages, profondeur), pour éviter d'avoir à les régler séparément à chaque fois, et pour garder une expérience cohérente.

## 📥 Entrées

-   in (Flux) : Point d'entrée du flux. Dès que le flux arrive sur ce bloc, les réglages ci-dessous sont appliqués automatiquement, sans action supplémentaire.
-   image (Image de fond) : L'image utilisée comme décor de la scène.
-   slots (Nombre, 3 par défaut) : Le nombre d'emplacements disponibles pour positionner des personnages dans la scène.
-   depth (Nombre, 1 par défaut) : Le nombre de plans (couches de profondeur) utilisés pour l'affichage des éléments de la scène.

## 📤 Sorties

-   out (Flux) : Le flux reprend une fois la scène affichée (après interactions, dialogues ou choix). Permet d'enchaîner vers d'autres scènes ou blocs narratifs.

## 💡 Exemple d'utilisation

Scénario : Introduction d'une scène de forêt enchantée

1. Le joueur termine un chapitre en ville et clique sur un choix "Explorer la forêt".
1. Le flux bascule vers un bloc Scène configuré avec :

- Fond : foret_enchantee.png
- Musique : ambiance_mystique.mp3
- Personnages : PNJ "Lutin" positionné à gauche.

1. La scène s'affiche : le fond apparaît, la musique démarre, et un dialogue s'ouvre avec le lutin.
1. Le joueur interagit via des choix ("Parler", "Observer", "Partir"), déclenchant des réponses ou des animations.
1. Après le dernier choix ("Quitter la forêt"), la scène se termine et le flux passe à un bloc Fond pour afficher la carte du monde.

## ⚙️ Détails Techniques

-   Rôle technique : Contrôleur visuel central pour les Visual Novels, garantissant la cohérence des éléments graphiques (position des avatars, effets, transitions) et sonores (jingles, ambiances) sur des séquences longues.
-   Gestion des variables : Toutes les configurations (fond, sons, animations) sont encapsulées dans le bloc, évitant les conflits avec d'autres nœuds.
-   Optimisation : Conçu pour des lectures intensives (dizaines de minutes) avec un rendu fluide des dialogues et des effets.

---

*Version documentée : v2*