Convenções do HyperFrames Studio
O Studio desenha uma linha da linha do tempo para cada elemento de nível superior. Um projeto que segue as regras abaixo abre como uma linha do tempo curta e legível; um que não as segue abre como uma parede de linhas não rotuladas que o usuário não consegue editar. Estas são convenções sobre o que construir. Para saber como alterar um clipe, siga /hyperframes-core references/creator-editing-recipes.md e nunca invente uma forma diferente da mesma edição.
1. Cada cena é uma subcomposição
A composição raiz contém apenas hosts com tempo, mídia e áudio. Qualquer cena com estrutura aninhada (uma div contendo filhos, um título com subtítulo, um gráfico) é seu próprio arquivo carregado com data-composition-src, conectando-se em references/sub-compositions.md.
Marcações aninhadas deixadas dentro da raiz não se tornam uma linha própria. Elas ficam ocultas dentro de uma linha opaca que não pode ser cortada ou movida parte por parte.
Autor como se um lint de estrutura rejeitasse qualquer violação.
2. Uma faixa de legendas
- Todas as legendas ficam em uma faixa: um único host de subcomposição (um
data-track-index) marcado comdata-track-kind="captions"que carrega cada grupo de legendas em ordem. - Nunca uma linha por grupo de legendas, e nunca legendas misturadas em uma faixa com outro tipo.
- As regras de temporização de palavras não mudam: veja
/embedded-captionse as regras de lintcaption_*.
3. Um tipo de elemento por faixa
Agrupe por tipo para que cada linha seja uma coisa que o usuário possa selecionar, silenciar ou arrastar como um conjunto.
| Tipo | data-track-kind |
|---|---|
| Vídeo base / A-roll | video (da tag) |
| Cenas, sobreposições, gráficos | graphics |
| Legendas | captions |
| Áudio (narração, música, efeitos sonoros) | audio (da tag) |
Coloque data-track-kind em hosts de subcomposição. Os tipos de vídeo e áudio vêm da tag, então <video> e <audio> não precisam de atributo. Dê a cada tipo seu próprio data-track-index; o número é apenas para exibição; ele nunca muda o que é renderizado sobreposto. Use CSS para camadas.
4. Zonas seguras
Qualquer régua ou sobreposição de caixa segura fica no painel de visualização, nunca dentro da composição, portanto não adicione elementos guia ao HTML.
Ambas as proporções (widescreen e vertical) usam as mesmas duas caixas seguras, os padrões do Premiere. O alternador de visualização as desenha com uma marca no ponto médio de cada borda. Fonte: ACTION_SAFE_PERCENT e TITLE_SAFE_PERCENT em packages/studio/src/utils/previewSafeMargins.ts.
| Caixa | Proporção do quadro | Margem interna em cada borda |
|---|---|---|
| Action-safe | 90% | 5% |
| Title-safe | 80% | 10% |
- Margens seguras: tudo visível permanece dentro da caixa action-safe (90%), e legendas e conteúdo-chave permanecem dentro da caixa title-safe (80%).
- Layouts de dois painéis e 50/50 mantêm o conteúdo de cada metade dentro da caixa title-safe.
Verificando seu trabalho
Execute hyperframes lint e corrija todos os achados. Em seguida, abra o projeto no Studio e verifique se a linha do tempo mostra uma linha base, uma linha por host de cena, uma linha de legendas e as linhas de áudio.