Convenciones de HyperFrames Studio
Studio dibuja una fila de línea de tiempo por elemento de nivel superior. Un proyecto que sigue las reglas a continuación se abre como una línea de tiempo corta y legible; uno que no lo hace se abre como un muro de filas sin etiquetar que el usuario no puede editar. Estas son convenciones para lo que se debe construir. Para saber cómo modificar un clip, sigue /hyperframes-core references/creator-editing-recipes.md y nunca inventes una forma diferente de la misma edición.
1. Cada escena es una subcomposición
La composición raíz contiene solo hosts de tiempo, medios y audio. Cualquier escena con estructura anidada (un div que contiene hijos, un título con subtítulo, un gráfico) es su propio archivo cargado con data-composition-src, siguiendo las instrucciones en references/sub-compositions.md.
El marcado anidado dejado dentro de la raíz no se convierte en una fila propia. Se oculta dentro de una fila opaca que no se puede recortar ni mover parte por parte.
Redacta como si un lint de estructura rechazara cualquier violación.
2. Una pista de subtítulos
- Todos los subtítulos viven en una pista: un único host de subcomposición (un
data-track-index) marcado condata-track-kind="captions"que lleva cada grupo de subtítulos en orden. - Nunca una fila por grupo de subtítulos, y nunca subtítulos mezclados en una pista con otro tipo.
- Las reglas de sincronización por palabra no cambian: consulta
/embedded-captionsy las reglas de lintcaption_*.
3. Un tipo de elemento por pista
Agrupa por tipo para que cada fila sea una cosa que el usuario pueda seleccionar, silenciar o arrastrar como conjunto.
| Tipo | data-track-kind |
|---|---|
| Video base / Toma principal | video (de la etiqueta) |
| Escenas, superposiciones, gráficos | graphics |
| Subtítulos | captions |
| Audio (voz en off, música, efectos de sonido) | audio (de la etiqueta) |
Coloca data-track-kind en los hosts de subcomposición. Los tipos de video y audio provienen de la etiqueta, por lo que <video> y <audio> no necesitan atributo. Asigna a cada tipo su propio data-track-index; el número es solo de visualización; nunca cambia lo que se renderiza arriba. Usa CSS para la superposición.
4. Zonas seguras
Cualquier regla o superposición de cuadro seguro vive en el panel de vista previa, nunca dentro de la composición, por lo que no agregues elementos guía al HTML.
Ambos encuadres (ancho y vertical) usan los mismos dos cuadros seguros, los valores predeterminados de Premiere. La alternancia de vista previa los dibuja con una marca en el punto medio de cada borde. Fuente: ACTION_SAFE_PERCENT y TITLE_SAFE_PERCENT en packages/studio/src/utils/previewSafeMargins.ts.
| Cuadro | Porcentaje del fotograma | Margen interior en cada borde |
|---|---|---|
| Acción segura | 90% | 5% |
| Título seguro | 80% | 10% |
- Márgenes seguros: todo lo visible permanece dentro del cuadro de acción segura (90%), y los subtítulos y el contenido clave permanecen dentro del cuadro de título seguro (80%).
- Los diseños de dos vistas y 50/50 mantienen el contenido de cada mitad dentro del cuadro de título seguro.
Verificación de tu trabajo
Ejecuta hyperframes lint y corrige cada hallazgo. Luego abre el proyecto en Studio y verifica que la línea de tiempo muestre una fila base, una fila por host de escena, una fila de subtítulos y las filas de audio.