======================================================================
  CONVERSIONE FOTO IN BIANCO E NERO (7 STADI) — ai riparo
======================================================================

Contenuto della cartella:
  - converti_bn.py              Script Python con pipeline fotografica a 7 stadi
  - requirements.txt            Librerie richieste (opencv-python, numpy, Pillow)
  - Avvia conversione.bat       Avvio rapido con doppio clic per Windows
  - Avvia conversione.command   Avvio rapido con doppio clic per macOS / Linux
  - foto da trasformare/        Cartella in cui copiare le foto a colori
  - foto in bianco e nero/      Cartella dove trovi le foto convertite

----------------------------------------------------------------------
1. USO RAPIDO CON DOPPIO CLIC (WINDOWS E MAC)
----------------------------------------------------------------------
1) Copia le tue foto dentro la cartella "foto da trasformare".
2) Su Windows: fai doppio clic su "Avvia conversione.bat".
   Su macOS:   fai doppio clic su "Avvia conversione.command".
   (Al primo avvio lo script crea da solo l'ambiente .venv e installa
   OpenCV, NumPy e Pillow; dalle volte successive parte in un istante).
3) Ritira le foto pronte nella cartella "foto in bianco e nero".

Nota per macOS al primo avvio dopo il download:
Se macOS blocca l'apertura di "Avvia conversione.command" o non ha il
permesso di esecuzione, apri il Terminale nella cartella ed esegui:
  chmod +x "Avvia conversione.command"
  xattr -d com.apple.quarantine "Avvia conversione.command" 2>/dev/null

----------------------------------------------------------------------
2. USO DA TERMINALE / POWERSHELL
----------------------------------------------------------------------
Windows (PowerShell):
  python -m venv .venv
  .venv\Scripts\python.exe -m pip install -r requirements.txt
  .venv\Scripts\python.exe converti_bn.py

macOS e Linux (Terminale):
  python3 -m venv .venv
  .venv/bin/python -m pip install -r requirements.txt
  .venv/bin/python converti_bn.py

Opzioni aggiuntive da riga di comando:
  python converti_bn.py -i "altra_cartella" -o "cartella_uscita" -q 98
======================================================================
