Saltar al contenido
← Todos los artículos

Contraste de color en códigos QR: importa la luminosidad, no el tono

2026-11-07 · 9 min de lectura

Contraste de color en códigos QR: importa la luminosidad, no el tono

En esta página
  1. Por qué un escáner ve la luminosidad y no el tono
  2. Cómo calcular la luminosidad relativa de un color hexadecimal
  3. Contraste de color de códigos QR en nuestras pruebas con decodificadores
  4. Qué califica un verificador: el contraste del símbolo en ISO/IEC 15415
  5. Los códigos claros sobre fondo oscuro necesitan soporte de inversión
  6. Cambia la forma, no la luminosidad
  7. Preguntas frecuentes
  8. Fuentes

El contraste de color de un código QR se reduce a un número por color: lo claro que es. El decodificador de código abierto jsQR y la biblioteca Java de ZXing convierten cada píxel en un único valor de gris antes de leer nada, así que el tono desaparece. El azul marino y el morado oscuro se leen como oscuros; el coral, como gris medio, y el amarillo y el rosa pastel, como gris pálido. Puedes calcular esa luminosidad a partir de un código hexadecimal con la fórmula de luminosidad relativa del W3C.

Datos comprobados el 5 de noviembre de 2026.

Por qué un escáner ve la luminosidad y no el tono

La biblioteca jsQR empieza por convertir la imagen a escala de grises ponderando los canales 0–255 de cada píxel como 0.2126 × rojo + 0.7152 × verde + 0.0722 × azul. La biblioteca Java de ZXing, cuando recibe píxeles RGB, calcula lo que su código fuente llama un «promedio que favorece el verde»: (rojo + 2 × verde + azul) ÷ 4. Ambas fórmulas dan un número de brillo por píxel. Según nuestra lectura, dos colores con el mismo brillo se ven idénticos para estos decodificadores, sea cual sea su tono.

La norma también reduce cada módulo a uno de dos valores. El procedimiento de decodificación de referencia de la edición de 2006 de ISO/IEC 18004 muestrea un área de 3 × 3 píxeles en cada punto de la cuadrícula y decide «oscuro o claro» frente a un umbral global.

Hay una excepción que importa para la impresión. DENSO WAVE dice en sus preguntas frecuentes que los escáneres de códigos QR usan luz roja, por lo que un código rojo sobre fondo blanco no se puede leer, y tampoco un código azul sobre fondo verde. Su recomendación básica es negro sobre blanco. Si tus códigos los van a leer escáneres de luz roja, el tono también importa. No verificamos cómo convierten el color en gris las apps de cámara de los teléfonos.

Cómo calcular la luminosidad relativa de un color hexadecimal

La definición de WCAG 2.2 del W3C normaliza la luminosidad relativa (relative luminance) a 0 para el negro más oscuro y 1 para el blanco más claro. Para un color hexadecimal:

  1. Separa el código hexadecimal en rojo, verde y azul, y divide cada valor entre 255.
  2. Linealiza cada valor: si es 0.04045 o menos, divídelo entre 12.92; si no, calcula ((valor + 0.055) ÷ 1.055) elevado a 2.4.
  3. Súmalos: L = 0.2126 × R + 0.7152 × G + 0.0722 × B.
  4. Compara dos colores con la relación de contraste (contrast ratio) (L1 + 0.05) ÷ (L2 + 0.05), donde L1 es el color más claro. Las relaciones van de 1:1 a 21:1.

Ejemplo resuelto: azul marino #1d3557. Los canales son 29, 53 y 87, o 0.1137, 0.2078 y 0.3412 tras dividir entre 255. Los tres superan 0.04045, así que se linealizan a 0.0123, 0.0356 y 0.0953. Ponderados: 0.0026 + 0.0255 + 0.0069 = 0.035. Frente al blanco (L = 1), la relación es 1.05 ÷ 0.085 = 12.4:1.

WCAG se escribió para texto en páginas web, no para códigos QR. Su criterio de conformidad sobre contraste pide al menos 4.5:1 para texto normal y 3:1 para texto grande, dice que el valor calculado no debe redondearse (4.499:1 no alcanza 4.5:1) y explica que el cálculo está diseñado para que el tono no sea un factor clave. Ninguna norma de QR que hayamos leído usa cifras de WCAG; tomamos prestada la fórmula porque convierte cualquier código hexadecimal en un número de luminosidad publicado y repetible. Despejando, un color necesita una L de aproximadamente 0.183 o menos para llegar a 4.5:1 frente al blanco puro (cálculo nuestro).

Una fila de diez muestras de color del negro al blanco, cada una con su código hexadecimal, su luminosidad relativa WCAG y su relación de contraste frente al blanco: negro 0.000 y 21.0:1, azul marino #1d3557 0.035 y 12.4:1, morado #7b1fa2 0.078 y 8.2:1, rojo #d7261e 0.159 y 5.0:1, azul #1565c0 0.133 y 5.7:1, verde #2e7d32 0.155 y 5.1:1, coral #e76f51 0.290 y 3.1:1, amarillo #f2c14e 0.576 y 1.7:1, rosa #f8bbd0 0.601 y 1.6:1, blanco 1.000 y 1.0:1

Diagrama elaborado para este artículo; valores calculados con la fórmula de WCAG 2.2.

Contraste de color de códigos QR en nuestras pruebas con decodificadores

El 5 de noviembre de 2026 renderizamos un código prototipo de puntos redondos (nivel de corrección de errores H, un enlace corto) en cinco combinaciones de colores y decodificamos cada una con jsQR y ZXing a 400, 240 y 160 px de ancho. Para ZXing usamos zxing-wasm, una versión en WebAssembly de ZXing-C++, no la biblioteca Java citada arriba; no comprobamos cómo convierte el color en gris.

Combinación de coloresLuminosidad o contrastejsQR a 400 / 240 / 160 pxZXing a 400 / 240 / 160 px
Azul marino #1d3557 sobre blanco (referencia)L 0.035, 12.4:1falló / decodificó / decodificódecodificó en los tres
Cinco colores oscuros, mezclados por móduloL 0.035–0.082falló / decodificó / decodificódecodificó en los tres
Cinco colores de tono medio, mezclados por móduloL 0.27–0.58falló en los tresfalló en los tres
Pastel #c98aa0 sobre #fde8ef2.4:1falló en los tresdecodificó en los tres
Puntos claros sobre azul marino (invertido)Fondo azul marino, invertidofalló en los tres sin inversión; 2 de 3 con ellafalló en los tres sin inversión; 3 de 3 con ella

Cinco versiones del mismo código QR con distintivos verdes o rojos para cada decodificador y cada ancho: puntos azul marino sobre blanco, cinco colores oscuros, cinco colores de tono medio, rosa pastel sobre rosa claro y puntos claros sobre azul marino

Diagrama elaborado para este artículo a partir de los resultados de nuestras pruebas con decodificadores.

Destacan tres lecturas. El código oscuro multicolor se decodificó exactamente igual que la referencia azul marino de un solo color; el fallo de jsQR a 400 px también ocurrió con el azul marino, así que la causa no fueron los colores. La paleta de tonos medios se veía igual de colorida y falló en todos los casos; nuestra interpretación es que sus módulos más claros, como el amarillo a 1.7:1, quedan demasiado cerca del fondo blanco. El código pastel dividió a los dos decodificadores, y por eso una sola decodificación correcta prueba poco. Las pruebas con decodificadores no sustituyen escanear pruebas impresas con teléfonos reales, y ningún resultado de aquí promete que un diseño vaya a escanearse.

Qué califica un verificador: el contraste del símbolo en ISO/IEC 15415

ISO/IEC 18004 dice que los símbolos QR deben evaluarse en cuanto a calidad usando las directrices de calidad de impresión 2D de ISO/IEC 15415. La edición de 2006 también hace que la nota de cada escaneo sea la más baja de las notas de sus parámetros, incluido el contraste del símbolo, y que la nota global del símbolo sea la media de varios escaneos. No hemos leído la propia ISO/IEC 15415, así que los detalles siguientes proceden de fabricantes de verificadores (documentación del fabricante).

El manual del verificador DataMan 475V de Cognex define el contraste del símbolo como la diferencia de reflectividad entre el módulo más claro y el más oscuro, y lo califica con A a partir del 70 %, B desde el 55 %, C desde el 40 %, D desde el 20 % y F por debajo del 20 %. Axicon afirma que la versión de 2024 de ISO/IEC 15415 mide el contraste del símbolo a partir del 1 % de píxeles más claros y más oscuros, en lugar de los valores individuales más claro y más oscuro.

El contraste del símbolo es una medición de reflectancia del código impreso, no un número calculado a partir de un valor hexadecimal, y no encontramos ninguna conversión publicada de una relación WCAG a un porcentaje de contraste del símbolo. Usa la fórmula para filtrar colores en pantalla; usa un verificador o pruebas impresas para juzgar la impresión.

Los códigos claros sobre fondo oscuro necesitan soporte de inversión

La edición de 2006 de ISO/IEC 18004 dice que los símbolos están pensados para leerse tanto oscuros sobre claro como claros sobre oscuro, y su procedimiento de decodificación identifica la polaridad de reflectancia a partir de los patrones de localización. ISO publicó una cuarta edición en agosto de 2024, que no hemos leído.

Los decodificadores tratan la inversión de forma distinta. El MultiFormatReader de ZXing en Java solo reintenta con una imagen invertida cuando quien lo llama activa la pista ALSO_INVERTED. jsQR prueba ambas por defecto, con un coste de rendimiento de alrededor del 50 %, y su README dice que probablemente el valor por defecto cambiará a no invertir. En nuestra prueba, en la que desactivamos y activamos la inversión de forma explícita en ambas bibliotecas, el código invertido falló siempre que estaba desactivada. Si tu diseño es oscuro, coloca el código sobre un panel claro; la lista de comprobación de problemas explica esa solución.

Cambia la forma, no la luminosidad

Para que un código se vea distinto sin tocar su luminosidad, cambia la forma de los puntos. En el editor de QR Maker AI, Estilo → Estilo de punto incluye Tejido y Tejido vertical, funciones Pro a noviembre de 2026 (consulta los precios). Unen los módulos oscuros consecutivos de una fila o columna en una sola barra redondeada de 0.76 módulos de ancho que cubre el centro de cada módulo. En nuestras pruebas con decodificadores previas al lanzamiento, los códigos de tejido se decodificaron con ambas bibliotecas en todos los tamaños probados.

El panel Estilo del editor cambiando el Estilo de punto entre Redondo, Líquido, Tejido y Tejido vertical mientras el código sigue siendo negro sobre blanco

Captura de pantalla de una cuenta de demostración con datos de ejemplo.

Antes de imprimir un código en color:

  1. Calcula L para cada color de punto, no un promedio de la paleta.
  2. Mantén cada color de punto muy por debajo del fondo; el grupo oscuro que se decodificó en nuestra prueba iba de aproximadamente 8:1 a 12.4:1 frente al blanco.
  3. Mantén oscuros los patrones de localización y claro el fondo.
  4. Revisa el archivo exportado con el Comprobador de códigos QR gratuito, que calcula una relación WCAG entre el módulo oscuro promedio y los módulos claros y señala cualquier valor por debajo de 4.5:1; luego escanea una prueba impresa con varios teléfonos.

Para poner imágenes bajo los puntos, consulta cómo siguen escaneándose los códigos QR artísticos; para ideas de color según el lugar, consulta ideas de diseño de códigos QR.

Preguntas frecuentes

¿Un código QR puede ser de cualquier color?

Los puntos pueden ser de cualquier color que sea mucho más oscuro que el fondo, porque el código de los decodificadores de código abierto que leímos reduce el color a brillo. Las preguntas frecuentes de DENSO WAVE añaden que los escáneres de luz roja no pueden leer un código rojo sobre blanco, así que prueba los colores en los escáneres que usa tu público.

¿Qué relación de contraste debe tener un código QR?

Ninguna norma de QR que hayamos leído fija una relación WCAG. Los verificadores califican el contraste del símbolo a partir de la reflectancia medida, con A a partir del 70 % en el manual de Cognex. Como regla para filtrar, los colores oscuros que se decodificaron en nuestras pruebas tenían aproximadamente 8:1 o más frente al blanco.

¿Por qué no se escanea mi código QR amarillo o dorado?

El amarillo es claro. #f2c14e tiene una luminosidad relativa de 0.576 y solo 1.7:1 de contraste frente al blanco, así que un decodificador ve puntos gris pálido sobre blanco. Usa un color oscuro para los puntos y pon el amarillo en un marco.

¿Funcionan los códigos QR invertidos?

La norma permite códigos claros sobre oscuro, pero el decodificador tiene que probar una imagen invertida. En nuestra prueba, ambos decodificadores fallaron sin inversión; no probamos apps de cámara de teléfonos, así que un código oscuro sobre claro es la opción más segura.

Fuentes

  1. W3C — Web Content Accessibility Guidelines (WCAG) 2.2: relative luminance and contrast ratio definitions. W3C Recommendation, published 12 December 2024. Accessed 5 November 2026.
  2. jsQR project — src/binarizer/index.ts. Undated source file. Accessed 5 November 2026.
  3. ZXing project — RGBLuminanceSource.java. Undated source file. Accessed 5 November 2026.
  4. ISO/IEC — ISO/IEC 18004:2006, QR Code 2005 bar code symbology specification. Second edition, published 1 September 2006 (copy hosted by Public.Resource.Org). Accessed 5 November 2026.
  5. DENSO WAVE — FAQ. QRcode.com, undated. Accessed 5 November 2026.
  6. W3C WAI — Understanding Success Criterion 1.4.3: Contrast (Minimum). Updated 6 September 2026. Accessed 5 November 2026.
  7. zxing-wasm project — README. Undated. Accessed 5 November 2026.
  8. Cognex — ISO/IEC 15415 Grading Parameters, DataMan 475V Verifier Reference Manual. Dated 13 August 2020. Accessed 5 November 2026. (vendor data)
  9. Axicon — ISO/IEC standard for 2D barcodes. Undated. Accessed 5 November 2026. (vendor data)
  10. ISO — ISO/IEC 18004:2024 standard page. Fourth edition, published August 2024. Accessed 5 November 2026.
  11. ZXing project — MultiFormatReader.java. Undated source file. Accessed 5 November 2026.
  12. ZXing project — DecodeHintType.java. Undated source file. Accessed 5 November 2026.
  13. jsQR project — README. Undated. Accessed 5 November 2026.

Crea gratis un código QR dinámico: cambia el destino cuando quieras y mide cada escaneo.

Empieza con este diseño →