跳至主要內容

點陣字庫工具

點陣字庫工具適合把圖片中的文字或圖形整理成可重複使用的點陣資料。它常用於截圖中的文字不是一般文字、無法用文字元素擷取時。

開啟工具​

先開啟 樣本工作台,切換到 點陣字庫工具 頁。也可以先在取色器中開啟截圖,再切換到點陣字庫工具繼續使用同一張圖。

做一個單字點陣​

  1. 開啟帶有目標文字或圖形的截圖。
  2. 在原圖上按一下目標文字顏色,把顏色加入 二值化偏色清單。
  3. 必要時調整 預設容差,或直接編輯類似 RRGGBB-RRGGBB 的顏色範圍。
  4. 按一下 二值化,直到二值化預覽中盡量只剩目標文字或圖形。
  5. 用 Shift 拖曳框住單個字。需要第二組選取範圍時,用 Meta/Ctrl 拖曳。
  6. 在 文字 中填寫這個字,例如 A 或 阿。
  7. 按一下 提交/更新,點陣會出現在 點陣清單 中。

觸控螢幕或行動裝置可以用 Shift選取範圍、Meta選取範圍 按鈕切換選取範圍模式。

拆分一排文字​

如果截圖中有一排字,可以先框住整排,再按一下 拆分。工具會按空列把一排字拆成多條點陣。

拆分前建議先確認二值化預覽足夠乾淨:背景盡量為空,文字盡量完整。拆分結果不理想時,可以調小或調大最小間隔列數,或者先用 選取範圍適應 讓選取範圍貼合內容。

看懂結果​

  • 二值化:把圖片變成只保留目標顏色的黑白預覽。
  • 偏色範圍:允許顏色有一點誤差,避免截圖抗鋸齒導致漏點。
  • 點陣清單:已經整理好的字庫項目。
  • 複製:複製目前點陣編碼行,適合貼到已有字庫中。
  • 匯出:複製或下載整份點陣清單,適合備份或匯入到其他專案。
  • 程式碼範本 → 複製程式碼:把目前顏色範圍、選取範圍和點陣清單產生為腳本片段,適合直接貼到腳本中。
  • 左偏移 / 右偏移:在字元左右留白,通常保持預設即可。

儲存點陣圖​

需要把點陣預覽儲存為圖片時:

  1. 按一下 儲存點陣圖。
  2. 輸入檔名。
  3. 檢查 產生的程式碼。
  4. 選擇儲存位置。
  5. 按一下 儲存,或按一下 複製程式碼並儲存影像。

選擇 複製程式碼並儲存影像 時,會把載入該圖片的程式碼複製到剪貼簿。通常把它貼到腳本中需要載入資源的位置。

儲存點陣影像中的程式碼範本與取色器的區域影像範本分別儲存。它支援檔名變數 $imgFileBaseName,也支援點陣程式碼範本的全部變數:

  • Shift 選取範圍:$shiftRect.left、$shiftRect.top、$shiftRect.right、$shiftRect.bottom。
  • Meta 選取範圍:$metaRect.left、$metaRect.top、$metaRect.right、$metaRect.bottom。
  • 點陣內容:$colorRange、$matrix、$matrixList、$word。

在裝置測試範本​

在文字編輯器或裝置右鍵選單設定目前開發測試裝置,再點擊「複製」左側的「在裝置測試」。取色器支援 5 個範本、find_image、load_data 和儲存區域影像;點陣頁支援 6 個範本和點陣影像。兩頁統一使用目前開發測試裝置,切換後立即跟隨;截圖裝置、裝置清單和群組的勾選不會改變測試目標。尚未設定或裝置無法使用時,請先透過上述入口設定可用裝置。

按取色器範本標題旁的鉛筆圖示可編輯名稱、原始程式碼、測試包裝並預覽結果;點陣沿用原有編輯視窗。修改自動儲存,關閉或 Escape 保留修改。範本 1~5 的空名稱顯示目前語言的預設名稱;空測試包裝會停用測試。還原預設會一併還原名稱、程式碼與測試包裝。

$code 插入目前產生的程式碼,內容不會再次展開變數。$screenOrient 是截圖方向,預設 0;點陣另可使用 $coreLine。圖像測試支援 $testResourceRoot 與 $testImagePath,可直接傳送目前 PNG,不必先儲存至本機。

測試會開啟編輯器並展開裝置日誌,保留檔案、既有日誌與工作台內容。日誌連線就緒後才傳送,結果與錯誤顯示於日誌。裝置或編輯器有執行、偵錯工作時,請先結束工作。傳送結果未確認時,先查看日誌再決定是否重試。

OCR、FindStr 預設自動載入目前點陣清單。$matrixListLiteral 會產生可安全嵌入 Lua 的字串,支援引號、換行與特殊字元。僅未修改的舊預設程式碼會升級;自訂程式碼保持不變。測試與複製程式碼使用相同內容,優先完整程式碼,空時使用核心行。

常見問題​

  • 二值化預覽為空:重新按一下目標顏色,或適當擴大容差。
  • 背景和內容反了:切換底色模式後重新提取。
  • 拆分結果為 0:確認選取範圍覆蓋了目標文字、顏色範圍已勾選、最小間隔列數沒有設定過大。
  • 提示點陣資料無效:檢查匯入內容是否每行一條,或重新從選取範圍提取。