← Todas las guías de FaintType

Solución de problemas

Por qué cambia la medición del contraste de un mismo texto en una captura

Cómo el suavizado, el escalado, la compresión, los límites del OCR y los fondos mixtos pueden alterar una estimación sin cambiar los colores previstos en el diseño.

Publicado Actualizado

Si eliges un texto oscuro y un fondo claro en una herramienta de diseño, calcular el contraste es sencillo. Si mides ese mismo texto en una captura, aparecen decenas de colores intermedios en los bordes de los caracteres. Una sola línea también puede atravesar una sombra, un degradado o un bloque de imagen comprimida.

Por eso, un comprobador de capturas puede discrepar de una calculadora basada en tokens de diseño aunque ambos cálculos estén bien implementados. Lo difícil es decidir qué píxeles renderizados representan el texto y cuáles representan el fondo.

El suavizado crea colores que no estaban en la paleta

La rasterización de fuentes mezcla los píxeles de los bordes con el fondo para suavizar curvas y diagonales. Tomar un píxel del borde como color del texto produce un contraste menor que tomar uno del interior del carácter. Ese equilibrio cambia con la escala de la pantalla, el renderizado de la fuente y el redimensionamiento de la imagen.

FaintType busca píxeles del interior de los caracteres en vez de tratar como texto todos los píxeles del rectángulo OCR. También excluye una franja estrecha junto al borde de ese rectángulo al seleccionar candidatos de primer plano. Así reduce la posibilidad de confundir el borde de un botón cercano con un carácter.

Un rectángulo OCR indica una ubicación, no una máscara de caracteres

Apple Vision devuelve observaciones de texto reconocido con regiones delimitadoras normalizadas y valores de confianza. El recuadro de una línea suele incluir espacios entre letras y puede abarcar elementos decorativos cercanos. La estimación de color debe precisar esa región aproximada antes de poder comparar texto y fondo.

FaintType toma muestras dentro de la región y en un anillo cercano, agrupa colores similares y separa los componentes de los caracteres que conserva del fondo circundante. Si el reconocimiento une textos sin relación o pasa por alto una etiqueta pequeña, el recuadro y la estimación de color resultantes pueden seguir siendo incorrectos.

Una línea puede tener más de un fondo real

Un degradado, una fotografía, un panel translúcido o una sombra hacen que no haya una sola muestra de fondo para toda la línea. FaintType estima un fondo local para los componentes de caracteres conservados y resume las mediciones con un valor típico, una estimación local más débil y la proporción de superficie que alcanza el umbral.

Esos indicadores responden a preguntas diferentes. El valor típico describe la mayor parte del texto renderizado; la estimación más débil ayuda a localizar una porción vulnerable; la cobertura indica cuánto del área muestreada alcanza el umbral WCAG seleccionado. No informes solo de la cifra más favorable cuando la línea atraviesa claramente un fondo cambiante.

Cómo investigar un resultado inesperado

Vuelve a la captura de tamaño original, selecciona el resultado y compara las muestras de color del texto y del fondo con los píxeles resaltados. Comprueba si la imagen se ha redimensionado, se ha vuelto a comprimir o se ha capturado con otra escala de pantalla. Si la confianza es media o baja, confirma los colores en el diseño original o en el inspector del navegador.

Una estimación debería ser reproducible para los mismos píxeles, pero no tiene por qué coincidir con un cálculo basado en los colores de origen después de transformar esos píxeles. Conserva la exportación original cuando una decisión dependa de un resultado muy próximo al umbral.