THotPDF.DecodeLoadedImageRegion Method
Dekoduje dokładny prostokąt we współrzędnych źródła z jednego streamu XObject wczytanego obrazu do TBitmap należącej do wywołującego
Deklaracja
function DecodeLoadedImageRegion(AImageStream: THPDFStreamObject;
RegionLeft, RegionTop, RegionRight, RegionBottom: Integer): TBitmap;
Jednostka
HPDFDoc
Parametry
| Nazwa | Przeznaczenie |
|---|---|
AImageStream | Stream XObject wczytanego obrazu do zdekodowania |
RegionLeft | Włączna lewa współrzędna źródła |
RegionTop | Włączna górna współrzędna źródła |
RegionRight | Wyłączna prawa współrzędna źródła |
RegionBottom | Wyłączna dolna współrzędna źródła |
Wartość zwracana
Zwraca świeżo przydzieloną bitmapę zawierającą przycięty, niepusty region albo nil, gdy obrazu lub żądanej geometrii nie da się zdekodować
Uwagi dotyczące użycia
- Wywołujący jest właścicielem zwróconej, niepustej bitmapy i musi ją zwolnić
- Współrzędne używają zdekodowanej przestrzeni rastra od lewego górnego narożnika obrazu, a granice prawa i dół są wyłączne
- Granice wykraczające poza obraz są przycinane przed dekodowaniem
- JPEG 2000 żąda natywnego regionu dekodera przed rozwinięciem pikseli
- Ta metoda zachowuje pełną zdekodowaną rozdzielczość regionu
- Pozostałe obsługiwane formaty obrazów dekodują się normalnie i zwracają dokładnie przycięty region
- Renderer wczytanych stron automatycznie używa wariantu świadomego rozdzielczości dla przycinanych lub pomniejszanych XObject obrazów wyrównanych do osi