# ARIS PhotoRedim - Guide utilisateur

Ce logiciel permet de redimensionner automatiquement un grand nombre d'images tout en conservant un flux simple, rapide et stable.

Fonctionnement non destructif (par défaut) : le logiciel ne modifie pas vos originaux et crée une nouvelle copie de l'image à chaque traitement.

## 1) Démarrage rapide

1. Choisissez le mode d'entrée : Dossier ou Image unique.
2. Chargez votre source :
   - mode dossier : bouton Choisir dossier...
   - mode image : bouton Choisir image...
3. Sélectionnez le format (`4:3` ou `16:9`).
4. Choisissez la taille maximale de sortie.
5. Activez les options souhaitées (amélioration, bordure, filigrane, format, etc.).
6. Cliquez sur Lancer le traitement.

## 2) Description des fonctionnalités

### Mode d'entrée : dossier ou image unique

- Dossier : traite toutes les images supportées trouvées dans le dossier et ses sous-dossiers.
- Image unique : traite uniquement l'image sélectionnée.
- L'interface grise automatiquement les contrôles non utilisés selon le mode choisi.
- En mode image, le bouton Visualiser permet d'ouvrir immédiatement l'image sélectionnée.

### Choix du format et de la taille

- Format 4:3 ou 16:9 : adapte la liste de tailles proposées automatiquement.
- Taille max : chaque image est réduite pour entrer dans cette boîte sans déformation.
- Pas d'agrandissement : une image déjà plus petite que la cible est ignorée (qualité préservée).

### Gestion des fichiers

- Comportement : traitement non destructif, création d'une copie de sortie uniquement.
- Conserver suffixe : ajoute un suffixe de type `_1024x768` pour identifier la sortie.
- Format de sortie : `auto`, `jpg`, `png`, `webp`, `bmp`.
- Qualité JPEG : règle la compression JPEG (plus haut = meilleure qualité, fichier plus lourd).

### Amélioration d'image (type Photoshop)

- Balance des blancs douce.
- Ajustement des niveaux sur la luminance.
- Correction gamma légère.
- Saturation légère pour redonner du relief.
- Netteté légère après redimensionnement (UnsharpMask).

### Bordure et filigrane

- Bordure : ajoute un cadre blanc ou noir avec épaisseur en pourcentage.
- Filigrane texte : inscrit un texte en bas à droite de l'image.

### Performance et robustesse

- Multi-thread : traitement parallèle des images.
- Threads dynamiques : adaptation automatique selon CPU, format dominant et options lourdes.
- Scan streaming : découverte progressive des fichiers, utile sur très gros dossiers.
- Logs : journalisation des actions et erreurs dans `log.txt`.

### Mode benchmark

L'option Mode benchmark calcule le temps de traitement par étape : `ouverture`, `auto-optimize`, `resize` et `sauvegarde`. Un résumé est écrit en fin de traitement dans `log.txt`.

## 3) Glisser-déposer (Drag & Drop)

Si le module de glisser-déposer est disponible, vous pouvez déposer un dossier ou une image directement sur la fenêtre. Le mode d'entrée est adapté automatiquement.

## 4) Aide intégrée

L'aide est accessible depuis le menu Aide de l'application. Elle ouvre ce fichier dans votre navigateur par défaut.

## 5) Icône de l'application

L'application peut utiliser l'icône `PhotoRedim.ico` dans la fenêtre et dans la barre des tâches Windows. Placez ce fichier dans le même dossier que `ARIS_PhotoRedim.py`.

## 6) Fichiers de log

- `log.txt` : suivi normal (images optimisées, ignorées, erreurs).
- `crash.log` : erreurs non gérées.
- `crash_startup.log` : erreurs au démarrage de l'application.

Conseil : gardez le suffixe pour comparer facilement les images source et les images optimisées.
Important : les images plus petites que la taille cible ne sont pas agrandies. Ce choix évite la dégradation de qualité.

## 7) Dépannage rapide

- Aucune image trouvée : vérifiez le dossier sélectionné et les extensions supportées.
- Visualisation impossible : vérifiez que le fichier image existe encore à l'emplacement indiqué.
- Erreurs de sauvegarde : vérifiez les droits d'écriture et les fichiers verrouillés.
- Traitement lent : activez le benchmark, puis ajustez les options les plus coûteuses.