НАЧАЛО >> Электронная библиотека >> Руководство администратора модуля FT >> Настройка модуля и параметров отображения >> Многостраничные документы >> FT::ExtractOneImageFromPDF()📄 Скачать в DOCX
FT::ExtractOneImageFromPDF() - служебная функция модуля FT для извлечения одной страницы PDF-документа в отдельный файл изображения. Ее используют в серверных сценариях обработки PDF, когда нужно получить изображение конкретной страницы без полной подготовки многостраничного просмотрщика.
Функция вызывается из PHP-кода через модуль FT:
UseModule('FT')->ExtractOneImageFromPDF(
string $pdfPath,
string $resultPath,
int $pageNo = 1,
string $resultFormat = 'png',
int $maxWidth = 0,
int $maxHeight = 0
);| Параметр | Обязательность | Описание |
|---|---|---|
$pdfPath |
Да | Полный путь к исходному PDF-файлу. |
$resultPath |
Да | Полный путь к результирующему файлу изображения. Имя файла должно соответствовать нужному расширению, например page-2.png или cover.jpg. |
$pageNo |
Нет | Номер страницы PDF для извлечения. Нумерация начинается с 1. |
$resultFormat |
Нет | Формат результирующего изображения: png, jpg, gif или bmp. По умолчанию используется png. |
$maxWidth |
Нет | Максимальная ширина изображения в пикселях. Значение 0 не ограничивает ширину. |
$maxHeight |
Нет | Максимальная высота изображения в пикселях. Значение 0 не ограничивает высоту. |
В указанном $resultPath создается файл изображения выбранной страницы. Внутри функция сначала получает PNG через mutool, а затем при необходимости конвертирует его в jpg, gif или bmp средствами расширения GD.
Если для сервера задано ограничение ширины или высоты, оно передается в mutool как ограничение размера результата. Если оба ограничения равны 0, страница извлекается без дополнительного ограничения размеров.
$pdf = 'C:/i128/data/source/book.pdf';
$image = 'C:/i128/data/tmp/book-page-2.jpg';
UseModule('FT')->ExtractOneImageFromPDF($pdf, $image, 2, 'jpg', 1200, 0);Пример создает JPEG-изображение второй страницы PDF и ограничивает ширину результата значением 1200 пикселей.
Краткая карточка функции также доступна в списке внешних функций модуля FT: ?id=Help/Show&m=Help/Module/Functions&module=FT#ExtractOneImageFromPDF.