Filmsquare AiutoDocumentazione

2.0 Come è organizzato un film2.6 Elementi, versioni e @handle

Elementi, versioni e @handle

Personaggi, set, oggetti di scena e stili sono elementi con versioni e immagini di riferimento, richiamati in ogni inquadratura con il loro @handle.

Aggiornato il 4 min di lettura.md

In questa pagina
  1. Tipi di elemento
  2. @handle
  3. Dove vivono gli elementi
  4. Creare un elemento
  5. Versioni
  6. Riferimenti e schede
  7. Versioni e approvazione
  8. Archiviare
  9. Con il tuo Claude

Un elemento è qualcosa che deve avere lo stesso aspetto in ogni inquadratura: un personaggio, un set, un oggetto di scena o uno stile. Ogni elemento ha un @handle, immagini di riferimento e versioni. Lo approvi una volta, poi lo richiami in qualsiasi inquadratura con il suo handle.

La schermata Elements con cast, set e oggetti di scena come schede e un filtro per tipo (apri lo screenshot intero)
Fig. 1 La schermata Elements con cast, set e oggetti di scena come schede e un filtro per tipo

Tipi di elemento #

TipoNell'appReparto
CharacterPersonaggioCasting, Costumi
LocationSetScenografia
PropOggetto di scenaAttrezzeria
StyleStileUn look: macchina, ottica, luce, color, pellicola. Vedi Stili

Un costume non è un elemento a sé: è un look di un personaggio, per scena.

@handle #

Ogni elemento ha un handle, come @anna o @backlot-street. Scrivi @ in un prompt, nella descrizione di un'inquadratura o nel compositore per portare dentro un elemento. Filmsquare aggiunge poi per te le immagini di riferimento dell'elemento al ciak, scelte per il taglio e l'angolazione dell'inquadratura.

Nella schermata Elements, Copy @handle lo copia. Search elements or @handle ne trova uno.

Dove vivono gli elementi #

Un elemento appartiene a una produzione, oppure a tutto lo spazio di lavoro («Every production in this workspace»). Un elemento di tutto lo spazio di lavoro si può usare in ogni produzione; l'elemento proprio di una produzione solo lì. In una produzione ci lavori sotto Cast & sets → Cast, Locations e Props, e sugli stili sotto Create → Mood. Una produzione ha anche una sua pagina Elements, con un pulsante sulla Home di una nuova produzione: mostra gli elementi di quella produzione e quelli di tutto lo spazio di lavoro che usa (segnati Every production), come quelli nominati dai suoi ciak importati. Ciò che aggiungi lì resta in quella produzione. Una modifica a un elemento di tutto lo spazio di lavoro vale ovunque, e la troupe si assegna solo agli elementi propri di una produzione.

Creare un elemento #

  • Da uno spoglio: lo spoglio di una sceneggiatura porta dentro il cast, i set e gli oggetti di scena che trova.
  • Add elements: nella pagina Elements, lascia cadere foto ovunque (o sceglierne più d'una). Ognuna diventa una scheda bozza con un tipo e un nome letto dal nome del file (chr_ines_v3.png è il personaggio Ines). Controlla entrambi, poi Add li aggiunge tutti insieme. Ogni foto diventa il primo riferimento dell'elemento.
  • Descrivine uno: scegli un Kind (tipo) e un Name (nome) e scrivi una frase. Filmsquare renderizza una scheda di riferimento e usa la prima.
  • Save as element: trasforma un ciak che ti piace in un personaggio, un set o un oggetto di scena. Il ciak diventa il suo primo riferimento.
  • Da un tag: Create accanto a un tag sotto Script → Tagging crea il personaggio, il set o l'oggetto di scena che nomina.
  • New look: sotto Create → Mood, crea uno stile da immagini che selezioni. Vedi Il canvas.
  • New style: sotto Create → Styles, scrivi una guida di stile e aggiungi immagini di riferimento, oppure usane una della libreria. Vedi Stili.

Versioni #

Ogni cambiamento di aspetto di un elemento è una nuova versione. Le versioni non cambiano mai una volta create, quindi le inquadrature che ne hanno usata una restano riproducibili. La versione più recente è Current; le inquadrature usano la versione attuale a meno che un'inquadratura non sia fissata a una più vecchia.

Nella pagina dell'elemento, New version copia la versione attuale, con ogni riferimento, come la successiva. Poi aggiungi o cambia i suoi riferimenti.

La pagina di un elemento con le sue versioni, le immagini di riferimento e le schede (apri lo screenshot intero)
Fig. 2 La pagina di un elemento con le sue versioni, le immagini di riferimento e le schede

Riferimenti e schede #

Un riferimento è un'immagine dell'elemento con un ruolo: frontale, tre quarti, profilo, retro, figura intera, turnaround, espressione, dettaglio, campo largo e qualche altro. Add reference ne carica uno. La croce accanto a un'immagine della versione attuale la toglie: Filmsquare crea una nuova versione senza di essa, e le versioni più vecchie la conservano.

Una scheda è una vista pulita dell'elemento, renderizzata per essere usata come riferimento. Ne renderizzi una dalla pagina dell'elemento; quando è giusta, Sign off as reference (approva come riferimento): Filmsquare crea una nuova versione con quell'immagine aggiunta.

Versioni e approvazione #

Una nuova versione (v2 in su) di un elemento è un cambiamento di lavoro già approvato. Fa scadere il suo reparto in ogni episodio ancora in lavorazione che usa l'elemento:

ElementoReparti che scadono
PersonaggioCasting, Costumi, Voci
SetScenografia
Oggetto di scenaAttrezzeria

Un nuovo elemento (v1) no: lo spoglio che l'ha portato dentro era già approvato. Vedi Approvazione e via libera.

Archiviare #

Archive… toglie un elemento dagli elenchi. Le inquadrature e i ciak che lo hanno usato conservano la loro cronologia. Non viene cancellato nulla.

Con il tuo Claude #

get_script restituisce gli handle che una produzione ha già, così uno spoglio li riusa. view_media mostra a Claude un'immagine di riferimento; upload_file aggiunge un'immagine come asset di produzione per un riferimento. Versioni, riferimenti e schede passano per find_actions e run_action (per esempio forkElementVersion, generateForElement, acceptElementTake). removeElementReferences toglie vecchie immagini da un elemento: una nuova versione senza di esse diventa quella attuale, e le versioni precedenti conservano le loro. Vedi Cosa può fare Claude.

Con Claude

MCP

Il tuo Claude lo fa via MCP, a tuo nome e con il tuo ruolo:

  • get_script

    Legge l'ultima stesura della sceneggiatura di un episodio, con gli @handle che esistono già.

    Chiedi: Leggi la sceneggiatura dell'episodio 2 e dimmi quali personaggi non hanno ancora un @handle.

  • view_media

    Guarda uno still, un fotogramma chiave o un ciak; il video torna come locandina più un link per scaricarlo.

    Chiedi: Mostrami lo still scelto dell'inquadratura 3 e dimmi se corrisponde ai suoi riferimenti.

  • upload_file

    Aggiunge un file che hai come nuovo ciak su un'inquadratura o una scena, o come asset della produzione (10 MB al massimo).

    Chiedi: Carica questa foto di riferimento negli asset della produzione.

  • find_actions

    Cerca tutto ciò che l'API sa fare e restituisce le azioni corrispondenti con i loro input.

    Chiedi: Trova l'azione che cambia la regola di approvazione di una fase.

  • run_action

    Esegue un'azione trovata con find_actions, come te, con il tuo ruolo e i tuoi diritti.

    Chiedi: Scegli il secondo ciak dell'inquadratura 5 sull'episodio 2.

Collega Claude 5.1

Questa pagina in Markdown: /docs/it/concepts/elements.md