Tyrano Direction Studio (演出監督室)
TyranoScript プロジェクトの中で演出を作り、プレビューし、そのままシナリオへ挿入するための VS Code 拡張機能です。
主な機能
- シナリオ再生: 開いている
.ks ファイルをステージ上で上演。テキスト行や [l] [p] はクリック送り。
- プロジェクト素材の自動参照:
data/ 配下の背景 (bgimage)・立ち絵 (fgimage)・BGM (bgm)・効果音 (sound) をファイル名で照合して使用。
- 解像度の自動検出:
data/system/Config.tjs の scWidth / scHeight を読み取り、座標系を自動設定。
- 演出ジェネレーター: カメラ / キャラ移動 / 揺れ・フラッシュ・マスク転換・フィルター / 映画的文字演出をスライダーで調整し、「✎ カーソル位置に挿入」でエディタへ追加。
- 保存で自動同期:
.ks を保存するとプレビュー側のスクリプトが更新され、すぐ再上演できます。
- 左メニューから常時起動: Activity Bar の「演出監督室」から、シナリオを選択していない状態でも全機能を開けます。
- 実行中変数のライブ操作: 実機プレビューの
f / sf / tf を台帳登録なしで自動検出し、値をその場で変更できます。
- 補助ツール: タグ自動付与、セリフ抽出、音声ファイルの並べ替え・連番リネーム・ZIP保存を内蔵しています。
使い方
- TyranoScript プロジェクトのフォルダ（
data/ を含む階層）を VS Code で開く
- 画面左の Activity Bar にある「演出監督室」アイコンを選択（
.ks ファイルの選択は不要です）
- 必要に応じて
.ks ファイルを開くと、簡易ステージやタグ挿入の対象として自動同期されます
- 「▶ 上演開始」でプレビュー。他のタブで演出を作って「✎ 挿入」→ 保存 → 再上演
インストール
.vsix ファイルから: 拡張機能ビューの「…」メニュー →「VSIX からのインストール」- ソースから開発実行: このフォルダを VS Code で開き F5（拡張機能開発ホスト）
Android APKの一括生成
「書き出し」タブで「Android用」を選び、「フォルダ出力後、続けてAPKファイルを作成する」を有効にすると、Android向けフォルダの出力からAPK作成まで一括実行できます。
- APK作成には、別途購入・入手した
TyranoConverter.exe が必要です。コンバーター本体はこの拡張機能に同梱されず、自動ダウンロードも行いません。
- 初回実行時に購入済みEXEを選択すると、そのパスをVS Code設定
tyranoDirection.android.converterPath に保存します。
- アプリケーションID、アプリ名、バージョン、フルスクリーン、PNGアイコン、Android SDKパスを指定できます。
- Java、Cordova、Gradle、Android SDKなど、コンバーターが利用するAndroidビルド環境は事前に設定してください。
- 変換ログはVS Codeの「Tyrano Android APK」出力パネルに表示されます。
対応タグ（プレビュー再現）
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 などの制御タグは未対応（該当行はスキップ）。
| |
