Конвертація PDF у JPG або PNG: що змінює DPI і як експортувати одну сторінку
«PDF у зображення» рендерить кожну сторінку в ZIP, у PNG, якщо не вибрати JPEG. У формі в браузері є лише формат і DPI; поля API для вибору сторінок і WebP ігноруються. Виміряні розміри файлів при 150 і 300 DPI та як експортувати одну сторінку.
PDF у зображення перетворює кожну сторінку PDF на окремий файл зображення й повертає їх у ZIP. Форма в браузері має два налаштування, формат (PNG або JPEG) і DPI, а вибрати сторінки чи WebP не можна. Обидва налаштування сильно змінюють розмір результату, і розділи нижче показують, наскільки.
Приклад від початку до кінця: шість сторінок, чотири налаштування
Тестовий файл — 6-сторінковий документ формату US Letter лише з текстом, згенерований у Ghostscript: 32 рядки Times 11 pt на сторінці, 5 593 байти. Його надсилали на кінцеву точку /api/v1/convert/pdf/img локальної збірки сервера, по одному разу для кожного налаштування. Числа — з одного прогону 2026-10-04; інший документ дасть інші розміри.
| DPI | Формат | Пікселів на сторінку | Сторінка 1 | ZIP, усі 6 сторінок |
|---|---|---|---|---|
| 150 | PNG | 1275 x 1650 | 53 400 байтів | 195 476 байтів |
| 300 | PNG | 2550 x 3300 | 127 391 байт | 494 897 байтів |
| 150 | JPEG | 1275 x 1650 | 252 280 байтів | 1 340 684 байти |
| 300 | JPEG | 2550 x 3300 | 685 891 байт | 3 272 299 байтів |
Піксельні розміри випливають із розміру сторінки: сторінка Letter має 8,5 на 11 дюймів, тож 150 DPI — це 1275 на 1650, а 300 DPI — 2550 на 3300. Подвоєння DPI учетверо збільшує кількість пікселів, але ZIP з PNG зріс тут приблизно у 2,5 раза, бо плоскі білі ділянки добре стискаються.
Для цього файлу JPEG виявився більшим за PNG: сторінка 1 була приблизно в 4,7 раза більшою при 150 DPI. Звична порада, що JPEG — це малий формат, слушна для фотографій. Текстова сторінка — це переважно плоский білий фон із різкими краями, які PNG стискає добре, а JPEG ні. Фотографічна або відсканована сторінка може поводитися навпаки, тож перевірте одну типову сторінку, перш ніж конвертувати сотню.
ZIP називається за PDF (contract.zip для contract.pdf) і містить page.1.png до page.6.png, або файли .jpg, якщо обрано JPEG.
Опції, які API приймає, але ігнорує
Форма в браузері цих двох не пропонує, але скрипт, що їх надсилає, не отримає ні помилки, ні ефекту:
- Вибір сторінок. Надсилання
pageNumbers=2повернуло всі шість сторінок, а не одну. Завжди рендеряться всі сторінки. - WebP.
imageFormat=webpповернув файли PNG з тими самими назвами й розмірами, що йpng. JPEG вибирають лишеjpegіjpg; будь-яке інше значення відкочується до PNG.
Якщо потрібен WebP, конвертуйте файли PNG потім у графічному редакторі.
Як отримати одну сторінку
Спершу вирізайте сторінку, потім конвертуйте односторінковий PDF:
- Відкрийте Вийняти сторінки, завантажте PDF і введіть
2як сторінку для збереження. У тесті результатом був 1-сторінковий PDF. - Завантажте цей PDF у PDF у зображення, задайте DPI 150 і залиште PNG. ZIP містив один файл,
page.1.png.
Файл називається page.1.png, хоча походить зі сторінки 2 оригіналу, бо нумерація в витягнутому PDF починається заново. Перейменуйте його, якщо номер сторінки оригіналу важливий.
DPI: де форма й API розходяться
Вебформа попередньо заповнює 300. Прямий виклик API без dpi рендерить при 150. Якщо скрипт дає менші зображення, ніж браузер, причина в цьому; задавайте dpi явно в обох випадках. Нечислове значення відхиляється з 400 і повідомленням «dpi must be a number».
Орієнтир, що спирається на таблицю вище, а не на будь-який тест якості: 150 DPI достатньо, щоб прочитати цілу сторінку на екрані; 300 DPI — для друку або для наближення до дрібного шрифту. У цьому прогоні ZIP з PNG при 300 DPI був приблизно в 2,5 раза більшим за ZIP при 150 DPI, а довгий документ із багатьма сканами примножує це.
Що не виживає
Результат — це пікселі, тому:
- Текст більше не виділяється і в ньому не можна шукати. Для тексту використайте PDF у текст, а для скана — OCR.
- Посилання перестають працювати.
- Векторні логотипи й діаграми растеризуються при вибраному вами DPI і розмиватимуться, якщо їх потім збільшити. Замість цього повторіть із вищим DPI.
Тримайте оригінальний PDF поруч із зображеннями. Повернення через Зображення в PDF дасть PDF із картинок тексту, а не оригінальний документ.
PDF, захищений паролем, відхиляється з 400, This PDF is password-protected. Enter its password., а поле password, надіслане на цю кінцеву точку, цього не змінює. Спершу зніміть пароль через Зняти пароль.
Перевірте перед масовим використанням набору
Відкрийте одну сторінку з ZIP у масштабі 100% і перевірте дрібний текст і тонкі лінії. Якщо вона м’яка, підніміть DPI й повторіть; якщо ZIP надто великий, знизьте DPI або перейдіть на JPEG лише після того, як переконаєтеся, що для ваших сторінок він справді менший.