C# Konwersja PDF na obraz: Kompletny przewodnik dla deweloperów

Why Convert PDF Documents to Images in C#?

Konwertowanie stron PDF na obrazy ma praktyczne zastosowania w nowoczesnych aplikacjach .NET Framework czy .NET. Systemy zarzadzania dokumentami potrzebuja miniatur do szybkiej nawigacji wizualnej, podczas gdy aplikacje webowe korzystaja z formatow obrazow dla lepszej zgodnosci z przegladarkami i szybszych czasow ladowania.

Dodatkowo, konwersja PDF do obrazów zapewnia, że twój PDF wygląda dobrze na każdej platformie z ograniczonym wsparciem dla bibliotek PDF. Niezaleznie od tego, czy pracujesz z wieloma stronami czy pojedyncza strona, IronPDF dokonuje tego procesu w zaledwie kilku linijkach kodu bez obaw o bledy czy skomplikowane renderowanie.

Pierwsze kroki z IronPDF

Najpierw stworz nowa aplikacje konsolowa C# w Visual Studio i zainstaluj IronPDF za pomoca Menedzera pakietow NuGet:

Install-Package IronPdf

IronPDF obsługuje .NET Framework, .NET Core i .NET 5+, zapewniając kompatybilność procesu konwersji plików PDF na obrazy z każdą używaną wersją .NET. Po zainstalowaniu możesz rozpocząć konwersję stron PDF na pliki graficzne w swoim programie.

Jak przekonwertować strony PDF na pliki graficzne?

Najprostszym sposobem na konwersję PDF na obrazy jest załadowanie dokumentu i wywołanie metody RasterizeToImageFiles:

using IronPdf;
class Program
{
    static void Main(string[] args)
    {
        // Load an existing PDF document
        var pdfDocument = PdfDocument.FromFile("report.pdf");
        // Convert all pages to PNG images
        pdfDocument.RasterizeToImageFiles(@"C:\images\page_*.png");
    }
}

using IronPdf;
class Program
{
    static void Main(string[] args)
    {
        // Load an existing PDF document
        var pdfDocument = PdfDocument.FromFile("report.pdf");
        // Convert all pages to PNG images
        pdfDocument.RasterizeToImageFiles(@"C:\images\page_*.png");
    }
}

Imports IronPdf

Class Program
    Shared Sub Main(args As String())
        ' Load an existing PDF document
        Dim pdfDocument = PdfDocument.FromFile("report.pdf")
        ' Convert all pages to PNG images
        pdfDocument.RasterizeToImageFiles("C:\images\page_*.png")
    End Sub
End Class

Ten kod konwertuje każdą stronę pliku PDF na oddzielny plik PNG. Gwiazdka (*) w szablonie nazwy pliku jest automatycznie zastępowana numerem strony. Dla właściwego zarządzania zasobami, należy umieścić PdfDocument w instrukcji using, aby zapewnić usunięcie zasobów.

Po uruchomieniu kodu w katalogu wyjściowym widzimy, że mimo iż nasz plik PDF zawiera wiele stron, nasz kod nie określa, które strony mają zostać przekonwertowane, więc każda z nich została zapisana jako osobny plik graficzny:

Aby przekonwertować konkretne strony, należy określić zakres stron:

// Specify the page indexes for conversion
int[] pageIndexes = new[] { 0, 1, 2 };
// Convert pages 1-3 to JPG images
pdfDocument.RasterizeToImageFiles(@"C:\images\page_*.jpg", pageIndexes);

// Specify the page indexes for conversion
int[] pageIndexes = new[] { 0, 1, 2 };
// Convert pages 1-3 to JPG images
pdfDocument.RasterizeToImageFiles(@"C:\images\page_*.jpg", pageIndexes);

' Specify the page indexes for conversion
Dim pageIndexes As Integer() = {0, 1, 2}
' Convert pages 1-3 to JPG images
pdfDocument.RasterizeToImageFiles("C:\images\page_*.jpg", pageIndexes)

Należy pamiętać, że indeksowanie stron zaczyna się od 0, więc pierwsza strona ma pageIndex = 0.

Jak kontrolować jakość obrazu?

Jakość obrazu ma bezpośredni wpływ na rozmiar pliku i przejrzystość wizualną. IronPDF pozwala kontrolować to poprzez ustawienia DPI (punktów na cal):

// High-quality conversion at 300 DPI
pdfDocument.RasterizeToImageFiles(@"C:\images\high_quality_*.png", DPI: 300);
// Web-optimized at 150 DPI
pdfDocument.RasterizeToImageFiles(@"C:\images\web_*.jpg", DPI: 150);

// High-quality conversion at 300 DPI
pdfDocument.RasterizeToImageFiles(@"C:\images\high_quality_*.png", DPI: 300);
// Web-optimized at 150 DPI
pdfDocument.RasterizeToImageFiles(@"C:\images\web_*.jpg", DPI: 150);

' High-quality conversion at 300 DPI
pdfDocument.RasterizeToImageFiles("C:\images\high_quality_*.png", DPI:=300)
' Web-optimized at 150 DPI
pdfDocument.RasterizeToImageFiles("C:\images\web_*.jpg", DPI:=150)

Domyślna rozdzielczość 96 DPI wystarcza do podstawowego podglądu, ale należy ją zwiększyć do 150–300 DPI w przypadku obrazów o jakości PRINT. Wyższe wartości DPI zapewniają ostrzejszy obraz, ale powodują zwiększenie rozmiaru plików.

Jakie formaty obrazów są obsługiwane?

IronPDF obsługuje wiele formatów obrazów poprzez parametr ImageType:

// Convert to different formats
pdfDocument.RasterizeToImageFiles(@"C:\images\output_*.png", IronPdf.Imaging.ImageType.Png);
pdfDocument.RasterizeToImageFiles(@"C:\images\output_*.jpg", IronPdf.Imaging.ImageType.Jpeg);
pdfDocument.RasterizeToImageFiles(@"C:\images\output_*.tiff", IronPdf.Imaging.ImageType.Tiff);
pdfDocument.RasterizeToImageFiles(@"C:\images\output_*.bmp", IronPdf.Imaging.ImageType.Bitmap);

// Convert to different formats
pdfDocument.RasterizeToImageFiles(@"C:\images\output_*.png", IronPdf.Imaging.ImageType.Png);
pdfDocument.RasterizeToImageFiles(@"C:\images\output_*.jpg", IronPdf.Imaging.ImageType.Jpeg);
pdfDocument.RasterizeToImageFiles(@"C:\images\output_*.tiff", IronPdf.Imaging.ImageType.Tiff);
pdfDocument.RasterizeToImageFiles(@"C:\images\output_*.bmp", IronPdf.Imaging.ImageType.Bitmap);

' Convert to different formats
pdfDocument.RasterizeToImageFiles("C:\images\output_*.png", IronPdf.Imaging.ImageType.Png)
pdfDocument.RasterizeToImageFiles("C:\images\output_*.jpg", IronPdf.Imaging.ImageType.Jpeg)
pdfDocument.RasterizeToImageFiles("C:\images\output_*.tiff", IronPdf.Imaging.ImageType.Tiff)
pdfDocument.RasterizeToImageFiles("C:\images\output_*.bmp", IronPdf.Imaging.ImageType.Bitmap)

Wybierz format PNG dla obrazów wymagających przezroczystości, JPEG dla zdjęć i treści internetowych, TIFF do celów archiwizacyjnych oraz BMP, gdy potrzebne są obrazy nieskompresowane. Dokumentacja API IronPDF zawiera szczegółowe informacje o wszystkich obsługiwanych opcjach ImageType.

Jak radzić sobie w zaawansowanych sytuacjach?

IronPDF doskonale radzi sobie ze złożonymi scenariuszami konwersji plików PDF na obrazy. Jedną ze szczególnie przydatnych funkcji jest konwersja stron internetowych bezpośrednio na obrazy poprzez renderowanie do formatu PDF. Dla większej ilości opcji konwersji HTML, zapoznaj się z przewodnikiem konwersji HTML do PDF:

// Convert a webpage to images
ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument webPdf = renderer.RenderUrlAsPdf("https://apple.com");
webPdf.RasterizeToImageFiles(@"C:\images\webpage_*.png", DPI: 200);

// Convert a webpage to images
ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument webPdf = renderer.RenderUrlAsPdf("https://apple.com");
webPdf.RasterizeToImageFiles(@"C:\images\webpage_*.png", DPI: 200);

Imports IronPdf

' Convert a webpage to images
Dim renderer As New ChromePdfRenderer()
Dim webPdf As PdfDocument = renderer.RenderUrlAsPdf("https://apple.com")
webPdf.RasterizeToImageFiles("C:\images\webpage_*.png", DPI:=200)

Takie podejście doskonale oddaje dynamiczne treści internetowe, zachowując wszystkie elementy stylistyczne i renderowane przez JavaScript.

Aby przetwarzać wiele plików PDF w trybie wsadowym, należy zaimplementować prostą pętlę:

string[] pdfFiles = Directory.GetFiles(@"C:\pdfs", "*.pdf");
foreach (string pdfPath in pdfFiles)
{
    using (var pdf = PdfDocument.FromFile(pdfPath))
    {
        string outputPath = Path.Combine(@"C:\images",
            Path.GetFileNameWithoutExtension(pdfPath) + "_*.png");
        pdf.RasterizeToImageFiles(outputPath);
    }
}

string[] pdfFiles = Directory.GetFiles(@"C:\pdfs", "*.pdf");
foreach (string pdfPath in pdfFiles)
{
    using (var pdf = PdfDocument.FromFile(pdfPath))
    {
        string outputPath = Path.Combine(@"C:\images",
            Path.GetFileNameWithoutExtension(pdfPath) + "_*.png");
        pdf.RasterizeToImageFiles(outputPath);
    }
}

Imports System.IO

Dim pdfFiles As String() = Directory.GetFiles("C:\pdfs", "*.pdf")
For Each pdfPath As String In pdfFiles
    Using pdf = PdfDocument.FromFile(pdfPath)
        Dim outputPath As String = Path.Combine("C:\images", Path.GetFileNameWithoutExtension(pdfPath) & "_*.png")
        pdf.RasterizeToImageFiles(outputPath)
    End Using
Next pdfPath

Wnioski

IronPDF ułatwia konwersję dokumentów PDF na pliki graficzne w języku C#. Niezależnie od tego, czy tworzysz miniatury, obrazy PNG, obrazy JPEG, czy obsługujesz konwersję TIFF dla wielu stron, metoda RasterizeToImageFiles obsługuje wszystko.

Dostosuj formaty wyjściowe, kontroluj jakość obrazu za pomocą ustawień DPI, a nawet konwertuj strony internetowe prezentowane jako PDFy na obrazy, wszystko bez skomplikowanej konfiguracji. Dla zaawansowanych funkcji PDF, sprawdź obszerną dokumentację IronPDF, zawierającą przykładowy kod i wyjaśnienia, aby zbadać wszystko, co IronPDF może zrobić.

Chcesz wdrożyć konwersję plików PDF na obrazy w swojej aplikacji napisanej w języku C#? Rozpocznij od darmowego okresu próbnego, aby odkryć pełne możliwości IronPDF, w tym produkcyjny test bez znaków wodnych przez 30 dni. Potrzebujesz konwertować dokumenty w skali? Rozważ komercyjną licencję na nieograniczone konwersje i priorytetowe wsparcie.