SetModernImageCodecLibrary
Bildhantering, Konfiguration, Inbyggda kodekar
Beskrivning
Sätter native MagickWand-biblioteksfilen eller -katalogen som modern bildavkodning använder
Syntax
Function TPDFlib.SetModernImageCodecLibrary(
Const FileNameOrDirectory: WideString): Integer;Parametrar
| FileNameOrDirectory | En fullständig sökväg till native-biblioteket, eller en katalog som innehåller biblioteket och dess beroenden |
|---|
Returvärden
| 1 | Sökvägen godtogs innan codec-modulen lästes in |
|---|---|
| 0 | En codec-modul är redan inläst och dess sökväg går inte att ändra under processens livstid |
Anmärkningar
Konfigurera sökvägen innan du anropar ModernImageCodecAvailable eller importerar en modern bild, eftersom båda operationerna kan läsa in modulen
Om argumentet är en portabel bibliotekskatalog som innehåller modules\coders, lämnar laddaren annars-osatta MAGICK_HOME-, MAGICK_CONFIGURE_PATH- och MAGICK_CODER_MODULE_PATH-värden för den processen
När ingen explicit sökväg är satt kontrollerar laddaren PDFLIB_MODERN_IMAGE_CODEC, den körbara filens katalog och plattformens biblioteksnamn
Program kan i stället anropa RegisterModernImageDecoderBackend från PDFlibModernImage med en decoder-callback som returnerar en fullständigt orienterad PNG-ström
PDFlibModernImage unit functions
PDFlibModernImage-uniten exponerar codec-mekaniken bakom metoderna ovan som fristående funktioner för program som driver avkodaren direkt:
DetermineModernImageFormat | Luktar på en strömheader och rapporterar mifAVIF, mifHEIF, mifJPEGXL eller mifUnknown |
|---|---|
ModernImageFormatName | Returnerar det läsbara formatnamnet (AVIF, HEIF, JPEG XL eller Unknown) |
SetModernImageCodecLibraryPath | Unitnivå-tvilling till den här metoden; returnerar False när codec-modulen redan lästs in för processen |
RegisterModernImageDecoderBackend | Installerar en TPDFlibModernImageDecodeCallback som tar emot indataströmmen, formatet, en ApplyOrientation-flagga och måste skriva en fullständigt orienterad PNG-ström; den går före den inbyggda codec-modulen |
ClearModernImageDecoderBackend | Removes a registered callback (equivalent to registering nil) |
ModernImageCodecAvailable | Försöker den engångsinläsning av codec-modulen och rapporterar huruvida native-avkodning är användbar; den identiskt namngivna TPDFlib-metoden wrappar den här kontrollen |
DecodeModernImageToPNG | Avkodar en bild via den registrerade callbacken eller, utan en, via den inbyggda codec-modulen; ApplyOrientation är som standard True |