Шаги по извлечению изображений из PDF‑документов на C#

1. Загрузить PDF в хранилище GroupDocs Cloud: Используйте StorageApi.UploadFile для размещения исходного PDF в облаке.

var uploadRequest = new UploadFileRequest(remotePdfPath, File.ReadAllBytes(localPdfPath));
storageApi.UploadFile(uploadRequest);

Этот вызов гарантирует, что файл доступен для разбора.

2. Запрос изображений документа: Вызовите ParserApi.GetDocumentImages с GetDocumentImagesRequest.

var imagesRequest = new GetDocumentImagesRequest(remotePdfPath);
ImagesResult imagesResult = parserApi.GetDocumentImages(imagesRequest);

Ответ содержит коллекцию объектов ImageInfo, каждый из которых хранит данные Base64 и метаданные. См. Справочник API для получения полной информации.

3. Декодировать и сохранить каждое изображение: Пройдите по imagesResult.Images, преобразуйте строку Base64 в массив байтов и запишите файл на диск.

foreach (ImageInfo imgInfo in imagesResult.Images)
{
    byte[] imageBytes = Convert.FromBase64String(imgInfo.Base64Data);
    string extension = imgInfo.FileExtension?.TrimStart('.').ToLower() ?? "bin";
    string fileName = $"extracted_page{imgInfo.PageNumber}_img{imgInfo.ImageIndex}_{imageCounter}.{extension}";
    File.WriteAllBytes(fileName, imageBytes);
}

Консоль выводит имя сохранённого файла, его размеры и DPI для проверки.

4. (Опционально) Очистка удалённого PDF: После извлечения вы можете удалить загруженный файл, чтобы поддерживать порядок в хранилище.

var deleteRequest = new DeleteFileRequest(remotePdfPath);
storageApi.DeleteFile(deleteRequest);

Этот шаг обёрнут в блок try‑catch, чтобы игнорировать любые ошибки очистки.

5. Просмотр вывода: Консоль отобразит сводку вроде Total images extracted: 12, подтверждая успешное извлечение.

Полный пример кода: извлечение изображений из PDF‑документов с помощью GroupDocs.Parser

Следующий пример демонстрирует полный рабочий процесс, описанный выше. Он включает конфигурацию, загрузку, извлечение изображений, сохранение и необязательную очистку.

using System;
using System.IO;
using System.Collections.Generic;
using GroupDocs.Parser.Cloud.Sdk.Api;
using GroupDocs.Parser.Cloud.Sdk.Client;
using GroupDocs.Parser.Cloud.Sdk.Model;
using GroupDocs.Parser.Cloud.Sdk.Model.Requests;

namespace ExtractImagesFromPdf
{
    class Program
    {
        static void Main(string[] args)
        {
            // Configuration – replace with your actual credentials
            var config = new Configuration
            {
                ClientId = "YOUR_CLIENT_ID",
                ClientSecret = "YOUR_CLIENT_SECRET"
            };

// APIs
            var storageApi = new StorageApi(config);
            var parserApi = new ParserApi(config);

// Input PDF path (local) and remote name in storage
            const string localPdfPath = "input.pdf";
            const string remotePdfPath = "input.pdf";

try
            {
                // -------------------------------------------------
                // 1. Upload PDF to GroupDocs Cloud storage (if not already there)
                // -------------------------------------------------
                if (!File.Exists(localPdfPath))
                    throw new FileNotFoundException($"Local file not found: {localPdfPath}");

var uploadRequest = new UploadFileRequest(remotePdfPath, File.ReadAllBytes(localPdfPath));
                storageApi.UploadFile(uploadRequest);

// -------------------------------------------------
                // 2. Retrieve document images (all pages)
                // -------------------------------------------------
                var imagesRequest = new GetDocumentImagesRequest(remotePdfPath);
                ImagesResult imagesResult = parserApi.GetDocumentImages(imagesRequest);

// -------------------------------------------------
                // 3. Save each extracted image to disk
                // -------------------------------------------------
                int imageCounter = 0;
                foreach (ImageInfo imgInfo in imagesResult.Images)
                {
                    // Image data is returned as Base64 string
                    byte[] imageBytes = Convert.FromBase64String(imgInfo.Base64Data);

// Build a descriptive file name
                    string extension = imgInfo.FileExtension?.TrimStart('.').ToLower() ?? "bin";
                    string fileName = $"extracted_page{imgInfo.PageNumber}_img{imgInfo.ImageIndex}_{imageCounter}.{extension}";
                    File.WriteAllBytes(fileName, imageBytes);

Console.WriteLine($"Saved: {fileName} ({imgInfo.Width}x{imgInfo.Height} px, {imgInfo.Resolution} DPI)");
                    imageCounter++;
                }

Console.WriteLine($"Total images extracted: {imageCounter}");
            }
            catch (ApiException apiEx)
            {
                Console.Error.WriteLine($"GroupDocs API error: {apiEx.ErrorCode} - {apiEx.Message}");
            }
            catch (Exception ex)
            {
                Console.Error.WriteLine($"Unexpected error: {ex.Message}");
            }
            finally
            {
                // -------------------------------------------------
                // 4. Optional cleanup – delete the uploaded PDF from storage
                // -------------------------------------------------
                try
                {
                    var deleteRequest = new DeleteFileRequest(remotePdfPath);
                    storageApi.DeleteFile(deleteRequest);
                }
                catch
                {
                    // Ignored – cleanup is optional
                }
            }
        }
    }
}

Примечание: Этот пример кода демонстрирует базовый функционал. Прежде чем использовать его в вашем проекте, убедитесь, что обновили все пути к файлам и значения конфигурации в соответствии с вашей реальной средой, проверьте, что все необходимые зависимости правильно установлены, и тщательно протестируйте в вашей среде разработки. Если вы столкнётесь с какими‑либо проблемами, обратитесь к официальной документации или свяжитесь с командой поддержки для получения помощи.

Извлечение изображений через REST API с помощью cURL

Тот же процесс можно выполнить с помощью прямых REST‑вызовов. Ниже приведён минимальный рабочий процесс cURL.

1. Получить токен доступа (OAuth 2.0 client credentials grant).

curl -X POST "https://api.groupdocs.cloud/v2.0/oauth2/token" \
     -H "Content-Type: application/x-www-form-urlencoded" \
     -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"

Ответ содержит access_token.

2. Загрузите PDF в облачное хранилище.

curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/pdf" \
     --data-binary "@input.pdf"

3. Запрос изображений для загруженного документа.

curl -X GET "https://api.groupdocs.cloud/v2.0/parser/input.pdf/images" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Ответ в формате JSON содержит массив изображений с base64Data, fileExtension, pageNumber и т.д.

4. Сохраните каждое изображение локально (пример с использованием jq и base64).

curl -X GET "https://api.groupdocs.cloud/v2.0/parser/input.pdf/images" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" | \
     jq -r '.images[] | "\(.pageNumber)_\(.imageIndex).\(.fileExtension) \(.base64Data)"' | \
     while read filename b64; do
         echo "$b64" | base64 -d > "$filename"
     done

Для получения более подробной информации об эндпоинтах и параметрах см. официальную документацию API.

Подготовка среды

1. Установите клиентскую библиотеку .NET через NuGet:

dotnet add package GroupDocs.Parser-Cloud

Пакет доступен на официальной странице загрузки.

2. Убедитесь, что у вас установлен .NET 6.0 или более новая версия, а также есть действующая учетная запись GroupDocs Cloud с клиентскими учетными данными.

3. (Опционально) Клонировать репозиторий примера для справки:

   git clone https://github.com/groupdocs-parser-cloud/groupdocs-parser-cloud-dotnet.git
   

Что делает GroupDocs.Parser подходящим для извлечения изображений

• Прямое извлечение изображений: Вызов GetDocumentImages возвращает изображения в их оригинальном формате без дополнительных шагов конвертации.
• Доставка в Base64: Изображения предоставляются в виде строк Base64, что упрощает их декодирование на любом языке.
• Метаданные на уровне страниц: Каждый ImageInfo включает номер страницы, размеры, разрешение и индекс, что помогает организовать извлечённые ресурсы.
• Поддержка всех распространённых растровых форматов: PNG, JPEG, BMP, GIF, TIFF и другие сохраняются точно так же, как хранятся в PDF.
• Масштабируемая облачная обработка: Большие PDF‑файлы обрабатываются на серверах GroupDocs, снижая нагрузку на память вашего приложения.

Настройка параметров извлечения изображений

Хотя базовый пример работает сразу, вы можете тонко настроить запрос:

• Укажите диапазон страниц: Добавьте pages = "1-5" к GetDocumentImagesRequest, чтобы ограничить извлечение.
• Установите качество изображения: Используйте параметр imageQuality (0‑100), если вам нужен сжатый вывод.
• Фильтрация по формату: Укажите fileExtensions = ["png","jpeg"], чтобы получить только выбранные форматы.

Эти параметры задокументированы в справочнике API.

Заключение

Извлечение изображений из PDF‑документов в C# становится простым и надёжным процессом, когда вы используете GroupDocs.Parser Cloud SDK for .NET. SDK обрабатывает загрузку, разбор и конвертацию в Base64, позволяя вам сосредоточиться на сохранении файлов и их интеграции в ваш рабочий процесс. Не забудьте защитить учётные данные клиента, соблюдать условия лицензирования и рассмотреть возможность получения временной лицензии для оценки на странице временной лицензии. С предоставленными примерами кода и REST‑запросов вы готовы добавить надёжное извлечение изображений из PDF в любое приложение .NET.

Часто задаваемые вопросы

Как извлечь изображения из PDF‑документов с помощью C#?
Используйте метод GetDocumentImages API Parser после загрузки PDF с помощью StorageApi.UploadFile. Декодируйте возвращённые строки Base64 и запишите их на диск, как показано в примере кода.

Что делать, если PDF защищён паролем?
Укажите пароль в модели запроса. SDK расшифрует файл перед извлечением изображений. Смотрите документацию для точного названия свойства.

Могу ли я ограничить извлечение определёнными страницами?
Да, установите свойство pages в GetDocumentImagesRequest в список, разделённый запятыми, или диапазон (например, "1-3,5"). API вернёт изображения только с этих страниц.

Есть ли ограничения по размеру для извлечённых изображений?
SDK возвращает оригинальные данные изображения без изменения размера. Если вам нужны более мелкие файлы, выполните пост‑обработку сохранённых изображений с помощью любой библиотеки обработки изображений.

Читать далее

• Извлечение изображений из PDF на C# .NET | PDF Image Extractor API
• Извлечение изображений из PDF‑документов на Java
• Извлечение текста из PDF с использованием .NET REST API | Document to Text Converter

Извлечение изображений из PDF‑документов на Java за 5 шагов

1. Настройте учетные данные API: Создайте объект Configuration и задайте ваш client ID и secret.

Configuration config = new Configuration();
config.setClientId("YOUR_CLIENT_ID");
config.setClientSecret("YOUR_CLIENT_SECRET");

2. Инициализировать Parser API: Создайте ApiClient с конфигурацией и создайте экземпляр ParserApi.

ApiClient apiClient = new ApiClient(config);
ParserApi parserApi = new ParserApi(apiClient);

3. Создайте запрос на извлечение изображений: Укажите путь к PDF‑файлу, используя FileInfo, и создайте ExtractImagesRequest.

   String inputFilePath = "input.pdf";
   ExtractImagesRequest request = new ExtractImagesRequest()
           .setFileInfo(new FileInfo().setFilePath(inputFilePath));
   

4. Выполнить извлечение и получить изображения: Вызовите extractImages и получите список объектов Image.

ImagesResult imagesResult = parserApi.extractImages(request);
List<Image> images = imagesResult.getImages();

5. Сохранить каждое изображение в локальное хранилище: Пройтись по коллекции и записать двоичные данные в файлы.

for (int i = 0; i < images.size(); i++) {
    Image img = images.get(i);
    String outputFileName = "extracted_image_" + (i + 1) + "_" + img.getFileName();
    try (FileOutputStream fos = new FileOutputStream(outputFileName)) {
        fos.write(img.getData());
    }
    System.out.println("Saved image: " + outputFileName);
}

Для получения более подробной информации о каждом классе см. официальную справочную документацию API.

Полный пример кода: извлечение изображений из PDF‑документов на Java с использованием GroupDocs.Parser

В следующем примере демонстрируется полный рабочий процесс от настройки учетных данных до сохранения изображения.

import com.groupdocs.parser.cloud.ApiClient;
import com.groupdocs.parser.cloud.Configuration;
import com.groupdocs.parser.cloud.api.ParserApi;
import com.groupdocs.parser.cloud.model.FileInfo;
import com.groupdocs.parser.cloud.model.Image;
import com.groupdocs.parser.cloud.model.ImagesResult;
import com.groupdocs.parser.cloud.model.requests.ExtractImagesRequest;

import java.io.FileOutputStream;
import java.util.List;

public class ExtractImagesFromPdf {
    public static void main(String[] args) {
        // Configure API credentials
        Configuration config = new Configuration();
        config.setClientId("YOUR_CLIENT_ID");
        config.setClientSecret("YOUR_CLIENT_SECRET");
        // config.setBaseUrl("https://api.groupdocs.cloud"); // optional, if needed

// Initialize API client and Parser API
        ApiClient apiClient = new ApiClient(config);
        ParserApi parserApi = new ParserApi(apiClient);

// Path to the PDF file stored in GroupDocs Cloud storage
        String inputFilePath = "input.pdf";

// Build request for image extraction
        ExtractImagesRequest request = new ExtractImagesRequest()
                .setFileInfo(new FileInfo().setFilePath(inputFilePath));

try {
            // Perform extraction
            ImagesResult imagesResult = parserApi.extractImages(request);
            List<Image> images = imagesResult.getImages();

// Save each extracted image to local disk
            for (int i = 0; i < images.size(); i++) {
                Image img = images.get(i);
                String outputFileName = "extracted_image_" + (i + 1) + "_" + img.getFileName();
                try (FileOutputStream fos = new FileOutputStream(outputFileName)) {
                    fos.write(img.getData());
                }
                System.out.println("Saved image: " + outputFileName);
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

Примечание: Этот пример кода демонстрирует базовый функционал. Прежде чем использовать его в вашем проекте, убедитесь, что обновили все пути к файлам и значения конфигурации в соответствии с вашей реальной средой, проверьте, что все необходимые зависимости правильно установлены, и тщательно протестируйте в вашей среде разработки. Если вы столкнётесь с какими‑либо проблемами, обратитесь к официальной документации или свяжитесь с командой поддержки для получения помощи.

Извлечение изображений из PDF с помощью cURL и REST API

Вы можете достичь того же результата, не пиша код на Java, вызывая REST‑конечные точки GroupDocs.Parser Cloud напрямую.

1. Получить токен доступа

curl -X POST "https://api.groupdocs.cloud/v2.0/connect/token" \
        -H "Content-Type: application/x-www-form-urlencoded" \
        -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"

2. Загрузите PDF‑файл

curl -X POST "https://api.groupdocs.cloud/v2.0/storage/file/upload?path=input.pdf" \
        -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
        -F "file=@/path/to/input.pdf"

3. Запрос извлечения изображений

curl -X POST "https://api.groupdocs.cloud/v2.0/parser/extractImages" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"fileInfo": {"filePath": "input.pdf"}}'

4. Скачать извлечённые изображения (ответ содержит данные в формате base64; вы можете декодировать их локально)

Для полного списка параметров см. официальную документацию API.

Установка и настройка GroupDocs.Parser Cloud SDK for Java

Добавьте зависимость Maven в ваш pom.xml (или эквивалентный фрагмент Gradle).

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-parser-cloud</artifactId>
    <version>26.2</version>
</dependency>

SDK поставляется как облачная библиотека; локальные бинарные файлы не требуются. Скачайте последнюю версию с страницы релизов. Убедитесь, что у вас установлен Java 8 или новее, а также действующая учетная запись GroupDocs Cloud с идентификатором клиента и секретом.

GroupDocs.Parser Cloud SDK for Java Функции, позволяющие извлекать изображения

• Полное извлечение изображений PDF - Извлекает каждое растровое и векторное изображение, встроенное в документ.
• Метаданные для каждого изображения - Возвращает имя файла, размер, формат и номер страницы.
• Поддержка всех распространённых форматов изображений - PNG, JPG, BMP, GIF, TIFF, и другие.
• Интеграция с облачным хранилищем - Работает напрямую с файлами, хранящимися в GroupDocs Cloud, без их предварительной загрузки.
• Масштабируемая обработка на основе REST‑based - Обрабатывает большие PDF и задачи с высоким объёмом нагрузки через облачный API.

Точная настройка параметров извлечения изображений

Хотя базовый запрос работает сразу же, вы можете настроить такие параметры, как:

• Защита паролем - Установите свойство password в FileInfo для зашифрованных PDF.
• Диапазон страниц - Ограничьте извлечение определёнными страницами, добавив массив pages в JSON‑запрос.
• Конвертация формата изображения - Запросите конвертацию в другой формат, указав желаемый тип вывода в запросе (см. API reference для точных полей).

Пример установки пароля (взято из основного кода):

FileInfo fileInfo = new FileInfo()
        .setFilePath("protected.pdf")
        .setPassword("mySecret");

Практические советы по эффективному извлечению изображений из PDF

• Проверьте наличие файла перед отправкой запроса, чтобы избежать ненужных вызовов API.
• Обрабатывайте изображения в потоках при работе с большими файлами, чтобы снизить потребление памяти.
• Используйте пагинацию, если вам нужны изображения только с определённых страниц; это ускорит ответ.
• Обрабатывайте ограничения скорости API, реализуя экспоненциальную задержку при ответах HTTP 429.
• Записывайте имя каждого сохранённого файла для упрощения отладки и аудита.

Заключение

Извлечение изображений из PDF‑документов в Java становится простой и надёжной задачей, когда вы используете возможности GroupDocs.Parser Cloud SDK for Java. SDK управляет учётными данными, взаимодействием с облачным хранилищем и декодированием изображений, позволяя вам сосредоточиться на логике приложения. Для продакшн‑развёртываний приобретите соответствующую лицензию на странице ценообразования или получите временную лицензию для оценки. С примером кода, руководством по cURL и рекомендациями лучших практик в этой статье вы готовы интегрировать извлечение изображений из PDF в любое решение на Java.

Часто задаваемые вопросы

• Какие форматы можно извлечь из PDF?
  SDK извлекает растровые форматы, такие как PNG, JPG, BMP, GIF и TIFF, а также векторную графику, когда она хранится в виде изображений.

• Нужно ли загружать PDF перед извлечением изображений?
  Нет. SDK работает напрямую с файлами, хранящимися в GroupDocs Cloud, исключая необходимость локального скачивания.

• Как SDK обрабатывает большие PDF?
  Извлечение выполняется на стороне сервера, поэтому использование памяти на вашем компьютере остаётся низким. Вы также можете ограничить извлечение конкретными страницами для повышения производительности.

• Есть ли способ протестировать извлечение без написания кода?
  Да, вы можете использовать приведённые выше команды cURL или попробовать интерактивную консоль API на странице продукта.

Читать дальше

• Извлечение изображений из PDF‑файлов в Java с использованием REST API
• Программное извлечение изображений из Word‑документов в Java
• Извлечение изображений из PDF‑документов с помощью Python