Skip to content

Commit 932f5ac

Browse files
committed
Update Sciript Documentation and README
- mod: "readme.md" - add: "\docs\pdf_combiner.md"
1 parent aab168e commit 932f5ac

File tree

2 files changed

+69
-11
lines changed

2 files changed

+69
-11
lines changed

Docs/pdf_combiner.md

Lines changed: 60 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,60 @@
1+
## 🖼️ _Generazione PDF da Immagini JPEG_ - **pdf_combiner.py**
2+
3+
Uno script Python con interfaccia grafica che consente di selezionare immagini JPEG e convertirle in un **PDF ottimizzato**, pronto per l’archiviazione o la stampa.
4+
5+
---
6+
7+
## Descrizione 📄
8+
9+
L'**Elaboratore di Documenti Scansionati** permette di importare una o più immagini, migliorarne automaticamente la leggibilità e generare un PDF ordinato e pulito.
10+
11+
Ideale per:
12+
13+
- **Digitalizzare documenti cartacei** in modo rapido.
14+
- **Migliorare la leggibilità** di scansioni non perfette.
15+
- **Creare archivi PDF** partendo da immagini di bassa qualità.
16+
17+
---
18+
19+
## Funzionalità 🌟
20+
21+
- **Correzione orientamento**: Rileva automaticamente la rotazione delle pagine.
22+
- **Pulizia avanzata**: Rimuove bordi, rumore e migliora la leggibilità del testo.
23+
- **Conversione bianco/nero**: Per un output chiaro, leggibile e leggero.
24+
- **Interfaccia intuitiva**: Selezione immagini con un semplice click.
25+
- **Output ordinato**: Salva un PDF nella cartella delle immagini, con nome e data.
26+
27+
---
28+
29+
### Esempio di utilizzo 🧪
30+
31+
1. Avvia lo script.
32+
2. Seleziona una o più immagini `.jpeg` o `.jpg`.
33+
3. Clicca su **"Elabora Documenti"**.
34+
4. Attendi la fine del processo: il PDF sarà generato automaticamente.
35+
36+
---
37+
38+
## Output 📊
39+
40+
### Output PDF
41+
42+
- Nome file: `Documenti_Scansionati_YYYYMMDD_HHMMSS.pdf`
43+
- Posizione: stessa cartella delle immagini originali.
44+
45+
### Output Terminale / Log
46+
47+
```plaintext
48+
Immagine 1/3: Analisi immagine...
49+
Immagine 1/3: Correzione orientamento...
50+
Immagine 1/3: Conversione in bianco e nero...
51+
...
52+
Creazione PDF...
53+
Elaborazione completata!
54+
```
55+
56+
## Note 📝
57+
58+
- Compatibilità: Supporta immagini .jpeg, .jpg e .png.
59+
- Performance: Il processo potrebbe richiedere alcuni secondi per immagine.
60+
- Nitidezza & Contrasto: Le funzioni di aumento sono disabilitate per migliorare la leggibilità del testo.

README.md

Lines changed: 9 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -69,6 +69,7 @@
6969
├── remove.py
7070
├── sposta_file.py
7171
├── transcribe_wav.py
72+
├── pdf_combiner.py
7273
└── trash.py
7374
```
7475

@@ -152,6 +153,11 @@
152153
<tr>
153154
<td><b><a href='https://github.com/Magnetarman/Python-Script/blob/master/scripts/estensioni.py'>estensioni.py</a></b></td>
154155
<td><code>❯ Analisi e elenco ordinato delle estensioni file in una directory.</code></td>
156+
</tr>
157+
<tr>
158+
<td><b><a href='https://github.com/Magnetarman/Python-Script/blob/master/scripts/pdf_combiner.py'>pdf_combiner.py</a></b></td>
159+
<td><code>❯ Genera PDF da immagini Jpeg.</code></td>
160+
</tr>
155161
</tr>
156162
</table>
157163
</blockquote>
@@ -197,8 +203,10 @@ Utilizza Python-Script seguendo questi step:
197203

198204
- [x] **`V 3.0`**: <strike>Creazione 'main.py'.</strike>
199205
- [x] **`V 3.1`**: <strike>Refactor 'Readme.md'. Creazione Cartella 'Docs' con la documentazione di ogni script.</strike>
206+
- [x] **`V 3.1.1`**: <strike>Aggiunta Script PDF Combiner in versione Stabile.</strike>
207+
- [x] **`V 3.1.2`**: <strike>il wrapper `main.py` aggiunge automaticamente i nuovi script all'avvio.</strike>
200208
- [ ] **`V 3.2`**: Automatizzare il processo di installazione di Python e dipendenze al 100%.
201-
- [ ] **`V 4.0`**: unificare il tutto in un unico'main.py' con aggiunta di Interfaccia grafica.
209+
- [ ] **`V 4.0`**: unificare il tutto in un unico 'main.py' con aggiunta di Interfaccia grafica.
202210

203211
---
204212

@@ -233,16 +241,6 @@ Utilizza Python-Script seguendo questi step:
233241
8. **Revisione**: Una volta che la tua PR sarà revisionata e approvata, verrà unita ("merged") nel branch principale. Congratulazioni per il tuo contributo!
234242
</details>
235243

236-
<details closed>
237-
<summary>Contributor Graph</summary>
238-
<br>
239-
<p align="left">
240-
<a href="https://github.com{/Magnetarman/Python-Script/}graphs/contributors">
241-
<img src="https://contrib.rocks/image?repo=Magnetarman/Python-Script">
242-
</a>
243-
</p>
244-
</details>
245-
246244
---
247245

248246
## 🎗 Licenza

0 commit comments

Comments
 (0)