Read text / OCR
Read a selected area, filter the output and store it in variables. Use local engines or choose Gemini/OpenRouter for suitable OCR tasks.
Keep settings readable.
This is a 3× capture of the actual English module panel. Open it and select Inspect full size to read the details.
In an original game scene
An illustrative composition with no third-party game assets. The product panel is real; the composition is not proof of an end-to-end commercial-game task.
When to use it
Read a selected area, filter the output and store it in variables. Use local engines or choose Gemini/OpenRouter for suitable OCR tasks.
Settings and options
Engine
Windows, Paddle or AI. Local Windows/Paddle modes do not use a remote OCR API; AI sends the selected region to its provider.
AI provider
Gemini or OpenRouter. Configure the key, model and reading prompt in Settings; never place an API key in a macro.
Reading region
SearchRegion is required. Crop closely around the text and exclude decoration or unrelated lines.
Language / scale / invert
Choose language, scale 1–3, inversion and accuracy options by comparing real previews.
Find text
If populated, only lines containing this text are selected. Leave empty for general reading.
Confidence
Only meaningful for engines that provide a score. Windows OCR and AI do not provide a genuine confidence score.
Output prefix
Npc produces Npc_Text, Npc_Found and Npc_Ms. Inspect the text before numeric conversion.
Transfer
Select the destination and order Text, Enter and Tab. Empty or failed readings are not sent.
Step-by-step setup
- Select the engine and target window.
- Pick the text region and preview it.
- Set the prefix and optional filter.
- Test the output before branching or transferring it.
Practical examples
Read a numeric value
- Select only the digits.
- Use the Price prefix.
- Convert with NUMBER(TRIM(Price_Text)) and handle errors.
Copy a label to a form
- Read the source label.
- Select the destination in Transfer.
- Use Text, Tab and test with sample data.
Explore the interface
Tips and troubleshooting
- AI provider quota, pricing and latency are separate from the JAQ account.
- Inspect the actual recognized text, not just the appearance of the screenshot.
- Handwriting and decorative game fonts have no accuracy guarantee.
See shared step settings for targeting, results, timeouts and preconditions, and the formula library for expressions.