이 프로젝트는 ImageMagick의 닷넷 레퍼 Magick.NET라이브러리를 닷넷AOT(Ahead-Of-Time compilation)로 빌드할수있게 만든 프로젝트 입니다. 또한 닷넷런타임을 통한 JIT실행도 가능 합니다. 현재 닷넷AOT빌드의 특성상 AOT빌드된 라이브러리가 P/Invoke하는 네이티브 라이브러리를 상대경로로 찾지못하는 특성때문에 따로 노출되는 초기화 함수를 만들어 라이브러리의 절대경로를 초기화 할수있게 하였습니다.
해당 프로젝트로 빌드된 라이브러리를 사용하기위해서는 Magick.Native을 통해 Magick.NET의 네이티브 라이브러리가 필요합니다. 그것을 위해서는 이 프로젝트 디렉토리의 src/Magick.Native에서 Magick.NET의 Install Magick.Native지침을 따르십시오.
DotIMagick솔루션에서 DotIMagick프로젝트를 빌드하는것 자체는 Magick.Native의 libraries가 꼭 필요하지는 않습니다. 하지만 DotIMagick빌드 결과물의 사용을 위해서는 Magick.Native의 libraries가 필요합니다. 만약 Magick.Native디렉토리에 libraries의 네이티브 라이브러리를 받은 상태에서 DotIMagick 프로젝트를 Publish한다면 DotIMagick 프로젝트의 빌드출력경로에 magickNativeFiles디렉토리와 그 안에 libraries의 요소가 복사되어 존재할것입니다. 빌드출력경로의 magickNativeFiles디렉토리의 이름을 "libraries"로 변경후에 DotIMagick패키지를 사용할 프로젝트루트에 이름을 "libraries"로 변경한 디렉토리를 복사하면 해당 프로젝트에서 Publish시에 DotIMagick패키지가 올바르게 동작할것 입니다.
DotIMagick패키지의 빌드 동작에는 이 패키지가 사용되는 프로젝트의 루트에 libraries디렉토리가 있는지 체크하는 과정이 있습니다. DotIMagick와 함께 프로젝트를 빌드하면 빌드 출력경로에 magickNativeFiles디렉토리가 생성됩니다. 이 디렉토리에는 libraries에서 복사된 네이티브 라이브러리가 위치합니다. DotIMagick의 닷넷라이브러리 또는 nuget을 통해 DotIMagick을 설치하였고 Magick.Native의 libraries를 자신의 프로젝트 루트에 위치했다면 이제 DotIMagick를 사용하기 위해 초기화가 필요합니다.
DotIMagick.NativeConstants.InitBaseLibraryPath(basePath);
여기서 basePath는 magickNativeFiles의 상위폴더의 절대경로가 되어야합니다. 이 위치는 동적으로 지정할수있음으로 프로그램 시작시에 지정하면 됩니다. 한번 초기화후에 다시 초기화함수를 호출해서는 안됩니다.
MagickImage image = new MagickImage(MagickColors.White, width, height);
초기화 이후 부터는 자유롭게 사용가능합니다.
| .NET Version | Platform | Platform specific | AnyCPU | OpenMP |
|---|---|---|---|---|
| .NET8 | windows (x64) | ✅ | ✅ | ✅ |
| windows (arm64) | ✅ | ✅ | ✅ | |
| linux (x64) | ✅ | ✅ | ✅ | |
| linux-arm64 (arm64) | ✅ | ✅ | ✅ | |
| linux-musl (x64) | ✅ | ✅ | ✅ | |
| macOS (x64) | ✅ | ✅ | ❌ | |
| macOS (arm64) | ✅ | ✅ | ❌ | |
| windows (x86) | ✅ | ✅ | ❌ |