Створення Image Extractor Plugin for Aspose.PDF
Як витягти зображення з PDF за допомогою Aspose.PDF Image Extractor в .NET

Як витягти зображення з PDF за допомогою Aspose.PDF Image Extractor в .NET

Введення

Ця стаття показує, як екстрактувати всі зображення, вбудовані в PDF-файли за допомогою Aspose.PDF Image Extractor в .NET. Ви побачите, що робити, щоб екструкувати знімки з одного або декількох PDF, визначити типи виходу, і справлятися з різними випадками використання з короткими прикладами коду.

Реальні проблеми світу

Багато інструментів відмовляються від зображень або низької якості, в той час як бізнесу потрібні оригінальні, високоякісні знімки для документації, звітування, архівування або відновлення.

Огляд рішення

Aspose.PDF Image Extractor для .NET пропонує точну, програмну екстракцію зображень з будь-якого PDF — підтримує робочі місця, всі загальні формати знімків і налаштування вихідних шляхів.

Передумови

  • Visual Studio 2019 або вище
  • .NET 6.0 або пізніше
  • Aspose.PDF для .NET встановлено через NuGet
PM> Install-Package Aspose.PDF

Крок за кроком реалізація

Крок 1: Інсталювати і встановити Aspose.PDF

Додайте необхідні номінаційні простори:

using Aspose.Pdf.Plugins;
using System.IO;

Крок 2: Підготовка PDF-документу

Налаштуйте шлях вхідного файлу (один PDF):

string inputPath = @"C:\Samples\sample.pdf";

Крок 3: Екстракція базового зображення з PDF

Користувати ImageExtractor і ImageExtractorOptions Для того, щоб отримати всі зображення з PDF:

using (var plugin = new ImageExtractor())
{
    var options = new ImageExtractorOptions();
    options.AddInput(new FileDataSource(inputPath));
    var resultContainer = plugin.Process(options);
    foreach (var result in resultContainer.ResultCollection)
    {
        var imageFile = result.ToFile();
        Console.WriteLine($"Image saved: {imageFile}");
    }
}

Використання випадків і додатків (з варіантами коду)

1. Витяг зображень з кількох PDF (Batch Processing)

Перейти через каталог ПДФ Файли та екстракти всіх зображень:

string[] pdfFiles = Directory.GetFiles(@"C:\Samples\PDFs", "*.pdf");
foreach (var pdfFile in pdfFiles)
{
    using (var plugin = new ImageExtractor())
    {
        var options = new ImageExtractorOptions();
        options.AddInput(new FileDataSource(pdfFile));
        var resultContainer = plugin.Process(options);
        foreach (var result in resultContainer.ResultCollection)
        {
            var imageFile = result.ToFile();
            Console.WriteLine($"Extracted: {imageFile}");
        }
    }
}

2. Витяг тільки конкретних типів зображень (наприклад, JPEG/PNG)

Ви можете фільтрувати результати після процесу за розширенням файлу:

foreach (var result in resultContainer.ResultCollection)
{
    var imageFile = result.ToFile();
    if (Path.GetExtension(imageFile).Equals(".jpg", StringComparison.OrdinalIgnoreCase))
    {
        // Process only JPEG images
        Console.WriteLine($"JPEG found: {imageFile}");
    }
}

3. Експорт зображень до персоналізованої папки

Напишіть зображення в папку, визначену користувачем для інтеграції з CMS або звітами:

string exportDir = @"C:\Samples\ExportedImages";
Directory.CreateDirectory(exportDir);
int count = 0;
foreach (var result in resultContainer.ResultCollection)
{
    var imageFile = result.ToFile();
    var destPath = Path.Combine(exportDir, $"extracted_{++count}{Path.GetExtension(imageFile)}");
    File.Copy(imageFile, destPath, overwrite:true);
}

4. Екстракт зображень сторінка за сторінкою (Advanced)

Для кращого контролю, обробляти зображення за сторінкою, спочатку розділяючи PDF-файли або використовуючи логіку нижнього потоку на ResultCollection Індекс.

Спільні виклики та рішення

Проблема: Деякі зображення не витягнутіРішення: Переконайтеся, що PDF не пошкоджений; перевірте проблеми з типом XObject/image або запустіть екстракцію з найновішою версією Aspose.PDF.

Виклик: Вихідний тип файлу / форматРішення: Використовуйте післяобробку для конвертації витягнутих зображень, якщо потрібен конкретний формат.

Виконання та найкращі практики

  • Використовуйте видобуток для великих проектів або повторних робочих місць
  • Організуйте вихідні папки, щоб уникнути конфліктів з іменем файлу
  • Визначте якість зображення виходу і перевіряйте за допомогою цільових додатків
  • Завжди очищайте тимчасові файли в автоматизованих роунах

Повний приклад реалізації 

using Aspose.Pdf.Plugins;
using System;
using System.IO;

class Program
{
    static void Main()
    {
        string inputPath = @"C:\Samples\sample.pdf";
        using (var plugin = new ImageExtractor())
        {
            var options = new ImageExtractorOptions();
            options.AddInput(new FileDataSource(inputPath));
            var resultContainer = plugin.Process(options);
            foreach (var result in resultContainer.ResultCollection)
            {
                var imageFile = result.ToFile();
                Console.WriteLine($"Extracted image: {imageFile}");
            }
        }
    }
}

Заключення

Aspose.PDF Image Extractor для .NET ускладнює процес відновлення всіх зображень з PDF-документів — підтримуючи окремі файли, комплекти або індивідуальні видобутки потреб. Використовуйте його для автоматизації робочих потоків, систем управління документами, або повернення PDF візуалів з мінімальним кодом.

 Українська