HyperFrames Studio コンベンション(慣例)
Studioは、トップレベル要素ごとにタイムラインの行を1つ描画します。以下のルールに従ったプロジェクトは、短く読みやすいタイムラインとして開かれます。従わないプロジェクトは、ラベルがなくユーザーが編集できない行の壁になって開かれます。これらは構築すべきものの慣例です。クリップの変更方法については、/hyperframes-core の references/creator-editing-recipes.md に従い、同じ編集の異なる形式を決して発明しないでください。
1. すべてのシーンはサブコンポジション
ルートコンポジションは、タイムドホスト、メディア、オーディオのみを保持します。ネスト構造(子を含むdiv、サブタイトル付きタイトル、チャート)を持つシーンはすべて、data-composition-src で読み込まれる独自のファイルとし、references/sub-compositions.md に配線します。
ルート内に残されたネストされたマークアップは、それ自体の行にはなりません。トリミングや部分的な移動ができない不透明な1行の中に隠れます。
構造リンターが違反を拒否するかのように作成してください。
2. 1つのキャプショントラック
- すべてのキャプションは1つのトラックに存在します。つまり、すべてのキャプショングループを順に運ぶ、
data-track-kind="captions"とマークされた単一のサブコンポジションホスト(1つのdata-track-index)です。 - キャプショングループごとに1行にすることはなく、またキャプションを他の種類のトラックに混ぜることもありません。
- ワードタイミングルールは変更ありません:
/embedded-captionsおよびcaption_*リンタールールを参照してください。
3. トラックごとに1つの要素の種類
種類ごとにグループ化することで、各行がユーザーが選択、ミュート、またはセットとしてドラッグできる1つのものになります。
| 種類 | data-track-kind |
|---|---|
| ベースビデオ / Aロール | video(タグから) |
| シーン、オーバーレイ、グラフィック | graphics |
| キャプション | captions |
| オーディオ(ナレーション、音楽、効果音) | audio(タグから) |
data-track-kind をサブコンポジションホストに設定します。ビデオとオーディオの種類はタグから来るため、<video> と <audio> には属性は不要です。各種類に独自の data-track-index を割り当てます。数値は表示専用で、レンダリングの前面/背面に影響を与えることはありません。レイヤリングにはCSSを使用してください。
4. セーフゾーン
ルーラーやセーフボックスのオーバーレイはすべてプレビューペインに存在し、コンポジション内には決して配置しないでください。そのため、ガイド要素をHTMLに追加しないでください。
両方のフレーミング(ワイドと縦)は同じ2つのセーフボックス、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でプロジェクトを開き、タイムラインにベース行、シーンホストごとに1行、キャプション行1行、オーディオ行が表示されることを確認してください。