# Interface Overview

Learn about the OCR interface components and how to use them for capturing and translating text from your game screen.

The OCR interface layout depends on the **output method** you selected when starting OCR:

* **Extra Window** - The interface shows the **Capture Area** and the **Side Toolbar** (right side)
* **Hyper Overlay** - The interface shows the **Overlay Toolbar** (left side), the **Capture Area**, and the **Side Toolbar** (right side)

<figure><img src="/files/8cxYWoimeUZoahc8nvZi" alt=""><figcaption></figcaption></figure>

## Capture Area

The Capture Area is a transparent overlay window that defines which part of your screen will be captured for OCR text recognition.

**How to Use:**

* Position the Capture Area over the dialogue text box in your game
* Resize the window to fully cover the text area
* Make sure the Capture Area includes only the text - avoid capturing UI buttons, character sprites, or background elements
* Once positioned, the Capture Area will automatically detect and capture text when **Auto Capture** is enabled

**Tips:**

* Leave a small margin around the text to ensure all characters are captured correctly
* Avoid capturing unnecessary parts of the screen, as this can reduce OCR accuracy

***

## Overlay Toolbar

{% hint style="info" %}
The Overlay Toolbar is only available when using **Hyper Overlay** as the output method. It will not appear when using Extra Window.
{% endhint %}

The Overlay Toolbar appears on the **left side** of the Capture Area and provides controls for managing how the translated text is displayed directly on your game screen.

#### **Hyper Overlay Toggle**

Turns Hyper Overlay on or off without stopping the OCR session.

#### **Text Styles**

<figure><img src="/files/8YRIpkOdHXtJifYOpiBH" alt=""><figcaption></figcaption></figure>

* **Auto Text Size:** Automatically adjusts the text size to fit within the recognized text area
* **Auto Text Color (B/W):** Automatically sets the text color to black or white based on the background for better readability
* T**ext Size:** Manually sets the text size. Only available when **Auto Text Size** is disabled
* **Min. Text Size:** Sets the minimum text size limit when **Auto Text Size** is enabled
* **Max. Text Size:** Sets the maximum text size limit when **Auto Text Size** is enabled
* **Font:** Sets the font used for the displayed translation text
* **Text Color:** Manually sets the text color. Only available when **Auto Text Color** is disabled

#### **Background**

Controls the background displayed behind the translated text on screen.

* **None:** No background
* **Default:** Applies a blur effect and removes the original text from the background for a cleaner overlay
* **Solid:** Displays a solid color background behind the translated text. You can adjust the color and opacity

#### Text Segmention (N/A)

...

#### **Clear All Text**

Removes all translated text currently displayed on the Hyper Overlay.\
This does not stop OCR - it only clears the overlay text that is currently visible on screen.

***

## Side Toolbar

The Side Toolbar appears on the **right side** of the Capture Area and provides quick access to OCR controls and settings.

#### Capture

Manually triggers a screen capture and sends it to the OCR engine for text recognition.

* Hotkey: **Ctrl + Space** (default)

#### Smart Capture (right-click the Capture button to access settings)

<figure><img src="/files/30BOJrLi6Wy3oqM1ASUZ" alt=""><figcaption></figcaption></figure>

Smart Capture adds intelligent detection before triggering OCR, helping to reduce unnecessary captures and improve accuracy.

* **Change Detection** - Only triggers a capture when the screen content has changed significantly:
  * **Min. Threshold (%):** Minimum percentage of screen change required to trigger a capture
  * **Max. Threshold (%):** Maximum percentage of screen change allowed before a capture is triggered
* **Stability Detection** - Waits until the screen content has been stable before triggering a capture:
  * **Min. Stable Duration (ms):** Minimum time (in milliseconds) the screen must remain unchanged before a capture is triggered
  * **Max. Wait Time (ms):** Maximum time (in milliseconds) to wait for the screen to stabilize before forcing a capture

#### Auto Capture

Automatically captures and processes text at regular intervals.

* Continuously monitors the Capture Area for new or changed text
* Hotkey: **Ctrl + Shift + A** (default)

#### Pre-processing

Opens image enhancement settings that are applied to the captured image before it is sent to the OCR engine.

* Adjust settings such as brightness, contrast, threshold, and filters
* Helps improve OCR accuracy, especially when using traditional OCR engines (Tesseract OCR, Windows OCR)

For more details, see [Pre-processing](https://docs.vntranslator.com/user-guide/ocr/pre-processing)

#### OCR Engine

Opens the OCR engine selection panel, allowing you to switch to a different OCR engine or language without restarting.

For a full list of available engines, see [OCR Engines](https://docs.vntranslator.com/user-guide/ocr/ocr-engines)

#### Capture Area / Screen Capture (Mouse Click-Through)

Toggles whether mouse clicks pass through the Capture Area window to the game beneath it.

* **ON** (default) - The Capture Area works normally and can be moved and resized using the mouse
* **OFF** - The Capture Area is locked in place and cannot be moved. Mouse clicks pass through to the game window, allowing you to interact with your game normally

#### Set Region

Allows you to redefine the Capture Area by drawing a new region directly on the screen.

* Hotkey: **Ctrl + Shift + R** (default)

***

## Status Bar

The Status Bar is displayed at the bottom of the Capture Area window and shows real-time information about the current OCR session.

**Information displayed:**

* Current Display Settings
* Capture Area Coordinates
* OCR Processing Status


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.vntranslator.com/user-guide/ocr/interface-overview.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
