Filmsquare AjudaDocumentação

2.0 Como um filme se organiza2.6 Elementos, versões e @nomes

Elementos, versões e @nomes

Personagens, cenários, objetos de cena e estilos são elementos com versões e imagens de referência, chamados em qualquer plano pelo seu @nome.

Atualizado em 4 min de leitura.md

Nesta página
  1. Tipos de elemento
  2. @nomes
  3. Onde os elementos ficam
  4. Como fazer um elemento
  5. Versões
  6. Referências e fichas
  7. Versões e aprovação
  8. Arquivar
  9. Com o seu próprio Claude

Um elemento é algo que precisa ter a mesma cara em todos os planos: um personagem, um cenário, um objeto de cena ou um estilo. Cada elemento tem um @handle, imagens de referência e versões. Aprove um uma vez e chame-o em qualquer plano pelo seu @nome.

A tela Elements com elenco, cenários e objetos de cena em cartões e um filtro por tipo (abrir a captura de tela completa)
Fig. 1 A tela Elements com elenco, cenários e objetos de cena em cartões e um filtro por tipo

Tipos de elemento #

TipoNo appDepartamento
CharacterPersonagemCasting, Figurino
LocationCenárioCenários
PropObjeto de cenaObjetos de cena
StyleEstiloUm look: câmera, lente, luz, correção de cor, filme. Veja Estilos

Um figurino não é um elemento próprio: é um look de um personagem, por cena.

@nomes #

Todo elemento tem um @nome, como @anna ou @backlot-street. Digite @ em um prompt, na descrição de um plano ou no compositor para trazer um elemento. O Filmsquare então acrescenta ao take as imagens de referência do elemento, escolhidas pelo enquadramento e pelo ângulo do plano.

Na tela Elements, Copy @handle (copiar @nome) copia o nome. Search elements or @handle (buscar elementos ou @nome) acha um.

Onde os elementos ficam #

Um elemento pertence a uma produção ou ao espaço de trabalho inteiro ("Every production in this workspace"). Um elemento do espaço de trabalho pode ser usado em todas as produções; o elemento próprio de uma produção, só nela. Em uma produção você trabalha neles em Cast & sets → Cast, Locations e Props, e nos estilos em Create → Mood. Uma produção também tem a sua própria página Elements, com um botão na Home de uma produção nova: ela mostra os elementos da produção e os do espaço de trabalho que ela usa (marcados Every production), como os que os seus takes importados citam. O que você acrescenta ali fica naquela produção. Uma mudança em um elemento do espaço de trabalho vale em todo lugar, e você escala a equipe só para os elementos próprios de uma produção.

Como fazer um elemento #

  • A partir de uma decupagem: a decupagem de um roteiro traz o elenco, os cenários e os objetos de cena que encontra.
  • Add elements (adicionar elementos): na página Elements, solte fotos em qualquer lugar (ou escolha várias). Cada uma vira um cartão de rascunho com um tipo e um nome lido do nome do arquivo (chr_ines_v3.png é a personagem Ines). Confira os dois e use Add para adicionar todos de uma vez. Cada foto vira a primeira referência do elemento.
  • Descreva um: escolha um Kind (tipo) e um Name (nome) e escreva uma frase. O Filmsquare renderiza uma ficha de referência e usa a primeira.
  • Save as element (salvar como elemento): transforme um take de que você gostou em personagem, cenário ou objeto de cena. O take vira a sua primeira referência.
  • A partir de uma marcação: Create (criar) ao lado de uma marcação em Script → Tagging faz o personagem, cenário ou objeto de cena que ela cita.
  • New look (novo look): em Create → Mood, faça um estilo a partir de imagens que você seleciona. Veja O canvas.
  • New style (novo estilo): em Create → Styles, escreva um guia de estilo e acrescente imagens de referência, ou use um da biblioteca. Veja Estilos.

Versões #

Toda mudança na aparência de um elemento é uma nova versão. As versões nunca mudam depois de feitas, então os planos que usaram uma continuam reproduzíveis. A versão mais nova é a Current (atual); os planos usam a versão atual, a menos que um plano esteja fixado em uma mais antiga.

Na página do elemento, New version (nova versão) copia a versão atual, com todas as referências, como a seguinte. Depois acrescente ou mude referências nela.

A página de um elemento com as suas versões, imagens de referência e fichas (abrir a captura de tela completa)
Fig. 2 A página de um elemento com as suas versões, imagens de referência e fichas

Referências e fichas #

Uma referência é uma imagem do elemento com uma função: frente, três quartos, perfil, costas, corpo inteiro, turnaround, expressão, detalhe, plano aberto e mais alguns. Add reference (adicionar referência) envia uma. A cruz ao lado de uma imagem da versão atual a remove: o Filmsquare faz uma nova versão sem ela, e as versões mais antigas a mantêm.

Uma ficha é uma visão limpa do elemento, renderizada para servir de referência. Renderize uma na página do elemento; quando estiver certa, use Sign off as reference (aprovar como referência): o Filmsquare faz uma nova versão com essa imagem acrescentada.

Versões e aprovação #

Uma nova versão (v2 em diante) de um elemento é uma mudança em um trabalho aprovado. Ela deixa o seu departamento desatualizado em todo episódio ainda em andamento que usa o elemento:

ElementoDepartamentos que ficam desatualizados
PersonagemCasting, Figurino, Vozes
CenárioCenários
Objeto de cenaObjetos de cena

Um elemento novo (v1) não faz isso: a decupagem que o trouxe já estava aprovada. Veja Aprovação e liberação.

Arquivar #

Archive… (arquivar) tira um elemento das listas. Os planos e takes que o usaram mantêm o histórico. Nada é apagado.

Com o seu próprio Claude #

get_script devolve os @nomes que uma produção já tem, para a decupagem reaproveitá-los. view_media mostra ao Claude uma imagem de referência; upload_file acrescenta uma imagem como material da produção para uma referência. Versões, referências e fichas passam por find_actions e run_action (por exemplo forkElementVersion, generateForElement, acceptElementTake). removeElementReferences tira imagens antigas de um elemento: uma nova versão sem elas passa a ser a atual, e as versões anteriores mantêm as suas. Veja O que o Claude faz.

Com o Claude

MCP

O seu próprio Claude faz isso via MCP, em seu nome e com a sua função:

  • get_script

    Lê o tratamento mais recente do roteiro de um episódio, com os @nomes que já existem.

    Peça: Leia o roteiro do episódio 2 e diga quais personagens ainda não têm @nome.

  • view_media

    Olha um still, keyframe ou take; o vídeo volta como o pôster mais um link de download.

    Peça: Mostre o still escolhido do plano 3 e diga se bate com as referências.

  • upload_file

    Adiciona um arquivo seu como novo take de um plano ou cena, ou como material da produção (10 MB no máximo).

    Peça: Envie esta foto de referência para os materiais da produção.

  • find_actions

    Busca tudo o que a API faz e devolve as ações que combinam, com seus parâmetros.

    Peça: Ache a ação que muda a regra de aprovação de uma etapa.

  • run_action

    Executa uma ação achada com find_actions, em seu nome, com a sua função e os seus direitos.

    Peça: Escolha o segundo take do plano 5 do episódio 2.

Conectar o Claude 5.1

Esta página em Markdown: /docs/pt-br/concepts/elements.md