Périphériques et rendu
Appareils et rendu
Aspose.PDF FOSS for .NET fournit des classes d’appareil qui rendent les pages PDF en images raster. Chaque appareil cible un format spécifique — TIFF, JPEG, PNG ou BMP — et accepte les paramètres de résolution et de qualité.
Rendu en PNG
PngDevice convertit une page PDF en image 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);Rendu en JPEG
JpegDevice convertit une page en JPEG avec une qualité configurable.
var device = new JpegDevice(new Resolution(150), 90); // 90% quality
using var stream = File.Create("page1.jpg");
device.Process(doc.Pages[1], stream);Rendu en TIFF
TiffDevice convertit une ou plusieurs pages en une image TIFF multipage.TiffSettings contrôle la compression, la profondeur de couleur et la forme.
var settings = new TiffSettings();
var device = new TiffDevice(new Resolution(200), settings);
using var stream = File.Create("document.tiff");
device.Process(doc, stream); // All pagesRendu en BMP
BmpDevice convertit une page en bitmap non compressé.
var device = new BmpDevice(new Resolution(300));
using var stream = File.Create("page1.bmp");
device.Process(doc.Pages[1], stream);Contrôle de résolution
Tous les appareils acceptent un objet Resolution spécifiant le DPI.
var lowRes = new Resolution(72); // Screen quality
var midRes = new Resolution(150); // Print draft
var hiRes = new Resolution(300); // Print qualityExtraction de texte via TextDevice
TextDevice extrait le texte d’une page en utilisant le pipeline de traitement du dispositif.
var device = new TextDevice();
using var stream = new MemoryStream();
device.Process(doc.Pages[1], stream);
string text = System.Text.Encoding.UTF8.GetString(stream.ToArray());Conseils et meilleures pratiques
- Utilisez 300 DPI pour une sortie de qualité impression et 72-150 DPI pour une utilisation écran/web.
TiffDevicepeut traiter le document entier en un seul appel ; les autres appareils traitent une page à la fois.- Les valeurs de qualité JPEG vont de 0 à 100 ; 85-90 offrent un bon équilibre entre qualité et taille de fichier.
- Pour une conversion par lots, parcourez les pages et traitez chacune avec l’appareil approprié.
- Libérez les flux après le traitement pour libérer les poignées de fichiers.
Problèmes courants
| Issue | Cause | Fix |
|---|---|---|
| L’image est floue | Résolution trop basse | Augmenter le DPI dans le constructeur Resolution |
| Fichier TIFF trop volumineux | Paramètres non compressés ou haute résolution | Configurer la compression TiffSettings |
| Le flux de sortie est vide | Process non appelé ou index de page incorrect | Vérifier que la page existe et que Process se termine |
FAQ
Puis-je rendre une plage de pages spécifique en TIFF ?
Oui. TiffDevice.Process possède des surcharges acceptant les numéros de page de début et de fin.
Quels types de compression TiffSettings prend‑il en charge ?
LZW, CCITT3, CCITT4, RLE, Aucun, et d’autres types de compression TIFF standard.
Puis-je contrôler les dimensions de l’image de sortie ?
Oui. Les constructeurs de Device acceptent les paramètres de largeur et de hauteur en plus ou à la place de la résolution.
Résumé de la référence API
| Class / Method | Description |
|---|---|
PngDevice | Rendre une page au format PNG |
JpegDevice | Rendre une page au format JPEG avec contrôle de la qualité |
TiffDevice | Rendre des pages au format TIFF multi-pages |
BmpDevice | Rendre une page au format BMP |
ImageDevice | Classe de base pour tous les périphériques de rendu d’image |
DocumentDevice | Classe de base pour les périphériques qui traitent des documents entiers |
TextDevice | Extraire le texte via le pipeline du périphérique |
Resolution | Spécification DPI pour le rendu |
TiffSettings | Configuration de sortie TIFF (compression, profondeur de couleur) |