SetModernImageCodecLibrary

Billedhåndtering, konfiguration, native codecs

Beskrivelse

Indstiller filen eller mappen for det oprindelige MagickWand-bibliotek, der bruges af moderne billedafkodning

Syntaks

Function TPDFlib.SetModernImageCodecLibrary(
  Const FileNameOrDirectory: WideString): Integer;

Parametre

FileNameOrDirectoryEn fuld sti til det oprindelige bibliotek eller en mappe, der indeholder biblioteket og dets afhængigheder

Returværdier

1Stien blev accepteret, før codec-modulet blev indlæst
0Et codec-modul er allerede indlæst, og dets sti kan ikke ændres i processens levetid

Bemærkninger

Konfigurer stien, før du kalder ModernImageCodecAvailable eller importerer et moderne billede, da begge handlinger kan indlæse modulet

Hvis argumentet er en portabel biblioteksmappe, der indeholder modules\coders, angiver indlæseren ellers ikke-indstillede værdier for MAGICK_HOME, MAGICK_CONFIGURE_PATH og MAGICK_CODER_MODULE_PATH for den pågældende proces

Når ingen eksplicit sti er angivet, kontrollerer indlæseren PDFLIB_MODERN_IMAGE_CODEC, programmets mappe og platformens biblioteksnavne

Programmer kan i stedet kalde RegisterModernImageDecoderBackend fra PDFlibModernImage med en dekodercallback, der returnerer en fuldt orienteret PNG-stream

Funktioner i PDFlibModernImage-uniten

Uniten PDFlibModernImage eksponerer kodekplumbing bag metoderne ovenfor som selvstændige funktioner til applikationer, der styrer dekoderen direkte:

DetermineModernImageFormatSniffer en stream-header og rapporterer mifAVIF, mifHEIF, mifJPEGXL eller mifUnknown
ModernImageFormatNameReturnerer det menneskelæsbare formatnavn (AVIF, HEIF, JPEG XL eller Unknown)
SetModernImageCodecLibraryPathModstykke til denne metode på unitniveau; returnerer False, når kodekmodulet allerede er blevet indlæst for processen
RegisterModernImageDecoderBackendInstallerer en TPDFlibModernImageDecodeCallback, der modtager inputstrømmen, formatet, et ApplyOrientation-flag og skal skrive en fuldt orienteret PNG-stream; den har forrang frem for det native kodekmodul
ClearModernImageDecoderBackendFjerner en registreret callback (svarende til at registrere nil)
ModernImageCodecAvailableForsøger den engangsindlæsning af kodekmodulet og rapporterer, om native dekodning kan bruges; den identisk navngivne TPDFlib-metode pakker dette tjek
DecodeModernImageToPNGDekoder ét billede gennem den registrerede callback eller, uden en, gennem det native kodekmodul; ApplyOrientation er som standard True

Se også

ModernImageCodecAvailable, AddModernImageFromFile