---
navigation:
  title: 介面
  parent: energymeter.md
---

# 能量儀表介面

本頁會說明<ItemLink id="meter" components="rarity=epic"/>可以調整的所有設定。

若要開啟設定，先放置方塊並對其點擊右鍵互動，即可開啟機器的介面。

整個介面分成兩個區域：左側是固定顯示的全域面板，

右側則會依上方分頁列目前選取的分頁而改變內容。

---

<br/>

# 全域面板

<FloatingImage src="assets/global_panel.png" align="right"/>

全域面板位於介面的左側。

無論切換到哪個分頁，它都會持續顯示。

這個面板會顯示當前的測量數值與狀態，  
也包含 I/O 格，以及重設已測得能量累計值的按鈕。

---

## 測量

測量資訊包含當前流量，以及已測得的能量累計值。

累計值可以透過 I/O 格下方的按鈕重設。

當前測量數值會在每次設定好的間隔結束後更新。

唯一的例外是觸發了「寬限值」設定。

詳細說明請參閱下方的「寬限值」段落。

---

## 狀態

只要有可能影響結果的設定或狀態發生變化，狀態顯示就會更新。

這包括當前流量、相鄰方塊的變化，以及輸入與輸出設定的改變。

狀態顯示為「未連接」，代表目前選擇的模式所需設定尚未完成。

大多數情況下，這表示少了輸入端或輸出端。

「閒置中」則表示所有設定都已正確完成，能量儀表正在等待傳輸能量。

最終顯示的狀態會依所選的傳輸模式而定，代表<ItemLink id="meter" components="rarity=epic"/>目前正在正常處理請求並運作。

---

## I/O 格

這個區域用來設定方塊各個面的用途。

每一面都可以設成輸入、輸出，或停用來拒絕能量請求。

正面無法設定，因為它保留給方塊上的流量顯示。

各個面可以透過左鍵或右鍵來調整，也可以立即重設單一面，或一次重設所有面。

更多資訊可在各按鈕的提示文字中查看。

某一面能否被設成輸入或輸出，會取決於目前選擇的傳輸模式。

<br clear="all" />

---

# 設定面板

<FloatingImage src="assets/configuration_tab.png" align="right"/>

切換到**設定**分頁後，即可開啟設定面板，  
用來調整模式以及測量相關的選項。

---

## 模式

這個區域使用單選按鈕來切換不同模式。

每個小節同一時間只能選擇一個選項。

---

## 傳輸

傳輸模式會決定從輸入面進來的能量請求，  
要如何被轉送到輸出面。

---

預設模式是**平均分配**。

在「平均分配」模式下，傳入的請求會平均分配至所有輸出端。

系統會先依輸出端數量，盡量平均分配能量，讓每個輸出端都收到相同份額。

若某個輸出端接受的量低於原本分配到的份額，剩餘的能量就會重新分配至其他輸出端。

因此這種平均分配不是強制固定的。

若輸出端數量比可用能量還多，剩餘的部分會送往隨機選中的輸出端。

---

**傳輸**模式是一種特殊模式。

它會改變 I/O 格的行為，並允許你為輸出端設定優先權。

優先權較高的輸出端，永遠會先收到轉送的能量，之後才依照優先權，由高到低繼續分配。

只有在高優先權輸出端無法接收全部能量時，低優先權輸出端才會收到能量。

---

**銷毀**模式主要用於測試配置。

這個模式不會轉送能量，而是會永久刪除所有傳入的能量。

同時，它也會改變 I/O 格的行為，讓你無法設定輸出端。

這通常用來測量所有輸入端總共能送入多少能量，尤其是在一般流動情況會受到輸出端限制時特別有用。

---

## 測量

測量模式會決定每個間隔的流量要如何計算。預設模式是**即時**。

在**即時**模式下，只會採計目前這個間隔內儲存的測量值，先前間隔的數值會被忽略。

當你需要精確數值時，這個模式會很有幫助。

**平滑**模式會把前一個間隔也納入計算。

它不是只使用目前間隔的測量值，而是會根據前一個間隔來調整流量。

這能讓圖表更平順，並降低流量尖峰帶來的影響。

若你想觀察較長時間內的平均表現，這個模式會很好用。

<br/>

---

## 設定值

這個區域的選項都是文字輸入框，用來修改會影響測量與能量流動的<ItemLink id="meter" components="rarity=epic"/>設定。

這些輸入框也支援一些額外功能。

預設情況下，欄位會一直顯示目前的值。

當你正在編輯數值時，畫面顯示的內容不會即時更新，而是會讓右側按鈕能夠點選。

按下該按鈕後，輸入的數值才會套用。你也可以按 **Enter** 鍵來確認修改後的值。

這些輸入框也支援幾項智慧功能，包括輸入驗證。

若輸入的內容無效，例如數字格式錯誤，輸入框就會變成紅色，而且無法套用該數值。

所有輸入框也都支援數學式。

可用的運算包含加、減、乘、除、次方與括號。

若偵測到數學式，輸入框會顯示一個小型彈出視窗，讓你直接套用計算結果。

由於所有可設定的值都是整數，因此數學式的結果會自動四捨五入為最接近的整數。

在輸入數學式時，也會阻止無效符號的輸入。

舉例來說，只有在前面已有對應左括號時，你才能輸入右括號。

---

## 上限值

傳輸上限值會決定<ItemLink id="meter" components="rarity=epic"/>每刻能傳輸多少能量（_1 秒 = 20 刻_）。

所有輸入都會先累加，再受到這個數值限制。

因此這個上限值是全域生效，而不是對每個輸入端各自生效。

任何超過上限值的能量，都會退回給發送端。

---

## 間隔值

間隔值會決定每隔多少刻（_1 秒 = 20 刻_），進行一次新的測量。

在一個間隔期間內，所有相關數值都會在內部被記錄並儲存。

當間隔結束時，這些數值會用來計算當前流量，並更新測得能量的累計值。

預設值是 **5 刻（0.25 秒）**。這個預設值可以在模組設定中更改。

基於效能考量，這個值永遠不能低於 5 刻。

這個相對較小的預設值，能讓<ItemLink id="meter" components="rarity=epic"/>快速對變化做出反應。

當你想立刻看出能源供應是否中斷時，這會特別有幫助。

不過，這也可能讓波動較大的數值，產生不斷變動的平均結果。

提高間隔值可以讓波動變得更平順，但流量更新的頻率也會變低。

---

## 寬限值

寬限值是一個比較偏進階、通常不太需要調整的選項。

它是用來細分間隔值的額外設定，決定在間隔重設之前，  
能量速率可以維持在「零」多少刻（_1 秒 = 20 刻_）。

在一個間隔期間內，能源供應有可能暫時停止。

這種情況下，流量只會在整個間隔完全結束後才被設為零。

當你使用較長的間隔值時，這會讓中斷變得較難以察覺。

寬限值的預設值是 **5 刻（0.25 秒）**。

這表示流經<ItemLink id="meter" components="rarity=epic"/>的能量流動，最多可以連續 5 刻為零。

若第 6 刻仍然沒有能量傳輸，這個間隔就會提早結束。

因此，這個選項只有在間隔值大於 5 刻時才真正有意義。

寬限值採用「包含本數」的計算方式。

若設定為 5，表示能量可以缺席 5 刻；只有到了第 6 刻，間隔才會被重設。

這個選項在使用非常長的間隔值、又想提早偵測能量流失時特別有用。

例如，若間隔值設為 **400 刻（20 秒）**，你可能會想把寬限值設為 **50 刻（2.5 秒）**。

這樣一來，你就能在 2.5 秒後就發現供電中斷，而不是最多得等到 20 秒。

這在使用「平滑」測量模式時尤其實用，因為那種模式下的流量歸零會更慢。

<br clear="all" />

---

# 圖表面板

<FloatingImage src="assets/graph_tab.png" align="right"/>

切換到**圖表**分頁後，就能開啟圖表面板。

它會以圖形方式顯示最近 10 個間隔的結果。

資料會顯示在一個簡單的座標系中。

**x 軸**代表最近的各個間隔，**y 軸**則顯示每個間隔的平均流量。

為了讓圖表上的點更容易閱讀，y 軸的最大值永遠會比最大間隔值再高出 **10%**。

若現有資料少於 10 個間隔，就只會顯示目前已有的那些間隔。

當前間隔還在進行時，圖上只會先顯示一條水平線；等到該間隔的結果產生後，對應的圖表點才會出現。

若你想更方便地查看資料，可以使用右上角的按鈕暫停圖表。

暫停只會停止圖表的視覺顯示，內部仍會持續處理新資料，能量儀表本身也會繼續運作。

圖表內會顯示一個標籤，提示目前已暫停。再次按下按鈕即可恢復圖表。

<br clear="all" />

---

# 紅石面板

紅石面板目前仍在開發中，尚未提供任何選項。
