
Harfinang®3d ist eine All-in-One-3D-Visualisierungsbibliothek, die in C ++, Python, Lua und Go verwendet werden kann.
Harfinang®3d ist eine einfach zu adaptierte, plattformübergreifende, mehrsprachige, leistungsstarke und optimierte Lösung für die Integration in eingebettete Systeme, in vorhandene Umgebungen und kombiniert Merkmale, um die industriellen Standards der Echtzeit-3D-Bildgebung zu erfüllen.
Die Harfinang®3D -Architektur erleichtert die Erfüllung der Anforderungen an Hardware -Integration, Anzeigeleistung und Sicherheit.
Harfinang®3d ist in C ++ geschrieben und basiert auf der Open-Source-BGFX-Bibliothek, die Vulkan, Metal, DirectX (von 9 bis 12), OpenGL und OpenGL ES unterstützt. Es baut auf Windows, Linux, Intel und Arm auf.
Plattformen unterstützt
Szenen -API
Rendering Pipeline
VR API
Physik -API
Audio -API
Sprachen unterstützt
Die folgenden Screenshots wurden auf einem 1080 gtx in 1080p erfasst, der bei 60 fps ausgeführt wurde.
(Sun Temple, mit freundlicher Genehmigung des Open Research Content Archive (ORCA)))
Sie können die Harfin -Binärdateien von der offiziellen Website herunterladen: https://dev.harfang3d.com/releases
Klonen Sie das Harfang 3D -Repository einschließlich seiner Submodules.
git clone --recursive -j8 https://github.com/harfang3d/harfang3d.git
cd harfang3d
Erstellen Sie das Build -Verzeichnis. Beachten Sie, dass das beschriebene Verzeichnislayout nicht obligatorisch ist.
mkdir build
cd build
Klon Fabgen.
git clone https://github.com/ejulien/FABGen.git
Download und installieren Sie Autodesk FBX SDK.
Erstellen Sie ein Verzeichnis, in dem das von CMAKE generierte Build -System enthält.
mkdir cmake
cd cmake
Generieren Sie das Build -System mit CMake. Zum Beispiel wird es unter Windows sein:
cmake ../.. -G "Visual Studio 16 2019" -A x64
-DCMAKE_INSTALL_PREFIX:PATH="D:/harfang/build/install"
-DPYTHON_EXECUTABLE:FILEPATH="C:/Python36/python.exe"
-DHG_FABGEN_PATH:PATH="D:/harfang/build/fabgen"
-DHG_FBX_SDK:PATH="D:/fbx_sdk"
CMAKE_INSTALL_PREFIX gibt das Verzeichnis an, in dem der Harfang -SDK installiert wird.PYTHON_EXECUTABLE ist der Pfad, der der Python 3 -Dolmetscher.FABGEN_PATH ist der Weg zum Fabgen -Bindungsgenerator.HG_FBX_SDK ist der Pfad zu Autodesk FBX SDK.
Hier ist die Liste der verfügbaren CMake -Optionen.
HG_BUILD_CPP_SDK : C ++ SDK erstellen (Standard: Aus ).HG_BUILD_TESTS : bauen c ++ SDK -Unit -Tests (Standard: Aus ).HG_BUILD_DOCS : API und C ++ SDK -Dokumentationen erstellen (Standard: Aus ).HG_ENABLE_BULLET3_SCENE_PHYSICS : Bullet Physics API aktivieren (Standard: Eins ).HG_ENABLE_RECAST_DETOUR_API : Aktivieren Sie das Navigationsnetz und die Pfadfindungs -API (Standardeinstellung: Eingeschaltet ).HG_ENABLE_OPENVR_API : OpenVR -API aktivieren (Standard: Aus ).HG_ENABLE_SRANIPAL_API : Aktivieren Sie die SDK (Sranipal) -API von Vive Eye und Gesichtsverfolgung (Standard: Aus ).HG_BUILD_ASSETC : Assetc Asset Compiler erstellen (Standard: Eins ).HG_BUILD_ASSIMP_CONVERTER : Erstellen Sie assIMP -basierte 3D -Modellkonverter (Standard: Eins ).HG_BUILD_FBX_CONVERTER : FBX Converter Build (Standard: Eins ).HG_BUILD_GLTF_IMPORTER : GLTF -Importeur erstellen (Standard: Eins ).HG_BUILD_GLTF_EXPORTER : GLTF -Exporteur erstellen (Standard: Eins ).HG_BUILD_HG_LUA : HARFANG LUA -Modul erstellen (Standard: Aus ).HG_BUILD_HG_PYTHON : HARFANG PYTHON MODUL (Rad) bauen (Standard: Aus ).HG_BUILD_HG_GO : Hartmodul erstellen (Standard: Aus ).Bauen Sie den SDK.
cmake --build . --config Release --target INSTALL
Hinweis: Unter Linux müssen Sie den Build -Typ mit -DCMAKE_BUILD_TYPE=Release explizit angeben
Abhängig von der an CMAKE übergebenen Option enthält das Installationsverzeichnis die folgenden Unterverzeichnisse:
cppsdk : Harfinang C ++ SDK.hg_python : HARFang -Python -Modul.hg_lua : HARFANG LUA -Modul.hg_go : Harfinang Go -Modul.assetc : Asset Compiler.assimp_converter : ANSIMP 3D -Modellkonverter.fbx_converter : FBX Converter.gltf_importer : GLTF -Importeur.gltf_exporter : GLTF -Exporteur.Installieren Sie die CMaketools -Erweiterung.
Kopieren Sie die Datei harfang/.vscode/template_settings.json in harfang/.vscode/settings.json und bearbeiten Sie sie, um Ihre lokale Installation widerzuspiegeln.
Öffnen Sie den harfang -Ordner im Visual Studio -Code. Cmaketools sollten das Projekt erfolgreich konfigurieren.
Das cppsdk -Verzeichnis von Harfinang C ++ SDK enthält Folgendes:
bin : Abhängig von der verwendeten Konfiguration enthält dieses Verzeichnis entweder ein Release oder Debug -Unterverzeichnis mit allen gemeinsamen Bibliotheken.lib : Wie das bin -Verzeichnis enthält es eine Unterverzeichnis, die nach der Konfiguration während des Builds ( Release oder Debug ) mit allen generierten statischen Bibliotheken benannt ist.include : Enthält alle C ++ -Dateien der Hartharfang -API.cmake : Enthält die CMAKE -Konfigurationsdateien. So fügen Sie Ihrem CMake -Projekt den Hart -C ++ - SDK hinzu, fügen Sie einfach Folgendes der CMakeLists.txt -Datei hinzu:
find_package (harfang REQUIRED
COMPONENTS cppsdk
PATHS ${HG_CPPSDK_PATH}
NO_DEFAULT_PATH
) Mit HG_CPPSDK_PATH den Pfad zum cppsdk -Verzeichnis. Wenn wir beispielsweise das oben angegebene Verzeichnislayout befolgen, wird es D:/harfang/build/install/cppsdk sein.
Ziele sollten mit den folgenden Bibliotheken verknüpft werden.
hg::enginehg::foundationhg::platformhg::libluadll Die Funktion install_cppsdk_dependencies installiert die Abhängigkeiten von Hartharfang C ++ SDK Shared Libraries.
install_cppsdk_dependencies( destination component )destination : Ist die Bibliothek, in der die freigegebenen Bibliotheken installiert werden.component : Installationskomponentenname.Harfinang folgt der Semantic Versioning Specification (SEMVER) (http://semver.org).
Bei einer Versionsnummer major.minor.patch erhöhen Sie:::
Harfinang ist unter der GPLV3, LGPLV3 und einer kommerziellen Lizenz lizenziert:
https://www.harfang3d.com/license
Indem Sie Ihren Kodex für Harboang beigetragen haben, gewähren Sie der Harfang3d-Organisation eine nicht exklusive, unwiderrufliche, weltweite, lizenzfreie, sublizenzielle, übertragbare Lizenz im Rahmen aller relevanten Rechte an geistigem Eigentum (einschließlich des Urheberrechts, Patents und anderer Rechte), kopieren Sie die Limit. MIT -Lizenz; und (b) binäre, proprietäre oder kommerzielle Lizenzen. Mit Ausnahme der hier gewährten Lizenzen reservieren Sie alles Recht, Titel und Interesse an und dem Beitrag.
Sie bestätigen, dass Sie uns diese Rechte gewähren können. Sie stellen fest, dass Sie rechtlich berechtigt sind, die oben genannte Lizenz zu gewähren. Wenn Ihr Arbeitgeber Rechte an geistigem Eigentum hat, die Sie erstellen, geben Sie an, dass Sie die Erlaubnis erhalten haben, die Beiträge im Namen dieses Arbeitgebers zu leisten, oder dass Ihr Arbeitgeber auf solche Rechte für die Beiträge verzichtet hat.
Sie stellen fest, dass die Beiträge Ihre ursprünglichen Urheberwerke sind, und nach Ihrem Wissen keine anderen Person, die Ansprüche oder das Recht haben, ein Recht in einer Erfindung oder einem Patent im Zusammenhang mit den Beiträgen zu beanspruchen. Sie geben auch darauf hin, dass Sie nicht rechtlich verpflichtet sind, sei es durch Abschluss einer Vereinbarung oder auf andere Weise, in irgendeiner Weise, die mit den Bedingungen dieser Lizenz in Konflikt steht.
Die Organisation von Harfinang3d erkennt an, dass, außer wie in dieser Vereinbarung explizit beschrieben, jeder Beitrag, den Sie zur Verfügung stellen, auf "As is" -Basis, ohne Garantien oder Bedingungen jeglicher Art, entweder ausdrücklich oder impliziert, einschließlich, ohne Einschränkung, Gewährleistungen oder Eigentumsbedingungen, Nichtverbörer, Handelsfähigkeit oder Eignung für einen bestimmten Zweck.
Es gibt zahlreiche Möglichkeiten, Harboang zu helfen, seine Gemeinschaft zu erweitern:
(Der Nvidia USD -Dachboden mit dem Harfin 3D AAA Renderer)
(Sun Temple, mit freundlicher Genehmigung des Open Research Content Archive (ORCA)))
(Bistro, mit freundlicher Genehmigung des Open Research Content Archive (ORCA)))
(Sponza Atrium gltf, mit freundlicher Genehmigung von Crytek/Themaister)
(Marine Melodies, durch Widerstand Norwegen)