Matching Character Recognition

## Matching Character Recognition

Identify character information in a specified area of the image.

## Module Principle
Uses a template matching-based algorithm to process image data and identify corresponding characters.

### Algorithm Workflow
1. Create a template based on specific image features and mark it as specified character information.
2. Search for targets matching the template in the image through the template.
3. Find the character information corresponding to the matching target.

## Usage Scenarios
This module is commonly used in character recognition scenarios with fewer character types, stable character positions, and clear imaging.

### Pre-Sequence Modules
The pre-sequence module for this module is generally Camera Image Acquisition or Image Preprocessing modules.

## Train Characters
1. Click the Character Training button to open the character training interface as shown below.
![](/media/202602/训练工具_1771828821.png)
2. Move the yellow detection box to cover the character to be trained.
3. Specify the template character and similarity.
4. Click the Generate Template button to create a character template.

## Parameter Configuration Description
### Character Count Judgment
Judgment of the number of characters in the character recognition result.
### Character Training Method
* Generate Font Library: This module trains to generate a font library and uses the trained font library for recognition.
* Load Font Library: This module can only load an already trained font library for recognition.
### Minimum Similarity
* Please Select: No character selected to set similarity.
* All Characters: Modify the similarity of all characters to the specified value.
### Load Font Library Path
The trained font library used for recognition.
### Output Character on Detection Failure
The character to output when no character is identified.

![](/media/202602/位置调整_1770106939.png)
### Position Adjustment
Manually adjust ROI related parameters.

![](/media/202602/字符识别-显示设置_1772163568.png)
### Display Settings
Set ROI, character area, and character display related parameters.

![](/media/202602/排序参数_1771913029.png)
### Sorting Standard
* None: Do not sort the output.
* Letter Ascending: Sort recognition results in ascending order of letters and output.
* Letter Descending: Sort recognition results in descending order of letters and output.
* X Ascending: Sort recognition results in ascending order of the identified character's X coordinate and output.
* X Descending: Sort recognition results in descending order of the identified character's X coordinate and output.
* Y Ascending: Sort recognition results in ascending order of the identified character's Y coordinate and output.
* Y Descending: Sort recognition results in descending order of the identified character's Y coordinate and output.
* X Ascending_Y Ascending: Sort recognition results in ascending order of the X coordinate, and if X coordinates are close, sort in ascending order of the Y coordinate.
* X Ascending_Y Descending: Sort recognition results in ascending order of the X coordinate, and if X coordinates are close, sort in descending order of the Y coordinate.
* X Descending_Y Ascending: Sort recognition results in descending order of the X coordinate, and if X coordinates are close, sort in ascending order of the Y coordinate.
* X Descending_Y Descending: Sort recognition results in descending order of the X coordinate, and if X coordinates are close, sort in descending order of the Y coordinate.
* Y Ascending_X Ascending: Sort recognition results in ascending order of the Y coordinate, and if Y coordinates are close, sort in ascending order of the X coordinate.
* Y Ascending_X Descending: Sort recognition results in ascending order of the Y coordinate, and if Y coordinates are close, sort in descending order of the X coordinate.
* Y Descending_X Ascending: Sort recognition results in descending order of the Y coordinate, and if Y coordinates are close, sort in ascending order of the X coordinate.
* Y Descending_X Descending: Sort recognition results in descending order of the Y coordinate, and if Y coordinates are close, sort in descending order of the X coordinate.
### Sorting Interval
The threshold for considering two values as close during sorting.
### ROI Type
* Rotated Rectangle: A rectangle that can be moved, resized, and rotated. Its angle range is any value from 0 to 360 degrees.
### ROI Source
* Manual ROI: In this mode, this module can directly set ROI related parameters.
* Reference ROI: In this mode, this module cannot modify ROI related parameters and can only introduce them from the module above.
### Position Correction
* Disable: Do not adjust the position of the set ROI.
* Pose Correction: Adjust the position of the set ROI based on the input value.

## Output Description
### Run Result
Whether the character recognition was successful.
### Character Count
The number of characters identified.
### Character Output
The identified character result.
### Rotated Rectangle ROI
The ROI area of the identified character.

---

Click here to jump to the corresponding Chinese manual page: [Matching Character Recognition](/doc/157)