---
# System prepended metadata

title: 光效程式操作

---

# 光效編輯程式操作
## 1.確認環境
* #### Live Server
安裝這個Vscode套件
     ![image](https://hackmd.io/_uploads/Hk-5bCBYA.png)
    安裝成功後右下角會有
    ![image](https://hackmd.io/_uploads/r1Sh-0HFR.png)
的圖標
* #### 安裝必要的Python packages
一樣打開終端機輸入並且執行(可以分行貼上執行或者一次貼上執行)
```
pip install PyQt6
pip install PyQt6-WebEngine
```

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

這樣就成功了

## 3.啟動編輯器
開啟`editor.py`
點擊執行
![image](https://hackmd.io/_uploads/HJUgQwy5C.png)
或者在終端機輸入
```bash
python editor.py
```

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

![image](https://hackmd.io/_uploads/r13HoBvlll.png)


### 鍵盤快捷鍵說明
| 快捷鍵 | 功能                               | 呼叫的函數                      |
|--------|------------------------------------|--------------------------------|
| `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` 編輯位置-->箭頭選擇的舞者會跟著滑鼠移動位置 左鍵定位
 可以用下面的紅色箭頭調整關鍵幀