Perangkat dan Rendering
Perangkat dan Rendering
Aspose.PDF FOSS for .NET menyediakan kelas perangkat yang merender halaman PDF ke gambar raster. Setiap perangkat menargetkan format tertentu — TIFF, JPEG, PNG, atau BMP — dan menerima parameter resolusi dan kualitas.
Rendering ke PNG
PngDevice mengonversi halaman PDF menjadi gambar PNG.
using var doc = Document.Open(pdfBytes);
var device = new PngDevice(new Resolution(300));
using var stream = File.Create("page1.png");
device.Process(doc.Pages[1], stream);Rendering ke JPEG
JpegDevice mengonversi halaman menjadi JPEG dengan kualitas yang dapat dikonfigurasi.
var device = new JpegDevice(new Resolution(150), 90); // 90% quality
using var stream = File.Create("page1.jpg");
device.Process(doc.Pages[1], stream);Rendering ke TIFF
TiffDevice mengonversi satu atau beberapa halaman menjadi gambar TIFF multi‑halaman.TiffSettings mengontrol kompresi, kedalaman warna, dan bentuk.
var settings = new TiffSettings();
var device = new TiffDevice(new Resolution(200), settings);
using var stream = File.Create("document.tiff");
device.Process(doc, stream); // All pagesRendering ke BMP
BmpDevice mengonversi halaman menjadi bitmap yang tidak terkompresi.
var device = new BmpDevice(new Resolution(300));
using var stream = File.Create("page1.bmp");
device.Process(doc.Pages[1], stream);Kontrol resolusi
Semua perangkat menerima objek Resolution yang menentukan DPI.
var lowRes = new Resolution(72); // Screen quality
var midRes = new Resolution(150); // Print draft
var hiRes = new Resolution(300); // Print qualityEkstraksi teks melalui TextDevice
TextDevice mengekstrak teks dari sebuah halaman menggunakan pipeline pemrosesan perangkat.
var device = new TextDevice();
using var stream = new MemoryStream();
device.Process(doc.Pages[1], stream);
string text = System.Text.Encoding.UTF8.GetString(stream.ToArray());Tips dan Praktik Terbaik
- Gunakan 300 DPI untuk output berkualitas cetak dan 72-150 DPI untuk penggunaan layar/web.
TiffDevicedapat memproses seluruh dokumen dalam satu panggilan; perangkat lain memproses satu halaman pada satu waktu.- Nilai kualitas JPEG berkisar antara 0-100; 85-90 memberikan keseimbangan yang baik antara kualitas dan ukuran file.
- Untuk konversi batch, iterasi halaman dan proses masing-masing dengan perangkat yang sesuai.
- Buang aliran setelah pemrosesan untuk melepaskan handle file.
Masalah Umum
| Issue | Cause | Fix |
|---|---|---|
| Gambar buram | Resolusi terlalu rendah | Tingkatkan DPI di konstruktor Resolution |
| File TIFF terlalu besar | Pengaturan tidak terkompresi atau resolusi tinggi | Konfigurasikan kompresi TiffSettings |
| Aliran output kosong | Process tidak dipanggil atau indeks halaman salah | Verifikasi halaman ada dan Process selesai |
FAQ
Bisakah saya merender rentang halaman tertentu ke TIFF?
Ya. TiffDevice.Process memiliki overload yang menerima nomor halaman mulai dan akhir.
Jenis kompresi apa yang didukung oleh TiffSettings?
LZW, CCITT3, CCITT4, RLE, None, dan tipe kompresi TIFF standar lainnya.
Bisakah saya mengontrol dimensi gambar output?
Ya. Konstruktor perangkat menerima parameter lebar dan tinggi selain atau menggantikan resolusi.
Ringkasan Referensi API
| Class / Method | Description |
|---|---|
PngDevice | Render halaman ke format PNG |
JpegDevice | Render halaman ke JPEG dengan kontrol kualitas |
TiffDevice | Render halaman ke TIFF multi-halaman |
BmpDevice | Render halaman ke format BMP |
ImageDevice | Kelas dasar untuk semua perangkat render gambar |
DocumentDevice | Kelas dasar untuk perangkat yang memproses seluruh dokumen |
TextDevice | Ekstrak teks melalui pipeline perangkat |
Resolution | Spesifikasi DPI untuk rendering |
TiffSettings | Konfigurasi output TIFF (kompresi, kedalaman warna) |