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

Bir PDF'yi Bir Görüntü Dosyasına Nasıl Dönüştürurum

This article was translated from English: Does it need improvement?
Translated
View the article in English

PDF dosyalarını Node.js'te görüntülere dönüştürmek için, IronPDF'nin rasterizeToImageFiles yöntemini kullanın. Bu yöntem, PDF'leri JPG, PNG, GIF ve diğer formatlara dönüştürmayı destekler ve tüm sayfaları veya belirli sayfaları dönüştürme seçenekleri sunar. Kutuphane, donusum surecini verimli bir sekilde yonetir, yuksek görüntü kalitesini korurken cıkıs formatı seciminde esneklik saglar.

Hızlı Başlangıc: PDF'den Görüntüye Dönüştürma

  1. IronPDF'i yükleyin: npm install @ironsoftware/ironpdf
  2. PdfDocument sınıfını içe aktarı
  3. PDF dosyanızı PdfDocument.fromFile() kullanarak yükleyin
  4. Çıkış yolunuzla birlikte rasterizeToImageFiles() çağırın
  5. Yöntem, dosya uzantısından formatı otomatik olarak algılar
:title=Quick PDF to PNG Conversion
import { PdfDocument } from "@ironsoftware/ironpdf";

PdfDocument.fromFile("./sample.pdf").then((pdf) => {
    pdf.rasterizeToImageFiles("./output.png");
});

PDF dosyalarını görüntülere dönüştürmek için, IronPDF'nin Node.js modülü tarafından sağlanan rasterizeToImageFiles yöntemini kullanın. Bu yöntemi, PDF'leri JPG, PNG ve diğer görüntü formatlarına dönüştürmek icin yapılandırın. Her sayfayı dönüştürun veya belirli sayfalar secin. IronPDF, donusum sureci uzerinde tam kontrol saglar.

PDF'den Görüntüye Dönüştürme icin IronPDF'yi Nasıl Yüklerim?

npm install @ironsoftware/ironpdf
npm install @ironsoftware/ironpdf
SHELL

IronPDF'nin Node.js modulunu NPM'den yukleyerek PDF'leri PNG, JPG, GIF ve diğer görüntü turlerine dönüştürun.

PDF'leri görüntülere dönüştürmeden once, uretişimde IronPDF kullanıyorsanız lisans anahtarınızı yapılandırın. Kutuphane, PDF render işlemlerini yurutmek icin sisteminizde IronPDF Engine kurulu olmasını gerektirir.

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

Bir tek sayfalık örnek PDF belgesi üzerinde önizleme içeriği bulunan bir belge ile çalışacağız. Daha karmaşık senaryolar için önce HTML'yi PDF'ye dönüştürmeyi ve ardından sonucu görüntülere dönüştürmeyi düşünün.

PDF görüntüleyici Lorem Ipsum metin belgesini görüntü formatına dönüştürmeden önce gösteriyor Örnek PDF dosyamızın bir PDF görüntüleyici uygulamasında açıldığı bir görüntü. Learning Container sitesinden bu PDF dosyasını ve diğerlerini test amacıyla indirin.

Aşağıdaki kaynak kod PDF dosyasını bir PNG dosyasına dönüştürür.

import { PdfDocument } from "@ironsoftware/ironpdf";

// Convert PDF File to a PNG File
// The operation is performed asynchronously with promises
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);
});

Örnek belgemizi yüklemek için PdfDocument.fromFile kullanıyoruz. Bu işlev, örnek dosyamızı temsil eden bir PdfDocument sınıfı döndürür. Nesne bir Promise içinde bulunduğundan, promise çözüldüğünde çalışacak bir geri çağırma fonksiyonu ekliyoruz.

Geri çağırma içine, tek sayfalık belgeyi bir görüntüye dönüştürmek için çözülmüş nesne üzerinde rasterizeToImageFiles çağırıyoruz. Hedef yolunu (dosya adı ve uzantısı dahil) bir argüman olarak belirtiyoruz. Yöntem, IronPDF'in PDF'lerde görüntü gömme işlemini yaptığı gibi çeşitli formatları destekler.

PDF dosyasındaki belge içeriğini gösteren dönüştürülmüş PNG görüntü Görüntü yukarıdaki kaynak koddan üretildi. IronPDF, örnek PDF'imizi sadece üç satır kodla PNG dosyasına dönüştürdü!

Learning Container, test amacıyla örnek PDF dosyaları sağlamaktadır. Bu örnekte kullanılan PDF dosyasını ücretsiz indirin. Farklı boyut ve karmaşıklıktaki diğer PDF'ler üzerinde yukarıdaki örneği deneyin. Daha ayrıntılı görüntü dönüştürme örnekleri için kapsamlı PDF to Images kılavuzuna bakın.

Gelişmiş Görüntü Dönüştürme Seçenekleri Neler?

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

Varsayılan olarak, rasterizeToImageFiles belgeleri hedef yolda belirtilen dosya türüne göre dönüştürür. Bu otomatik format algılama, görüntü formatları arasında kodu değiştirmeden kolay geçiş sağlar.

Örnek PDF'mizi JPG dosyasına dönüştürmek için, hedef yoldaki dosya uzantısını değiştirme:

// Convert PDF to JPG (not to PNG)
pdf.rasterizeToImageFiles("./images/pdf-to-jpeg.jpg");

Alternatif olarak, bir ImageType seçeneği belirtin. Bir ImageType değeri, hedef yolda ilan edilen görüntü dosyası türünü geçersiz kılar. Bu, rasterizeToImageFiles işlemi sırasında dosya adını görmezden gelmeye zorlayarak çıkış formatı üzerinde açık kontrol sağlar.

Bir sonraki örnek, ImageType ilan eden rasterizeToImageFiles çağrısı ile JSON opsiyonları argümanı içerir.

import { PdfDocument, ImageType } from "@ironsoftware/ironpdf";

// Convert PDF to JPEG Format using ImageType.JPG
const options = {
   type: ImageType.JPG,
   dpi: 300  // High quality output
};
PdfDocument.fromFile("./sample-pdf-file.pdf").then((pdf) => {
    pdf.rasterizeToImageFiles("./images/pdf-to-jpeg.png", options);
    return pdf;
});

Bu program bir JPG görüntüsü oluşturur. Dikkat edin, hedef dosya adı hala PNG dosya uzantısını kullanıyor. rasterizeToImageFiles, .PNG uzantısını görmezden gelir ve bunun yerine ImageType.JPG değerini takip eder. Bu yaklaşım, IronPDF'in diğer dönüştürme işlemleri sırasında yaptığı gibi açık tip belirtimi öncelik taşıdığı durumlarla benzer.

Bu örneği, PDF'leri GIF ve Bitmap formatları dahil diğer görüntü türlerine dönüştürmek için uyarlayabilirsiniz.

İpucu: Bu yaklaşım, dosya adlarını belirli tiplere değiştirmenin mümkün olmadığı durumlarda kullanışlıdır, örneğin: otomatik dosya adlandırma sistemleriyle veya farklı çıktı formatları arasında tutarlı adlandırma kurallarını korurken.

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

Birden çok sayfalı belgeleri dönüştürmek için, aynı şekilde rasterizeToImageFiles yöntemini kullanın. Yöntem, her sayfayı belirtilen türde ayrı bir görüntü olarak oluşturur ve dosya adlarına otomatik olarak sayfa numaralarını ekler. Bu işlevsellik, görüntü galerileri oluştururken veya çok sayfalı belgeler ile çalışırken kullanışlıdır.

İki sayfalı PDF belge, görüntüye dönüştürme işleminden önce örnek içerik gösteren görüntüleyicide açık İki sayfalık örnek PDF belgesi.

Bir sonraki kod bloğu, yukarıda gösterilen iki sayfalık PDF dosyası örneğinden iki PNG dosyası üretir.

import { PdfDocument } from "@ironsoftware/ironpdf";

// Convert PDF with two pages to a set of images.
PdfDocument.fromFile("./multipage-pdf.pdf").then((pdf) => {
    pdf.rasterizeToImageFiles("./images/multipage-pdf/multipage-pdf-page.png");
});

İki sayfalı PDF'den oluşturulmuş iki bireysel PNG dosyası, dosya adlarındaki otomatik sayfa numaralandırmasını gösteriyor İki sayfalı PDF dosyasında rasterizeToImageFiles yöntemi kullanımının sonucu. Yöntem, orijinal dosyanın her sayfası için bir görüntü oluşturur.

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

Çok sayfalı bir belgeden belirli sayfaları rasterize etmek için fromPages özelliğine sahip bir JSON nesnesi kullanın. Bu seçici dönüştürme, yalnızca belirli sayfalar ihtiyaç duyulduğunda büyük PDF'lerle çalışırken kullanışlıdır, PDF'den belirli sayfaları kaldırdığınız gibi.

Aşağıdaki kod örneği, büyük örnek dosyanın sadece birinci, dördüncü, altıncı ve dokuzuncu sayfasını bitmap'lere dönüştürür.

import { PdfDocument, ImageType } from "@ironsoftware/ironpdf";

// Convert PDF containing many pages to BMP images.
const options = {
    type: ImageType.BMP,
    fromPages: [0, 3, 5, 8],  // Select only the desired pages (0-indexed)
    dpi: 150  // Balance quality and file size
};
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);
});

Dört PDF sayfası başarıyla görüntülere dönüştürüldü, multipage-pdf-page_2, page_4, page_7 ve page_9 dosyalarını gösteriyor IronPDF, options argümanında belirttiğimiz yalnızca sayfalarda PDF-to-Image işlemini gerçekleştirdi.

Seçici sayfa dönüştürme özelliği, desteklenen tüm görüntü formatlarıyla çalışır ve belirttiğiniz kalite ayarlarını korur. Daha karmaşık sayfa düzenlemeleri için, tüm mevcut seçenek ve yöntemleri ayrıntılandıran kapsamlı API referansını keşfedin.

Daha Fazla Kaynak Nerede Bulunabilir?

API Belgelerine Nerede Ulaşabilirim?

PdfDocument sınıfının API belgesini ve rasterizeToImageFiles yöntemlerini okuyarak yöntemi ihtiyaçlarınıza göre nasıl adapte edeceğiniz hakkında daha fazla bilgi edinin. Belgeler, mevcut tüm parametreler ve seçenekler hakkında ayrıntılı bilgi sunar.

Başka Ne Tür Kod Örnekleri Mevcut?

Sıkça Sorulan Sorular

Node.js'te bir PDF'yi nasıl bir görüntüye dönüştürebilirim?

Node.js'te PDF dosyalarını görüntülere dönüştürmek için IronPDF'in `rasterizeToImageFiles` yöntemini kullanın. Önce IronPDF'i `npm install @ironsoftware/ironpdf` ile yükleyin, ardından PDF dosyanızı `PdfDocument.fromFile()` ile yükleyin ve istediğiniz çıktı yoluyla `rasterizeToImageFiles()`'i çağırın. Yöntem, dosya uzantısından görüntü formatını otomatik olarak algılar.

PDF'ler dönüştürülürken hangi görüntü formatları desteklenmektedir?

IronPDF, JPG, PNG, GIF ve diğer yaygın formatlar dahil olmak üzere PDF'leri birden fazla görüntü formatına dönüştürmeyi destekler. `rasterizeToImageFiles` yöntemi, belirttiğiniz çıktı yolundaki dosya uzantısına bağlı olarak çıktı formatını otomatik olarak belirler.

Belirli PDF sayfalarını resimlere dönüştürebilir miyim?

Evet, IronPDF `rasterizeToImageFiles` yöntemini kullanırken tüm sayfaları veya belirli sayfaları dönüştürmenize olanak tanır. Bu, PDF belgenizdeki hangi sayfaların görüntü dosyalarına dönüştürüleceği üzerinde tam kontrol sağlar.

PDF'yi görüntüye dönüştürme için kurulum gereksinimleri nelerdir?

PDF'leri görüntülere dönüştürmek için `npm install @ironsoftware/ironpdf` kullanarak IronPDF'i yüklemeniz gerekir. Kütüphane ayrıca PDF işleme işlemlerini yapan IronPDF Motorunun sisteminize yüklenmesini gerektirir. Üretim kullanımı için lisans anahtarınızı yapılandırmanız gerekecek.

Dönüştürme, yüksek görüntü kalitesini koruyor mu?

Evet, IronPDF dönüştürme işlemini verimli bir şekilde yürütürken yüksek görüntü kalitesini korur. `rasterizeToImageFiles` yöntemi, PDF içeriğinizin kayda değer nitelik kaybı olmadan doğru şekilde görüntü olarak işlenmesini sağlar.

PDF'den görüntüye dönüştürme işlemi asenkron mudur?

Evet, IronPDF içindeki dönüştürme işlemi, vaatler kullanılarak asenkron olarak gerçekleştirilir. Başarılı dönüşümü yönetmek ya da PDF'den görüntüye dönüştürme işlemi sırasında meydana gelebilecek hataları yönetmek için `.then()` ve `.catch()` kullanabilirsiniz.

Darrius Serrant
Tam Yığın Yazılım Mühendisi (WebOps)

Darrius Serrant, Miami Üniversitesi'nden Bilgisayar Bilimleri lisans derecesine sahiptir ve Iron Software'de Tam Yığın WebOps Pazarlama Mühendisi olarak çalışmaktadır. Küçük yaşlardan itibaren kodlamaya ilgi duyan Darrius, bilişimi hem gizemli hem de erişilebilir buldu ve onu yaratıcılık ve problem çö...

Daha Fazlasını Oku
Başlamaya Hazır mısınız?
Sürüm: 2026.4 yeni yayınlandı
Still Scrolling Icon

Hala Kaydiriyor musunuz?

Hızlı bir kanit mi istiyorsunuz?
bir örnek çalıştır HTML'nizin PDF olduğunu izleyin.