charls native dotnet

CharLS.Native .NET

CharLS.Native .NET ist eine Adapterassembly, die Zugriff auf die native CharLS JPEG-LS C++-Implementierung für .NET-basierte Anwendungen bietet.
JPEG-LS (ISO-14495-1) ist ein verlustfreier/nahezu verlustfreier Komprimierungsstandard für Halbtonbilder.

Anmerkung: Mit dem CharLS .NET-Projekt wird eine reine C#-Implementierung bereitgestellt.

Merkmale

• Klassenbibliothek für .NET 9.0, .NET 8.0 und .NET Framework 4.8.
• Unterstützung für die .NET-Plattformen: Windows, Linux und macOS.
• Enthält vorgefertigte native CharLS-Windows-DLLs (x86, x64 und ARM64).

Wie zu verwenden

CharLS.Native kann Ihrem C#-Projekt über die Dotnet-Befehlszeile oder den NuGet-Paketmanager in Visual Studio hinzugefügt werden.

Installieren Sie über die Dotnet-Befehlszeile

dotnet add package CharLS.Native

Windows-spezifische Installationsschritte

Das NuGet-Paket enthält vorgefertigte CharLS-DLLs für die x86-, x64- und ARM64-Ziele. Auf dem Zielsystem muss Microsoft Visual C++ 2015-2022 Redistributable (v14.42 oder neuer) installiert sein.

Linux-spezifische Installationsschritte

Eine vorgefertigte gemeinsam genutzte CharLS-Bibliothek kann mit dem Apt-Paketmanager installiert werden:

sudo apt install libcharls2

MacOS-spezifische Installationsschritte

Eine vorgefertigte gemeinsam genutzte CharLS-Bibliothek kann mit dem Homebrew-Paketmanager installiert werden:

brew install team-charls/tap/charls

So verwenden Sie die C#-Klassen im NuGet-Paket

Im GitHub-Repository ist eine Beispielanwendung enthalten, die zeigt, wie gängige Bildtypen wie .bmp, .png und .jpg in .jls (JPEG-LS) konvertiert werden.

Allgemeine Schritte zum Erstellen dieses Repositorys

• Verwenden Sie Git, um einen Klon dieses Repositorys zu erhalten:

 git clone --recurse-submodules

• Verwenden Sie CMake, um die native gemeinsame C++-Bibliothek zu erstellen. Sehen Sie sich das CharLS-Projekt an, wie das geht. Beim Erstellen mit Visual Studio kann dieser Schritt übersprungen werden.
• Verwenden Sie die .NET 9.0-CLI oder Visual Studio 2022 (v17.12 oder neuer), um die Lösungsdatei CharLSNativeDotNet.sln zu erstellen. Beispiel: dotnet build && dotnet test && dotnet publish um das Nuget-Paket zu erstellen.

Erstellen von Windows-DLLs und Codesignatur aller Komponenten

Das Erstellen des NuGet-Pakets mit signierten Windows-DLLs kann nur auf der Windows-Plattform mit Visual Studio 2022 oder mit Build-Tools für Visual Studio 2022 erfolgen. Zur Unterstützung der Codesignierung mit einem Codesignaturzertifikat, das auf einer Smartcard gespeichert ist, ist eine Windows-Befehlsdatei vorhanden verfügbar: create-signed-nuget-package.cmd . Anweisungen:

• Öffnen Sie eine Visual Studio Developer-Eingabeaufforderung
• Gehen Sie zum Stammverzeichnis des geklonten Repositorys
• Stellen Sie sicher, dass das Codesignaturzertifikat verfügbar ist
• Führen Sie den Befehl create-signed-nuget-package.cmd certificate-thumb-print time-stamp-url
  Die URL-Argumente für den Fingerabdruck des Zertifikats und den Zeitstempel hängen vom verwendeten Codesignaturzertifikat ab.

Alle DLLs und das NuGet-Paket selbst werden signiert.

Informationen zum JPEG-LS-Bildkomprimierungsstandard

Weitere Informationen zu JPEG-LS finden Sie in der README-Datei des C++ CharLS-Projekts. Dieses Repository enthält auch Anweisungen zum Erstellen der nativen gemeinsam genutzten C++-CharLS-Bibliothek aus dem Quellcode.