# Cuelist sequencer

{% file src="<https://1860701378-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjMsEs0cvoBtRQvHuq2Gn%2Fuploads%2Frh74xE1tsBLB4zDyI8bz%2Fcuelist_sequencer.tox?alt=media&token=25b05ffc-f3a4-452e-ac27-89c8729fb0e5>" %}

## Instructions

### Installation

Glisser la composante cuelist\_sequencer.tox dans votre projet touchdesigner. Aucune installation supplémentaire est nécéssaire.

### Configuration

#### 1. Création du Master Component

La première étape consiste à désigner un Master Operator. Ce composant (un `COMP base`) constitue la scène principaleet le moteur logique de votre projet.

Chaque Cue créée dans le séquenceur représente une modification d'état ou une variation spécifique de cette scène. Le système enregistre les paramètres du Master pour chaque étape afin de générer des transitions fluides entre elles.

Prérequis des sorties (Outputs) : Pour transmettre les données au reste de votre réseau TouchDesigner, votre Master Component doit impérativement inclure des opérateurs de sortie parmi les types suivants :

* TOP&#x20;
* CHOP
* SOP
* POP
* DAT&#x20;

Le Cuelist sequencer expose automatiquement ces mêmes types de sorties sur ses propres connecteurs, reflétant ainsi le contenu de votre scène en temps réel.

{% hint style="danger" %}
Définissez l'ensemble de vos sorties (TOP, CHOP, SOP, POP, DAT) avant l'assignation du Master Component à la Cuelist. Une fois le composant lié et en cours d'utilisation, la configuration des types et du nombre de sorties devient fixe pour garantir la stabilité du flux de données.
{% endhint %}

<figure><img src="https://1860701378-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjMsEs0cvoBtRQvHuq2Gn%2Fuploads%2FGaDAmSp0ireroJctMMn7%2Fezgif-60b9c77a113b27ac.gif?alt=media&#x26;token=526b5fb9-7109-4530-a961-b73ab595a2d9" alt=""><figcaption></figcaption></figure>

#### 2. Sélectionner le mode de lecture

Le Cuelist Sequencer offre quatre méthodes distinctes pour piloter le défilement de vos cues. Choisissez le mode de lecture dans l'onglet `Configuration → Time`.

<table><thead><tr><th width="157.69921875">Mode</th><th>Description</th><th>Contrôles spécifiques</th></tr></thead><tbody><tr><td>Locked to Timeline</td><td>La lecture se synchronise directement sur la timeline globale de TouchDesigner.</td><td>Se base sur le <code>framecount</code> du projet.</td></tr><tr><td>Local Timer</td><td>Le séquenceur utilise son propre moteur de temps interne pour une gestion autonome.</td><td>Définissez la durée en images (Length) et utilisez les boutons Init et Start.</td></tr><tr><td>Frame Input</td><td>Le pilotage s'effectue via un signal externe connecté à l'entrée CHOP In du composant.</td><td>Idéal pour synchroniser la cuelist avec un Timer CHOP externe.</td></tr><tr><td>Manual Index</td><td>Le choix de la cue active s'effectue manuellement ou par référence de paramètre.</td><td>Utilisez le curseur Index pour naviguer directement entre les cues.</td></tr></tbody></table>

<figure><img src="https://1860701378-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjMsEs0cvoBtRQvHuq2Gn%2Fuploads%2FvNZHiLKrCq5piByfj72j%2FCapture%20d%E2%80%99e%CC%81cran%2C%20le%202026-02-18%20a%CC%80%2021.06.02.png?alt=media&#x26;token=306b2736-9d13-4e7b-9fc0-224e34ec6eca" alt=""><figcaption></figcaption></figure>

#### 3. Créer des cues

Une fois votre Master Operator configuré, rendez-vous dans l'onglet Cuelist pour bâtir votre séquence. Chaque cue enregistre l'état de votre scène à un instant précis.

{% columns %}
{% column %}
**Ajouter ou supprimer des Cues**

* Bouton « + » : Ajoute une nouvelle cue à la suite de la liste.
* Bouton « - » : Supprime la cue dernière de la séquence.

**Paramètres d'une Cue**

Pour chaque cue créée, vous disposez des réglages suivants :

* Note : Champ libre pour nommer la cue (ex: "Intro", "Chorus", "Blackout"). Cela facilite l'organisation et la lecture de la séquence.
* Time (s) : Définit le point d'activation de la cue sur la timeline, exprimé en secondes à partir de zéro.
* FadeIn Time (s) : Détermine la durée de la transition fluide (interpolation) entre la cue précédente et la cue actuelle. Une valeur de 0 déclenche un changement instantané.
  {% endcolumn %}

{% column %}

<figure><img src="https://1860701378-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjMsEs0cvoBtRQvHuq2Gn%2Fuploads%2FsRSFXNQcHChOFkYZocAv%2FCapture%20d%E2%80%99e%CC%81cran%2C%20le%202026-02-18%20a%CC%80%2021.07.47.png?alt=media&#x26;token=71f413a0-db8f-458f-a6a4-e855d95a2d90" alt=""><figcaption></figcaption></figure>

{% endcolumn %}
{% endcolumns %}

**L'outil d'édition : Edit (Pulse)**

Le bouton Edit est l'élément central pour la création de vos contenus.

* Accès direct : Une pression sur Edit ouvre instantanément le réseau interne de votre Master Operator.
* Configuration des presets : Ce mode permet d'ajuster précisément la logique interne, les paramètres visuels ou les valeurs de sortie spécifiques à la cue sélectionnée.

<figure><img src="https://1860701378-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjMsEs0cvoBtRQvHuq2Gn%2Fuploads%2FKcvZ36VLpBPwciqtOjHu%2Fezgif-6d204533f15986b4.gif?alt=media&#x26;token=04c1d66f-6f6e-4814-99e8-3f76722dd519" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Le bouton Reload est indispensable pour valider vos modifications.
{% endhint %}

### Visualisation de la séquence

Pour obtenir une représentation visuelle de votre programmation, utilisez le bouton Open Timeline. Cette action affiche la timeline complète, vous permettant de superviser le déroulement des cues et la progression des transitions en temps réel.

<figure><img src="https://1860701378-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjMsEs0cvoBtRQvHuq2Gn%2Fuploads%2F0jwUBbB2CbIbSrwH2erR%2Fezgif-63427ac852b57ef9.gif?alt=media&#x26;token=3caeabd4-8ecc-4a1b-af4f-276b80608013" alt=""><figcaption></figcaption></figure>