RGB vers entier décimal

De nombreuses API graphiques, moteurs de jeu et boîtes à outils d'interface héritées stockent une couleur comme un seul entier décimal de 24 bits plutôt que trois canaux séparés ou une chaîne hex. Cette capacité convertit dans les deux sens : envoyez un code hex ou un triplet RGB avec direction to_int pour obtenir le décimal, ou envoyez un décimal dans la plage légale de 0 à 16777215 avec direction from_int pour retrouver les canaux et un hex normalisé.

Empaqueter RGB ou hex en un entier décimal de 24 bits

Le champ obligatoire color accepte les mêmes formes que les designers et développeurs saisissent chaque jour : un code hex à six chiffres avec ou sans dièse initial tel que #FF8000 ou FF8000, un raccourci CSS à trois chiffres tel que #f80 qui s'étend en doublant chaque chiffre, un préfixe 0x optionnel pour l'hex, un triplet séparé par des virgules comme 255,128,0, ou la forme de fonction CSS rgb telle que rgb(255, 128, 0). En interne le moteur multiplie le rouge par soixante-cinq mille cinq cent trente-six, multiplie le vert par deux cent cinquante-six et ajoute le bleu—de façon équivalente la formule binaire rouge décalé de seize bits à gauche, ou vert décalé de huit bits à gauche, ou bleu—produisant un entier unique entre zéro et seize millions sept cent soixante-dix-sept mille deux cent quinze. Le noir pur s'empile à zéro, le blanc pur au maximum, et les oranges de marque comme #FF8000 deviennent seize millions sept cent quarante-quatre mille quatre cent quarante-huit. Choisissez la direction to_int lorsque vous avez déjà une couleur et qu'il vous faut un seul nombre empaqueté. Chaque canal doit être un entier de zéro à deux cent cinquante-cinq inclus ; les canaux hors plage et les longueurs hex mal formées échouent avec invalid_input et ne sont pas facturés. Les alias value, input, hex, n et rgb mappent vers le même champ color lorsque les clients préfèrent ces noms. Les alias de direction to_decimal, rgb_to_int et encode sélectionnent le même chemin d'empaquetage pour coller au vocabulaire de votre base de code. Des entrées identiques produisent toujours un JSON identique car le chemin est de l'arithmétique pure sans réseau, sans graine aléatoire et sans horloge murale.

Dépaqueter un entier décimal vers RGB et hex

La plage légale va de zéro à seize millions sept cent soixante-dix-sept mille deux cent quinze inclus—l'intervalle non signé complet de 24 bits. En cas de succès le moteur extrait le rouge comme la valeur décalée de seize bits à droite masquée sur huit bits, le vert comme la valeur décalée de huit bits à droite masquée sur huit bits, et le bleu comme les huit bits bas. Choisissez la direction from_int lorsqu'un pipeline vous remet un entier de couleur empaqueté et que vous avez besoin des canaux ou d'une chaîne hex prête pour CSS. Placez l'entier dans le champ color comme chaîne de chiffres décimaux ou nombre JSON, ou comme littéral hex préfixé 0x. Un entier au-dessus de 16777215 est rejeté avec invalid_input qui nomme le maximum afin que les appelants corrigent le bogue sans deviner ; les entiers négatifs sont également rejetés. La réponse renvoie ces canaux en r, g et b, les imbriquent sous un objet rgb, construit un champ hex à six chiffres en majuscules préfixé dièse, expose hex_digits sans le dièse et fournit une chaîne css_rgb telle que rgb(255, 128, 0) pour les feuilles de style. La même valeur numérique apparaît sous decimal, integer et rgb_int pour que le code d'interface, les démos SDK et les correcteurs choisissent le nom qui convient sans remapper. L'étiquette method est int_to_rgb pour le dépaquetage et rgb_to_int pour l'empaquetage, et max vaut toujours 16777215 pour la documentation côté clients. Les alias de direction from_decimal, int_to_rgb et decode sélectionnent le chemin de dépaquetage.

Usage API, tarification, flux de travail et limites pratiques

Appelez le convertisseur gratuit dans le navigateur de RGB vers entier décimal pour des contrôles de design, des démos d'outils de jeu et une vérification mentale rapide sans installer de bibliothèques de couleur. Associez ce point de terminaison à des convertisseurs RGB vers HSL ou hex vers HSL lorsque l'étape suivante est un ajustement perceptuel, ou à des contrôles de contraste de couleur lorsque l'entier empaqueté alimente un flux WCAG après dépaquetage. Gardez les entiers dans la plage 24 bits publiée ; les espaces couleur plus larges et les canaux alpha sont hors du périmètre de cette intention produit. Envoyez un corps JSON avec les champs obligatoires color et direction. Utilisez l'API prépayée lorsqu'un pipeline de thèmes, un générateur de planches de sprites, une suite d'outils d'accessibilité ou un service d'actifs multijoueur a besoin d'un contrat stable sous solde KIT à $0.002 par élément réussi ; les échecs de validation ne consomment jamais de solde après le rejet du moteur. Les auteurs qui livrent des SDK peuvent mapper les champs decimal et hex directement dans des formulaires qui affichent un échantillon à côté de l'entier—le même modèle mental que voient les artistes lorsqu'un fichier binaire stocke des couleurs en RGB empaqueté 24 bits.