charls native dotnet

CharLS.Native .NET

CharLS.Native .NET 是一个适配器程序集，可为基于 .NET 的应用程序提供对本机 CharLS JPEG-LS C++ 实现的访问。
JPEG-LS (ISO-14495-1) 是连续色调图像的无损/近无损压缩标准。

备注：CharLS .NET 项目提供了纯 C# 实现。

特征

• .NET 9.0、.NET 8.0 和 .NET Framework 4.8 类库。
• 支持 .NET 平台：Windows、Linux 和 macOS。
• 包括预构建的本机 CharLS Windows DLL（x86、x64 和 ARM64）。

如何使用

可以使用 dotnet 命令行或 Visual Studio 中的 NuGet 包管理器将 CharLS.Native 添加到 C# 项目中。

使用 dotnet 命令行安装

dotnet add package CharLS.Native

Windows 特定安装步骤

NuGet 包附带了针对 x86、x64 和 ARM64 目标的预构建 CharLS DLL。需要在目标系统上安装 Microsoft Visual C++ 2015-2022 Redistributable（v14.42 或更高版本）。

Linux具体安装步骤

可以使用 Apt 包管理器安装预构建的 CharLS 共享库：

sudo apt install libcharls2

MacOS具体安装步骤

可以使用 Homebrew 包管理器安装预构建的 CharLS 共享库：

brew install team-charls/tap/charls

如何使用 NuGet 包中的 C# 类

GitHub 存储库中包含一个示例应用程序，演示如何将 .bmp、.png 和 .jpg 等常见图像类型转换为 .jls (JPEG-LS)。

构建此存储库的一般步骤

• 使用 Git 获取此存储库的克隆：

 git clone --recurse-submodules

• 使用 CMake 构建本机 C++ 共享库，请参阅 CharLS 项目如何执行此操作。使用 Visual Studio 构建时，可以跳过此步骤。
• 使用 .NET 9.0 CLI 或 Visual Studio 2022（v17.12 或更高版本）构建解决方案文件 CharLSNativeDotNet.sln。例如： dotnet build && dotnet test && dotnet publish来构建 nuget 包。

构建 Windows DLL 并对所有组件进行代码签名

使用签名的 Windows DLL 构建 NuGet 包只能在 Windows 平台上使用 Visual Studio 2022 或使用 Visual Studio 2022 的构建工具来完成。为了支持使用存储在智能卡上的代码签名证书进行代码签名，Windows 命令文件是可用： create-signed-nuget-package.cmd 。指示：

• 打开 Visual Studio 开发人员命令提示符
• 转到克隆存储库的根目录
• 确保代码签名证书可用
• 执行命令create-signed-nuget-package.cmd certificate-thumb-print time-stamp-url
  证书指纹和时间戳 URL 参数取决于所使用的代码签名证书。

所有 DLL 和 NuGet 包本身都将被签名。

关于 JPEG-LS 图像压缩标准

有关 JPEG-LS 的更多信息可以在 C++ CharLS 项目的自述文件中找到。该存储库还包含如何从源代码构建本机 C++ CharLS 共享库的说明。