SetModernImageCodecLibrary

Image handling, Configuration, Native codecs

คำอธิบาย

กำหนดไฟล์หรือไดเรกทอรีไลบรารี MagickWand เนทีฟที่ใช้ถอดรหัสภาพสมัยใหม่

ไวยากรณ์

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

พารามิเตอร์

FileNameOrDirectory	พาธไลบรารีเนทีฟแบบเต็ม หรือไดเรกทอรีที่มีทั้งไลบรารีและไฟล์ที่ต้องพึ่ง

ค่าที่ส่งกลับ

1	พาธถูกยอมรับก่อนโมดูล codec ถูกโหลด
0	มีโมดูล codec โหลดอยู่แล้วและพาธของมันเปลี่ยนไม่ได้ตลอดอายุโปรเซส

หมายเหตุ

กำหนดพาธก่อนเรียก ModernImageCodecAvailable หรือนำเข้าภาพสมัยใหม่ เพราะทั้งสองการทำงานอาจโหลดโมดูล ถ้าอาร์กิวเมนต์เป็นไดเรกทอรีไลบรารีแบบพกพาที่มี

modules\coders ตัวโหลดจะกำหนดค่า MAGICK_HOME, MAGICK_CONFIGURE_PATH และ MAGICK_CODER_MODULE_PATH ที่ยังไม่ได้ตั้งให้กับโปรเซสนั้น เมื่อไม่ได้ตั้งพาธแบบชัดเจน ตัวโหลดจะตรวจ

PDFLIB_MODERN_IMAGE_CODEC

RegisterModernImageDecoderBackend ไดเรกทอรีของไฟล์ปฏิบัติการ และชื่อไลบรารีเฉพาะแพลตฟอร์ม แอปพลิเคชันอาจเลือกเรียก PDFlibModernImage จาก

ฟังก์ชันใน unit PDFlibModernImage

unit PDFlibModernImage เปิดเครื่องภายใน codec เบื้องหลังของเมธอดข้างบนออกมาเป็นฟังก์ชันอิสระ สำหรับแอปพลิเคชันที่ขับเคลื่อนตัวถอดรหัสเองโดยตรง:

`DetermineModernImageFormat`	ดมส่วนหัวของสตรีมแล้วรายงาน `mifAVIF`, `mifHEIF`, `mifJPEGXL` หรือ `mifUnknown`
`ModernImageFormatName`	ส่งคืนชื่อรูปแบบที่คนอ่านได้ (`AVIF`, `HEIF`, `JPEG XL` หรือ `Unknown`)
`SetModernImageCodecLibraryPath`	ฝาแฝดระดับ unit ของเมธอดนี้ คืน `False` เมื่อโมดูล codec ถูกโหลดไปแล้วสำหรับโปรเซส
`RegisterModernImageDecoderBackend`	ติดตั้ง `TPDFlibModernImageDecodeCallback` ที่รับสตรีมอินพุต รูปแบบ แฟล็ก `ApplyOrientation` และต้องเขียนสตรีม PNG ที่หมุนวางถูกต้องครบ ตัวนี้ได้สิทธิ์ก่อนโมดูล codec เนทีฟ
`ClearModernImageDecoderBackend`	เอา callback ที่ลงทะเบียนไว้ออก (เท่ากับลงทะเบียน `nil`)
`ModernImageCodecAvailable`	พยายามโหลดโมดูล codec ครั้งเดียวแล้วรายงานว่าการถอดรหัสเนทีฟใช้ได้หรือไม่ เมธอด `TPDFlib` ชื่อเดียวกันห่อการตรวจนี้ไว้
`DecodeModernImageToPNG`	ถอดรหัสภาพหนึ่งภาพผ่าน callback ที่ลงทะเบียนไว้ หรือถ้าไม่มีก็ผ่านโมดูล codec เนทีฟ `ApplyOrientation` ค่าเริ่มต้นเป็น `True`

ดูเพิ่มเติม

ModernImageCodecAvailable, AddModernImageFromFile