Apparaten en Rendering
Apparaten en Rendering
Aspose.PDF FOSS for .NET biedt apparaatklassen die PDF‑pagina’s renderen naar rasterafbeeldingen. Elk apparaat richt zich op een specifiek formaat — TIFF, JPEG, PNG, of BMP — en accepteert resolutie‑ en kwaliteitsparameters.
Renderen naar PNG
PngDevice converteert een PDF-pagina naar een PNG-afbeelding.
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);Renderen naar JPEG
JpegDevice converteert een pagina naar JPEG met configureerbare kwaliteit.
var device = new JpegDevice(new Resolution(150), 90); // 90% quality
using var stream = File.Create("page1.jpg");
device.Process(doc.Pages[1], stream);Renderen naar TIFF
TiffDevice converteert één of meer pagina’s naar een meerpagina‑TIFF‑afbeelding.TiffSettings regelt compressie, kleurdiepte en vorm.
var settings = new TiffSettings();
var device = new TiffDevice(new Resolution(200), settings);
using var stream = File.Create("document.tiff");
device.Process(doc, stream); // All pagesRenderen naar BMP
BmpDevice converteert een pagina naar een ongecomprimeerde bitmap.
var device = new BmpDevice(new Resolution(300));
using var stream = File.Create("page1.bmp");
device.Process(doc.Pages[1], stream);Resolutiecontrole
Alle apparaten accepteren een Resolution object dat DPI specificeert.
var lowRes = new Resolution(72); // Screen quality
var midRes = new Resolution(150); // Print draft
var hiRes = new Resolution(300); // Print qualityTekstextractie via TextDevice
TextDevice haalt tekst uit een pagina met behulp van de apparaatverwerkingspipeline.
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 en best practices
- Gebruik 300 DPI voor afdrukkwaliteit en 72-150 DPI voor scherm-/webgebruik.
TiffDevicekan het volledige document in één oproep verwerken; andere apparaten verwerken één pagina per keer.- JPEG-kwaliteitswaarden variëren van 0-100; 85-90 biedt een goede balans tussen kwaliteit en bestandsgrootte.
- Voor batchconversie, doorloop de pagina’s en verwerk elke pagina met het juiste apparaat.
- Vernietig streams na verwerking om bestandskoppelingen vrij te geven.
Veelvoorkomende problemen
| Issue | Cause | Fix |
|---|---|---|
| Afbeelding is onscherp | Resolutie te laag | Verhoog DPI in de Resolution constructor |
| TIFF-bestand te groot | Ongecomprimeerde of hoge resolutie‑instellingen | Configureer TiffSettings compressie |
| Uitvoerstroom is leeg | Process niet aangeroepen of paginapindex onjuist | Controleer of pagina bestaat en Process voltooid is |
FAQ
Kan ik een specifiek paginabereik renderen naar TIFF?
Ja. TiffDevice.Process heeft overloads die start‑ en eindpaginanummers accepteren.
Welke compressietypen ondersteunt TiffSettings?
LZW, CCITT3, CCITT4, RLE, None, en andere standaard TIFF-compressietypen.
Kan ik de afmetingen van de uitvoerafbeelding regelen?
Ja. Device-constructors accepteren breedte- en hoogteparameters naast of in plaats van resolutie.
API-referentieoverzicht
| Class / Method | Description |
|---|---|
PngDevice | Render een pagina naar PNG-formaat |
JpegDevice | Render een pagina naar JPEG met kwaliteitsregeling |
TiffDevice | Render pagina’s naar multi-page TIFF |
BmpDevice | Render een pagina naar BMP-formaat |
ImageDevice | Basisklasse voor alle beeldrenderingsapparaten |
DocumentDevice | Basisklasse voor apparaten die volledige documenten verwerken |
TextDevice | Tekst extraheren via de apparaat‑pijplijn |
Resolution | DPI‑specificatie voor rendering |
TiffSettings | TIFF‑uitvoerconfiguratie (compressie, kleurdiepte) |