HyperFrames Studio 규칙
Studio는 최상위 요소당 하나의 타임라인 행을 그립니다. 아래 규칙을 따르는 프로젝트는 짧고 읽기 쉬운 타임라인으로 열리며, 그렇지 않은 프로젝트는 사용자가 편집할 수 없는 레이블 없는 행의 벽으로 열립니다. 이 규칙은 무엇을 구축할지에 대한 규칙입니다. 클립을 변경하는 방법은 /hyperframes-core의 references/creator-editing-recipes.md를 따르고 동일한 편집의 다른 형태를 절대 발명하지 마십시오.
1. 모든 장면은 하위 컴포지션입니다
루트 컴포지션은 시간 지정 호스트, 미디어 및 오디오만 보유합니다. 중첩 구조(자식을 포함하는 div, 부제목이 있는 제목, 차트)가 있는 모든 장면은 data-composition-src와 함께 로드되는 자체 파일이며, references/sub-compositions.md에 배선됩니다.
루트 내부에 남겨진 중첩 마크업은 자체 행이 되지 않습니다. 부분별로 트리밍하거나 이동할 수 없는 하나의 불투명한 행 안에 숨겨집니다.
구조 린터가 위반 사항을 거부하는 것처럼 작성하십시오.
2. 하나의 캡션 트랙
- 모든 캡션은 하나의 트랙에 있습니다:
data-track-kind="captions"로 표시된 단일 하위 컴포지션 호스트(하나의data-track-index)로, 모든 캡션 그룹을 순서대로 전달합니다. - 캡션 그룹당 하나의 행을 사용하지 말고, 캡션을 다른 종류의 트랙에 혼합하지 마십시오.
- 단어 타이밍 규칙은 변경되지 않습니다:
/embedded-captions및caption_*린트 규칙을 참조하십시오.
3. 트랙당 하나의 요소 종류
종류별로 그룹화하여 각 행이 사용자가 선택, 음소거 또는 세트로 드래그할 수 있는 하나의 요소가 되도록 하십시오.
| 종류 | data-track-kind |
|---|---|
| 기본 비디오 / A-roll | video (태그에서) |
| 장면, 오버레이, 그래픽 | graphics |
| 캡션 | captions |
| 오디오(내레이션, 음악, 효과음) | audio (태그에서) |
하위 컴포지션 호스트에 data-track-kind를 설정하십시오. 비디오 및 오디오 종류는 태그에서 비롯되므로 <video> 및 <audio>에는 속성이 필요하지 않습니다. 각 종류에 고유한 data-track-index를 지정하십시오. 숫자는 표시용일 뿐이며 위에 렌더링되는 내용을 변경하지 않습니다. 레이어링에는 CSS를 사용하십시오.
4. 안전 영역
모든 눈금자 또는 안전 상자 오버레이는 미리보기 창에만 있으며, 컴포지션 내부에는 절대 없으므로 HTML에 안내 요소를 추가하지 마십시오.
두 프레이밍(와이드 및 세로) 모두 Premiere의 기본값인 동일한 두 개의 안전 상자를 사용합니다. 미리보기 토글은 각 가장자리의 중간 지점에 눈금을 그립니다. 출처: packages/studio/src/utils/previewSafeMargins.ts의 ACTION_SAFE_PERCENT 및 TITLE_SAFE_PERCENT.
| 상자 | 프레임 비율 | 각 가장자리 여백 |
|---|---|---|
| 액션 안전 | 90% | 5% |
| 타이틀 안전 | 80% | 10% |
- 안전 여백: 보이는 모든 것은 액션 안전 상자(90%) 안에 유지되고, 캡션과 주요 콘텐츠는 타이틀 안전 상자(80%) 안에 유지됩니다.
- 2업 및 50/50 레이아웃은 각 절반의 콘텐츠를 타이틀 안전 상자 안에 유지합니다.
작업 확인
hyperframes lint를 실행하고 모든 발견 사항을 수정하십시오. 그런 다음 Studio에서 프로젝트를 열고 타임라인에 기본 행, 장면 호스트당 하나의 행, 하나의 캡션 행 및 오디오 행이 표시되는지 확인하십시오.