カラーピッカー
カラーピッカーは、デバイスのスクリーンショットや画像から、スクリプトで使用する座標、色、範囲を記録するのに適しています。初めて使用するときは、まず簡単な操作を試してください。スクリーンショットを開き、対象位置をクリックして、座標と色をスクリプトへコピーします。
カラーピッカーと画像を開く
主な開き方：
- メイン画面のその他のツールまたはアクションから
サンプルワークベンチを開くと、既定でカラーピッカーページが表示されます。 - デバイス一覧でデバイスを右クリックし、
スクリーンショットを取得してカラーピッカーで開くを選択します。 - リモート操作パネルで現在の画面をキャプチャし、カラーピッカーで開くことを選択します。
- ファイルマネージャーまたは開発プロジェクトの画像プレビューで、
カラーピッカーで開くをクリックします。 - サンプルワークベンチを先に開き、ローカル画像をキャンバス領域へドラッグするか、ワークベンチがアクティブなときにクリップボードの画像を貼り付けます。
サンプルワークベンチでは、複数の画像タブを同時に開けます。異なるスクリーンショットを処理するときは、上部のタブを切り替える、ドラッグして順序を調整する、不要になったタブを閉じるといった操作ができます。
1 つのポイントを記録する
- 画像を開いた後、マウスホイールで拡大・縮小し、左ボタンを押したまま画面をドラッグして、対象位置をクリックしやすい大きさまで拡大します。
- 画像上でマウスを動かすと、拡大鏡に現在の座標と色が表示されます。
- 対象位置をクリックすると、そのポイントが
ポイント色一覧へ追加されます。 ポイント色一覧で座標と色の値を確認し、スクリプトへコピーして使用します。- よく使うポイントをいくつか固定する場合は、
ポイント色記録を使用します。画像へマウスを合わせて1～5を押すと、対応する記録位置へ書き込まれます。
ランダムに色を取得 は、選択範囲内に複数のカラーポイントを自動生成し、複数ポイントで色を比較する場合に適しています。コードテンプレート は、取得済みの座標、色、範囲をスクリプト断片へ変換します。コピーしてスクリプトへ直接貼り付け、必要に応じて調整できます。
範囲を選択して小さな画像を保存する
スクリプトで画像の一部分を認識する場合は、先に範囲を選択してから保存できます。
Shiftを押しながらドラッグして、通常の選択範囲を作成します。- 2 つ目の範囲が必要な場合は、
Meta/Ctrlを押しながらドラッグして、別の選択範囲を作成します。 コードテンプレートで範囲画像を保存をクリックします。- ファイル名を入力します。
- 保存先として、
小画像の保存パス、プロジェクトパス/res/、ダウンロードのいずれかを選択します。 コードをコピーして画像を保存をクリックします。
これにより範囲画像が保存され、対応するコードがクリップボードへコピーされます。通常は、画像を検索または小さな画像を読み込む箇所へコードを貼り付けます。
範囲画像の保存テンプレート は、ドットマトリクス画像のテンプレートとは別に保存されます。ファイル名変数 $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 を直接送れます。
テスト時はエディターのデバイスログを開き、ファイル、既存ログ、作業内容を保持します。ログ接続後にコードを送り、結果とエラーをログに表示します。実行中のスクリプトやエディターの実行・デバッグは先に終了してください。送信結果が不明な場合は、再試行前にログを確認してください。
よくある問題
- スクリーンショットの取得に失敗：デバイスがオンラインでライセンス認証済みであり、デバイス自体でスクリーンショットを正常に取得できることを確認します。
- 画像を貼り付けても反応しない：クリップボードの内容が画像であることを確認し、サンプルワークベンチをアクティブにしたまま貼り付けます。
- ローカルの指定パスへの保存に失敗：先に
システム設定でローカル保存に関する権限を有効にする必要があります。有効でない場合は、ダウンロードを選択してブラウザのダウンロードディレクトリへ保存できます。 - コピーに失敗：コード欄または座標テキストを手動で選択してからコピーできます。
同じスクリーンショットからドットマトリクスを作成するか、テキスト要素を取得する場合は、ドットマトリクス辞書ツールまたはテキスト要素取得ツールへ切り替えます。