跳至主要內容

取色器

取色器適合從裝置截圖或圖片中記錄腳本會用到的座標、顏色和區域。第一次使用時,可以先完成一個簡單目標:開啟截圖,點一下目標位置,將座標和顏色複製到腳本裡。

開啟取色器和圖片​

常見入口:

  • 在主介面更多工具或動作入口中開啟 樣本工作台,預設進入 取色器 頁。
  • 在裝置清單中右鍵裝置,選擇 截圖並用取色器開啟。
  • 在遠端控制面板中截取目前畫面後,選擇用取色器開啟。
  • 在檔案管理員或開發專案圖片預覽中,按一下 用取色器開啟。
  • 先開啟樣本工作台,再把本機圖片拖到畫布區域,或在工作台作用中時貼上剪貼簿中的圖片。

樣本工作台支援同時開啟多個圖片標籤。處理不同截圖時,可以在頂部標籤間切換、拖曳調整順序,或關閉不再需要的標籤。

記錄一個點位​

  1. 開啟圖片後,用滑鼠滾輪縮放,按住左鍵拖曳畫面,把目標位置放大到容易點選。
  2. 在圖片上移動滑鼠,放大鏡會顯示目前座標和顏色。
  3. 按一下目標位置,點位會進入 點色清單。
  4. 在 點色清單 中檢視座標和顏色值,並複製到腳本中使用。
  5. 如果要固定幾個常用點,可以使用 點色記錄。滑鼠指向影像時按 1 到 5,會寫入對應記錄位。

隨機取色 用於在選取範圍內自動產生多個顏色點,適合需要多點比色的場景。程式碼範本 會把已取得的座標、顏色或區域套用成腳本片段,複製後可以直接貼到腳本中再視需要調整。

框選和儲存小圖​

當腳本需要辨識一小塊圖片時,可以先框選範圍再儲存:

  1. 按住 Shift 並拖曳,建立普通選取範圍。
  2. 需要第二個區域時,按住 Meta/Ctrl 並拖曳,建立另一組選取範圍。
  3. 在 程式碼範本 中按一下 儲存區域影像。
  4. 輸入檔名。
  5. 選擇儲存位置:小圖儲存路徑、專案路徑/res/ 或 下載。
  6. 按一下 複製程式碼並儲存影像。

這樣會同時儲存區域圖片,並把對應程式碼複製到剪貼簿。通常把程式碼貼到腳本中需要找圖或載入小圖的位置。

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

  • 點位與記錄:$pointInitList、$pointList、$recordInitList、$recordList、$point[n].x、$point[n].y、$point[n].c、$record[n].x、$record[n].y、$record[n].c。
  • 座標範圍:$xMin、$yMin、$xMax、$yMax、$xFirst、$yFirst。
  • 選取範圍:$shiftRect.left、$shiftRect.top、$shiftRect.right、$shiftRect.bottom、$metaRect.left、$metaRect.top、$metaRect.right、$metaRect.bottom。
  • 選取範圍影像資料:$shiftRectImgData、$metaRectImgData。

在裝置測試範本​

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

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

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

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

常見問題​

  • 截圖失敗:先確認裝置線上、已授權,並且裝置本身可以正常截圖。
  • 貼上圖片沒有反應:確認剪貼簿裡確實是圖片,再讓樣本工作台保持作用中後貼上。
  • 儲存到本機指定路徑失敗:需要先在 系統設定 中開啟本機儲存相關權限;沒有開啟時,可以選擇 下載 儲存到瀏覽器下載目錄。
  • 複製失敗:可以手動選取程式碼框或座標文字,再複製。

如果需要從同一張截圖繼續製作點陣或擷取文字元素,可以切換到 點陣字庫工具 或 文字元素擷取器。