Urządzenia i renderowanie

Urządzenia i renderowanie

Urządzenia i renderowanie

Aspose.PDF FOSS for .NET udostępnia klasy urządzeń, które renderują strony PDF do obrazów rastrowych. Każde urządzenie obsługuje określony format — TIFF, JPEG, PNG lub BMP — i przyjmuje parametry rozdzielczości i jakości.


Renderowanie do PNG

PngDevice konwertuje stronę PDF na obraz 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);

Renderowanie do JPEG

JpegDevice konwertuje stronę do formatu JPEG z konfigurowalną jakością.

var device = new JpegDevice(new Resolution(150), 90); // 90% quality
using var stream = File.Create("page1.jpg");
device.Process(doc.Pages[1], stream);

Renderowanie do TIFF

TiffDevice konwertuje jedną lub więcej stron na wielostronicowy obraz TIFF.
TiffSettings kontroluje kompresję, głębię kolorów i kształt.

var settings = new TiffSettings();
var device = new TiffDevice(new Resolution(200), settings);

using var stream = File.Create("document.tiff");
device.Process(doc, stream);  // All pages

Renderowanie do BMP

BmpDevice konwertuje stronę na nieskompresowaną bitmapę.

var device = new BmpDevice(new Resolution(300));
using var stream = File.Create("page1.bmp");
device.Process(doc.Pages[1], stream);

Kontrola rozdzielczości

Wszystkie urządzenia akceptują obiekt Resolution określający DPI.

var lowRes = new Resolution(72);   // Screen quality
var midRes = new Resolution(150);  // Print draft
var hiRes = new Resolution(300);   // Print quality

Ekstrakcja tekstu przy użyciu TextDevice

TextDevice wyodrębnia tekst ze strony przy użyciu potoku przetwarzania urządzenia.

var device = new TextDevice();
using var stream = new MemoryStream();
device.Process(doc.Pages[1], stream);
string text = System.Text.Encoding.UTF8.GetString(stream.ToArray());

Wskazówki i najlepsze praktyki

  • Użyj 300 DPI do wyjścia o jakości druku i 72‑150 DPI do użytku na ekranie/stronie internetowej.
  • TiffDevice może przetworzyć cały dokument w jednym wywołaniu; inne urządzenia przetwarzają jedną stronę na raz.
  • Wartości jakości JPEG mieszczą się w przedziale 0‑100; 85‑90 zapewnia dobrą równowagę między jakością a rozmiarem pliku.
  • Przy konwersji wsadowej iteruj strony i przetwarzaj każdą przy użyciu odpowiedniego urządzenia.
  • Zwolnij strumienie po przetworzeniu, aby zwolnić uchwyty plików.

Typowe problemy

IssueCauseFix
Obraz jest rozmytyRozdzielczość zbyt niskaZwiększ DPI w konstruktorze Resolution
Plik TIFF jest za dużyUstawienia nieskompresowane lub wysokiej rozdzielczościSkonfiguruj kompresję TiffSettings
Strumień wyjściowy jest pustyProcess nie wywołano lub indeks strony jest nieprawidłowySprawdź, czy strona istnieje i Process zostało wykonane

FAQ

Czy mogę renderować określony zakres stron do TIFF?

Tak. TiffDevice.Process ma przeciążenia przyjmujące numery stron początkowej i końcowej.

Jakie typy kompresji obsługuje TiffSettings?

LZW, CCITT3, CCITT4, RLE, None i inne standardowe typy kompresji TIFF.

Czy mogę kontrolować wymiary wyjściowego obrazu?

Tak. Konstruktorzy urządzeń akceptują parametry szerokości i wysokości oprócz lub zamiast rozdzielczości.


API Podsumowanie odniesienia

Class / MethodDescription
PngDeviceRenderuj stronę do formatu PNG
JpegDeviceRenderuj stronę do formatu JPEG z kontrolą jakości
TiffDeviceRenderuj strony do wielostronicowego TIFF
BmpDeviceRenderuj stronę do formatu BMP
ImageDeviceKlasa bazowa dla wszystkich urządzeń renderowania obrazu
DocumentDeviceKlasa bazowa dla urządzeń przetwarzających całe dokumenty
TextDeviceWyodrębnij tekst za pośrednictwem potoku urządzenia
ResolutionSpecyfikacja DPI dla renderowania
TiffSettingsKonfiguracja wyjścia TIFF (kompresja, głębia kolorów)

Zobacz także

 Polski