From 5f83bbf81dc3eb7953ef101de8f73eccf09e5702 Mon Sep 17 00:00:00 2001 From: Florian Date: Thu, 3 Sep 2026 21:50:17 +0200 Subject: [PATCH] Ajout du README.md --- README.md | 45 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 45 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..2438a63 --- /dev/null +++ b/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.