Ajout du README.md

README.md

@@ -0,0 +1,45 @@
+# ColorPicker
+
+Application Windows portable (sans installeur) offrant une palette de couleurs complète, un outil de prélèvement de couleur à l'écran (pipette), l'affichage en temps réel des codes hexadécimal et RGB avec copie rapide, ainsi qu'un outil pour personnaliser — et restaurer — la couleur de l'icône d'un dossier dans l'Explorateur Windows.
+
+Compatible **Windows 10 et 11**, **32 et 64 bits** (nécessite le .NET Framework 4.8, préinstallé sur ces systèmes). Aucune installation requise : un seul exécutable à lancer.
+
+## Fonctionnalités
+
+- **Palette de couleurs complète** : grille de teintes × nuances + niveaux de gris, sélectionnable en un clic.
+- **Pipette écran** : capture la couleur exacte de n'importe quel pixel affiché à l'écran (même en dehors de l'application), avec une loupe qui suit le curseur en temps réel.
+- **Couleur personnalisée** : sélecteur Windows complet (roue de couleurs, valeurs RVB/TSL précises), ou saisie directe d'un code hexadécimal.
+- **Codes en temps réel** : affichage instantané du code hexadécimal (`#RRGGBB`) et du code RGB (`R, G, B`), chacun avec son propre bouton **Copier** pour coller le code dans PowerShell, cmd, Word, Excel, ou tout autre logiciel.
+- **Couleur de dossier Windows** : applique une icône de dossier teintée de la couleur choisie, et permet de restaurer l'icône Windows par défaut à tout moment.
+
+## Utilisation
+
+1. Téléchargez ou compilez `ColorPicker.exe` (voir [Compilation](#compilation) ci-dessous).
+2. Lancez `ColorPicker.exe` — aucune installation n'est nécessaire.
+3. **Choisir une couleur** :
+   - cliquez sur une case de la palette, **ou**
+   - cliquez sur **"Prélever une couleur à l'écran"**, déplacez le curseur (qui devient une pipette) n'importe où sur l'écran puis cliquez pour capturer la couleur du pixel survolé (Échap pour annuler), **ou**
+   - cliquez sur **"Couleur personnalisée..."** pour ouvrir le sélecteur Windows complet, **ou**
+   - tapez directement un code hexadécimal dans le champ dédié puis validez avec Entrée ou le bouton **"OK"**.
+4. Les champs **Hexadécimal** et **RGB** se mettent à jour automatiquement. Utilisez le bouton **Copier** à côté de chacun pour le coller ailleurs.
+5. **Colorer un dossier** :
+   - cliquez sur **"Parcourir..."** et sélectionnez le dossier à colorer,
+   - cliquez sur **"Appliquer la couleur au dossier"** pour appliquer la couleur actuellement sélectionnée,
+   - cliquez sur **"Restaurer la couleur par défaut"** pour retirer la personnalisation et retrouver l'icône Windows standard.
+   - Si l'icône ne se met pas à jour immédiatement dans l'Explorateur, fermez puis rouvrez la fenêtre du dossier (ou appuyez sur F5).
+
+## Fonctionnement technique (couleur de dossier)
+
+Windows ne propose aucune API permettant de teinter nativement l'icône système d'un dossier. L'application génère donc, dans le dossier ciblé, une icône de remplacement (`.ico` multi-résolution) ainsi qu'un fichier `desktop.ini` — tous deux marqués cachés/système — qui indiquent à l'Explorateur d'utiliser cette icône personnalisée. La restauration supprime ces fichiers et retire l'attribut associé, ce qui rend au dossier son apparence par défaut.
+
+## Compilation
+
+Le code source se trouve dans `src/`. Pour recompiler :
+
+```bash
+build.bat
+```
+
+Ce script utilise le compilateur C# fourni avec le .NET Framework (déjà présent sur Windows), aucun outil supplémentaire n'est nécessaire.
+
+Le dossier `tests/` contient un harnais de test indépendant (`TestHarness.cs`) qui valide la logique d'application/restauration de la couleur de dossier, ainsi qu'un utilitaire (`IconPreview.cs`) permettant d'exporter un aperçu PNG de l'icône générée.