OCR Recognize Screen Region

OCR Recognize Screen Region

Tipo: ocr-recognize-region  ·  Paquete: OCR Activities v1.2.5  ·  Salida: string

Captura un área rectangular de la pantalla y reconoce el texto que contiene. Útil para leer datos de una aplicación que no expone su texto de forma accesible (un visor de imágenes, un control personalizado, contenido dibujado) cuando los selectores de Desktop no llegan.

Cómo funciona

Captura la región definida por x, y (esquina superior izquierda) y width, height (tamaño), en píxeles de pantalla, y la pasa por OCR. Requiere una sesión de escritorio interactiva: se captura lo que está visible en ese momento, así que la ventana debe estar al frente y sin otras ventanas encima.

• Las coordenadas se cuentan desde la esquina superior izquierda de la pantalla principal; con varios monitores, las pantallas a la izquierda o arriba de la principal tienen coordenadas negativas.
• Esta actividad no tiene preprocesado. Si la captura sale con errores, guarda una imagen con Win Screenshot y léela con OCR Recognize File y preprocess = "auto".

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
x	int	—	Coordenada izquierda del área (px).
y	int	—	Coordenada superior del área (px).
width	int	—	Ancho del área (px). Debe ser mayor que cero.
height	int	—	Alto del área (px). Debe ser mayor que cero.

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
language	string	"eng"	Idioma del texto: código de Tesseract (eng, spa, eng+spa) o etiqueta regional (es-CO, en-US). Ver idioma.

Salida

Devuelve un string con el texto reconocido en esa región. Si no hay texto legible, devuelve una cadena vacía o con solo saltos de línea.

Ejemplo

OCR Recognize Screen Region   x = 100   y = 250   width = 400   height = 60   language = "spa"   → output: saldo
Set Variable   name = saldoNumero   value = regexFind(saldo, "[\d.,]+")

Coordenadas fijas = frágil

Leer por coordenadas de pantalla depende de la resolución y de que la ventana esté siempre en el mismo lugar. Siempre que el control sea accesible, prefiere Win Get Text (Desktop), que es mucho más robusto. Usa OCR de pantalla solo cuando no haya alternativa.

Errores comunes

Mensaje	Causa y solución
'width' y 'height' deben ser mayores que cero.	El tamaño del área es 0 o negativo.
'x' es obligatorio. (igual para y, width, height)	Falta una de las coordenadas.
No se encontró el idioma de Tesseract '…' en '…'. Disponibles: [eng, spa].	El código de language no está instalado.
Error al capturar la pantalla	No hay un escritorio interactivo (sesión bloqueada o sin usuario conectado). Ejecuta el robot en una sesión con escritorio activo.

Actividades relacionadas

• OCR Screenshot — leer toda la pantalla.
• OCR Find Text — encontrar la posición de un texto en pantalla.
• Win Get Text — alternativa robusta vía UIA.