# 光效編輯程式操作
## 1.確認環境
* #### Live Server
安裝這個Vscode套件
安裝成功後右下角會有
的圖標
* #### 安裝必要的Python packages
一樣打開終端機輸入並且執行(可以分行貼上執行或者一次貼上執行)

pip install PyQt6
pip install PyQt6-WebEngine

更詳細的環境架設可以參考
* [架設開發環境](https://hackmd.io/@Wego-lightdance/Ftutorials/%2FVjSY-xlTSROaxDT1woqKQg)
## 2.啟動Live Server
1.先點右下角 `Go Live`
之後會跳出
並且Vscode右下角變成

這樣就成功了

## 3.啟動編輯器
開啟`editor.py`
點擊執行
或者在終端機輸入

python editor.py

接著編輯器就會彈出來了!!


### 鍵盤快捷鍵說明
| 快捷鍵 | 功能 | 呼叫的函數 |
|--------|------------------------------------|--------------------------------|
| `1` | 更改當前的顏色設定 | `colorchanged` |
| `2` | 設置當前幀的開始時間 | `set_frame_start_bynowtime` |
| `3` | 設置當前幀的結束時間 | `set_frame_end_bynowtime` |
| `G` | 播放或暫停音頻 |`playPause` |
| `A` | 添加一個新的關鍵幀 | `addnewframe` |
| `D` | 刪除當前的關鍵幀 | `delframe` |
| `P` | 快進功能，增加當前播放時間 0.1 秒 | `forward` |
| `O` | 倒退功能，減少當前播放時間 0.1 秒 | `backward` |
| `9` | 增加音波圖的縮放比例，放大功能 | `zoomin` |
| `8` | 減少音波圖的縮放比例，縮小功能 | `zoomout` |
| `-` | 向左滾動音波圖 | `scrollleft` |
| `=` | 向右滾動音波圖 | `scrollright` |
| `R` | 發送即時 UDP 數據 | `UDP_now` |
| `Z` | 設定新位置關鍵幀 | `newpos` |
| `C` | 刪除當前位置關鍵幀 | `delpos` |
| `L` | 加載選擇的預設值 | `loadpreset` |

## 基本的操作方法
* 1.最左側選擇想要編輯的舞者(箭頭顯示的)
* 2.在編輯區編輯部位的顏色
* 3.按`1`將變更儲存並刷新到模擬器(會同時儲存至data.json)
* 藍色進度條調整波型圖縮放

---------------

## Preset區
#### 新增preset
1. 先在命名區輸入preset的名字
2. 按save as preset 後會將箭頭指著的舞者的全身光效儲存為preset
#### 載入 preset
1. 選擇想要載入的preset
2. 按load preset 預設中的全身光效會載入

--------
### Debug模式
在表演前接線的時候，開啟Debug模式。
功能是在最前面跟最後面反覆恆跳 以達到一暗一滅
可以檢查硬體是否有問題

-----

### 光效關鍵幀

按`A`可以新增幀
按`D`可以刪除幀
可以用上面的綠色箭頭調整關鍵幀(或者用`2`跟`3`)

-----

### 位置關鍵幀

按`Z`可以新增幀
按`C`可以刪除幀
按`U` 編輯位置-->箭頭選擇的舞者會跟著滑鼠移動位置 左鍵定位
可以用下面的紅色箭頭調整關鍵幀