Filmsquare AideDocs

2.0 Comment un film est organisé2.6 Éléments, versions et @handles

Éléments, versions et @handles

Personnages, décors, accessoires et styles sont des éléments avec des versions et des images de référence, appelés dans n'importe quel plan par leur @handle.

Mis à jour 4 min de lecture.md

Sur cette page
  1. Types d'éléments
  2. @handles
  3. Où vivent les éléments
  4. Créer un élément
  5. Versions
  6. Références et fiches
  7. Versions et validation
  8. Archivage
  9. Avec votre propre Claude

Un élément est quelque chose qui doit avoir le même aspect dans chaque plan : un personnage, un décor, un accessoire ou un style. Chaque élément a un @handle, des images de référence et des versions. Validez-le une fois, puis appelez-le dans n'importe quel plan avec son handle.

L'écran Elements avec personnages, décors et accessoires en cartes et un filtre par type (ouvrir la capture en entier)
Fig. 1 L'écran Elements avec personnages, décors et accessoires en cartes et un filtre par type

Types d'éléments #

TypeDans l'appDépartement
CharacterCast memberCasting, Costumes
LocationSetDécors
PropPropAccessoires
StyleStyleUn look : caméra, optique, lumière, étalonnage, pellicule. Voir Styles

Un costume n'est pas un élément à part : c'est un look sur un personnage, par séquence.

@handles #

Chaque élément a un handle, comme @anna ou @backlot-street. Tapez @ dans un prompt, une description de plan ou le composer pour faire entrer un élément. Filmsquare ajoute alors à la prise les images de référence de l'élément, choisies selon la valeur de plan et l'axe de caméra.

Sur l'écran Elements, Copy @handle le copie. Search elements or @handle en trouve un.

Où vivent les éléments #

Un élément appartient à une production, ou à tout l'espace de travail (« Every production in this workspace »). Un élément d'espace de travail peut servir dans toutes les productions ; l'élément propre à une production, seulement dans celle-ci. Dans une production, vous les travaillez sous Cast & sets → Cast, Locations et Props, et les styles sous Create → Mood. Une production a aussi sa propre page Elements, avec un bouton sur le Home d'une nouvelle production : elle montre les éléments de cette production et ceux de l'espace de travail qu'elle utilise (marqués Every production), comme ceux que nomment ses prises importées. Ce que vous y ajoutez reste dans cette production. Une modification d'un élément d'espace de travail vaut partout, et vous n'affectez une équipe qu'aux éléments propres à une production.

Créer un élément #

  • À partir d'un dépouillement : le dépouillement d'un scénario fait entrer les personnages, décors et accessoires qu'il trouve.
  • Add elements : sur la page Elements, déposez des photos n'importe où (ou choisissez-en plusieurs). Chacune devient une carte provisoire avec un type et un nom lus dans le nom du fichier (chr_ines_v3.png est le personnage Ines). Vérifiez les deux, puis ajoutez-les toutes d'un coup avec Add. Chaque photo devient la première référence de l'élément.
  • Describe one : choisissez un Kind et un Name et écrivez une phrase. Filmsquare lance le rendu d'une fiche de référence et retient la première.
  • Save as element : transformez une prise qui vous plaît en personnage, décor ou accessoire. La prise devient sa première référence.
  • À partir d'un tag : Create à côté d'un tag sous Script → Tagging crée le personnage, le décor ou l'accessoire qu'il nomme.
  • New look : sous Create → Mood, faites un style à partir d'images que vous sélectionnez. Voir Le canevas.
  • New style : sous Create → Styles, écrivez une charte de style et ajoutez des images de référence, ou prenez-en une dans la bibliothèque. Voir Styles.

Versions #

Chaque changement de l'aspect d'un élément est une nouvelle version. Les versions ne changent jamais une fois créées, si bien que les plans qui en ont utilisé une restent reproductibles. La version la plus récente est Current ; les plans utilisent la version actuelle, sauf si un plan est épinglé à une version plus ancienne.

Sur la page de l'élément, New version copie la version actuelle, avec chaque référence, comme version suivante. Ajoutez ou modifiez ensuite des références dessus.

La page d'un élément avec ses versions, ses images de référence et ses fiches (ouvrir la capture en entier)
Fig. 2 La page d'un élément avec ses versions, ses images de référence et ses fiches

Références et fiches #

Une référence est une image de l'élément avec un rôle : face, trois quarts, profil, dos, plan en pied, turnaround, expression, détail, plan large, et quelques autres. Add reference en téléverse une. La croix à côté d'une image de la version actuelle la retire : Filmsquare fait une nouvelle version sans elle, et les versions plus anciennes la gardent.

Une fiche (sheet) est une vue propre de l'élément, produite pour servir de référence. Lancez-en le rendu depuis la page de l'élément ; quand elle est juste, Sign off as reference (valider comme référence) : Filmsquare crée une nouvelle version avec cette image ajoutée.

Versions et validation #

Une nouvelle version (v2 et plus) d'un élément est un changement sur du travail validé. Elle rend caduc son département dans chaque épisode encore en cours qui utilise l'élément :

ÉlémentDépartements qui deviennent caducs
PersonnageCasting, Costumes, Voix
DécorDécors
AccessoireAccessoires

Un nouvel élément (v1) ne le fait pas : le dépouillement qui l'a fait entrer était déjà validé. Voir Validation et feu vert.

Archivage #

Archive… retire un élément des listes. Les plans et les prises qui l'ont utilisé gardent leur historique. Rien n'est supprimé.

Avec votre propre Claude #

get_script renvoie les handles qu'une production a déjà, de sorte qu'un dépouillement les réutilise. view_media montre une image de référence à Claude ; upload_file ajoute une image comme ressource de la production pour une référence. Les versions, références et fiches passent par find_actions et run_action (par exemple forkElementVersion, generateForElement, acceptElementTake). removeElementReferences retire d'anciennes images d'un élément : une nouvelle version sans elles devient la version actuelle, et les versions précédentes gardent les leurs. Voir Ce que Claude peut faire.

Avec Claude

MCP

Votre propre Claude le fait via MCP, en votre nom et avec votre rôle :

  • get_script

    Lit la dernière version du scénario d'un épisode, avec les @handles qui existent déjà.

    Demandez : Lis le scénario de l'épisode 2 et dis-moi quels personnages n'ont pas encore de @handle.

  • view_media

    Regarde une image fixe, une image clé ou une prise ; une vidéo revient sous forme d'affiche avec un lien de téléchargement.

    Demandez : Montre-moi l'image choisie du plan 3 et dis-moi si elle correspond à ses références.

  • upload_file

    Ajoute un fichier comme nouvelle prise sur un plan ou une séquence, ou comme asset de la production (10 Mo au plus).

    Demandez : Importe cette photo de référence dans les assets de la production.

  • find_actions

    Cherche dans tout ce que l'API sait faire et renvoie les actions correspondantes avec leurs paramètres.

    Demandez : Trouve l'action qui change la règle de validation d'une étape.

  • run_action

    Exécute une action trouvée avec find_actions, en votre nom, avec votre rôle et vos droits.

    Demandez : Retiens la deuxième prise du plan 5 de l'épisode 2.

Connecter Claude 5.1

Cette page en Markdown: /docs/fr/concepts/elements.md