Light Stream Converter 參數
Converter 是一種設備，從計算機接收網絡信號，並通過自己的端口（Port）將信號分發給實際的燈具。在 Light Stream 項目中，Converter 描述數據去往哪裏、以及如何發送：使用網絡中的哪個地址、使用哪種協議、設備有多少個端口，以及每個端口分配了哪些宇宙（Universe）。
本文介紹 Light Stream 中 Converter 的參數。物理設備本身的配置（設備自身的 IP、端口模式、晶片類型）在另一個窗口中進行，具體見 Light Stream Converter 配置 一文。
固定裝置（Fixtures）窗口中的 Converter
項目中的所有設備都顯示在固定裝置（Fixtures）窗口的上半部分。結構始終相同：Light Stream Player → Converter → Converter 端口 → 端口中的燈具。
Converter 行從左到右依次為：
- 箭頭用於展開和摺疊端口列表。
- Converter 圖標——點擊它會向設備發送識別命令：真實的 Converter 會閃爍指示燈幾秒鐘，方便在配電箱中找到對應的設備。命令會發送到參數中設置的地址。
- 圖標旁的指示燈顯示發送狀態：數據發送時閃爍，停止發送時熄滅。
- Converter 的名稱。可通過雙擊或右鍵→重命名（Rename）修改。
- 數據發送目標的IP 地址（IP Address）。
- 右側的複選框——Converter 的可見性。
右鍵點擊 Converter 可使用重命名（Rename）、刪除（Delete）、複製（Duplicate）和取消全部配址（Unpatch All）。
如果 Converter 帶有鎖形圖標，說明它是內部 Converter（Internal Converter）——即 Player 自帶的內置宇宙。它無法刪除，參數也更少，詳見下文相關章節。
Converter 或端口名稱顯示為紅色，表示尋址錯誤：該端口的燈具超出了分配給它的宇宙範圍。
向項目中添加 Converter
- 打開固定裝置窗口。
- 點擊添加設備（Add Device）按鈕（窗口左下角的加號）。
- 選擇 Light Stream 及所需型號——Converter 2、Converter 6 或 Converter 8 LITE。名稱中的數字即物理設備的端口數量。
- 對於其他廠商的設備，選擇 Art-Net Converter 並指定端口數量：1 到 16 個。
新 Converter 會添加到窗口中當前選中的 Player（如果沒有選中任何內容，則添加到第一個 Player），並立即獲得一個唯一名稱、下一個可用的 IP 地址，以及緊接在上一個 Converter 宇宙之後的宇宙。這樣一來，可以連續添加多個 Converter 而不會出現宇宙衝突，需要修改的通常只有一個字段——IP 地址。
第二種方法是在網絡中找到已經配置好的設備，將其連同真實的網絡設置一起添加進來，具體見 Light Stream Converter 配置 一文。
複製（Duplicate）會連同所有設置以及已配址到該 Converter 上的燈具副本一起創建一個 Converter 副本。副本會獲得自己的名稱、下一個可用的 IP 以及下一組可用的宇宙。這是在場地中描述多台相同設備最快的方法。
在哪裏查看參數
在固定裝置窗口中選中一個 Converter——它的參數會出現在屬性（Properties）窗口中。這裏沒有確定和應用按鈕：數值會立即生效，數據發送也會在需要時自動重啟。屬性窗口的通用結構見 Properties 一文。
參數分為兩部分：基本（General）和宇宙設置（Universe Settings）。
"基本"（General）部分
| 參數 | 作用 |
|---|---|
| 名稱（Name） | Converter 在項目中的名稱。同一個 Player 下的 Converter 名稱必須各不相同——重名會妨礙將設置導出到 Player。如果輸入的名稱已被佔用，程序會自動在其後添加編號。名稱中不允許使用以下字符：/ ? # [ ] @ ! $ & ' ( ) * + , ; " < > % { } ^ `
|
| 協議（Protocol） | ArtNet 或 sACN——數據使用哪種協議發送。根據物理設備所支持的協議選擇 |
| 控制器類型（Controller Type） | DMX 或 SPI。決定端口中的燈具如何分佈到各個宇宙中，見下文相關章節 |
| 廣播（Broadcast） | 數據以廣播方式發送——同時發給網絡中的所有設備，此時不使用IP 地址字段。僅在協議為 ArtNet 時顯示 |
| 組播（Multicast） | 組播發送。僅在協議為 sACN 時顯示 |
| IP 地址（IP Address） | 數據發送到的設備地址，必須與 Converter 本身設置的地址一致。僅在廣播關閉時使用 |
| 端口（Port） | 用於發送數據的網絡端口。Art-Net 使用 6454。只有在特殊情況下才需要修改 |
| 使用自定義網絡接口（Use Custom Network Interface） | 默認情況下，所有 Converter 都通過項目共用的網卡發送數據。勾選此項可讓該 Converter 使用自己的網卡 |
| 網卡（Network Adapter） | 為該 Converter 單獨選擇網卡。僅在啟用自定義網絡接口時生效 |
項目共用的網卡以及全局的啟用 Art-Net（Enable Art-Net）按鈕位於程序設置的網絡（Network）部分（見 Settings）。無需單獨啟用每個 Converter：所有 Converter 都通過同一個按鈕啟動和停止。
"宇宙設置"（Universe Settings）部分
| 參數 | 作用 |
|---|---|
| 起始宇宙（Start Universe） | 第一個端口的宇宙編號。其餘端口的宇宙按順序從該編號開始計算 |
| 端口數量（Port Count） | 項目中該 Converter 的端口數量。請設置為設備實際擁有的端口數 |
| 每端口宇宙數（Universes per Port） | 一個端口佔用的宇宙數量。數值越大，一個端口能容納的燈具越多。上限由程序設置中的每端口最大宇宙數（Maximum Universes per Port）決定（默認值為 4） |
| 發送空端口（Send Empty Ports） | 即使端口中沒有任何燈具，也會發送數據。未勾選此項時，空端口不發送任何數據 |
有兩項設置會改變已經搭建好的項目的尋址方式，因此修改時需要格外注意：
- 起始宇宙會將該 Converter 所有燈具的宇宙整體偏移相同的數值。當需要在整體尋址方案中移動整台設備時很方便，但偏移之後燈具會落在不同的宇宙中。
- 減少端口數量會連同配址一起刪除多餘的端口：被刪除端口中的燈具會返回到固定裝置窗口下方的列表中，變為未配址狀態。燈具本身及其在 mapping 上的位置不會丟失。
端口宇宙如何計算
端口的宇宙編號不是手動設置的，而是按以下公式計算：
端口宇宙 = 起始宇宙 + (端口編號 − 1) × 每端口宇宙數
例如，一個 Converter 的起始宇宙為 1，每端口一個宇宙，則結果為：端口 1——宇宙 1，端口 2——宇宙 2，端口 3——宇宙 3。如果設置為每端口兩個宇宙，則端口 1 佔用宇宙 1 和 2，端口 2 佔用 3 和 4，端口 3 佔用 5 和 6。
已佔用的宇宙會直接標註在固定裝置窗口的端口行中，形式為 U1、U1-U2 等。要查看實際佔用了哪些宇宙，最簡單的方法就是在修改起始宇宙或每端口宇宙數之後直接查看這裏。
項目中的宇宙數量受許可證限制。如果宇宙總數超過許可證密鑰允許的數量，程序會在 mapping 界面上給出提示。
控制器類型：DMX 還是 SPI
該參數要解決的是同一個問題：對於放不下剩餘宇宙空間的燈具該如何處理。
- DMX——通道以連續的數據流方式發送。在某個宇宙末尾開始的燈具會延續到下一個宇宙的開頭。普通的 DMX 線路就是這樣工作的。
- SPI——燈具會整體移動到下一個宇宙，上一個宇宙剩餘的部分不會被使用。像素線路就是這樣工作的：一個像素不能被拆分到兩個宇宙中。
該值需要在給燈具配址之前設置好：更改類型會重新計算該 Converter 上所有燈具的地址。如果物理設備的端口已經切換為SPI模式，那麼項目中對應的 Converter 也必須設置為SPI——否則現場畫面會在宇宙邊界處出現錯位。
可見性與數據發送
固定裝置窗口中 Converter 右側的複選框即其可見性。禁用後的 Converter，其所有端口都會輸出零值：現場的燈具會熄滅，但不會從項目中消失，地址也會保留。需要臨時關閉場地中的一部分而又不想拆掉配址時，這一功能很方便。
可見性按鏈條方式生效，鏈條中任意一環被禁用都會將數據清零：
- 燈具本身的可見性；
- 端口的可見性（端口旁的複選框）；
- Converter 的可見性；
- 全局的啟用 Art-Net（Enable Art-Net）按鈕。
如果程序中動畫在運行，但燈具沒有反應，應按照上述順序依次檢查，然後再檢查網絡參數：IP 地址、廣播以及網卡。
Player 的內部 Converter
內部 Converter（Internal Converter）是 Light Stream Player 自帶的內置宇宙。當在 Player 的屬性中啟用使用內部 Converter（Use Internal Converter）參數後，它會出現在列表中，並標有鎖形圖標。
它與普通 Converter 的區別在於：
- 無法刪除或複製；
- 沒有網絡參數——數據不會通過網絡發送到任何地方，地址取自 Player 本身；
- 在屬性窗口中，只能設置名稱、起始宇宙和端口數量。
內部 Converter 的宇宙與其他宇宙一樣參與統一編號，同樣不能與其他 Converter 的宇宙重疊。
更改參數之後
Converter 的網絡設置和宇宙是會被發送到 Light Stream Player 的那部分設置。一旦修改了其中任何內容，固定裝置窗口中 Player 名稱旁就會出現橙色警告圖標。點擊它會提示打開 Player 的屬性並重新發送設置。
在重新發送設置之前，Player 上保留的仍是舊的宇宙方案，獨立播放會使用錯誤的地址。
如果出現問題
端口或 Converter 顯示為紅色。 燈具數量超出了端口的宇宙容量：最後一個地址超出了範圍。請增大每端口宇宙數，或將部分燈具轉移到相鄰端口。
宇宙衝突。 同一個 Player 下的兩個 Converter 佔用了相同的宇宙編號。請調整其中一個的起始宇宙，使範圍不再重疊；注意一個 Converter 會連續佔用 端口數量 × 每端口宇宙數 個宇宙。
名稱自動發生了變化。 說明該名稱已被另一個 Converter 佔用——程序自動添加了編號，以保證名稱各不相同。
沒有信號。 請依次檢查整條可見性鏈條，然後檢查 Converter 的IP 地址（必須與真實設備的地址一致）、廣播狀態以及所選的網卡。點擊 Converter 圖標可以確認程序確實連接到了正確的設備——設備會閃爍指示燈。
現場畫面在宇宙交界處出現錯位。 很可能是控制器類型不匹配：像素線路需要使用SPI模式。
燈具脫離了端口。 請檢查是否減少過端口數量——被刪除端口中的燈具會返回到固定裝置窗口下方的列表中。