Konwersja PDF na JPG lub PNG: co zmienia DPI i jak wyeksportować jedną stronę
PDF na obrazy renderuje każdą stronę do archiwum ZIP, jako PNG, chyba że wybierzesz JPEG. Formularz w przeglądarce ma tylko format i DPI; pola API do wyboru stron i WebP są ignorowane. Zmierzone rozmiary plików przy 150 i 300 DPI oraz sposób eksportu jednej strony.
PDF na obrazy zamienia każdą stronę pliku PDF w osobny plik obrazu i zwraca je w archiwum ZIP. Formularz w przeglądarce ma dwa ustawienia, format (PNG lub JPEG) i DPI, a nie da się w nim wybrać stron ani formatu WebP. Oba ustawienia mocno zmieniają rozmiar wyniku, a poniższe sekcje pokazują, o ile.
Przykład krok po kroku: sześć stron, cztery ustawienia
Plik testowy to 6-stronicowy dokument w formacie US Letter, wyłącznie z tekstem, wygenerowany w Ghostscript: 32 wiersze czcionki Times 11 pt na stronę, 5593 bajty. Został wysłany do punktu końcowego /api/v1/convert/pdf/img lokalnej wersji serwera, raz dla każdego ustawienia. Liczby pochodzą z jednego przebiegu z 2026-10-04; inny dokument da inne rozmiary.
| DPI | Format | Piksele na stronę | Strona 1 | ZIP, wszystkie 6 stron |
|---|---|---|---|---|
| 150 | PNG | 1275 x 1650 | 53 400 bajtów | 195 476 bajtów |
| 300 | PNG | 2550 x 3300 | 127 391 bajtów | 494 897 bajtów |
| 150 | JPEG | 1275 x 1650 | 252 280 bajtów | 1 340 684 bajtów |
| 300 | JPEG | 2550 x 3300 | 685 891 bajtów | 3 272 299 bajtów |
Wymiary w pikselach wynikają z rozmiaru strony: strona Letter ma 8,5 na 11 cali, więc 150 DPI to 1275 na 1650, a 300 DPI to 2550 na 3300. Podwojenie DPI czterokrotnie zwiększa liczbę pikseli, ale ZIP z plikami PNG urósł tu około 2,5 raza, ponieważ jednolite białe obszary dobrze się kompresują.
Dla tego pliku JPEG był większy niż PNG: strona 1 miała przy 150 DPI około 4,7 raza większy rozmiar. Popularna rada, że JPEG to format mały, sprawdza się przy fotografiach. Strona tekstowa to głównie jednolita biel z ostrymi krawędziami, które PNG kompresuje dobrze, a JPEG nie. Strona z fotografią lub skan może wypaść odwrotnie, więc przetestuj jedną reprezentatywną stronę, zanim skonwertujesz sto.
Archiwum ZIP nosi nazwę pliku PDF (contract.zip dla contract.pdf) i zawiera pliki od page.1.png do page.6.png, albo pliki .jpg, gdy wybierzesz JPEG.
Opcje, które API przyjmuje, ale ignoruje
Formularz w przeglądarce ich nie oferuje, ale skrypt, który je wyśle, nie dostanie błędu ani żadnego efektu:
- Wybór stron. Wysłanie
pageNumbers=2zwróciło wszystkie sześć stron, a nie jedną. Zawsze renderowane są wszystkie strony. - WebP.
imageFormat=webpzwróciło pliki PNG o tych samych nazwach i rozmiarach copng. Tylkojpegijpgwybierają JPEG; każda inna wartość wraca do PNG.
Jeśli potrzebujesz WebP, przekonwertuj potem pliki PNG w edytorze obrazów.
Pobranie jednej strony
Najpierw wytnij stronę, a potem skonwertuj jednostronicowy PDF:
- Otwórz Wyodrębnij strony, wgraj PDF i wpisz
2jako stronę do zachowania. Wynikiem w teście był 1-stronicowy PDF. - Wgraj ten PDF do PDF na obrazy, ustaw DPI na 150 i zostaw PNG. Archiwum ZIP zawierało jeden plik,
page.1.png.
Plik nazywa się page.1.png, choć pochodzi ze strony 2 oryginału, bo numeracja zaczyna się od nowa w wyodrębnionym PDF. Zmień nazwę, jeśli ważny jest numer strony z oryginału.
DPI: gdzie formularz i API się różnią
Formularz na stronie jest wstępnie wypełniony wartością 300. Bezpośrednie wywołanie API bez dpi renderuje przy 150. Jeśli skrypt daje mniejsze obrazy niż przeglądarka, to jest powód; wysyłaj dpi jawnie w obu miejscach. Wartość nienumeryczna jest odrzucana błędem 400 z komunikatem „dpi must be a number”.
Orientacyjna wskazówka, oparta na tabeli powyżej, a nie na żadnym teście jakości: 150 DPI wystarcza, by czytać całą stronę na ekranie; 300 DPI służy do druku albo do powiększania drobnego druku. W tym przebiegu ZIP z plikami PNG przy 300 DPI był około 2,5 raza większy niż przy 150 DPI, a długi dokument pełen skanów to pomnaża.
Co nie przetrwa
Wynik to piksele, więc:
- Tekst nie jest już zaznaczalny ani wyszukiwalny. Do tekstu użyj PDF na RTF (tekst), a dla skanu OCR.
- Linki przestają działać.
- Wektorowe logo i diagramy są rasteryzowane przy wybranym DPI i rozmyją się po późniejszym powiększeniu. Zamiast tego uruchom konwersję ponownie z wyższym DPI.
Trzymaj oryginalny PDF obok obrazów. Powrót przez Obrazy na PDF da PDF złożony ze zdjęć tekstu, a nie oryginalny dokument.
Plik PDF chroniony hasłem jest odrzucany błędem 400, This PDF is password-protected. Enter its password., a pole password wysłane do tego punktu końcowego tego nie zmienia. Najpierw usuń hasło narzędziem Usuń hasło.
Sprawdź, zanim użyjesz całego zestawu
Otwórz jedną stronę z archiwum ZIP w powiększeniu 100% i sprawdź drobny tekst oraz cienkie linie. Jeśli jest miękki, podnieś DPI i uruchom ponownie; jeśli ZIP jest za duży, obniż DPI albo przełącz na JPEG dopiero po upewnieniu się, że dla twoich stron faktycznie jest mniejszy.