メインコンテンツへ移動

ドットマトリクス辞書ツール

ドットマトリクス辞書ツールは、画像内の文字や図形を再利用可能なドットマトリクスデータとして整理するのに適しています。スクリーンショット内の文字が通常のテキストではなく、テキスト要素として取得できない場合によく使用します。

ツールを開く​

サンプルワークベンチ を開き、ドットマトリクス辞書ツール ページへ切り替えます。先にカラーピッカーでスクリーンショットを開き、ドットマトリクス辞書ツールへ切り替えて同じ画像を引き続き使用することもできます。

1 文字のドットマトリクスを作成する​

  1. 対象の文字または図形を含むスクリーンショットを開きます。
  2. 元の画像で対象文字の色をクリックし、その色を 二値化の色範囲一覧 へ追加します。
  3. 必要に応じて 既定の許容差 を調整するか、RRGGBB-RRGGBB のような色範囲を直接編集します。
  4. 二値化 をクリックし、二値化プレビューに対象の文字または図形だけができるだけ残るようにします。
  5. Shift を押しながらドラッグして、1 文字を囲みます。2 つ目の選択範囲が必要な場合は、Meta/Ctrl を押しながらドラッグします。
  6. 文字 に、A や 阿 などの対象文字を入力します。
  7. 送信/更新 をクリックすると、ドットマトリクスが ドットマトリクス一覧 に表示されます。

タッチスクリーンやモバイル端末では、Shift 選択範囲、Meta 選択範囲 ボタンで選択モードを切り替えられます。

1 行の文字を分割する​

スクリーンショットに文字が 1 行並んでいる場合は、まず行全体を囲んでから 分割 をクリックします。空の列を境界として、1 行の文字が複数のドットマトリクスへ分割されます。

分割前に、二値化プレビューが十分に明瞭であることを確認してください。背景をできるだけ空にし、文字をできるだけ完全な状態にします。分割結果が不適切な場合は、最小間隔の列数を小さくするか大きくします。または、先に 選択範囲を内容に合わせる を使用して、選択範囲を内容へ合わせます。

結果の見方​

  • 二値化:対象の色だけを残した白黒プレビューへ画像を変換します。
  • 色範囲:色にある程度の誤差を許容し、スクリーンショットのアンチエイリアスによって点が欠けることを防ぎます。
  • ドットマトリクス一覧:整理済みの辞書項目です。
  • コピー:現在のドットマトリクスのエンコード行をコピーします。既存の辞書へ貼り付ける場合に適しています。
  • エクスポート:ドットマトリクス一覧全体をコピーまたはダウンロードします。バックアップや別のプロジェクトへのインポートに適しています。
  • コードテンプレート → コードをコピー:現在の色範囲、選択範囲、ドットマトリクス一覧からスクリプト断片を生成します。スクリプトへ直接貼り付ける場合に適しています。
  • 左オフセット / 右オフセット:文字の左右に空白を設けます。通常は既定値のままでかまいません。

ドットマトリクス画像を保存する​

ドットマトリクスのプレビューを画像として保存する場合:

  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。

デバイスでテンプレートをテスト​

テキストエディターまたはデバイスの右クリックメニューで開発テストデバイスを設定し、テンプレート横の「端末でテスト」をクリックします。結果はエディターのデバイスログで確認できます。テスト前に実行中またはデバッグ中のスクリプトを停止してください。

テンプレート編集画面で元のコードとテストラッパーを編集し、生成結果を確認します。初期状態に戻すには「テンプレートを既定に戻す」をクリックします。

$code は生成済みコードを挿入し、その内容を再展開しません。$screenOrient は撮影方向で既定は 0、ドットマトリクスでは $coreLine も使えます。画像テストでは $testResourceRoot と $testImagePath を使え、ローカル保存せず現在の PNG を直接送れます。

OCR と FindStr のテストでは現在のマトリックス一覧を使用します。カスタムテンプレートには $matrixListLiteral で一覧を挿入できます。

よくある問題​

  • 二値化プレビューが空:対象の色をもう一度クリックするか、許容差を適度に広げます。
  • 背景と内容が逆:背景色モードを切り替えてから、もう一度抽出します。
  • 分割結果が 0:選択範囲が対象文字を覆っていること、色範囲へチェックが入っていること、最小間隔の列数が大きすぎないことを確認します。
  • ドットマトリクスデータが無効と表示される:インポート内容が 1 行につき 1 件になっているか確認するか、選択範囲から再抽出します。