SetModernImageCodecLibrary

이미지 처리, 구성, 네이티브 코덱

설명

최신 이미지 디코딩에 사용하는 네이티브 MagickWand 라이브러리 파일 또는 디렉터리를 설정합니다

구문

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

매개변수

FileNameOrDirectory완전한 네이티브 라이브러리 경로 또는 라이브러리와 종속성을 포함하는 디렉터리

반환 값

1코덱 모듈을 로드하기 전에 경로를 수락했습니다
0코덱 모듈이 이미 로드되어 있으며 프로세스 수명 동안 해당 경로를 변경할 수 없습니다

비고

두 작업 모두 모듈을 로드할 수 있으므로 ModernImageCodecAvailable를 호출하거나 최신 이미지를 가져오기 전에 경로를 구성합니다

인수가 modules\coders를 포함하는 이식 가능한 라이브러리 디렉터리이면 로더는 해당 프로세스에 아직 설정되지 않은 MAGICK_HOME, MAGICK_CONFIGURE_PATH, MAGICK_CODER_MODULE_PATH 값을 제공합니다

명시적 경로가 설정되지 않으면 로더는 PDFLIB_MODERN_IMAGE_CODEC, 실행 파일 디렉터리 및 플랫폼 라이브러리 이름을 확인합니다

애플리케이션은 RegisterModernImageDecoderBackend를 PDFlibModernImage에서 호출하고 완전히 방향이 맞춰진 PNG 스트림을 반환하는 디코더 콜백을 제공할 수도 있음

PDFlibModernImage 유닛의 함수

PDFlibModernImage 유닛은 위 메서드 뒤에서 코덱 배관을, 디코더를 직접 구동하는 애플리케이션용 독립 함수로 노출합니다

DetermineModernImageFormat스트림 헤더를 살펴보고 mifAVIF, mifHEIF, mifJPEGXL 또는 mifUnknown을 보고합니다
ModernImageFormatName사람이 읽을 수 있는 형식 이름(AVIF, HEIF, JPEG XL 또는 Unknown)을 반환합니다
SetModernImageCodecLibraryPath이 메서드의 유닛 수준 쌍으로, 프로세스에서 코덱 모듈이 이미 로드된 후에는 False를 반환합니다
RegisterModernImageDecoderBackend입력 스트림, 형식, ApplyOrientation 플래그를 받고 완전히 방향이 보정된 PNG 스트림을 기록해야 하는 TPDFlibModernImageDecodeCallback을 설치하며, 네이티브 코덱 모듈보다 우선합니다
ClearModernImageDecoderBackend등록된 콜백을 제거합니다(nil 등록과 동일)
ModernImageCodecAvailable코덱 모듈의 일회성 로드를 시도하고 네이티브 디코딩이 사용 가능한지 보고하며, 동일한 이름의 TPDFlib 메서드가 이 검사를 감쌉니다
DecodeModernImageToPNG등록된 콜백을 통해, 없으면 네이티브 코덱 모듈을 통해 이미지 한 장을 디코딩하며, ApplyOrientation의 기본값은 True입니다

참고 항목

ModernImageCodecAvailable, AddModernImageFromFile