
# mekaYMD LiveScreenBinder v17

## Live Screen Camera 対応版 / v1.3.10

## 概要

`LiveScreenBinder` は、HS2 / StudioNEOV2 用の Live Screen 表示プラグインです。

専用アイテム **Live Screen** に、Studio内のカメラ映像を表示できます。
追加アイテム **Live Screen Camera** を配置すると、その位置・向きから見た映像を Live Screen に表示できます。

Live Screen Camera を配置していない場合は、従来通りメインカメラ映像を表示します。

v1.3.10では、スクリーンの明るさ調整機能を追加しました。
GraphicsプリセットやPostProcess設定によってスクリーンが暗く見える場合でも、Live Screen側の明るさを段階的に調整できます。

---

## 対応環境

* HoneySelect2 / HS2
* StudioNEOV2
* BepInEx 導入済み環境

---

## 同梱内容

配布内容に応じて、以下のファイルが含まれます。

```txt
LiveScreenBinder.dll
mekaYMD_live_screen01.zipmod
mekaYMD_live_screen_camera01.zipmod
README.txt
```

※zipmod名は配布形態により異なる場合があります。

---

## 導入方法

### 1. DLLを配置

`LiveScreenBinder.dll` を以下の場所に入れてください。

```txt
HoneySelect2/
└─ BepInEx/
   └─ plugins/
      └─ LiveScreenBinder.dll
```

古い版の `LiveScreenBinder.dll` が入っている場合は、必ず削除または退避してください。
複数のLiveScreenBinder系DLLを同時に入れると、正常に動作しない場合があります。

---

### 2. zipmodを配置

Live Screen関連のzipmodを以下の場所に入れてください。

```txt
HoneySelect2/
└─ mods/
   ├─ mekaYMD_live_screen01.zipmod
   └─ mekaYMD_live_screen_camera01.zipmod
```

---

## 使い方

StudioNEOV2を起動し、アイテム一覧から以下を配置します。

```txt
Live Screen
Live Screen Camera
```

`Live Screen` は映像を表示するスクリーンです。
`Live Screen Camera` は撮影位置を指定するためのカメラマーカーです。

Live Screen Camera を配置した状態でライブ表示を開始すると、Live Screen Camera の位置・向きから見た映像が Live Screen に表示されます。

Live Screen Camera を配置していない場合は、メインカメラ映像が表示されます。

---

## 操作キー

```txt
Ctrl + Shift + L
Live Screenを検出してライブ表示を開始 / 再開します。
```

```txt
Ctrl + Shift + P
ライブ更新を一時停止 / 再開します。
ポーズ作成中やFK/IK操作中に不具合が出る場合は、一時停止してから作業してください。
```

```txt
Ctrl + Shift + U
手動で1回だけ映像を更新します。
一時停止中でも使用できます。
```

```txt
Ctrl + Shift + Backspace
Emergency Restoreを実行します。
カメラ状態や表示状態の緊急復元を行います。
FK/IK操作点などの表示がおかしくなった場合に使用してください。
```

```txt
Ctrl + Shift + M
スクリーンの明るさを段階的に切り替えます。

x0.75 → x1.0 → x1.25 → x1.5 → x2.0 → x3.0
```

```txt
Ctrl + Shift + 0
スクリーンの明るさを x1.0 にリセットします。
```

---

## おすすめの使い方

通常時は以下の流れで使用してください。

```txt
1. Live Screenを配置
2. 必要に応じてLive Screen Cameraを配置
3. Ctrl + Shift + L でライブ表示開始
```

ポーズ作成やFK/IK操作を行う場合は、以下の使い方をおすすめします。

```txt
1. Ctrl + Shift + P でライブ更新を一時停止
2. FK/IKやポーズ編集を行う
3. 必要に応じて Ctrl + Shift + U で手動更新
4. 作業後、Ctrl + Shift + P または Ctrl + Shift + L でライブ再開
```

スクリーンが暗く見える場合は、以下を試してください。

```txt
Ctrl + Shift + M
スクリーン明るさ切替
```

Graphicsプリセットによって暗く見える場合は、x1.5〜x2.0程度に上げると見やすくなる場合があります。

---

## v1.3.10 の主な機能

```txt
- Live Screen Camera対応
- Live Screen Cameraが無い場合はメインカメラ映像にフォールバック
- 板スクリーン対応
- Skybox反映対応
- RenderTexture残像対策
- 20FPS固定更新
- WaitForEndOfFrame撮影
- FK/IK操作点を誤って非表示にしないよう修正
- ライブ一時停止機能
- Emergency Restore機能
- スクリーン明るさ調整機能
```

---

## スクリーン明るさ調整について

v1.3.10では、スクリーン側に明るさ補正を追加しています。

この機能は、Studio全体やメインカメラそのものの明るさを変更するものではありません。
Live Screenに表示されている映像だけを明るく、または暗くする機能です。

そのため、以下のどちらの場合でも明るさ調整が有効です。

```txt
Live Screen Cameraあり
→ Live Screen Camera映像の明るさを調整

Live Screen Cameraなし
→ メインカメラ映像の明るさを調整
```

---

## 注意事項

* 古いLiveScreenBinder系DLLを同時に入れないでください。
* Graphics、SSS、PostProcess、Move Controller、AdvIK、HSPE系Pluginなどの環境によっては、表示や操作点に相性が出る場合があります。
* FK/IK操作点が消える、または操作しづらくなる場合は、`Ctrl + Shift + P` でライブ更新を一時停止してから作業してください。
* 表示状態がおかしくなった場合は、`Ctrl + Shift + Backspace` の Emergency Restore を試してください。
* それでも改善しない場合は、Studioを再起動してください。
* Live Screen Camera配置直後に、白い球状の表示が出る場合があります。ワークスペースでキャラや別オブジェクトをクリックすると消える場合があります。動作には影響ありません。
* 環境によっては、Graphics側の Blur / Motion Blur / DOF / Temporal系設定の影響を受ける場合があります。

---

## トラブルシューティング

### Live Screenに映像が出ない場合

以下を確認してください。

```txt
- LiveScreenBinder.dll が BepInEx/plugins に入っているか
- 古いLiveScreenBinder.dllが同時に入っていないか
- Live Screen zipmod が mods フォルダに入っているか
- Studioで Live Screen を配置しているか
- Ctrl + Shift + L を押したか
```

---

### Live Screen Camera視点にならない場合

以下を確認してください。

```txt
- Live Screen Camera zipmod が mods フォルダに入っているか
- Studioで Live Screen Camera を配置しているか
- Live Screen Camera の名前やPrefab構造が変更されていないか
```

Live Screen Camera が検出されない場合は、メインカメラ映像にフォールバックします。

---

### スクリーンが暗い場合

以下を試してください。

```txt
Ctrl + Shift + M
スクリーン明るさ切替
```

明るさは以下の順で切り替わります。

```txt
x0.75 → x1.0 → x1.25 → x1.5 → x2.0 → x3.0
```

明るさを標準に戻したい場合は、以下を押してください。

```txt
Ctrl + Shift + 0
明るさ x1.0 にリセット
```

---

### FK/IKの操作点が表示されない、または消える場合

以下を試してください。

```txt
1. Ctrl + Shift + P でライブ更新を一時停止
2. Ctrl + Shift + Backspace で Emergency Restore
3. キャラや別オブジェクトをクリックして選択状態を更新
4. 改善しない場合はStudioを再起動
```

ポーズ作成中は、ライブ更新を一時停止してから作業することをおすすめします。

---

## アンインストール

以下のファイルを削除してください。

```txt
BepInEx/plugins/LiveScreenBinder.dll
mods/内のLive Screen関連zipmod
```

---

## バージョン

```txt
LiveScreenBinder v1.3.10
brightness shader fix build
```

---

## 制作

mekaYMD
