Files
ColorPicker/README.md
2026-09-03 21:50:17 +02:00

46 lines
3.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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.