Tyrano Direction Studio (演出監督室)
TyranoScript プロジェクトの中で演出を作り、プレビューし、そのままシナリオへ挿入するための VS Code 拡張機能です。
主な機能
- シナリオ再生: 開いている
.ks ファイルをステージ上で上演。テキスト行や [l] [p] はクリック送り。
- プロジェクト素材の自動参照:
data/ 配下の背景 (bgimage)・立ち絵 (fgimage)・BGM (bgm)・効果音 (sound) をファイル名で照合して使用。
- 解像度の自動検出:
data/system/Config.tjs の scWidth / scHeight を読み取り、座標系を自動設定。
- 演出ジェネレーター: カメラ / キャラ移動 / 揺れ・フラッシュ・マスク転換・フィルター / 映画的文字演出をスライダーで調整し、「✎ カーソル位置に挿入」でエディタへ追加。
- 保存で自動同期:
.ks を保存するとプレビュー側のスクリプトが更新され、すぐ再上演できます。
使い方
- TyranoScript プロジェクトのフォルダ（
data/ を含む階層）を VS Code で開く
- シナリオの
.ks ファイルを開く
- コマンドパレット（Ctrl+Shift+P / Cmd+Shift+P）で「演出監督室: プレビューを開く」を実行
（エディタ右上のアイコンからも開けます）
- 「▶ 上演開始」でプレビュー。他のタブで演出を作って「✎ 挿入」→ 保存 → 再上演
インストール
.vsix ファイルから: 拡張機能ビューの「…」メニュー →「VSIX からのインストール」- ソースから開発実行: このフォルダを VS Code で開き F5（拡張機能開発ホスト）
対応タグ（プレビュー再現）
bg / image / camera / reset_camera / quake / mask / mask_off / wait / filter /
keyframe〜endkeyframe / ptext / kanim / free /
chara_new / chara_show / chara_mod / chara_move / chara_hide / chara_hide_all /
playbgm / stopbgm / fadeinbgm / fadeoutbgm / playse / stopse / l / p / cm / r
加えて煉瓦書架マクロセット（flash_white, blackout, quake_s, filter_sepia, cine_title, glitch_title 等）をネイティブ解釈します。
未対応タグはスキップし、実行ログに記録します。
実機プレビュー（v0.2）
- 「実機プレビュー」タブは、内蔵ローカルサーバー経由でプロジェクトの index.html（TyranoScript 本体）を iframe 実行します。挙動は実機そのものです。
- 「カーソル位置のシーンから起動」: エンジン初期化後に [jump] で編集中ファイル・直前ラベルへ自動ジャンプ。失敗時はゲーム画面右上の ▶ ボタンで手動ジャンプできます。
- .ks はエディタのバッファ（未保存可）を配信するため、編集 → ⟲ リロードで即反映されます。
- サーバーは 127.0.0.1 のランダムポートで待機し、VS Code 終了時に停止します。
制限事項（簡易ステージ）
- プレビューは演出確認用の簡易エンジンです。実機（TyranoScript 本体）の完全な再現ではありません。
- kanim は opacity / x / y の補間に対応（scale / rotate は未対応）。
- if / jump / call などの制御タグは未対応（該当行はスキップ）。
| |
