charls native dotnet

CharLS.Native .NET

CharLS.Native .NET est un assemblage d'adaptateurs qui donne accès à l'implémentation native CharLS JPEG-LS C++ pour les applications basées sur .NET.
JPEG-LS (ISO-14495-1) est une norme de compression sans perte/presque sans perte pour les images à tons continus.

Remarque : une implémentation purement C# est fournie avec le projet CharLS .NET.

Caractéristiques

• Bibliothèque de classes .NET 9.0, .NET 8.0 et .NET Framework 4.8.
• Prise en charge des plateformes .NET : Windows, Linux et macOS.
• Comprend des DLL Windows CharLS natives prédéfinies (x86, x64 et ARM64).

Comment utiliser

CharLS.Native peut être ajouté à votre projet C# à l'aide de la ligne de commande dotnet ou du gestionnaire de packages NuGet dans Visual Studio.

Installer à l'aide de la ligne de commande dotnet

dotnet add package CharLS.Native

Étapes d'installation spécifiques à Windows

Le package NuGet est livré avec des DLL CharLS prédéfinies pour les cibles x86, x64 et ARM64. Le redistribuable Microsoft Visual C++ 2015-2022 (v14.42 ou plus récent) doit être installé sur le système cible.

Étapes d'installation spécifiques à Linux

Une bibliothèque partagée CharLS pré-construite peut être installée à l'aide du gestionnaire de packages Apt :

sudo apt install libcharls2

Étapes d'installation spécifiques à MacOS

Une bibliothèque partagée CharLS pré-construite peut être installée à l'aide du gestionnaire de packages Homebrew :

brew install team-charls/tap/charls

Comment utiliser les classes C# dans le package NuGet

Un exemple d'application est inclus dans le référentiel GitHub qui montre comment convertir des types d'images courants tels que .bmp, .png et .jpg en .jls (JPEG-LS).

Étapes générales pour créer ce référentiel

• Utilisez Git pour obtenir un clone de ce dépôt :

 git clone --recurse-submodules

• Utilisez CMake pour créer la bibliothèque partagée native C++, consultez le projet CharLS pour savoir comment procéder. Lors de la création avec Visual Studio, cette étape peut être ignorée.
• Utilisez la CLI .NET 9.0 ou Visual Studio 2022 (v17.12 ou version ultérieure) pour créer le fichier de solution CharLSNativeDotNet.sln. Par exemple : dotnet build && dotnet test && dotnet publish pour créer le package nuget.

Création de DLL Windows et signature de code de tous les composants

La création du package NuGet avec des DLL Windows signées ne peut être effectuée que sur la plateforme Windows avec Visual Studio 2022 ou avec les outils de génération pour Visual Studio 2022. Pour prendre en charge la signature de code avec un certificat de signature de code, stocké sur une carte à puce, un fichier de commande Windows est disponible : create-signed-nuget-package.cmd . Instructions:

• Ouvrez une invite de commande de développeur Visual Studio
• Allez à la racine du dépôt cloné
• Assurez-vous que le certificat de signature de code est disponible
• Exécutez la commande create-signed-nuget-package.cmd certificate-thumb-print time-stamp-url
  Les arguments de l'empreinte numérique du certificat et de l'URL d'horodatage dépendent du certificat de signature de code utilisé.

Toutes les DLL et le package NuGet lui-même seront signés.

À propos de la norme de compression d'image JPEG-LS

Plus d'informations sur JPEG-LS peuvent être trouvées dans le README du projet C++ CharLS. Ce référentiel contient également des instructions sur la manière de créer la bibliothèque partagée native C++ CharLS à partir des sources.