Capturar el color de un píxel de imagen
- Panel
- Documentación
- API
¿Qué es un color picker de imagen?
Un color picker (en español cuentagotas de color o captura de color) es una herramienta que devuelve el valor exacto de un píxel elegido en una imagen. Carga una foto, hace clic en el punto que le interesa y la herramienta devuelve el color preciso en forma de HEX, RGB y HSL. Es el equivalente web del cuentagotas de los programas de diseño como Photoshop, GIMP o Figma.
Nuestra herramienta funciona directamente en su navegador. Sube su imagen, se muestra en la página y basta con que haga clic en un píxel para obtener su color. La lectura del píxel se realiza en el lado del cliente mediante la API canvas, sin idas y venidas al servidor, sin recompresión y sin envío de la imagen por la red para la selección.
Diferencia con un extractor de colores
Nuestro extractor de colores y nuestro color picker responden a dos necesidades distintas, que conviene diferenciar bien:
- El extractor analiza el conjunto de la imagen y devuelve la paleta dominante (los 5, 8 o 10 tonos más representados). Es la herramienta de elección para sintetizar la atmósfera cromática de una foto, crear un mood board o nutrir una carta.
- El color picker devuelve el color exacto de un píxel concreto que usted designe. Es la herramienta de elección cuando sabe dónde mirar: un logotipo en una captura, un matiz preciso de un degradado, un fondo de pantalla de referencia.
El extractor trabaja sobre millones de píxeles y aplica clustering para hacer emerger grupos de colores; el picker se limita a leer el valor RGB almacenado en la posición donde usted hace clic. El primero generaliza, el segundo es quirúrgico.
Cómo funciona, técnicamente
Una imagen digital es una rejilla de píxeles, cada píxel con tres canales RGB (rojo, verde, azul) codificados generalmente en 8 bits, es decir, 256 valores por canal. Cuando hace clic en un punto, la herramienta:
- Dibuja su imagen en un elemento canvas, conservando sus dimensiones nativas (con un techo de 1500 píxeles de ancho para que resulte cómoda en pantalla).
- Convierte la posición del clic en coordenadas de imagen nativa, compensando el redimensionado de visualización del navegador.
- Lee el valor RGBA del píxel mediante la API
canvas.getContext('2d').getImageData(x, y, 1, 1). - Muestra una vista previa del color elegido. Al enviar, el servidor lee la misma posición con PHP GD y calcula los códigos HEX, RGB y HSL definitivos.
El valor HSL se calcula mediante nuestro servicio de conversión de color, idéntico al que utiliza nuestro convertidor de colores. Coherencia de extremo a extremo: obtiene los mismos valores que si hubiera introducido el código HEX en el convertidor.
Casos de uso típicos
- Reproducir un color de captura de pantalla: tiene una captura de un sitio y quiere replicar exactamente el tono de un botón o de un fondo. El picker le da el código HEX preciso para pegarlo en su CSS.
- Identificar un color de carta sobre una foto: un PDF de presentación, una página de revista, una imagen de producto. Ya no hace falta pedir la carta, lee el color directamente.
- Ingeniería inversa de identidad visual: capturar el azul exacto de un logotipo, el rosa de un banner, el naranja de una llamada a la acción.
- Inspiración y observación de diseño: ve una foto que le gusta, recupera el tono exacto de una flor, de una pared, de un cartel.
- Depuración front-end: una captura de un bug muestra un color incorrecto, lee el valor real para compararlo con el esperado en el maquetado.
- Creación de paleta a partir de una referencia: hace pick de varios puntos de una misma imagen para reconstituir una paleta personalizada.
Cómo utilizar el color picker
- Suba su imagen (PNG, JPG, GIF, BMP, WebP, hasta 20 MB).
- Se muestra una vista previa en la página. Haga clic en un píxel para obtener su color.
- Una mira marca la posición clicada y aparece una vista previa del color al lado.
- Valide con el botón de envío para obtener el resultado final: cuadrado coloreado, código HEX, RGB y HSL.
- Para transformar el valor entre formatos, pase por nuestro convertidor de colores.
Preguntas frecuentes
¿Cuál es la diferencia entre HEX, RGB y HSL?
Son tres representaciones del mismo color. HEX (#ff0000) es el
formato más utilizado en CSS. RGB expresa los tres canales rojo / verde / azul en
valores 0-255. HSL (Hue, Saturation, Lightness) es más intuitivo para ajustar un
tono: es el formato a privilegiar cuando se quiere oscurecer, desaturar o modificar un
color sin cambiar el tono de base.
¿Por qué mi clic no devuelve exactamente el color esperado?
En una zona de degradado, dos píxeles vecinos pueden tener valores muy distintos. Además, las imágenes JPG están comprimidas con pérdida: el color de un píxel puede diferir ligeramente del original. Para códigos de color fiables, prefiera PNG o imágenes sin recompresión.
¿Mis coordenadas son las de la pantalla o las de la imagen?
Las de la imagen original. Nuestro script JavaScript convierte automáticamente la posición del clic (en píxeles de pantalla) a la posición en la imagen nativa. Si su imagen mide 4000x3000 y se muestra a 800x600, un clic en el centro le devolverá (2000, 1500) y no (400, 300).
¿Funciona el picker con imágenes transparentes?
Sí. Si hace clic en un píxel transparente, obtiene el color RGB almacenado en ese punto (a menudo blanco o negro según el editor de origen). La transparencia en sí misma (canal alfa) no se devuelve en el resultado; para analizar un canal alfa, abra la imagen en un editor gráfico.
¿Qué tamaño de imagen se acepta?
Hasta 20 MB, formatos PNG, JPG, GIF, BMP y WebP. Las imágenes muy grandes se muestran a 1500 píxeles de ancho como máximo para resultar cómodas en pantalla, pero el color leído sigue siendo el del píxel original, sin remuestreo.
¿Se almacenan mis imágenes en el servidor?
No. La selección se realiza en su navegador. En el momento del envío, el fichero se procesa al vuelo para confirmar el color del píxel solicitado y, después, se elimina el fichero temporal. No se conserva, indexa ni comparte ninguna imagen.
¿Qué ocurre si JavaScript está desactivado?
El envío clásico del formulario sigue siendo posible. Las coordenadas x e y se gestionan mediante campos ocultos que JavaScript rellena al hacer clic. Sin JavaScript, esos campos quedan vacíos y el formulario señalará que falta una posición, pero la imagen en sí se transmite efectivamente al servidor para su tratamiento.
Ejemplo de solicitud
curl -X POST https://cdrn.fr/api/v1/tools/color-picker/execute \
-F "image=@/path/to/file" \
-F "x=..." \
-F "y=..."
Esquema de entrada
| Campo | Tipo | Obligatorio | Por defecto |
|---|---|---|---|
image |
file | ✓ | – |
x |
string | – | – |
y |
string | – | – |
esta herramienta espera un archivo - utiliza Content-Type multipart/form-data en lugar de application/json
Puntos de acceso
GET https://cdrn.fr/api/v1/tools- lista todas las herramientas disponiblesGET https://cdrn.fr/api/v1/tools/color-picker- recupera el esquema de esta herramientaPOST https://cdrn.fr/api/v1/tools/color-picker/execute- ejecuta esta herramienta con un payload JSON