charls native dotnet

CharLS.Native .NET

CharLS.Native .NET — это сборка адаптера, которая обеспечивает доступ к собственной реализации CharLS JPEG-LS C++ для приложений на основе .NET.
JPEG-LS (ISO-14495-1) — это стандарт сжатия без потерь или почти без потерь для изображений с непрерывными тонами.

Примечание: реализация на чистом C# предоставляется в проекте CharLS .NET.

Функции

• Библиотека классов .NET 9.0, .NET 8.0 и .NET Framework 4.8.
• Поддержка платформ .NET: Windows, Linux и macOS.
• Включает встроенные библиотеки DLL CharLS для Windows (x86, x64 и ARM64).

Как использовать

CharLS.Native можно добавить в проект C# с помощью командной строки dotnet или диспетчера пакетов NuGet в Visual Studio.

Установите с помощью командной строки dotnet

dotnet add package CharLS.Native

Специальные шаги установки Windows

Пакет NuGet поставляется с готовыми библиотеками CharLS DLL для целевых систем x86, x64 и ARM64. В целевой системе необходимо установить распространяемый пакет Microsoft Visual C++ 2015–2022 (версии 14.42 или новее).

Особые шаги установки Linux

Предварительно собранную общую библиотеку CharLS можно установить с помощью менеджера пакетов Apt:

sudo apt install libcharls2

Особые шаги установки MacOS

Предварительно собранную общую библиотеку CharLS можно установить с помощью менеджера пакетов Homebrew:

brew install team-charls/tap/charls

Как использовать классы C# в пакете NuGet

В репозиторий GitHub включен пример приложения, которое демонстрирует, как конвертировать распространенные типы изображений, такие как .bmp, .png и .jpg, в .jls (JPEG-LS).

Общие шаги по созданию этого репозитория

• Используйте Git, чтобы получить клон этого репозитория:

 git clone --recurse-submodules

• Используйте CMake для создания собственной общей библиотеки C++. Как это сделать, см. в проекте CharLS. При сборке с помощью Visual Studio этот шаг можно пропустить.
• Используйте интерфейс командной строки .NET 9.0 или Visual Studio 2022 (17.12 или новее) для создания файла решения CharLSNativeDotNet.sln. Например: dotnet build && dotnet test && dotnet publish для сборки пакета nuget.

Создание библиотек Windows DLL и подписание кода всех компонентов.

Сборку пакета NuGet с подписанными библиотеками DLL Windows можно выполнить только на платформе Window с помощью 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 можно найти в README проекта C++ CharLS. Этот репозиторий также содержит инструкции по сборке собственной общей библиотеки C++ CharLS из исходного кода.