Convertire un PDF in JPG o PNG: cosa cambia con i DPI e come esportare una sola pagina
PDF in immagini genera ogni pagina in uno ZIP, come PNG a meno che tu scelga JPEG. Il modulo del browser ha solo formato e DPI; i campi API per la selezione delle pagine e per WebP vengono ignorati. Dimensioni misurate dei file a 150 e 300 DPI e come esportare una singola pagina.
PDF in immagini trasforma ogni pagina di un PDF in un file immagine e li restituisce in uno ZIP. Il modulo del browser ha due impostazioni, il formato (PNG o JPEG) e i DPI, e non c'è modo di scegliere le pagine né WebP. Entrambe le impostazioni cambiano molto la dimensione dell'output, e le sezioni seguenti mostrano di quanto.
Un esempio concreto: sei pagine, quattro impostazioni
Il file di prova era un documento di 6 pagine, in formato US Letter, solo testo, generato con Ghostscript: 32 righe di Times a 11 pt per pagina, 5.593 byte. È stato inviato all'endpoint /api/v1/convert/pdf/img di una build locale del server, una volta per ogni impostazione. I numeri vengono da una sola esecuzione il 2026-10-04; un altro documento darà dimensioni diverse.
| DPI | Formato | Pixel per pagina | Pagina 1 | ZIP, tutte e 6 le pagine |
|---|---|---|---|---|
| 150 | PNG | 1275 x 1650 | 53.400 byte | 195.476 byte |
| 300 | PNG | 2550 x 3300 | 127.391 byte | 494.897 byte |
| 150 | JPEG | 1275 x 1650 | 252.280 byte | 1.340.684 byte |
| 300 | JPEG | 2550 x 3300 | 685.891 byte | 3.272.299 byte |
Le dimensioni in pixel derivano dal formato della pagina: una pagina Letter è 8,5 per 11 pollici, quindi 150 DPI sono 1275 per 1650 e 300 DPI sono 2550 per 3300. Raddoppiare i DPI quadruplica il numero di pixel, ma lo ZIP dei PNG è cresciuto di circa 2,5 volte, perché le aree bianche uniformi si comprimono bene.
Per questo file, il JPEG è risultato più grande del PNG: la pagina 1 era circa 4,7 volte più grande a 150 DPI. Il consiglio abituale secondo cui il JPEG è il formato leggero vale per le fotografie. Una pagina di testo è quasi tutta bianca uniforme con bordi netti, che il PNG comprime bene e il JPEG no. Una pagina fotografica o scansionata può andare nel verso opposto, quindi prova una pagina rappresentativa prima di convertirne cento.
Lo ZIP prende il nome del PDF (contract.zip per contract.pdf) e contiene da page.1.png a page.6.png, oppure file .jpg se scegli JPEG.
Opzioni che l'API accetta ma ignora
Il modulo del browser non offre queste due opzioni, ma uno script che le invia non riceve alcun errore e nessun effetto:
- Selezione delle pagine. Inviando
pageNumbers=2sono tornate tutte e sei le pagine, non una. Ogni pagina viene sempre generata. - WebP.
imageFormat=webpha restituito file PNG con gli stessi nomi e dimensioni dipng. Solojpegejpgselezionano JPEG; qualsiasi altro valore ripiega su PNG.
Se ti serve WebP, converti i file PNG in seguito con un editor di immagini.
Ottenere una sola pagina
Ritaglia prima la pagina, poi converti il PDF di una pagina:
- Apri Estrai pagine, carica il PDF e inserisci
2come pagina da tenere. Il risultato nella prova era un PDF di 1 pagina. - Carica quel PDF su PDF in immagini, imposta i DPI a 150 e lascia PNG. Lo ZIP conteneva un solo file,
page.1.png.
Il file si chiama page.1.png anche se viene dalla pagina 2 dell'originale, perché la numerazione riparte nel PDF estratto. Rinominalo se il numero di pagina originale ha importanza.
DPI: dove il modulo e l'API non concordano
Il modulo web precompila 300. Una chiamata API diretta che omette dpi genera a 150. Se uno script produce immagini più piccole di quelle del browser, il motivo è questo; invia dpi esplicitamente in entrambi i casi. Un valore non numerico viene rifiutato con un 400 e il messaggio "dpi must be a number".
Indicazione di massima, basata sulla tabella qui sopra e non su un benchmark di qualità: 150 DPI bastano per leggere una pagina intera su uno schermo; 300 DPI servono per la stampa o per ingrandire i caratteri piccoli. In questa esecuzione lo ZIP dei PNG a 300 DPI era circa 2,5 volte quello a 150 DPI, e un documento lungo e ricco di scansioni moltiplica la differenza.
Cosa non sopravvive
Il risultato sono pixel, quindi:
- Il testo non è più selezionabile né ricercabile. Per il testo usa PDF in RTF (testo), oppure OCR per una scansione.
- I link smettono di funzionare.
- Loghi e diagrammi vettoriali vengono rasterizzati ai DPI scelti e si sfocheranno se ingranditi in seguito. Rigenera invece a DPI più alti.
Tieni il PDF originale accanto alle immagini. Tornare indietro con Immagini in PDF ti dà un PDF fatto di immagini di testo, non il documento originale.
Un PDF protetto da password viene rifiutato con un 400, This PDF is password-protected. Enter its password., e un campo password inviato a questo endpoint non cambia la situazione. Rimuovi prima la password con Rimuovi password.
Controlla prima di usare l'intero set
Apri una pagina dello ZIP al 100% di zoom e controlla i caratteri piccoli e le linee sottili. Se è sfocata, alza i DPI e rigenera; se lo ZIP è troppo grande, abbassa i DPI, oppure passa a JPEG solo dopo aver verificato che sia davvero più piccolo per le tue pagine.