gnome-asus-kbd-rgb/docs/synthese roue chromatique.md

Synthèse — Mettre en place une roue chromatique (HSV) dans GNOME Shell 48

Contexte

• GNOME Shell 48 (GJS) utilise St/Clutter (pas GTK dans le Shell).
• Il n’existe pas de composant natif « roue chromatique » (type GtkColorChooser) directement exploitable dans une extension GNOME Shell.
• Objectif : offrir une roue HSV pour choisir une couleur (H, S) + un contrôle d’intensité (V), puis produire un RGB (0–255) utilisable pour piloter un matériel (ex. clavier RGB).

---

Options possibles (du plus recommandé au plus “hybride”)

Option A — Roue HSV native GNOME Shell (recommandée)

Principe

• Créer un widget custom basé sur Clutter.Canvas.
• Dessiner une roue HSV (visualisation en V=1 pour lisibilité).
• Capturer les interactions souris :
  • angle → Hue (H)
  • rayon → Saturation (S)
• Ajouter un slider pour Value (V) (intensité).
• Convertir HSV → RGB (0–255) et déclencher un callback.

Avantages

• 100% intégré au Shell (look & feel cohérent extension).
• Dépendances minimales (GJS uniquement).
• Utilisable dans un menu top-bar, Quick Settings, ou popup.
• Contrôle immédiat (idéal pour piloter des LED).

Inconvénients

• Code à maintenir (rendu + interaction).
• Optimisation possible nécessaire pour performance (cache image).

Recommandation

• C’est la meilleure solution pour une extension GNOME 48, surtout si l’usage cible est le pilotage hardware RGB.

---

Option B — Sliders RGB (solution la plus robuste)

Principe

• Ne pas faire de roue.
• 3 sliders St.Slider ou PopupSliderMenuItem :
  • R (0–255)
  • G (0–255)
  • B (0–255)
• Afficher un carré d’aperçu (preview) St.Widget dont la couleur suit les sliders.

Avantages

• Très simple, très stable, très maintenable.
• Exact pour piloter des LED (RGB natif).
• Peu de code, faible coût performance.

Inconvénients

• Moins intuitif qu’une roue HSV.
• Expérience utilisateur moins “graphique”.

Recommandation

• Excellent si priorité = fiabilité et précision LED.
• Peut être combiné avec la roue (Option A) pour affiner.

---

Option C — Hybride : application GTK externe (GtkColorChooser) + DBus

Principe

• Créer une petite app GTK (hors Shell) utilisant GtkColorChooser (roue native GNOME).
• L’extension GNOME Shell lance l’app ou communique via DBus.
• L’app renvoie la couleur choisie (RGB/HSV) à l’extension.

Avantages

• UI GNOME native parfaite (roue GTK).
• Moins de code côté Shell pour le rendu.

Inconvénients

• Architecture plus lourde (extension + service/app).
• Gestion DBus, packaging, cycle de vie de l’app.
• Moins fluide pour un usage “réglage instantané”.

Recommandation

• À considérer si tu veux absolument la roue GTK standard et acceptes la complexité.

---

Option D — Réutiliser du code existant (extensions / libs)

Principe

• S’inspirer d’une extension existante (Color Picker, etc.) ou porter un widget JS déjà implémenté.
• Intégrer le code (Canvas, HSV->RGB, interactions) dans ton extension.

Avantages

• Gain de temps si un code de roue HSV est déjà éprouvé.
• Possibilité de reprendre des patterns Shell (PopupMenu, Quick Settings, etc.).

Inconvénients

• Variabilité de qualité et compatibilité GNOME 48.
• Nécessite vérification licence / maintenance.

Recommandation

• Très efficace si tu trouves un code déjà aligné GJS/Clutter moderne.

---

Rendu “fidèle” vs LED (point important)

• Une roue à l’écran (sRGB) ne correspond pas parfaitement au rendu des LED de clavier.
• Recommandé :
  • afficher RGB 0–255 et/ou HEX
  • prévoir un slider d’intensité (V) + luminosité matériel
  • optionnel : appliquer une correction empirique (ex. réduire le bleu) pour coller au rendu réel.

---

UX conseillée (pragmatique)

MVP (simple et efficace)

• Roue HSV (H,S) + slider V
• Aperçu (carré couleur)
• Affichage RGB (0–255) + HEX
• Bouton “Appliquer” (ou appliquer en live)

Version “confort”

• Roue HSV + sliders RGB (affinage)
• Presets (palette)
• Historique des dernières couleurs
• “Appliquer au démarrage” (persist)

---

Recommandation finale

Pour GNOME Shell 48, le meilleur choix est :

1. Option A (roue HSV custom via Clutter.Canvas) + slider V
2. compléter par Option B (sliders RGB) si tu veux une précision LED maximale

Option C (GTK externe) est valable mais plus lourde et moins adaptée à un réglage rapide dans le Shell.

---

Livrables possibles (si on passe à l’implémentation)

• Widget HsvWheel réutilisable (Canvas + interaction)
• Intégration top-bar (PopupMenu) ou Quick Settings
• Callback standard onColor({r,g,b,h,s,v})
• Module utilitaire HSV<->RGB
• (Option) pipeline d’application : sysfs / asusctl / DBus service s