Coordenadas do Retângulo para Detecção de Região OCR

Updated: 29 de junho de 2026

Vários métodos do IronOCR aceitam um Rectangle para que você possa executar OCR em uma única parte da imagem em vez de toda. Os quatro valores necessários, x, y, width e height, podem ser lidos diretamente do Microsoft Paint.

O construtor é assim:

Rectangle(int x, int y, int width, int height, MeasurementUnits units = MeasurementUnits.Pixels)

Rectangle(int x, int y, int width, int height, MeasurementUnits units = MeasurementUnits.Pixels)

Cada parâmetro mapeia para uma medida:

x: distância da borda esquerda da imagem até o início da sua região.
y: distância da borda superior da imagem até o início da sua região.
width: largura da região que você deseja ler.
height: altura da região que você deseja ler.
MeasurementUnits.Pixels: indica ao IronOCR que os valores estão em pixels.

As coordenadas começam no canto superior esquerdo da imagem: x cresce para a direita, y cresce para baixo.

Sistema de coordenadas mostrando origem no canto superior esquerdo com X crescendo para a direita e Y crescendo para baixo

Antes de começar, você precisa do Microsoft Paint (ou qualquer editor que mostre a posição do cursor e o tamanho da seleção em pixels), da imagem que deseja ler e do IronOCR adicionado ao seu projeto.

Solução

1. Leia o Ponto de Início X e Y

Abra a imagem no Microsoft Paint, depois mova o cursor para o canto superior esquerdo da região que você deseja ler. A posição do cursor aparece no canto inferior esquerdo da janela. Uma leitura de 2403, 1653px oferece o início da região:

Barra de status do Microsoft Paint mostrando coordenadas do cursor 2403, 1653px no canto superior esquerdo da região OCR

X = 2403
Y = 1653

X = 2403
Y = 1653

Text

2. Leia a Largura e Altura

Mude para a ferramenta Selecionar e arraste uma caixa sobre o texto alvo. O Paint informa o tamanho da seleção no canto inferior esquerdo. Uma leitura de 1031 × 214px é as dimensões da sua região:

Seleção do Microsoft Paint em torno do texto Testing123 com barra de status mostrando o tamanho da seleção 1031 x 214px

Width = 1031
Height = 214

Width = 1031
Height = 214

Text

3. Construa o Retângulo

Com os quatro valores em mãos, construa o Rectangle. Para a região Testing123 acima:

var rectangle = new Rectangle(2403, 1653, 1031, 214, MeasurementUnits.Pixels);

var rectangle = new Rectangle(2403, 1653, 1031, 214, MeasurementUnits.Pixels);

4. Pass It to IronOCR

Entregue o retângulo para LoadImage para recortar a entrada até essa região antes de executar o OCR:

var rectangle = new Rectangle(2403, 1653, 1031, 214, MeasurementUnits.Pixels);
ocrInput.LoadImage(frame, rectangle);

var rectangle = new Rectangle(2403, 1653, 1031, 214, MeasurementUnits.Pixels);
ocrInput.LoadImage(frame, rectangle);

Dicas de Depuração

O valor 1031 × 214px na barra de status é a largura e altura da seleção, não uma coordenada.
A leitura do cursor 2403, 1653px é o ponto de partida X e Y, significando o canto superior esquerdo da região.
O Paint relata em pixels, então passe MeasurementUnits.Pixels para corresponder.
Ler os valores a olho deixa-os deslocados por alguns pixels. Se o recorte cortar parte do texto, alargue width ou height ligeiramente, ou abaixe x ou y.

Cuidado: Não use o tamanho total da imagem, como 4960 × 7014px, como o tamanho do retângulo. Isso seleciona a imagem inteira em vez da sua região.

Curtis Chau

Converse agora mesmo com a equipe de engenharia.

Redator Técnico

Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais bem estruturados e visualmente atraentes.

...