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

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

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

IronPDF for Node.js, PDF sayfalarını tek bir metod çağrısıyla görsellere dönüştürür. Mevcut çözünürlük ve sayfa seçimini doğrudan kontrol ederek, rasterizeToImageFiles metodu, tek sayfalı veya çok sayfalı herhangi bir PDF'den PNG, JPG, GIF, BMP ve diğer formatlar üretir.

Metod, sağladığınız dosya uzantısından çıktı formatını otomatik olarak algılar, bu yüzden format değiştirmek için yapılandırma değişiklikleri gerektirmez. Uzantının değiştirilemediği ortamlarda, belirgin bir ImageType enum değeri, uzantıya dayalı algılamayı geçersiz kılar. IronPDF Node.js belgeleri, dosya yolları, byte tamponları ve rasterizasyondan önce PDF'ye dönüştürülen HTML dizeleri gibi desteklenen giriş kaynaklarının tam yelpazesini kapsar.

Hızlı Başlangıç: PDF'yi PNG'ye Dönüştürme

  1. IronPDF'i Yükleyin: npm install @ironsoftware/ironpdf
  2. Paketten PdfDocument'i içe aktarın
  3. PDF'inizi PdfDocument.fromFile() ile yükleyin
  4. Çıktı yoluyla rasterizeToImageFiles() çağırın
:path=/static-assets/pdf/content-code-examples/how-to/nodejs-pdf-to-image/quickstart.js

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

npm i @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.

Sistem Gereksinimleri Nelerdir?

Node.js 12 veya daha yeni bir sürüm gereklidir. IronPDF Motor binary'si, paket ilk yüklendiğinde otomatik olarak indirilmektedir, ancak çıkış ağ erişimini kısıtlayan bir dağıtım ortamınız varsa, manuel olarak yükleyebilirsiniz. @ironsoftware/ironpdf paketi npm kaydı üzerinde mevcuttur ve yerel modül derleme aşaması içermez, bu da CI hatlarını sade tutar.

Lütfen dikkate alınGeliştirme sırasında lisans anahtarı gerekmemektedir. Lisanssız modda filigranlı çıktı üretilir. Geçerli bir anahtar yapılandırıldığında filigranlar kaldırılır.

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

rasterizeToImageFiles metodu bir PDF belgesini okur ve sağladığınız çıktı yoluna her sayfa için bir görüntü dosyası yazar. Tek sayfalı 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.

PDF görüntüleyici, PDF'den görüntüye dönüştürmeden önce giriş olarak kullanılan tek sayfalık bir Lorem Ipsum örnek belgesini gösteriyor Ö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

PdfDocument.fromFile PDF'i yükler ve bir PdfDocument nesnesine çözülen bir Promise döndürür. .then geri çağırma, çözülen belgeyi alır ve varış yolu ile rasterizeToImageFiles çağırır. Yoldaki dosya uzantısı — burada .png — IronPDF'e hangi formatı üretmesi gerektiğini söyler. .catch bloğu herhangi bir okuma veya dönüşüm hatasını ele alır.

Dönüştürülmüş PNG çıkış dosyası, Lorem Ipsum belgesi içeriğini PNG görüntüsü olarak render edilmiş halde gösteriyor 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?

Format seçimi otomatik: rasterizeToImageFiles'a geçirdiğiniz herhangi bir uzantı çıktı formatını belirler. 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 otomatik hatlarda — uzantıya dayalı algılamayı geçersiz kılmak için seçenekler nesnesinde bir ImageType değeri geçirin:

:path=/static-assets/pdf/content-code-examples/how-to/nodejs-pdf-to-image/convert-to-jpeg-imagetype.js

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ı üretir. Aynı model GIF ve BMP çıktılarına da uygulanır.

DPI Ayarları Çıktı Kalitesini Nasıl Etkiler?

Seçenekler nesnesindeki dpi özelliği rasterize edilmiş çıktının piksel yoğunluğunu kontrol eder. Daha yüksek değerler daha fazla detay içeren daha büyük dosyalar üretir; daha düşük değerler netliği azaltma pahasına dosya boyutunu düşürür.

İpuçlarıdpi: 300 ayarlanması yüksek çözünürlüklü baskı veya arşivleme için uygun baskı kalitesinde görüntüler üretir. Ekran görüntüsü veya küçük resim oluşturma için dpi: 96, web kullanımı için yeterli netliği korurken dosya boyutunu azaltır.

150 DPI, çoğu arşiv veya önizleme senaryosu için makul bir varsayılan değerdir — çıktı, ekranda okumak için yeterince nettir ve dosya boyutları yönetilebilir kalır. Çevrildikten sonra yazdırılacak veya OCR işlemine tabi tutulacak içerikler için 300 DPI veya daha yüksek bir çözünürlük tercih edilir.

Icon Quote related to DPI Ayarları Çıktı Kalitesini Nasıl Etkiler?

Bu türden favori kütüphanem IronPDF'dir. PDF dosyalarının hızlı ve verimli bir şekilde işlenmesine olanak tanır. Ayrıca, PDF/A formatına dışa aktarma ve dijital imzalama gibi birçok değerli özelliğe sahiptir.

Milan Jovanovic related to DPI Ayarları Çıktı Kalitesini Nasıl Etkiler?

Milan Jovanovic

Microsoft MVP

Vaka çalışmasını görüntüle
Icon Quote related to DPI Ayarları Çıktı Kalitesini Nasıl Etkiler?

IronOCR, manuel işleme maliyetinden yıllık 40.000 USD tasarruf etmemizi sağlıyor, üretkenliği artırıyor ve yüksek etkili görevler için kaynakları serbest bırakıyor. Kesinlikle tavsiye ederim.

Brent Matzelle related to DPI Ayarları Çıktı Kalitesini Nasıl Etkiler?

Brent Matzelle

Teknoloji Müdürü, OPYN

Vaka çalışmasını görüntüle
Icon Quote related to DPI Ayarları Çıktı Kalitesini Nasıl Etkiler?

IronSuite, operasyonlarımızda kritik bir rol oynar. Bunlar, iş süreçlerinde verimliliği artıran, kat planları oluşturmak ve envanter yönetimini geliştirmek gibi araçlardır.

David Jones related to DPI Ayarları Çıktı Kalitesini Nasıl Etkiler?

David Jones

Baş Yazılım Mühendisi, Agorus Build

Vaka çalışmasını görüntüle

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

Birden fazla sayfaya sahip belgeler için, rasterizeToImageFiles her sayfa için bir görüntü 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.

Görüntüleyicide açık olan iki sayfalık bir PDF belgesi, resim dönüşümünden önce örnek içerik gösteriyor İ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

Yukarıdaki iki sayfalık PDF'den oluşturulan iki PNG çıkış dosyası — multipage-pdf-page_1.png ve multipage-pdf-page_2.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 belgelerden yalnızca belirli sayfaları dönüştürmek için bir sonraki bölümdeki fromPages seçeneği ile eşleştirin. 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.

Çıktı Dosya Adları Nasıl Yapılandırılır?

Dosya adı deseni, dosya uzantısından önce bir tabanlı sayfa numarası ekler. Çıktı yolu ./images/report-page.png ise, üç sayfalık bir PDF report-page_1.png, report-page_2.png ve report-page_3.png üretir. Çıktı dizini, rasterizeToImageFiles çağrılmadan önce mevcut olmalıdır — metot, eksik dizinleri otomatik olarak oluşturmaz.

ÖnemlirasterizeToImageFiles çağrılmadan önce çıktı dizinini oluşturun. Hedef dizin mevcut değilse metot bir hata fırlatır. Onu önceden oluşturmak için Node.js'in fs.mkdirSync('./images/output', { recursive: true }) metodunu kullanın.

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

Seçenekler nesnesindeki fromPages özelliği, sıfır bazlı sayfa dizinlerinden oluşan bir dizi 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. Onları çevirmeden önce bireysel sayfalarla çalışmanız gerektiğinde, PdfDocument için Node.js API referansı ek sayfa düzeyindeki işlemleri belgeler.

:path=/static-assets/pdf/content-code-examples/how-to/nodejs-pdf-to-image/convert-selective-pages.js

Büyük bir PDF'den oluşturulan dört BMP çıkış dosyası, multipage-pdf-page_1, page_4, page_7 ve page_9 olarak etiketlenmiş IronPDF, fromPages dizisinde belirtilen yalnızca dört sayfayı rasterize etti. Diğer sayfalar işlenmedi.

fromPages dizisindeki sayfa dizinleri sıfır bazlı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.

Lütfen dikkate alınÖrnek PDF ile görüntüler içeren yukarıdaki örnekte kullanılan Luxaviation'dan indirin.

Sıfır Tabanlı ve Bir Tabanlı Sayfa Numaraları Arasındaki Fark Nedir?

fromPages sıfır bazlı dizini kullanır, bu da JavaScript'in standart dizi gelenekleriyle eşleşir. Belgedeki 1. sayfa 0 dizinine, 2. sayfa 1 dizinine karşılık gelir ve böyle devam eder. Bu, PDF görüntüleyicilerinde görünen bir tabanlı sayfa numaralarından farklıdır. Görüntüleyici sayfa numaralarını fromPages dizinlerine dönüştürürken, her sayfa numarasından bir çıkarın.

İpuçlarıBir PDF'nin son sayfasını önceden toplam sayfa sayısını bilmeden dönüştürmek için, sayfa sayısını PdfDocument API üzerindeki pdf.pageCount() okuyun ve [pdf.pageCount() - 1]fromPages değeri olarak kullanın.

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

IronPDF'in rasterizeToImageFiles metodu format seçimini, çok sayfalı ayırmayı ve seçici sayfa dönüştürmeyi tutarlı bir API içinde ele alır. Seçenekler nesnesi, format değişiklikleri, DPI kontrolü ve sayfa filtreleme için tek uzatma noktasıdır.

Daha ileri gitmek için IronPDF Node.js API referansı, rasterizeToImageFiles üzerinde mevcut tüm parametreleri ve PdfDocument sınıfını belgeler. PDF to Images kod örneği, ek yapılandırmayla birlikte kullanılan rasterizeToImageFiles'i gösterir. 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

Sıkça Sorulan Sorular

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

IronPDF'nin rasterizeToImageFiles yöntemini kullanın. Paket yüklemek için npm install @ironsoftware/ironpdf kullanın, PDF'inizi PdfDocument.fromFile() ile yükleyin, ardından rasterizeToImageFiles()'yi çıktı yoluyla çağırın. Dosya uzantısı, çıktı formatını otomatik olarak belirler.

rasterizeToImageFiles hangi görüntü formatlarını destekler?

IronPDF, PNG, JPG, GIF ve BMP çıktısını destekler. Format, çıktı yolundaki dosya uzantısından belirlenir. Bunu geçersiz kılmak için, seçenekler nesnesine bir ImageType enum değeri geçin: örneğin, { type: ImageType.JPG } dosya adı uzantısına bakılmaksızın JPEG çıktı almayı sağlar.

Bir PDF'nin yalnızca belirli sayfalarını nasıl görüntülere dönüştürebilirim?

Seçenekler nesnesine bir fromPages dizisi geçin. Dizi, sıfır tabanlı sayfa indekslerini kabul eder, bu nedenle fromPages: [0, 2, 4] birinci, üçüncü ve beşinci sayfaları dönüştürür. Dizede listelenmeyen sayfalar atlanır.

PDF'yi görüntüye dönüştürmek için hangi DPI kullanmalıyım?

Seçenekler nesnesinde dpi özelliğini ayarlayın. Ekran görüntüleme ve küçük resimler için dpi: 96 kullanın, arşiv ve önizleme durumları için dpi: 150 kullanın ve dönüşümden sonra OCR tarafından işlenecek içerikler veya baskı kalitesinde çıktı için dpi: 300 kullanın.

Node.js'de IronPDF kurulumu için gereksinimler nelerdir?

Node.js 12 veya daha yeni sürüm gereklidir. Paketi npm install @ironsoftware/ironpdf ile yükleyin. IronPDF Motoru ikili dosyası ilk kullanımda otomatik olarak indirilir ve tüm PDF işlemlerini yönetir. Üretim kullanımı için, çıktıdaki filigranları kaldırmak adına bir lisans anahtarı yapılandırın.

Çok sayfalı PDF'ler için çıktı dosya adları nasıl yapılandırılır?

IronPDF, dosya uzantısından önce bir tabanlı sayfa numarası ekler. Çıktı yolu report-page.png ise, üç sayfalık bir PDF report-page_1.png, report-page_2.png ve report-page_3.png üretir. Yöntemi çağırmadan önce çıktı dizini mevcut olmalıdır.

Node.js'de PDF'den görüntüye dönüştürme işlemi eşzamanlı mı?

Evet. Hem PdfDocument.fromFile() hem de rasterizeToImageFiles() Promises döndürür. Başarı yolunu .then() ile bağlayın ve dönüştürme hatalarını yönetmek için .catch() kullanın. Bu yöntemlerle async/await sözdizimini de kullanabilirsiniz.

Curtis Chau
Teknik Yazar

Curtis Chau, Bilgisayar Bilimleri alanında Lisans Derecesine (Carleton Üniversitesi) sahip ve Node.js, TypeScript, JavaScript ve React konularında uzmanlaşmış ön uç geliştirmeyle ilgileniyor. Sezgisel ve estetik açıdan hoş kullanıcı arayüzleri oluşturma tutkunu, Curtis modern çerçevelerle çalışmayı ve iyi yapı...

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

Hâlâ Kaydırıyor Musunuz?

Hızlıca kanıt ister misiniz?
bir örnek çalıştır HTML'nizi bir PDF'ye dönüştüğünü izleyin.