LjStudio — USB メモリー / SD へ書き出し、LjPlay と同時に再生して比べる

LjStudio は Martin LightJockey 2.7 が書いたデータを読み書きする独自実装です。Martin 社の製品ではなく、同社とは関係がありません。

0. 動画で見る

書き出しから、M5 2 台に入れて LjStudio と同時に再生して比べるまでを通しで（約 4 分・字幕つき）: https://youtu.be/8zJuU9LW8n8

1. 何ができるか

LjStudio で開いているライブラリを、LjPlay（M5 の SD 再生機）や LjTouch（Linux のタッチパネル再生機）へ運ぶために、USB メモリーや SD カードへ書きます。 SD はカードリーダーで PC に挿せば、USB メモリーと同じように選べます。

LjPlay 用	ドライブの直下に `LjShow` フォルダを作ります（M5 は SD の /LjShow を読んで起動）。中身は Cue リスト・Cue・Sequence と、M5 が使う `M5.patchmask.bin`（その場で作り、LJ の出力と突き合わせてから書きます）。
LjTouch 用	ドライブのラベルを「LJTOUCH」に変え、`LjTouchData` フォルダに書きます（挿すと LjTouch が数秒で読み込みます）。

メニュー: LjStudio(Z) → USB メモリー / SD へ書き出す（LjPlay・LjTouch）…

2. 書き出す手順

USB メモリー、または SD を入れたカードリーダーを PC に挿します。
メニューから窓を開き、「書き出し先」の一覧からドライブを選びます。取り外し可能なドライブだけが出ます。前に入っているデータがあれば、その名前も出ます。
「LjPlay 用」「LjTouch 用」の要るほうに印を付けます。M5 の SD なら LjPlay 用だけ。
窓の中に書く内容（どのドライブに・何を・前のデータをどこへ残すか）が出ます。確かめてから「書き出す」。
下の記録に「書きました」が出たら、Windows の「ハードウェアを安全に取り外す」で止めてから抜きます。

書き出しの窓（書く前） — 書く前: ドライブを選び、LjPlay 用に印。下の枠に「書く内容」が出る（押すと大きく）

書き出しの窓（書いた後） — 書いた後: 記録に「書きました」と、知らせ（リンク 2 以降の器具・直下の LjPlay.ini）が出る（押すと大きく）

前のデータと、機体ごとの設定

前に入っていたデータは消しません。LjPlay 用は前の LjShow を LjShow_old_001 のような番号付きの名前で残します（M5 が COM で受け取るときと同じ流儀）。 LjTouch 用は書き終わってから入れ替えます。

SD 直下の LjPlay.ini（M5 の機体ごとの設定）には触りません。LjShow の中に LjPlay.ini は入れません——入れると、直下の機体ごとの設定が読まれなくなるためです。前の LjShow の中に LjPlay.ini があったときは、その旨を知らせます（中の行は SD 直下の LjPlay.ini へ移してください）。

3. M5 に入れる

同じように書いた SD を M5 に挿して電源を入れると、/LjShow を読み込み、液晶に Cue リストの名前（動画では「SYNC TEST 512」）が出ます。動画では 2 枚書いて、COM74 と COM23 の 2 台に入れました。SD を差し替えただけでは読み直さないので、電源を入れ直すかリセットしてください。

4. 受信機の監視画面の見方

M5 の DMX 出力を、PC につないだ DMX 受信機で受けて見ます（左が COM23、右が COM74 を受けている窓）。

いちばん上の段	Art-Net の送り先とユニバース。受けた DMX を、そのまま Art-Net で送ります（Visualizer に写すため）。
升目	ch ごとの値。試験データ SyncTest512 では 51〜56 番がショーの時刻で、これを読んで LjStudio とのずれを測ります。
下の行	受信の検査: 毎秒の枚数、枠の長さ、誤り・途切れの数、線の上の周期と BREAK・MAB の長さ。その下の棒は 512 ch の値です。

5. Visualizer に並べて同時に再生する

Visualizer の左の舞台にこの PC の LjStudio、右の舞台に M5 の出力（受信機から Art-Net で写したもの）を並べます。左右のショーの時刻の差は、数で出します（緑 = 25 ms 以内・黄 = 100 ms 以内・赤 = それ以上）。

同時に頭から始める

M5 はタイマーから BLE で「0 から」の合図を受けます。合図は BLE と受信の道で約 0.16 秒遅れて届くので、その分だけ先にタイマーへ送り、LjStudio を頭出しします。 BLE の届き方は毎回少し揺れる（今回は ±40 ms ほど）ので、25 ms 以内に入るまで何度か始め直します。動画では 2 回目で COM74 が +4 ms、COM23 が −34 ms でした。

物差し（40 画素）は 1 マス 25 ms。左右の白い点が同じ位置なら、ずれは 25 ms 以内です。流れる点滅、毎秒のフラッシュ、色が飛ぶ PAR、ムービングの位置も、左右で同じ瞬間に変わるかを見ます。

6. 注意と、AI からの操作

LjPlay が出すのはリンク 1 の 512 ch だけです。リンク 2 以降に器具があれば、そう知らせます（動画のライブラリは、右の舞台と時計を映すための表示用の器具をリンク 2・3 に持っています）。
音（MediaPlayerSettings）は LjPlay 用には入れません。LjPlay では鳴りません。
LjTouch 用は、面（.pnl）が無いライブラリでも書けます。LjTouch は Cue リストから自動の面を作って出します。
書き出し先は取り外し可能なドライブだけです。PC の固定ディスクには書きません。

AI（Claude 等）からは LjStudio の命令で同じことができます: usb open ／ usb drive F: ／ usb ljplay on ／ usb ljtouch off ／ usb run（窓なしなら usb write F: ljplay）。