Herramienta de diccionario de matriz de puntos

La herramienta de diccionario de matriz de puntos permite convertir texto o gráficos de una imagen en datos de matriz de puntos reutilizables. Resulta especialmente útil cuando el texto de una captura no es texto normal y no se puede capturar como elemento de texto.

Abrir la herramienta

Abre primero Espacio de trabajo de muestras y cambia a la página Herramienta de diccionario de matriz de puntos. También puedes abrir una captura en el selector de color y cambiar después a esta herramienta para seguir usando la misma imagen.

Crear una matriz de puntos de un carácter

1. Abre una captura que contenga el texto o gráfico deseado.
2. Haz clic en el color del texto en la imagen original para añadirlo a Lista de colores de desviación de binarización.
3. Si es necesario, ajusta la Tolerancia predeterminada o edita directamente un rango de colores como RRGGBB-RRGGBB.
4. Haz clic en Binarizar hasta que la vista previa binarizada conserve únicamente, en la medida de lo posible, el texto o gráfico deseado.
5. Usa Shift y arrastra para encuadrar un carácter. Para una segunda selección, arrastra con Meta/Ctrl.
6. Introduce el carácter en Texto, por ejemplo A o B.
7. Haz clic en Enviar/actualizar; la matriz de puntos aparecerá en Lista de matrices de puntos.

En pantallas táctiles o dispositivos móviles, puedes cambiar el modo de selección con los botones Selección Shift y Selección Meta.

Separar una fila de texto

Si la captura contiene una fila de caracteres, encuadra primero toda la fila y haz clic en Separar. La herramienta dividirá la fila en varias matrices de puntos según las columnas vacías.

Antes de separar, comprueba que la vista previa binarizada esté suficientemente limpia: el fondo debe quedar lo más vacío posible y el texto lo más completo posible. Si el resultado no es satisfactorio, ajusta el número mínimo de columnas de separación o usa primero Ajustar selección para que la selección se adapte al contenido.

Entender el resultado

• Binarizar: convierte la imagen en una vista previa en blanco y negro que conserva solo los colores deseados.
• Rango de desviación de color: permite un pequeño margen de error de color para evitar perder puntos por el suavizado de la captura.
• Lista de matrices de puntos: entradas del diccionario ya organizadas.
• Copiar: copia la línea de codificación de la matriz actual para pegarla en un diccionario existente.
• Exportar: copia o descarga la lista completa de matrices de puntos para hacer una copia de seguridad o importarla en otro proyecto.
• Plantillas de código → Copiar código: genera un fragmento de script con el rango de colores, la selección y la lista de matrices actuales para pegarlo directamente en un script.
• Desplazamiento izquierdo / Desplazamiento derecho: deja espacio a ambos lados del carácter; normalmente basta con conservar el valor predeterminado.

Guardar una imagen de matriz de puntos

Para guardar la vista previa de la matriz de puntos como imagen:

1. Haz clic en Guardar imagen de matriz de puntos.
2. Introduce el nombre del archivo.
3. Comprueba el Código generado.
4. Selecciona la ubicación de guardado.
5. Haz clic en Guardar o en Copiar código y guardar imagen.

Al seleccionar Copiar código y guardar imagen, el código para cargar la imagen se copiará al portapapeles. Normalmente se pega en el script donde se necesita cargar el recurso.

La plantilla de código de Guardar imagen de matriz de puntos se guarda por separado de la plantilla de imágenes de región del selector de color. Admite la variable de nombre de archivo $imgFileBaseName y todas las variables de las plantillas de código de matrices de puntos:

• Selección Shift: $shiftRect.left, $shiftRect.top, $shiftRect.right, $shiftRect.bottom.
• Selección Meta: $metaRect.left, $metaRect.top, $metaRect.right, $metaRect.bottom.
• Contenido de la matriz de puntos: $colorRange, $matrix, $matrixList, $word.

Probar plantillas en un dispositivo

Configura el dispositivo de prueba de desarrollo actual en el editor de texto o desde el menú contextual del dispositivo y pulsa el botón de prueba situado a la izquierda de Copiar. Se admiten las cinco plantillas de color, find_image, load_data e imágenes de región, además de las seis plantillas y las imágenes de matriz. Ambas herramientas usan el dispositivo de prueba de desarrollo actual y siguen sus cambios de inmediato. El dispositivo de captura y las selecciones de la lista de dispositivos o grupos no cambian el destino de la prueba. Si no hay un dispositivo actual configurado o no está disponible, configura uno disponible desde esos mismos menús.

El lápiz junto al título permite editar el nombre, código original, envoltura de prueba y vistas previas. Las matrices usan su editor habitual. Los cambios se guardan automáticamente, incluso al cerrar con Escape. Los nombres vacíos de las plantillas 1–5 usan el valor predeterminado del idioma actual; una envoltura vacía desactiva la prueba. Restablecer recupera juntos nombre, código y envoltura.

$code inserta el código generado sin volver a expandir su contenido. $screenOrient indica la orientación de captura, con valor predeterminado 0; las matrices también admiten $coreLine. Las pruebas de imagen admiten $testResourceRoot y $testImagePath y envían el PNG actual sin guardarlo localmente primero.

La prueba abre los registros del editor y conserva archivos, registros anteriores y contenido del espacio de trabajo. El código se envía cuando la conexión de registros está lista; allí aparecen resultados y errores. Finaliza primero cualquier ejecución o depuración activa. Si el envío no está confirmado, consulta los registros antes de reintentar.

OCR y FindStr cargan automáticamente la lista matricial actual. $matrixListLiteral genera una cadena Lua segura con comillas, saltos de línea y caracteres especiales. Solo se actualizan los valores antiguos sin modificar; se conserva el código personalizado. La prueba usa el mismo contenido que Copiar código: código completo o línea principal si está vacío.

Problemas habituales

• La vista previa binarizada está vacía: vuelve a hacer clic en el color deseado o amplía la tolerancia adecuadamente.
• El fondo y el contenido están invertidos: cambia el modo de color de fondo y vuelve a extraerlos.
• El resultado de la separación es 0: confirma que la selección cubra el texto deseado, que el rango de colores esté marcado y que el número mínimo de columnas de separación no sea demasiado grande.
• Los datos de la matriz de puntos no son válidos: comprueba que el contenido importado tenga una entrada por línea o vuelve a extraerlo de la selección.