Node.js'de PDF'yi Görüntü Dosyasına Dönüştürme

Node.js için IronPDF'yi Nasıl Yüklerim?

npm install @ironsoftware/ironpdf

npm install @ironsoftware/ironpdf

PDF'leri PNG, JPG, GIF, BMP ve diğer görsel formatlara dönüştürmek için npm'den IronPDF'in Node.js paketini yükleyin.

Üretimde PDF'leri görsele dönüştürmeden önce lisans anahtarınızı yapılandırın. Paket ayrıca, tüm PDF işleme işlemlerini yürüten ve dönüştürmenin çalışabilmesi için sistemde bulunması gereken IronPDF Motorunun yüklenmesini gerektirir.

PDF'yi Görüntüye Nasıl Dönüştürürüm?

rasterizeToImageFiles yöntemi, bir PDF belgesini okur ve sağladığınız çıktı yoluna sayfa başına bir görüntü dosyası yazar. Tek sayfalık PDF'ler için tam olarak bir görüntü üretir. Çok sayfalı PDF'ler için, her dosya adının sonuna sayfa numarası eki otomatik olarak eklenir.

Aşağıdaki örnek, Learning Container'dan bir örnek PDF indirir ve bunu bir PNG dosyasına dönüştürür.

Örnek PDF dosyası bir görüntüleyicide açıldı. Bu dosyayı ve diğer test PDF'lerini Learning Containerdan indirin.

//:path=/static-assets/pdf/content-code-examples/how-to/nodejs-pdf-to-image/convert-to-png.js
import { PdfDocument } from "@ironsoftware/ironpdf";

// Load the PDF and convert it to a PNG image.
// The output path determines the format — change .png to .jpg for JPEG output.
PdfDocument.fromFile("./sample-pdf-file.pdf").then((pdf) => {
    pdf.rasterizeToImageFiles("./images/sample-pdf-file.png");
    return pdf;
}).catch((error) => {
    console.error("Error converting PDF to image:", error);
});

PdfDocument.fromFile, PDF'yi yükler ve PdfDocument nesnesine çözümleyen bir Promise döndürür. .then geri çağrısı, çözümlenmiş belgeyi alır ve hedef yol ile rasterizeToImageFiles'yi çağırır. Yoldaki dosya uzantısı — burada .png — IronPDF'ye hangi formatı üreteceğini bildirir. .catch bloğu, okuma veya dönüştürme hatalarını yönetir.

Yukarıdaki örnek PDF'den üretilen PNG. IronPDF belgeyi üç satır kodla dönüştürür.

Bu metodun seçenekleri hakkında daha ayrıntılı örnekler için PDF to Images kod örneği sayfasına bakın.

Bir PDF'yi JPEG Formatına Nasıl Dönüştürürüm?

Biçim seçimi otomatiktir: rasterizeToImageFiles'ye hangi uzantıyı geçirirseniz, çıktı biçimi o uzantıya göre belirlenir. Bir JPEG üretmek için, hedef yolundaki uzantıyı değiştirin:

//:path=/static-assets/pdf/content-code-examples/how-to/nodejs-pdf-to-image/convert-to-jpeg-extension.js
// Switch to JPEG by changing the file extension in the output path.
pdf.rasterizeToImageFiles("./images/pdf-to-jpeg.jpg");

Çıktı dosya adının kontrol edilemediği durumlarda (örneğin, sabit adlandırma şemalarına sahip otomatikleştirilmiş iş akışlarında), uzantıya dayalı algılamayı geçersiz kılmak için seçenekler nesnesine ImageType değerini geçirin:

//:path=/static-assets/pdf/content-code-examples/how-to/nodejs-pdf-to-image/convert-to-jpeg-imagetype.js
import { PdfDocument, ImageType } from "@ironsoftware/ironpdf";

// ImageType.JPG forces JPEG output regardless of the file extension.
const options = {
    type: ImageType.JPG,
    dpi: 300
};
PdfDocument.fromFile("./sample-pdf-file.pdf").then((pdf) => {
    pdf.rasterizeToImageFiles("./images/output.png", options);
    return pdf;
});

Seçenekler nesnesindeki type özelliği, dosya adı uzantısından önceliklidir. Yukarıdaki örnekte, rasterizeToImageFiles, hedef yol .png ile bitmesine rağmen bir JPEG dosyası oluşturur. Aynı model GIF ve BMP çıktılarına da uygulanır.

Çok Sayfalı Bir PDF'yi Görüntülere Nasıl Dönüştürürüm?

Birden fazla sayfadan oluşan belgeler için, rasterizeToImageFiles her sayfa için bir resim oluşturur. IronPDF, çıktının organize edilmesi için her bir çıktı dosyasına sıfır tabanlı bir sayfa indeksini ekler — ek bir kod gerekmez.

İki sayfalık örnek PDF. Dönüştürme sırasında IronPDF her sayfa için bir görüntü dosyası oluşturur.

//:path=/static-assets/pdf/content-code-examples/how-to/nodejs-pdf-to-image/convert-multipage.js
import { PdfDocument } from "@ironsoftware/ironpdf";

// Each page of the PDF becomes a separate image file.
// Output filenames: multipage-pdf-page_1.png, multipage-pdf-page_2.png, etc.
PdfDocument.fromFile("./multipage-pdf.pdf").then((pdf) => {
    pdf.rasterizeToImageFiles("./images/multipage-pdf/multipage-pdf-page.png");
});

İki sayfalık PDF'den üretilen iki PNG dosyası. IronPDF her çıktı dosyasını sayfa numarası ile adlandırır.

Bu otomatik sayfa bölme özelliği desteklenen tüm görüntü formatlarıyla çalışır. Büyük belgelerdeki yalnızca belirli sayfaları dönüştürmek için bunu bir sonraki bölümdeki fromPages seçeneğiyle birlikte kullanın. Tersi yönde çalışmak için, birden fazla görüntü dosyasını tek bir PDF belgesinde birleştirmenin nasıl yapılacağını gösteren görüntüden PDF'ye örneği inceleyin.

Sadece Belirli Sayfaları Nasıl Dönüştürürüm?

Seçenekler nesnesindeki fromPages özelliği, sıfır tabanlı sayfa dizinlerinden oluşan bir diziyi kabul eder. Sadece belirtilen sayfalar rasterleştirilecektir; diğerleri atlanacaktır. Bu, yalnızca bir sayfa alt kümesine ihtiyaç duyulduğunda büyük PDF'lerle çalışırken yararlıdır — örneğin, bir belge önizlemesi için kapak ve bölüm başlangıç sayfalarını çıkarmak için. Sayfaları dönüştürmeden önce tek tek üzerinde çalışmanız gerektiğinde, PdfDocument için Node.js API Referansı, sayfa düzeyinde gerçekleştirilebilecek ek işlemleri açıklamaktadır.

//:path=/static-assets/pdf/content-code-examples/how-to/nodejs-pdf-to-image/convert-selective-pages.js
import { PdfDocument, ImageType } from "@ironsoftware/ironpdf";

// Convert only pages 1, 4, 6, and 9 (zero-indexed: 0, 3, 5, 8) to BMP.
const options = {
    type: ImageType.BMP,
    fromPages: [0, 3, 5, 8],
    dpi: 150
};
PdfDocument.fromFile("./sample-pdf-with-images.pdf").then((pdf) => {
    pdf.rasterizeToImageFiles(
        "./images/multipage-selective-pdf/multipage-pdf-page.bmp",
        options
    );
}).catch((error) => {
    console.error("Failed to convert pages:", error);
});

IronPDF, yalnızca fromPages dizisinde belirtilen dört sayfayı rasterleştirdi. Diğer sayfalar işlenmedi.

fromPages içindeki sayfa indeksleri sıfır tabanlıdır, bu nedenle [0, 3, 5, 8] birinci, dördüncü, altıncı ve dokuzuncu sayfaları hedefler. 150 DPI değeri, arşiv veya önizleme kullanım durumları için uygun olan çıktı kalitesi ile dosya boyutu arasında bir denge sağlar. Seçimli dönüştürme, desteklenen tüm görüntü türleriyle uyumludur.

PDF'den Görüntüye Dönüştürme İçin Bir Sonraki Adım Nedir?

IronPDF'nin rasterizeToImageFiles yöntemi, tutarlı bir API içinde format seçimi, çok sayfalı bölme ve seçici sayfa dönüştürme işlemlerini gerçekleştirir. Seçenekler nesnesi, format değişiklikleri, DPI kontrolü ve sayfa filtreleme için tek uzatma noktasıdır.

Daha fazla bilgi için, IronPDF for Node.js API Referansı, rasterizeToImageFiles ve PdfDocument sınıfında bulunan tüm parametreleri belgelemektedir. PDF'den Görüntülere kod örneği, ek yapılandırma ile birlikte kullanılan rasterizeToImageFiles'yi göstermektedir. Tersi yönde çalışmak için, görüntüleri PDF dosyalarına dönüştürme veya çok çerçeveli TIFF dosyalarını PDF'ye dönüştürme konularına bakın.

IronPDF for Node.js'in ücretsiz denemesini başlatın ve kendi projenizde PDF'den görüntüye dönüştürme işlemini test edin. Lisans seçeneklerini görüntüle ve ekibinize uyan bir plan bulun.

IronPDF'nin başka neler yapabileceğini görmeye hazır mısınız? Tam Node.js eğitici içeriklerini burada inceleyin: Node.js'de HTML'den PDF'ye