使い方ガイド

PremiAnnoの現行ワークフローを説明します。

概要

PremiAnnoはカット境界ベースで区間を作成し、クラスCSVを読み込んで区間ラベルを付与し、最終的にTOMLへエクスポートします。

基本ワークフロー

1. PremiAnnoを開く

1. Adobe Premiere Proを起動
2. 対象プロジェクトとシーケンスを開く
3. ウィンドウ > 拡張機能 > PremiAnno を選択

2. カットをスキャン

1. Scan Cuts をクリック
2. ビデオトラック上のクリップ境界から区間を生成
3. 開始/終了時刻を持つ区間一覧が表示される

前回スキャン時からカット構造が変わっている場合、ラベル不整合の警告が表示されます。

3. クラスCSVを読み込み

1. Import Classes をクリック
2. CSVファイルを選択
3. 推奨フォーマット:

index,class
0,Intro
1,Dialogue
2,B-roll

補足:

• index,class ヘッダー対応（推奨）
• index でソートしてラベル候補を作成
• ヘッダーが無い場合は1列目=index, 2列目=classとして解釈

4. 区間にラベル付け

1. 各行に開始/終了タイムコードが表示される
2. ドロップダウンからラベルを選択
3. Clear で未ラベル状態に戻す

ラベル変更は自動保存されます。

5. TOMLを書き出し

1. Export TOML をクリック
2. 保存先を選択
3. 下流処理向けのTOMLファイルを取得

ローカル保存仕様

• アノテーションはユーザーデータ配下 premianno-annotations/ にJSON保存
• 保存キーは projectPath + sequence に基づく
• クラス一覧は同ディレクトリの class-list.json に保存

トラブルシューティング

アクティブシーケンスが見つからない

• プロジェクトを開き、シーケンスをアクティブにしてください

クラス一覧が読み込まれていない

• 先にCSVをインポートしてください

CSVにクラスが見つからない

• 内容にラベルがあるか確認してください
• index,class ヘッダー形式を推奨します

次のステップ

• APIリファレンス - データ形式
• 開発ガイド - ソース開発