IRONSOFTWAREHOME

Java PDF'den Görüntü Dosyasına

Curtis Chau
Curtis Chau
Updated: 29 Haziran 2026

IronPDF'nin toBufferedImages yöntemi kullanılarak Java'da PDF belgelerini JPEG, PNG veya TIFF gibi resim formatlarına dönüştürün. Bir PDF dosyasını yükleyin, toBufferedImages çağırarak BufferedImage nesne listesini alın ve ardından her görüntüyü ImageIO kullanarak diske yazın. Tüm dönüşüm, on satırdan daha az çalışan Java kodu gerektirir.

Hızlı Başlangıç: Java'da PDF'yi Görüntülere Dönüştürün

  1. Maven projenize IronPDF bağımlılığı ekleyin:
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf</artifactId>
    <version>2024.9.1</version>
</dependency>
Text
  1. PDF belgenizi yükleyin:
//:path=/static-assets/ironpdf-java/content-code-examples/how-to/java-pdf-to-image-tutorial/load-pdf.java
PdfDocument pdf = PdfDocument.fromFile(Paths.get("document.pdf"));
Java
  1. Görüntülere dönüştürün ve kaydedin:
//:path=/static-assets/ironpdf-java/content-code-examples/how-to/java-pdf-to-image-tutorial/convert-and-save.java
List<BufferedImage> images = pdf.toBufferedImages();
for (int i = 0; i < images.size(); i++) {
    ImageIO.write(images.get(i), "PNG", new File("page_" + i + ".png"));
}
Java

PDF'den Görüntüye Dönüşüm Nedir ve Neden Gereklidir?

PDF'den görüntüye dönüştürme, bir PDF belgesinin her sayfasını bağımsız bir görüntü dosyasına (JPEG, PNG veya TIFF) çevirir ve bu dosyalar bir PDF görüntüleyicisi olmadan görüntülenebilir, gömülebilir veya işlenebilir. Java'nın standart kütüphaneleri bunun için yerleşik bir mekanizma sağlamaz, bu da belge önizlemelerine, küçük resim üreticilere veya arşiv kanallarına ihtiyaç duyan geliştiriciler için sürekli bir sorun noktası yapar.

Yaygın kullanım durumları, belge yönetim sistemleri için küçük resim önizlemeleri oluşturmayı, web uygulamaları için sayfa seviyesinde ekran görüntüleri üretmeyi ve raporlar veya sunumlar için görsel içeriği çıkarmayı içerir. IronPDF, tüm işleme karmaşıklığını dahili olarak halleder, bu nedenle uygulama kodu kısa kalır ve çıktının yazı tiplerinden, vektör grafiklerinden veya kaynak PDF'lerdeki form alanlarından etkilenmeksizin piksel olarak doğru olur. Görüntüleri bir PDF'ye yerleştirme işleminin tersi için görüntüden PDF'ye nasıl yapılır kılavuzuna bakın.

IronPDF Java için Nedir ve Nasıl Yardımcı Olur?

IronPDF for Java, Maven tabanlı projelerde PDF dosyaları oluşturmak, okumak ve düzenlemek için bir kütüphanedir. Geliştiriciler, HTML'den PDF oluşturmak, mevcut belgeleri değiştirmek ve içerik çıkarmak için Adobe Acrobat veya sunucuda yüklü herhangi bir PDF görüntüleyiciye ihtiyaç duymadan bunu kullanır.

Kütüphane, özel başlıklar ve altbilgiler, dijital imzalar, form oluşturma, parola koruması ve çok iş parçacıklı işleme sunar. .PDF-to-image özelliği, toBufferedImages iki aşırı yüklemesi üzerinden temiz bir API sunar: biri varsayılan ayarlarla her sayfayı dönüştürür, diğeri ise çözünürlüğü ve sayfa aralığını kontrol etmek için bir ToImageOptions nesne ve bir PageSelection kabul eder. Tam özellik genel görünümü için IronPDF for Java dokümantasyonunu ziyaret edin. Tam API referansı için Java API referansına bakın.

Temel dönüşümün ötesinde, IronPDF HTML'den PDF'ye işleme, özel filigranlar, arka planlar ve ön planlar, ve form oluşturma destekler. Ayrıca, standardize edilmiş Maven veya Gradle iş akışlarına uyması için Sonatype Maven Central repository'de Maven artefaktları ile birlikte gelir.

Başlamadan Önce Hangi Gereksinimlere İhtiyacım Var?

Başlamadan önce, aşağıdakilerin yerine oturduğundan emin olun:

  1. Ortam Değişkenlerinde yol ayarlanmış Java kurulmuş. Resmi Java kurulum kılavuzuna bakın.
  2. Bir Java IDE'si kurulu; Eclipse veya IntelliJ her ikisi de iyi çalışır. Eclipse'i veya IntelliJ IDEA'yı indirin.
  3. IDE ile entegre Maven. IntelliJ için bu Maven kurulum öğreticisine bakın.
  4. Dağıtıma geçmeden önce Lisans anahtarları yapılandırılmış.

IronPDF Java için Nasıl Kurulur?

Tüm önkoşullar yerine getirildikten sonra, kurulum tek bir Maven bağımlılık bildirimidir. Ayrıntılı kurulum adımları için başlangıç belgelerine başvurun.

JetBrains IntelliJ IDEA'yı açın ve yeni bir Maven projesi oluşturun.

IronPDF kurulumu için Maven seçili ve Java 16 SDK yapılandırılmış IntelliJ IDEA Yeni Proje iletişim kutusu

Yeni bir Maven Projesi Oluşturun

Yeni bir pencere açılır. Proje adını girin ve Bitir'e tıklayın.

Proje adı giriş alanını ve proje konumu olarak Masaüstü klasörünü gösteren IntelliJ IDEA Yeni Proje iletişim kutusu

Yeni Proje Adı

Finish'e tıkladıktan sonra yeni proje, varsayılan olarak pom.xml görüntülenmiş olarak açılır. O dosyaya aşağıdaki bağımlılıkları ekleyin. Opsiyonel SLF4J girişi, geliştirme sırasında günlük gürültüsünü bastırır; eğer projeniz zaten bir loglama framework'ü içeriyorsa kaldırın.

IronPDF bağımlılığı eklemeye hazır, Java 10 derleyici ayarlarıyla boş bir Maven pom.xml gösteren IntelliJ IDEA

Yeni Proje: varsayılan pom.xml

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/java-pdf-to-image-tutorial/pom-dependencies.xml
<dependencies>
    <dependency>
        <groupId>com.ironsoftware</groupId>
        <artifactId>ironpdf</artifactId>
        <version>2024.9.1</version>
    </dependency>
    <!-- Optional: SLF4J logging - remove if your project already uses a logging framework -->
    <dependency>
        <groupId>org.slf4j</groupId>
        <artifactId>slf4j-simple</artifactId>
        <version>1.7.36</version>
    </dependency>
</dependencies>
XML

Bağımlılıklar pom.xml eklenir eklenmez, editörün sağ üst köşesinde bir Maven senkronizasyon simgesi görünür.

IntelliJ IDEA'da IronPDF ve SLF4J bağımlılık blokları vurgulanmış ve Maven eşitleme simgesi görünür durumdaki Maven pom.xml dosyası

Maven Bağımlılıkları Eklendi

IronPDF JAR dosyasını indirmek için senkronizasyon simgesine tıklayın. İndirme süresi bağlantı hızına bağlıdır, genellikle iki dakikadan kısadır. Kurulumdan sonra, mevcut tüm yöntemleri ve yapılandırma seçeneklerini görmek için Java API referansına göz atın. Bulut dağıtım hedefleri için, IronPDF'nin AWS, Azure ve Google Cloud için test edilmiş kılavuzları vardır.

IronPDF Kullanarak PDF Dosyalarını Görüntülere Nasıl Dönüştürürüm?

toBufferedImages çağrısı, bir PdfDocument nesnesi üzerinde, her bir elemanın, artan sayfa numarası sırasına göre bir PDF sayfasına karşılık geldiği bir List<BufferedImage> üretir. Sonuç daha sonra diske yazılabilir, bir görüntü işleme hattına geçirilebilir veya doğrudan bir web yanıtına geri döndürülebilir.

IronPDF ayrıca URL'leri ve HTML dizelerini anında PDF'ye dönüştürür, bu yüzden herhangi bir web sayfası veya işlenmiş HTML dökümanını ayrı bir işleme adımına ihtiyaç duymadan tek bir hat üzerinden görsel olarak yakalamak mümkündür.

Mevcut Bir PDF Belgesini Görüntülere Nasıl Dönüştürürüm?

toBufferedImages, çıktı boyutlarını kontrol etmek için isteğe bağlı bir ToImageOptions argümanı ve belirli sayfaları hedeflemek için bir PageSelection argümanını kabul eder. Hiçbir argüman geçirilmediğinde, tüm sayfalar doğal çözünürlüklerinde dönüştürülür.

Aşağıdaki örnek, her çıktıyı 800x500 piksel ile sınırlamak için ToImageOptions kullanarak bir PDF'nin tüm sayfalarını PNG dosyalarına dönüştürmektedir:

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/java-pdf-to-image-tutorial/convert-pdf-to-images.java
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.edit.PageSelection;
import com.ironsoftware.ironpdf.image.ToImageOptions;
import javax.imageio.ImageIO;
import java.awt.image.BufferedImage;
import java.io.File;
import java.io.IOException;
import java.nio.file.Paths;
import java.util.List;

public class Main {
    public static void main(String[] args) throws IOException {
        // Load the PDF document from disk
        PdfDocument pdf = PdfDocument.fromFile(Paths.get("business_plan.pdf"));

        // Configure output image dimensions
        ToImageOptions options = new ToImageOptions();
        options.setImageMaxHeight(800);
        options.setImageMaxWidth(500);

        // Convert all pages to BufferedImage objects with the configured dimensions
        List<BufferedImage> pages = pdf.toBufferedImages(options, PageSelection.allPages());

        // Write each page image to the assets/images folder (create the folder first)
        int pageIndex = 1;
        for (BufferedImage page : pages) {
            String fileName = "assets/images/" + pageIndex++ + ".png";
            ImageIO.write(page, "PNG", new File(fileName));
        }
    }
}
Java

Çıktı görüntüleri, 1 başlangıç noktası olan sayısal dosya adları ile assets/images/ kaydedilir. Programı çalıştırmadan önce o klasörü oluşturun, çünkü ImageIO.write eksik dizinleri oluşturmaz. setImageMaxHeight ve setImageMaxWidth çağrıları her bir boyutta üst sınırları belirler; IronPDF orijinal en-boy oranını korur ve görüntüyü germez.

İpuçları: JPEG formatında kaydetmek için, ImageIO.write içindeki format stringini "PNG" yerine "JPEG" olarak değiştirin ve dosya uzantısını buna göre güncelleyin.
PDF'den görsele dönüştürmeden sonra assets/images klasöründe 11 numaralandırılmış PNG görüntü dosyasını gösteren Windows dosya gezgini

PDF'den Görüntü Çıktısı - Sayfa başına bir adet olmak üzere 11 adet PNG dosyası

Daha fazla dönüştürme örneği için PDF rasterleştirme örnekleri sayfasını ziyaret edin.

IronPDF kullanarak bir URL'yi nasıl görüntülere dönüştürürüm?

PdfDocument.renderUrlAsPdf URL'yi alır, yerleşik Chromium motoru ile işler ve hemen toBufferedImages'e iletilebilen bir PdfDocument döndürür. Bu, genel erişime açık herhangi bir web sayfasını bir dizi görüntü olarak yakalamayı kolaylaştırır.

Aşağıdaki örnek, bir Amazon ürün sayfasını PDF'ye dönüştürür ve sonra her bir oluşan sayfayı bir PNG dosyası olarak kaydeder:

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/java-pdf-to-image-tutorial/convert-url-to-images.java
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.edit.PageSelection;
import com.ironsoftware.ironpdf.image.ToImageOptions;
import javax.imageio.ImageIO;
import java.awt.image.BufferedImage;
import java.io.File;
import java.io.IOException;
import java.util.List;

public class Main {
    public static void main(String[] args) throws IOException {
        // Render a URL to a PDF document using the Chromium rendering engine
        PdfDocument pdf = PdfDocument.renderUrlAsPdf("https://www.amazon.com");

        // Configure output image dimensions
        ToImageOptions options = new ToImageOptions();
        options.setImageMaxHeight(800);
        options.setImageMaxWidth(500);

        // Convert all pages and write to disk
        List<BufferedImage> pages = pdf.toBufferedImages(options, PageSelection.allPages());
        int pageIndex = 1;
        for (BufferedImage page : pages) {
            String fileName = "assets/images/" + pageIndex++ + ".png";
            ImageIO.write(page, "PNG", new File(fileName));
        }
    }
}
Java
IronPDF ile bir URL'yi görsellere dönüştürdükten sonra assets/images klasöründe 5 numaralandırılmış PNG dosyasını gösteren Windows dosya gezgini

URL'den Görüntü Çıktısı - 5 PNG dosyası

Kimlik doğrulama veya oturum çerezleri gerektiren sayfalar için web sitesi giriş kılavuzunu inceleyin.

Lütfen dikkate alın: renderUrlAsPdf'i destekleyen Chromium görüntüleme motoru, modern bir masaüstü tarayıcısı ile aynı CSS ve JavaScript desteğini uygular. İçeriği yüklemek için istemci tarafı JavaScript'e bağlı olan sayfalar doğru şekilde işlenecektir, tek sayfalı uygulamalar dahil.

Belirli Sayfaları Görüntülere Nasıl Dönüştürürüm?

PageSelection, tüm belge yerine bir sayfa alt kümesini hedeflemek için birkaç fabrika yöntemi sağlar. Bu, yalnızca bir kapak sayfası, bir özet bölümü veya bilinen bir sayfa aralığının çıkarılması gerektiğinde kullanışlıdır.

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/java-pdf-to-image-tutorial/page-selection.java
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.edit.PageSelection;
import com.ironsoftware.ironpdf.image.ToImageOptions;
import javax.imageio.ImageIO;
import java.awt.image.BufferedImage;
import java.io.File;
import java.io.IOException;
import java.nio.file.Paths;
import java.util.List;

public class PageSelectionExample {
    public static void main(String[] args) throws IOException {
        PdfDocument pdf = PdfDocument.fromFile(Paths.get("report.pdf"));
        ToImageOptions options = new ToImageOptions();
        options.setImageMaxHeight(800);
        options.setImageMaxWidth(500);

        // Convert only the first page (page index is zero-based)
        List<BufferedImage> coverPage = pdf.toBufferedImages(options, PageSelection.singlePage(0));
        ImageIO.write(coverPage.get(0), "PNG", new File("cover.png"));

        // Convert pages 2 through 5 (zero-based indices 1 through 4)
        List<BufferedImage> excerpt = pdf.toBufferedImages(options, PageSelection.pageRange(1, 4));
        for (int i = 0; i < excerpt.size(); i++) {
            ImageIO.write(excerpt.get(i), "PNG", new File("excerpt_" + (i + 1) + ".png"));
        }
    }
}
Java

PageSelection.singlePage(0) yalnızca ilk sayfayı hedefler, bu da kapak resmi oluşturmak için yararlıdır. PageSelection.pageRange(1, 4), sıfır tabanlı dizinler kullanarak ikinci ve beşinci sayfaları çıkarır. Her ikisi de bir List<BufferedImage> döndürür, bu nedenle döngü modeli, seçilen sayfa sayısından bağımsız olarak aynıdır.

Önemli: PageSelection içindeki sayfa dizinleri sıfır tabanlıdır: ilk sayfa 0, ikincisi 1, ve bu şekilde devam eder. Aralık dışı bir indeks geçirme, çalışma zamanında bir IndexOutOfBoundsException fırlatır.

Java PDF'den Görüntüye Dönüştürme İçin Sonraki Adımlar Nelerdir?

Bu kılavuz, mevcut bir PDF'nin tüm sayfalarını dönüştürme, bir URL'yi sayfa görüntüleri kümesi olarak yakalama ve hedeflenen bir sayfa aralığını çıkarma gibi üç yaygın deseni kapsamıştır. IronPDF, çağrı kodunu kısa ve öngörülebilir tutarak çözünürlük kontrolünü ve format seçimini ToImageOptions ve ImageIO üzerinden yönetir.

IronPDF for Java ile devam etmek için, bu ilgili kaynakları keşfedin:

IronPDF for Java geliştirme için ücretsizdir. Ticari dağıtım için bir lisans gereklidir. Ücretsiz denemenizi başlatın veya projenize uygun planı görmek için lisans seçeneklerini görüntüleyin.

IronPDF'nin başka neler yapabileceğini görmeye hazır mısınız? Tam IronPDF for Java eğitim sayfasına göz atın.

Sıkça Sorulan Sorular

Bir PDF dosyasını Java'da PNG görüntülerine nasıl dönüştürürüm?

PdfDocument.fromFile() kullanarak PDF'yi yükleyin, toBufferedImages() çağırarak her sayfayı temsil eden BufferedImage nesnelerinin bir listesini alın ve ardından her resmi PNG dosyası olarak kaydetmek için ImageIO.write() kullanın.

PDF sayfalarını dönüştürürken hangi görüntü formatları desteklenir?

IronPDF'nin toBufferedImages metodu BufferedImage nesneleri döndürür. Bunları Java'nın ImageIO sınıfı tarafından desteklenen herhangi bir formatta kaydedebilirsiniz, buna PNG, JPEG ve TIFF dahildir.

Sadece belirli PDF sayfalarını görüntüye dönüştürebilir miyim?

Evet. toBufferedImages metoduna bir PageSelection argümanı geçin. Bir sayfayı dönüştürmek için PageSelection.singlePage(0) veya bir aralık dönüştürmek için PageSelection.pageRange(1, 4) kullanın. Sayfa dizinleri sıfır tabanlıdır.

Java'da PDF'den görüntüye dönüştürmenin yaygın kullanım alanları nelerdir?

Yaygın kullanım alanları arasında belge yönetim sistemleri için küçük resim önizlemeleri oluşturma, web uygulamaları için sayfa seviyesinde ekran görüntüleri üretme, sunumlar için görsel içerik çıkarma ve PDF render desteği olmayan sistemler için belge arşivleme işlemleri yer alır.

IronPDF'i Maven projemde nasıl eklerim?

<dependencies> bloğunun içine aşağıdaki bağımlılığı ekleyin: <dependency><groupId>com.ironsoftware</groupId><artifactId>ironpdf</artifactId><version>2024.9.1</version></dependency>

Bir URL'yi doğrudan görüntü dosyalarına dönüştürebilir miyim?

Evet. Sayfayı yerleşik Chromium motoru ile render etmek için PdfDocument.renderUrlAsPdf(url) çağırın, ardından PdfDocument sonucunu toBufferedImages'a geçirin ve sayfa görüntülerinin listesini alın.

Çıktı görüntü çözünürlüğünü nasıl kontrol ederim?

Bir ToImageOptions örneği oluşturun, azami boyutları ayarlamak için setImageMaxHeight() ve setImageMaxWidth() çağırın, ardından bunu toBufferedImages metoduna ilk argüman olarak geçirin. IronPDF, en-boy oranını korur ve görüntüyü esnetmez.

What are the output image formats that IronPDF supports?

IronPDF supports converting PDFs to various image formats, including JPEG, PNG, and TIFF.

How does IronPDF handle conversion of multi-page PDFs?

IronPDF converts each page of a multi-page PDF into a standalone image, maintaining the order and allowing for individual processing or storage.

What Java prerequisites are needed for using IronPDF?

Before using IronPDF, ensure that Java is installed, along with a Java IDE like Eclipse or IntelliJ, and that Maven is set up and integrated with the IDE.

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ılandırılmış, görsel olarak çekici kılavuzlar oluşturmayı seviyor.

...
Daha Fazla Oku

Başlamaya Hazır mısınız?

Sürüm:2026.6yeni yayınlandı

ÜCRETSİZİNİZİ EDİNİN

30 günlük Deneme Anahtarınızı anında edinin.

bullet_checkedKredi kartı veya hesap oluşturma gerektirmez
bullet_testÜretimde Test
filigran olmadan
bullet_calendar30 gün tamamen
işlevsel ürün
bullet_supportDeneme sırasında teknik
24/5 destek
Ücretsiz 30 Günlük Deneme Anahtarınızı anında alın.
Kredi kartı veya hesap oluşturma gerektirmez
Java için Maven Kütüphanesi PDF
Maven ile Yükle

Sürüm: 2026.6

<dependency>
   <groupId>com.ironsoftware</groupId>
   <artifactId>ironpdf</artifactId>
   <version>2026.6.1</version>
</dependency>
https://central.sonatype.com/artifact/com.ironsoftware/ironpdf/2026.6.1
or
Java PDF JAR
İndir JAR

Sürüm: 2026.6

Projenize manuel olarak yükleyin

Key in blue circle

Ücretsiz 30 günlük Deneme Anahtarınızı anında edinin.

Your trial license will be sent to your email address

Herhangi bir sınırlama yoktur. %100 erişim. Kredi kartı gerekmez.

bullet_checkedKredi kartı veya hesap oluşturma gerektirmezHerhangi bir sınırlama yoktur. %100 erişim. Kredi kartı gerekmez.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
Ücretsiz Canlı Demo rezervasyonu yapın
Booking Badge

Dünya Çapında Milyonlarca Mühendisin Güvendiği

Iron Software müşteri logoları
Bağımsız Danışmanlık Alın
Aşağıdaki formu doldurun veya sales@ironsoftware.com adresine e-posta gönderin
Bilgileriniz daima gizli kalacaktır.
Dünya Çapında Milyonlarca Mühendisin Güvendiği
Iron Software müşteri logoları
Ücretsiz 30 Günlük Deneme Anahtarınızı anında alın.
Kredi kartı veya hesap oluşturma gerektirmez