Empaquetador RGB a RGB565

Los canales fuera de cero a doscientos cincuenta y cinco se rechazan con un error invalid_input claro, en lugar de envolverse o saturarse en silencio.

Cómo funciona el empaquetado RGB565 y qué contiene la respuesta

La respuesta repite los canales validados r, g y b, devuelve el entero empaquetado como rgb565, una cadena hexadecimal de cuatro dígitos en mayúsculas con prefijo 0x, los cuatro dígitos hexadecimales solos, una cadena binaria de dieciséis caracteres, los campos recortados r5, g6 y b5, los canales de ocho bits reconstruidos r_q, g_q y b_q al desplazar de nuevo a la izquierda esos campos recortados, los bytes alto y bajo que una transferencia SPI a un controlador de la familia ILI9341 espera en ese orden, cadenas CSS rgb del color original y del cuantizado, la etiqueta de método truncate_rgb565, la fórmula de bits y max siempre igual a 65535.

Cómo se validan r, g y b y por qué el recorte de bits es honesto

Los espacios exteriores de los canales en cadena se recortan; un signo más inicial opcional solo se admite cuando el resto son dígitos decimales que se interpretan como un entero dentro del rango. Valores como ciento veintiocho punto cinco fallan la validación en lugar de redondearse, y los negativos o de doscientos cincuenta y seis en adelante fallan con un mensaje que nombra el canal y afirma que debe permanecer entre cero y doscientos cincuenta y cinco. Los campos ausentes y las cadenas vacías tras recortar espacios se rechazan del mismo modo. El recorte es el contrato porque Adafruit GFX, TFT_eSPI, los ejemplos de la hoja de datos de ILI9341 y casi toda macro de color de Arduino descartan los bits bajos con un desplazamiento a la derecha; un empaquetador que redondeara discreparía del firmware ya desplegado y rompería las pruebas áureas que fijan 0xF800 para el rojo pleno. Los campos preferidos son r para el rojo, g para el verde y b para el azul. Se aceptan los alias red y R mayúscula, green y G mayúscula, y blue y B mayúscula, para que hojas de cálculo, cadenas de consulta y formularios tipados reutilicen el contrato sin renombrar columnas. Un número JSON desnudo se acepta únicamente si es un entero finito entre cero y doscientos cincuenta y cinco. Los canales reconstruidos r_q, g_q y b_q muestran el color que realmente llega al framebuffer cuando esos bits ya no están, que es la vista previa honesta que un artista necesita antes de fijar una paleta.

Dónde resulta útil un empaquetador de RGB a RGB565

Los autores de firmware se encuentran este mapeo cuando una guía de marca lista muestras RGB de ocho bits y el controlador de pantalla pide un color uint16_t, cuando una hoja de sprites se convierte fuera de línea en un arreglo C de 16 bits, o cuando un registro serie imprime una palabra empaquetada y el escritorio necesita la constante hexadecimal equivalente. En esta página el trabajo se ejecuta por completo en su navegador; a través de la API cada empaquetado correcto cuesta $0.002, la validación fallida no se cobra y nada se almacena después de devolver la respuesta. Esa separación —exploración interactiva gratuita y una API de pago idéntica— coincide con el resto del catálogo tier A de KIT y le permite pasar de una demostración de banco o una diapositiva de clase a una tubería de firmware automatizada sin cambiar el resultado empaquetado.