SetModernImageCodecLibrary
Obsługa obrazów, konfiguracja, natywne kodeki
Opis
Ustawia plik lub katalog natywnej biblioteki MagickWand używanej do dekodowania nowoczesnych obrazów
Składnia
Function TPDFlib.SetModernImageCodecLibrary(
Const FileNameOrDirectory: WideString): Integer;Parametry
| FileNameOrDirectory | Pełna ścieżka do natywnej biblioteki albo katalog zawierający bibliotekę i jej zależności |
|---|
Wartości zwracane
| 1 | Ścieżka została zaakceptowana przed wczytaniem modułu kodeka |
|---|---|
| 0 | Moduł kodeka został już wczytany, a jego ścieżka pozostaje niezmienna przez cały czas życia procesu |
Uwagi
Skonfiguruj ścieżkę przed wywołaniem ModernImageCodecAvailable lub zaimportowaniem nowoczesnego obrazu, ponieważ każda z tych operacji może wczytać moduł
Jeśli argument jest katalogiem przenośnej biblioteki zawierającym modules\coders, moduł ładujący dostarcza nieustawione wcześniej wartości MAGICK_HOME, MAGICK_CONFIGURE_PATH i MAGICK_CODER_MODULE_PATH dla tego procesu
Gdy nie ustawiono jawnej ścieżki, moduł ładujący sprawdza PDFLIB_MODERN_IMAGE_CODEC, katalog pliku wykonywalnego i nazwy bibliotek właściwe dla platformy
Aplikacje mogą zamiast tego wywołać RegisterModernImageDecoderBackend z PDFlibModernImage, przekazując wywołanie zwrotne dekodera zwracające w pełni zorientowany strumień PNG
Funkcje modułu PDFlibModernImage
Moduł PDFlibModernImage udostępnia mechanikę kodeków stojącą za powyższymi metodami jako samodzielne funkcje dla aplikacji sterujących dekoderem bezpośrednio:
DetermineModernImageFormat | Rozpoznaje nagłówek strumienia i raportuje mifAVIF, mifHEIF, mifJPEGXL lub mifUnknown |
|---|---|
ModernImageFormatName | Zwraca czytelną dla człowieka nazwę formatu (AVIF, HEIF, JPEG XL lub Unknown) |
SetModernImageCodecLibraryPath | Odpowiednik tej metody na poziomie modułu; zwraca False, gdy moduł kodeka został już wczytany dla procesu |
RegisterModernImageDecoderBackend | Instaluje TPDFlibModernImageDecodeCallback, który otrzymuje strumień wejściowy, format i flagę ApplyOrientation i musi zapisać w pełni zorientowany strumień PNG; ma pierwszeństwo przed natywnym modułem kodeka |
ClearModernImageDecoderBackend | Usuwa zarejestrowany callback (równoznaczne z rejestracją nil) |
ModernImageCodecAvailable | Próbuje jednokrotnego wczytania modułu kodeka i raportuje, czy dekodowanie natywne jest użyteczne; identycznie nazwana TPDFlib opakowuje to sprawdzenie |
DecodeModernImageToPNG | Dekoduje jeden obraz przez zarejestrowany callback, a bez niego przez natywny moduł kodeka; ApplyOrientation domyślnie True |