> ## 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).

# Enlever personnage

# 🟧 Enlever personnage

${frame}[Vidéo : anatomie du bloc Enlever personnage](https://celestory-docs-videos.netlify.app/fr/anatomie-bloc/removecharacter.html)

Le bloc **Enlever personnage** permet de faire sortir de scène un personnage présent à l'écran, avec une animation de sortie.

Il libère aussi la place qu'occupait le personnage dans la grille du bloc Scène : cette place redevient disponible pour un autre personnage.

## 📥 Entrées

*   **in (Flux)** : Point d'entrée. Dès que le flux arrive, le personnage quitte la scène ; le flux repart une fois la sortie terminée.
*   **personnage (Référence de personnage)** : Liste déroulante des personnages du module. Ce bloc ne propose **pas** de menu d'humeur : il retire le personnage quelle que soit l'humeur affichée.
*   **transition (Choix, « instantané » par défaut)** : Manière dont le personnage s'en va. `instantané` le fait disparaître d'un coup, sans animation ; `vers le haut`, `vers la droite`, `vers le bas` et `vers la gauche` le font glisser hors de l'écran par le bord correspondant ; `fade out` le fait disparaître en fondu.
*   **durée (Nombre, 0,4 par défaut)** : Durée de l'animation de sortie, en secondes. Sans effet avec la transition `instantané`.

## 📤 Sorties

*   **out (Flux)** : Le flux repart une fois le personnage sorti de l'écran.

## 💡 Exemple d'utilisation

**Scénario : la libraire retourne en réserve**

1. La libraire est en scène, en place 3, depuis un bloc Ajouter personnage.
2. Le dialogue se termine par « Je vais vous chercher ça. »
3. Un bloc Enlever personnage cible « Libraire », transition `vers la droite`, durée 0,6 : elle sort de l'écran par la droite en 0,6 s.
4. La place 3 est de nouveau libre : un bloc Ajouter personnage peut y installer « Le chat de la boutique ».
5. Le flux continue avec un bloc Dialogue du narrateur pendant l'attente.

## ⚙️ Détails Techniques

*   **Identifiant interne** : `removeCharacter`
*   **Le personnage doit être en scène** : si le personnage visé n'a jamais été ajouté (ou s'il a déjà été enlevé), le bloc ne fait rien et le flux continue normalement, sans avertissement. Même chose si aucun bloc Scène n'a été joué en amont : sans grille de places, le bloc est inopérant.
*   **Transition `instantané`** : pour un personnage en image, la disparition est immédiate, sans animation, même si vous avez saisi une durée.
*   **Enlever n'est pas masquer** : l'objet graphique du personnage est détruit. Pour le refaire apparaître, il faut un nouveau bloc Ajouter personnage, en re-choisissant sa place, son plan et son humeur — rien n'est mémorisé.
*   **Autres sorties de scène** : un personnage peut aussi quitter l'écran sans ce bloc — quand un bloc Scène est rejoué (tous les personnages sortent en fondu), ou quand un Ajouter personnage vise une place occupée alors que la scène est pleine.
*   **Réglage « Désactiver toutes les transitions et délais »** : quand il est actif dans les réglages du module, la durée est ignorée et la sortie est immédiate.

## 🔗 Voir aussi

*   **Ajouter personnage** : le bloc symétrique, pour faire entrer un personnage.
*   **Scène** : rejouer une scène retire d'office tous les personnages présents.

---

*Version documentée : v1*