Impacchettatore RGB in RGB565

Questo impacchettatore da RGB a RGB565 prende interi di rosso, verde e blu da zero a duecentocinquantacinque e li comprime troncando i bit bassi inutilizzati: cinque bit di rosso, sei di verde e cinque di blu, poi assembla il classico schema a sedici bit usato da ILI9341, ST7735, ST7789, SSD1351, Adafruit GFX e TFT_eSPI. I canali fuori da zero a duecentocinquantacinque vengono rifiutati con un errore invalid_input chiaro, anziché essere avvolti o saturati in silenzio.

Come funziona l'impacchettamento RGB565 e che cosa contiene la risposta

La risposta ripete i canali validati r, g e b, restituisce l'intero impacchettato come rgb565, una stringa esadecimale di quattro cifre in maiuscolo con prefisso 0x, le quattro cifre hex da sole, una stringa binaria di sedici caratteri, i campi troncati r5, g6 e b5, i canali a otto bit ricostruiti r_q, g_q e b_q spostando di nuovo a sinistra quei campi troncati, i byte alto e basso che un trasferimento SPI verso un controller della famiglia ILI9341 si aspetta in quell'ordine, stringhe CSS rgb del colore originale e di quello quantizzato, l'etichetta di metodo truncate_rgb565, la formula dei bit e max sempre uguale a 65535.

Come vengono validati r, g e b e perché il troncamento resta onesto

Gli spazi esterni sui canali stringa vengono eliminati; un più iniziale facoltativo è ammesso solo quando i caratteri restanti sono cifre decimali che si interpretano come un intero nell'intervallo. Valori come centoventotto punto cinque falliscono la validazione invece di essere arrotondati, e i numeri negativi o da duecentocinquantasei in su falliscono con un messaggio che nomina il canale e afferma che deve restare tra zero e duecentocinquantacinque. I campi mancanti e le stringhe vuote dopo il trim vengono rifiutati allo stesso modo. Il troncamento è il contratto perché Adafruit GFX, TFT_eSPI, gli esempi del datasheet ILI9341 e quasi ogni macro di colore Arduino scartano i bit bassi con uno scorrimento a destra; un impacchettatore che arrotondasse sarebbe in disaccordo con il firmware già in campo e romperebbe i test aurei che fissano 0xF800 per il rosso pieno. I campi preferiti sono r per il rosso, g per il verde e b per il blu. Sono accettati gli alias red e R maiuscola, green e G maiuscola, e blue e B maiuscola, così fogli di calcolo, query string e moduli tipizzati riutilizzano il contratto senza rinominare colonne. Un numero JSON nudo è accettato solo se è un intero finito compreso tra zero e duecentocinquantacinque. I canali ricostruiti r_q, g_q e b_q mostrano il colore che arriva davvero nel framebuffer dopo che quei bit sono spariti, che è l'anteprima onesta di cui un artista ha bisogno prima di chiudere una palette.

Dove un impacchettatore da RGB a RGB565 merita il proprio posto

Gli autori di strumenti richiamano lo stesso contratto da script di build per seminare intestazioni di palette, da test di proprietà che confrontano un nuovo driver con questo oracolo, e da pipeline di token di design che devono emettere insieme un hex CSS e una parola di firmware da un'unica fonte di verità. Lo abbini a un convertitore da RGB a hex quando il consumatore successivo è un foglio di stile, a un impacchettatore da RGB a intero decimale quando ha bisogno di una parola a ventiquattro bit, e ad altri strumenti di colore deterministici e gratuiti quando sta allestendo un piccolo laboratorio di igiene delle palette embedded. Gli autori di firmware incontrano questa mappatura quando una guida di marca elenca campioni RGB a otto bit e il driver del display vuole un colore uint16_t, quando un foglio di sprite viene convertito offline in un array C a 16 bit, o quando un log seriale stampa una parola impacchettata e la scrivania ha bisogno della costante hex corrispondente. Gli studenti la vedono nei corsi di sistemi embedded che presentano i framebuffer TFT, nei laboratori di programmazione di giochi rivolti a portatili a sedici bit e nei riscaldamenti da colloquio che chiedono lo schema di bit di RGB565. In questa pagina il lavoro avviene interamente nel Suo browser; tramite l'API ogni impacchettamento riuscito costa $0.002, la validazione fallita non viene addebitata e nulla viene conservato dopo la restituzione della risposta. Questa separazione — esplorazione interattiva gratuita e API identica a pagamento — corrisponde al resto del catalogo tier A di KIT e Le consente di passare da una demo al banco o da una diapositiva di lezione a una pipeline di firmware automatizzata senza cambiare il risultato impacchettato.