SetModernImageCodecLibrary
Bildverarbeitung, Konfiguration, native Codecs
Beschreibung
Legt die native MagickWand-Bibliotheksdatei oder das Verzeichnis für die moderne Bilddekodierung fest
Syntax
Function TPDFlib.SetModernImageCodecLibrary(
Const FileNameOrDirectory: WideString): Integer;Parameter
| FileNameOrDirectory | Ein vollständiger nativer Bibliothekspfad oder ein Verzeichnis mit der Bibliothek und ihren Abhängigkeiten |
|---|
Rückgabewerte
| 1 | Der Pfad wurde akzeptiert, bevor das Codec-Modul geladen wurde |
|---|---|
| 0 | Ein Codec-Modul ist bereits geladen und sein Pfad bleibt während der gesamten Prozesslaufzeit unveränderlich |
Anmerkungen
Konfigurieren Sie den Pfad vor dem Aufruf von ModernImageCodecAvailable oder dem Import eines modernen Bilds, da beide Vorgänge das Modul laden können
Wenn das Argument ein portables Bibliotheksverzeichnis mit modules\coders ist, stellt der Loader für diesen Prozess andernfalls nicht gesetzte Werte für MAGICK_HOME, MAGICK_CONFIGURE_PATH und MAGICK_CODER_MODULE_PATH bereit
Wenn kein expliziter Pfad festgelegt ist, prüft der Loader PDFLIB_MODERN_IMAGE_CODEC, das Verzeichnis der ausführbaren Datei und plattformspezifische Bibliotheksnamen
Anwendungen können stattdessen RegisterModernImageDecoderBackend aus PDFlibModernImage mit einem Decoder-Callback aufrufen, der einen vollständig ausgerichteten PNG-Stream zurückgibt
Funktionen der Unit PDFlibModernImage
Die Unit PDFlibModernImage stellt die Codec-Infrastruktur hinter den obigen Methoden als eigenständige Funktionen für Anwendungen bereit, die den Decoder direkt ansteuern:
DetermineModernImageFormat | Erkennt am Stream-Header das Format und meldet mifAVIF, mifHEIF, mifJPEGXL oder mifUnknown |
|---|---|
ModernImageFormatName | Gibt den lesbaren Formatnamen zurück (AVIF, HEIF, JPEG XL oder Unknown) |
SetModernImageCodecLibraryPath | Unit-seitiges Pendant dieser Methode; gibt False zurück, sobald das Codec-Modul für den Prozess bereits geladen wurde |
RegisterModernImageDecoderBackend | Installiert einen TPDFlibModernImageDecodeCallback, der den Eingabestream, das Format und ein ApplyOrientation-Flag empfängt und einen vollständig ausgerichteten PNG-Stream schreiben muss; er hat Vorrang vor dem nativen Codec-Modul |
ClearModernImageDecoderBackend | Entfernt einen registrierten Callback (äquivalent zur Registrierung von nil) |
ModernImageCodecAvailable | Versucht das einmalige Laden des Codec-Moduls und meldet, ob native Dekodierung nutzbar ist; die gleichnamige TPDFlib-Methode kapselt diese Prüfung |
DecodeModernImageToPNG | Dekodiert ein Bild über den registrierten Callback oder, ohne einen, über das native Codec-Modul; ApplyOrientation ist standardmäßig True |