Skip to main content

Bitmap Dictionary Tool

The Bitmap Dictionary Tool turns text or graphics in an image into reusable bitmap data. It is useful when screenshot text is not ordinary text and cannot be captured with Text Element Capture.

Open the Tool​

Open Sample Workbench, then switch to the Bitmap Dictionary Tool page. You can also open a screenshot in the Color Picker first, then switch to this page and continue with the same image.

Create One Character Bitmap​

  1. Open a screenshot that contains the target text or graphic.
  2. Click the target text color on the original image to add it to Binary Color Ranges.
  3. If needed, adjust Default Tolerance, or edit a color range such as RRGGBB-RRGGBB.
  4. Click Binarize until the binary preview keeps only the target text or graphic as much as possible.
  5. Hold Shift and drag to select one character. If you need a second selection, hold Meta/Ctrl and drag.
  6. Enter the character in Text, for example A or 阿.
  7. Click Submit/Update. The bitmap appears in the Bitmap List.

On touch or mobile screens, use the Shift Selection and Meta Selection buttons to switch selection modes.

Split a Row of Text​

If a screenshot contains a row of characters, select the whole row and click Split. The tool splits the row into multiple bitmap entries by empty columns.

Before splitting, make sure the binary preview is clean: the background should mostly disappear, and the characters should remain complete. If the result is poor, adjust the minimum empty-column count, or use Fit Selection before splitting.

Understand the Result​

  • Binarize: convert the image into a black-and-white preview that keeps the target colors.
  • Color Range: allow some color difference so anti-aliased screenshot pixels are not missed.
  • Bitmap List: the character entries you have collected.
  • Copy: copy the current encoded line, useful when pasting into an existing dictionary.
  • Export: copy or download the whole bitmap list, useful for backup or reuse in another project.
  • Code Templates → Copy Code: generate a script snippet from the current color range, selection, and bitmap list.
  • Left Offset / Right Offset: leave spacing around the character. Keep the defaults unless you know you need to adjust them.

Save a Bitmap Image​

When you need to save the bitmap preview as an image:

  1. Click Save Bitmap Image.
  2. Enter a file name.
  3. Review the generated code.
  4. Choose where to save it.
  5. Click Save, or click Copy Code and Save Image.

Copy Code and Save Image copies the image-loading code to the clipboard. Paste it where your script loads resources.

Save Bitmap Image supports the filename variable $imgFileBaseName and the following variables:

  • Shift selection: $shiftRect.left, $shiftRect.top, $shiftRect.right, and $shiftRect.bottom.
  • Meta selection: $metaRect.left, $metaRect.top, $metaRect.right, and $metaRect.bottom.
  • Bitmap content: $colorRange, $matrix, $matrixList, and $word.

Test templates on a device​

Set the development test device in the text editor or the device context menu, click “Test on device” beside the template, and check the result in the editor’s device log. Stop any running or debugging script before testing.

Edit the source code and test wrapper in the template editor and preview the generated result. Click “Restore default templates” to reset it.

$code inserts the generated original code without expanding its contents again. $screenOrient is the screenshot orientation, defaulting to 0; matrix templates also support $coreLine. Image tests support $testResourceRoot and $testImagePath and can send the current PNG directly without saving it locally first.

OCR and FindStr tests use the current matrix list. Use $matrixListLiteral to insert the list into a custom template.

Common Issues​

  • Binary preview is empty: click the target color again, or increase the tolerance.
  • Foreground and background are reversed: switch the background mode and extract again.
  • Split returns 0 entries: confirm that the selection covers the target text, the color range is enabled, and the minimum empty-column count is not too large.
  • Bitmap data is invalid: check that imported data has one entry per line, or extract again from a selection.