1. Qué es Scoreboard Vision
Scoreboard Vision es una aplicación de escritorio para Windows que convierte el contenido visual de un marcador deportivo en datos estructurados. Trabaja sobre vídeo continuo: recibe una señal, recorta la zona del marcador, analiza regiones independientes y mantiene sus valores disponibles para otros sistemas.
Está pensado para relojes, tanteos, períodos y textos mostrados con dígitos LED, siete segmentos o grafismos de retransmisión. El reconocimiento se ejecuta en segundo plano y solo publica una salida nueva cuando cambia un valor confirmado.
| Etapa | Qué ocurre |
|---|---|
| 1. Entrada | Se recibe vídeo desde Archivo, RTMP, NDI, OMT o Blackmagic DeckLink. |
| 2. Encuadre | Se recorta el marcador y el visor amplía esa zona para trabajar con precisión. |
| 3. Campos | Se dibuja una región para cada dato: tiempo, local, visitante, período u otro valor. |
| 4. OCR | Cada campo usa su tipo y motor de reconocimiento; los valores se estabilizan antes de confirmarse. |
| 5. Publicación | Los archivos scoreboard.json, scoreboard.csv, scoreboard.xml y scoreboard.txt se reemplazan de forma atómica. |
2. Funciones principales
Vídeo continuo: lectura sin capturas manuales y reconexión automática si la señal se interrumpe.
Fuentes profesionales: Archivo, RTMP, NDI, OMT y dispositivos Blackmagic DeckLink.
Recorte de marcador: reduce el área de análisis y amplía automáticamente la zona útil en el visor.
Campos editables: creación, selección, movimiento y redimensionado directamente sobre la imagen.
OCR por campo: el tipo de dato y el motor se pueden ajustar de forma independiente.
Procesado de imagen: alto contraste, inversión, niveles de negro y blanco, conectividad, erosión y dilatación.
Lectura rápida: intervalo configurable y análisis de las regiones cuya imagen ha cambiado.
Resultados en directo: valor y confianza por campo, además de métricas de OCR por segundo y latencia.
Salida multiformato: JSON, CSV, XML y TXT actualizados al confirmarse un cambio.
Proyectos reutilizables: guarda fuente, recortes, campos, filtros, formatos e intervalo OCR.
Licencia administrable: activación obligatoria, validación periódica y cambio de clave desde la cabecera.
3. Requisitos y preparación
| Componente | Recomendación |
|---|---|
| Sistema | Windows de 64 bits y resolución de pantalla suficiente para trabajar con el visor y la barra lateral. |
| Licencia | Clave válida de Scoreboard Vision. No existe modo de evaluación. |
| Red | Conectividad estable para activar/validar y para las fuentes IP. La primera validación debe realizarse en línea. |
| NDI | NDI Runtime 6 o NDI Tools instalados en el equipo. |
| OMT | Las bibliotecas oficiales de OMT se incluyen en el instalador. |
| DeckLink | Blackmagic Desktop Video con los componentes WDM/DirectShow y el controlador del dispositivo. |
| Tesseract | Opcional. Debe estar instalado si se elige Tesseract como motor de un campo. |
| Consejo de rendimiento Empieza con una región de marcador ajustada y campos pequeños. Cuantos menos píxeles irrelevantes procese el OCR, menor será la latencia y más estable la lectura. |
|---|
4. Activación y acceso
Scoreboard Vision necesita una licencia activada y validada al menos una vez. En el primer inicio aparece el diálogo de activación.
Comprueba que el equipo tiene acceso a Internet.
Introduce la clave de licencia facilitada para Scoreboard Vision.
Confirma la activación y espera la validación del equipo.
Cuando la licencia sea aceptada, se abrirá la interfaz principal.
| Funcionamiento sin conexión Después de una activación válida, el programa puede usar una tolerancia sin conexión de hasta 72 horas. Esta tolerancia no sustituye a la activación inicial y no crea una versión de evaluación. |
|---|
Desde la cabecera puedes abrir la web, acceder a Gestión de licencia o pulsar Cambiar licencia. Si una clave presenta un problema, el programa permite sustituirla y volver a activar.
5. Conocer la interfaz
| Zona | Función |
|---|---|
| Cabecera | Logo, enlaces web y de licencia, estado de conexión y botones Iniciar/Detener. |
| Pestaña Fuente | Tipo de entrada, dirección o dispositivo, descubrimiento, proyecto, vista previa e intervalo OCR. |
| Pestaña Campos | Recorte del marcador, lista de campos, región, tipo, motor y procesamiento manual. |
| Pestaña Salida | Carpeta de destino y selección de formatos JSON, CSV, XML y TXT. |
| Visor | Imagen original o procesada, recorte activo y regiones editables superpuestas. |
| Lectura en directo | Tabla con Campo, Valor y Confianza del último valor confirmado. |
| Ajuste de imagen | Controles para limpiar, binarizar y reforzar los caracteres antes del OCR. |
| Barra de estado | Avisos de conexión, búsqueda de señales, proyecto y escritura de salidas. |
6. Puesta en marcha rápida
En Fuente, selecciona Archivo, RTMP, NDI, OMT o Blackmagic DeckLink.
Indica la fuente. Para NDI, OMT y DeckLink, el programa busca señales automáticamente; también puedes pulsar Buscar señales.
Pulsa Iniciar señal y comprueba que la imagen se mueve de forma continua.
En Campos, pulsa Recortar marcador y arrastra sobre la zona completa del marcador.
Pulsa Añadir campo, asigna un nombre y elige su Tipo y Motor.
Pulsa Marcar región del campo y arrastra alrededor de los caracteres. Repite para cada dato.
Ajusta las regiones directamente en el visor: arrastra el interior para mover y los tiradores para redimensionar.
En Salida, elige la carpeta y activa los formatos necesarios.
Deja Lectura automática activada o usa Procesar ahora para una comprobación inmediata.
Guarda el proyecto para recuperar toda la configuración en la próxima sesión.
7. Configurar una fuente de vídeo
| Tipo | Cómo configurarlo | Uso habitual |
|---|---|---|
| Archivo | Pulsa Abrir archivo y selecciona MP4, MKV, AVI, MOV o TS. | Pruebas, calibración y análisis de grabaciones. |
| RTMP | Escribe la URL completa, por ejemplo rtmp://servidor/aplicacion/stream. | Emisiones y codificadores de streaming. |
| NDI | Selecciona el tipo; la búsqueda automática muestra las fuentes visibles en red. | Producción IP en directo. |
| OMT | Elige una señal descubierta o indica una dirección omt://servidor:puerto. | Flujos IP abiertos y baja latencia. |
| DeckLink | Selecciona la entrada detectada tras instalar Blackmagic Desktop Video. | Captura SDI/HDMI mediante hardware Blackmagic. |
| Cambio de tipo de fuente Al cambiar entre tipos, Scoreboard Vision limpia el campo Fuente. En NDI, OMT y DeckLink inicia una búsqueda automática para evitar reutilizar una dirección incompatible. |
|---|
Reconexión
Si una fuente continua se corta, el estado de la cabecera informa del problema y el sistema intenta volver a conectarse. Mantén la aplicación abierta y revisa la red, el emisor o el dispositivo si la señal no regresa.
8. Recortar el marcador
Inicia la señal y espera a que aparezca un fotograma válido.
Abre Campos y pulsa Recortar marcador.
Haz clic en una esquina exterior del marcador y arrastra hasta la esquina opuesta.
Suelta el ratón. El visor se amplía automáticamente al área recortada.
Si el encuadre no es correcto, repite la operación; el recorte anterior se sustituye.
| Encuadre recomendado Incluye todos los datos que vayas a leer, pero evita público, publicidad, líneas de pista y otros números. Deja un margen pequeño alrededor del marcador para absorber movimientos leves de cámara. |
|---|
9. Crear y editar campos
Un campo es una región del marcador asociada a un dato. Los nombres de campo se usan también como claves en los archivos de salida; conviene que sean breves, estables y sin duplicados.
Pulsa Añadir campo e introduce un nombre, por ejemplo tiempo, local, visitante o periodo.
Selecciona el campo en la lista.
Elige el Tipo que describe su contenido y el Motor OCR.
Pulsa Marcar región del campo y rodea únicamente sus caracteres.
Comprueba el rectángulo amarillo y la etiqueta del campo sobre el visor.
Mover y redimensionar
| Acción | Resultado |
|---|---|
| Clic sobre un campo | Lo selecciona y sincroniza la lista lateral. |
| Arrastrar dentro del rectángulo | Mueve la región sin cambiar su tamaño. |
| Arrastrar un tirador | Redimensiona desde el borde o la esquina elegida. |
| Icono de papelera | Elimina el campo seleccionado; el tooltip muestra Eliminar campo. |
| Precisión de la región Incluye la altura completa de los caracteres y un margen mínimo. No incluyas rótulos, separadores ajenos, dígitos vecinos ni bordes luminosos. |
|---|
10. Tipos de campo
| Tipo | Contenido esperado | Ejemplo |
|---|---|---|
| Reloj (formato automático) | Detecta el formato temporal apropiado. | 19:44 |
| Reloj HH:MM:SS | Horas, minutos y segundos. | 01:32:08 |
| Reloj MM:SS | Minutos y segundos. | 08:27 |
| Reloj MM:SS.f | Minutos, segundos y décimas. | 00:12.4 |
| Marcador / Tanteo | Puntuación numérica del equipo. | 82 |
| Período | Cuarto, set, parte o período. | 3 |
| Número | Valor numérico genérico. | 24 |
| Texto | Contenido alfanumérico. | LOCAL |
El tipo incorpora los caracteres permitidos y las reglas de normalización. Por ejemplo, un reloj prioriza dígitos y separadores temporales, mientras que Marcador / Tanteo evita letras.
11. Motores OCR
| Motor | Cuándo usarlo |
|---|---|
| Automático preciso (recomendado) | Primera opción para relojes y tanteos; combina lectura rápida y validación según el tipo de campo. |
| Siete segmentos (ultrarrápido) | Dígitos LED bien separados, estables y con segmentos claramente visibles. |
| EasyOCR rápido | Grafismos variados o caracteres que no siguen una matriz de segmentos. |
| Tesseract | Texto o tipografías convencionales; requiere instalación externa. |
| EasyOCR + Tesseract | Campos difíciles donde compensa comparar motores, con mayor coste de CPU y latencia. |
| Regla práctica Usa Automático preciso como punto de partida. Cambia únicamente el campo que falle; no es necesario que todos los campos compartan motor. |
|---|
12. Ajustar la imagen
El selector de Vista previa permite alternar entre Imagen procesada e Imagen original. Trabaja normalmente con la procesada para ver exactamente qué recibe el OCR y vuelve a la original para comprobar el encuadre.
| Control | Efecto | Cuándo tocarlo |
|---|---|---|
| Alto contraste | Convierte la imagen en una representación más limpia de fondo y caracteres. | Marcadores LED y grafismos con buen contraste. |
| Invertir colores | Intercambia claro y oscuro. | Cuando los caracteres quedan negros y el fondo blanco, o al revés de lo deseado. |
| Nivel negro | Determina qué tonos se consideran oscuros. | Para eliminar fondos, reflejos o ruido gris. |
| Nivel blanco | Determina qué tonos se conservan como claros. | Para recuperar segmentos débiles o evitar zonas quemadas. |
| Conectividad | Cierra pequeños huecos entre píxeles próximos. | Segmentos cortados o discontinuos. |
| Erosión | Reduce las zonas blancas. | Dígitos demasiado gruesos o unidos. |
| Dilatación | Aumenta las zonas blancas. | Trazos finos o incompletos. |
Método de ajuste recomendado
Activa Alto contraste y muestra Imagen procesada.
Ajusta primero Nivel negro y Nivel blanco hasta que los caracteres queden completos y el fondo limpio.
Usa Conectividad solo si hay pequeños cortes.
Añade Erosión o Dilatación en valores bajos; comprueba que no se unan dígitos vecinos.
Pulsa Procesar ahora y observa Valor y Confianza.
13. Lectura automática y rendimiento
Lectura automática ejecuta el OCR de forma periódica. Intervalo OCR acepta valores desde 40 hasta 5000 ms; un intervalo corto reacciona antes, pero aumenta el trabajo del procesador.
| Escenario | Intervalo inicial | Orientación |
|---|---|---|
| Reloj en directo | 80-150 ms | Prioriza respuesta rápida con campos pequeños. |
| Tanteos y período | 150-300 ms | Suficiente para cambios ocasionales. |
| EasyOCR + Tesseract | 300-1000 ms | Reduce carga; úsalo solo en campos que lo necesiten. |
| Calibración manual | Lectura automática desactivada | Usa Procesar ahora mientras ajustas filtros y regiones. |
| Estabilidad del valor Scoreboard Vision confirma lecturas repetidas antes de publicar un cambio. Esto evita que un único fotograma borroso sustituya inmediatamente un resultado correcto. |
|---|
14. Salida de datos
En Salida, selecciona una carpeta y marca uno o varios formatos. Cuando un valor confirmado cambia, los archivos se reemplazan de forma atómica para que una aplicación externa no lea contenido parcial.
| Formato | Archivo | Contenido |
|---|---|---|
| JSON | scoreboard.json | Objeto clave/valor, sencillo para APIs, overlays y automatización. |
| CSV | scoreboard.csv | Filas con field, text y confidence. |
| XML | scoreboard.xml | Elemento scoreboard con un nodo field por dato. |
| TXT | scoreboard.txt | Una línea nombre: valor por campo. |
Ejemplo JSON
| { "tiempo": "19:44", "local": "19", "visitante": "12" } |
|---|
Ejemplo CSV
| field,text,confidence tiempo,19:44,99.00 local,19,96.00 visitante,12,98.00 |
|---|
Ejemplo XML
| <?xml version='1.0' encoding='utf-8'?> <scoreboard> <field name="tiempo" confidence="99.00">19:44</field> <field name="local" confidence="96.00">19</field> <field name="visitante" confidence="98.00">12</field> </scoreboard> |
|---|
Ejemplo TXT
| tiempo: 19:44 local: 19 visitante: 12 |
|---|
| Integración externa La aplicación consumidora debe vigilar los archivos scoreboard.* y volver a leer el archivo completo cuando cambie. Los nombres permanecen fijos; no se genera un archivo histórico por cada lectura. |
|---|
15. Guardar y abrir proyectos
Un proyecto .scoreboard conserva la configuración necesaria para repetir una producción: tipo y dirección de fuente, carpeta de salida, recorte, campos, filtros de imagen, intervalo OCR, lectura automática y formatos.
Abre Fuente y localiza el bloque Proyecto.
Pulsa Guardar, asigna un nombre descriptivo y conserva el archivo .scoreboard.
En otra sesión, pulsa Abrir y selecciona el proyecto.
Revisa que la fuente y la carpeta de salida sigan disponibles antes de iniciar.
| Buena práctica Crea un proyecto por recinto, cámara o grafismo. Usa nombres como pabellon-central-decklink.scoreboard o futbol-rtmp-overlay.scoreboard. |
|---|
16. Ejemplos de uso
Fútbol desde una señal RTMP
Una productora recibe el programa por RTMP y necesita alimentar un grafismo web con tiempo y resultado.
Fuente: RTMP.
Campos: tiempo (Reloj MM:SS), local y visitante (Marcador / Tanteo).
Motor: Automático preciso.
Salida: JSON para el overlay y CSV para supervisión.
Intervalo orientativo: 100-150 ms.
Baloncesto en producción NDI
El marcador llega por la red del control de realización y cambia con mucha frecuencia.
Fuente: NDI descubierta automáticamente.
Campos: reloj (Reloj MM:SS.f), local, visitante y periodo.
Motor: Automático preciso; Siete segmentos en tanteos si los dígitos son LED limpios.
Salida: JSON y XML para dos sistemas consumidores.
Intervalo orientativo: 80-120 ms con regiones muy ajustadas.
Marcador físico mediante DeckLink
Una cámara o matriz SDI entrega la imagen de un marcador electrónico a una tarjeta Blackmagic.
Fuente: Blackmagic DeckLink.
Procesado: Alto contraste, ajuste de niveles y conectividad baja.
Campos: reloj, tanteos y período.
Motor: Siete segmentos para dígitos limpios; Automático preciso si hay reflejos o pérdidas de segmento.
Salida: TXT para un titulador sencillo y CSV para registro operativo.
Calibración con un vídeo grabado
Antes de una retransmisión se usa un archivo del recinto para preparar el proyecto sin ocupar la entrada en directo. Tras definir regiones y filtros, se cambia a la fuente real y se corrige únicamente el encuadre si fuera necesario.
17. Resolución de problemas
| Síntoma | Comprobaciones |
|---|---|
| No aparece vídeo | Verifica la fuente, red o archivo; confirma NDI Runtime o Blackmagic Desktop Video; pulsa Detener e Iniciar. |
| La señal se desconecta | Comprueba emisor y red. El programa reintenta automáticamente; observa el estado de la cabecera. |
| Lee 3:228 en vez de 12:34 | Usa un tipo Reloj, ajusta la región para incluir todos los trazos, revisa niveles y prueba Automático preciso. |
| Confunde 1, 4 o 9 | Incluye el carácter completo, evita recortes laterales y ajusta Nivel blanco/conectividad con moderación. |
| La lectura tarda | Reduce regiones, aumenta el intervalo, evita EasyOCR + Tesseract salvo necesidad y usa Siete segmentos en LED limpios. |
| CPU alta | Aumenta Intervalo OCR, limita motores pesados, recorta mejor el marcador y elimina campos innecesarios. |
| Un campo no cambia | Comprueba Lectura automática, región, tipo y motor; pulsa Procesar ahora y revisa la confianza. |
| No se crean archivos | Define una carpeta con permiso de escritura y marca al menos un formato. |
| No se descubre NDI/OMT | Confirma que emisor y receptor están activos y en una red accesible; usa Buscar señales de nuevo. |
| Problema de licencia | Comprueba Internet y accede a Gestión de licencia. Usa Cambiar licencia si necesitas sustituir la clave. |
18. Lista de comprobación antes del directo
Licencia validada y equipo con hora del sistema correcta.
Fuente estable durante varios minutos y reconexión comprobada.
Recorte del marcador ajustado y sin elementos ajenos.
Todos los campos visibles, correctamente nombrados y sin solapamientos innecesarios.
Tipo y motor adecuados en cada campo.
Imagen procesada limpia: caracteres completos y fondo controlado.
Valores y confianza revisados durante cambios reales del marcador.
Carpeta de salida accesible y archivos actualizándose.
Sistema consumidor probado con JSON, CSV, XML o TXT.
Proyecto guardado con un nombre identificable.
19. Enlaces
Web del producto: https://scoreboard.vision/
Gestión de licencia: https://panel.scoreboard.vision/
| Resumen Conecta la fuente, recorta el marcador, define campos pequeños y tipados, ajusta la imagen mirando la vista procesada y publica solo los formatos que vaya a consumir tu flujo de producción. |
|---|