
Harfang®3D adalah perpustakaan visualisasi 3D all-in-one yang dapat digunakan dalam C ++, Python, Lua dan Go.
Harfang®3D adalah solusi yang mudah diawetkan, lintas platform, multi-bahasa, kuat dan dioptimalkan untuk berintegrasi dengan sistem tertanam, ke dalam lingkungan yang ada dan menggabungkan fitur untuk memenuhi standar industri pencitraan 3D waktu nyata.
Arsitektur Harfang®3D memudahkan untuk memenuhi persyaratan untuk integrasi perangkat keras, kinerja tampilan dan keamanan.
Harfang®3D ditulis dalam C ++ dan didasarkan pada pustaka BGFX open-source yang mendukung Vulkan, Metal, DirectX (dari 9 hingga 12), OpenGL dan OpenGL ES. Ini dibangun di atas jendela, Linux, Intel dan lengan.
Platform didukung
API Adegan
Rendering Pipeline
VR API
API Fisika
Audio API
Bahasa didukung
Tangkapan layar berikut ditangkap pada 1080GTX dalam 1080p berjalan pada 60fps.
(Sun Temple, milik Open Research Content Archive (ORCA))
Anda dapat mengunduh harfang binari dari situs web resmi: https://dev.harfang3d.com/releases
Kloning repositori Harfang 3D termasuk submodulesnya.
git clone --recursive -j8 https://github.com/harfang3d/harfang3d.git
cd harfang3d
Buat Direktori Bangun. Perhatikan bahwa tata letak direktori yang dijelaskan tidak wajib.
mkdir build
cd build
Klon Fabgen.
git clone https://github.com/ejulien/FABGen.git
Unduh dan instal Autodesk FBX SDK.
Buat direktori yang akan menahan sistem build yang dihasilkan oleh CMake.
mkdir cmake
cd cmake
Menghasilkan sistem build menggunakan cmake. Misalnya, pada windows itu akan:
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 Menentukan direktori tempat Harfang SDK akan diinstal.PYTHON_EXECUTABLE adalah jalur penafsir Python 3.FABGEN_PATH adalah jalur menuju generator pengikat Fabgen.HG_FBX_SDK adalah jalur ke Autodesk FBX SDK.
Berikut adalah daftar opsi CMake yang tersedia.
HG_BUILD_CPP_SDK : Bangun C ++ SDK (default: OFF ).HG_BUILD_TESTS : Bangun uji unit C ++ SDK (default: OFF ).HG_BUILD_DOCS : Bangun API dan C ++ SDK Dokumentasi (default: OFF ).HG_ENABLE_BULLET3_SCENE_PHYSICS : Aktifkan API Fisika Bullet (default: on ).HG_ENABLE_RECAST_DETOUR_API : Aktifkan recast/detour navigation mesh dan jalur menemukan API (default: on ).HG_ENABLE_OPENVR_API : Aktifkan OpenVR API (default: OFF ).HG_ENABLE_SRANIPAL_API : Aktifkan Vive Eye and Facial Tracking SDK (Sranipal) API (default: OFF ).HG_BUILD_ASSETC : Bangun Kompiler Asset Assetc (Default: ON ).HG_BUILD_ASSIMP_CONVERTER : Bangun konverter model 3D berbasis assimp (default: on ).HG_BUILD_FBX_CONVERTER : Bangun FBX Converter (default: on ).HG_BUILD_GLTF_IMPORTER : Bangun Importir GLTF (default: on ).HG_BUILD_GLTF_EXPORTER : Bangun eksportir GLTF (default: on ).HG_BUILD_HG_LUA : Bangun modul Harfang Lua (default: off ).HG_BUILD_HG_PYTHON : Bangun modul Harfang Python (roda) (default: off ).HG_BUILD_HG_GO : Bangun modul Harfang Go (default: off ).Bangun SDK.
cmake --build . --config Release --target INSTALL
Catatan: Di Linux Anda perlu secara eksplisit menentukan jenis build dengan -DCMAKE_BUILD_TYPE=Release
Tergantung pada set opsi yang diteruskan ke CMake, direktori instal akan berisi subdirektori berikut:
cppsdk : Harfang C ++ SDK.hg_python : Modul Harfang Python.hg_lua : Modul Harfang Lua.hg_go : Modul Harfang Go.assetc : Kompiler Aset.assimp_converter : AssIMP 3D Model Converter.fbx_converter : FBX Converter.gltf_importer : Importir GLTF.gltf_exporter : Eksportir GLTF.Pasang ekstensi cmaketools.
Salin file harfang/.vscode/template_settings.json ke harfang/.vscode/settings.json dan edit untuk mencerminkan instalasi lokal Anda.
Buka folder harfang dalam kode studio visual. CMaketools harus berhasil mengkonfigurasi proyek.
Direktori Harfang C ++ SDK cppsdk berisi yang berikut:
bin : Bergantung pada konfigurasi yang digunakan, direktori ini berisi Release atau Debug subdirektori dengan semua perpustakaan bersama.lib : Seperti direktori bin , berisi subdirektori yang dinamai setelah konfigurasi yang digunakan selama build ( Release atau Debug ) dengan semua perpustakaan statis yang dihasilkan.include : Berisi semua C ++ termasuk file Harfang Public API.cmake : Berisi file konfigurasi CMake. Untuk menambahkan Harfang C ++ SDK ke proyek CMake Anda, cukup tambahkan yang berikut ini ke file CMakeLists.txt :
find_package (harfang REQUIRED
COMPONENTS cppsdk
PATHS ${HG_CPPSDK_PATH}
NO_DEFAULT_PATH
) dengan HG_CPPSDK_PATH jalur ke direktori cppsdk . Misalnya, jika kita mengikuti tata letak direktori yang diberikan di atas, itu akan menjadi D:/harfang/build/install/cppsdk .
Target harus menautkan terhadap perpustakaan berikut.
hg::enginehg::foundationhg::platformhg::libluadll Fungsi install_cppsdk_dependencies menginstal dependensi perpustakaan bersama Harfang C ++ SDK.
install_cppsdk_dependencies( destination component )destination : adalah perpustakaan tempat perpustakaan bersama akan diinstal.component : Nama Komponen Instalasi.Harfang mengikuti spesifikasi versi semantik (SEMVER) (http://semver.org).
Diberikan nomor versi Major.minor.patch, tambah:
Harfang dilisensikan di bawah GPLV3, LGPLV3 dan lisensi komersial:
https://www.harfang3d.com/license
By contributing your code to HARFANG you grant the HARFANG3D organization a non-exclusive, irrevocable, worldwide, royalty-free, sublicenseable, transferable license under all of Your relevant intellectual property rights (including copyright, patent, and any other rights), to use, copy, prepare derivative works of, distribute and publicly perform and display the Contributions on any licensing terms, including without limitation: (a) open source licenses like the Lisensi MIT; dan (b) lisensi biner, hak milik, atau komersial. Kecuali untuk lisensi yang diberikan di sini, Anda memesan semua hak, kepemilikan, dan minat dalam dan untuk kontribusi.
Anda mengonfirmasi bahwa Anda dapat memberi kami hak -hak ini. Anda menyatakan bahwa Anda berhak secara hukum untuk memberikan lisensi di atas. Jika majikan Anda memiliki hak atas kekayaan intelektual yang Anda buat, Anda menyatakan bahwa Anda telah menerima izin untuk memberikan kontribusi atas nama majikan itu, atau bahwa majikan Anda telah mengesampingkan hak tersebut atas kontribusi tersebut.
Anda menyatakan bahwa kontribusi adalah karya kepenulisan asli Anda, dan sepengetahuan Anda, tidak ada orang lain yang mengklaim, atau memiliki hak untuk mengklaim, hak apa pun dalam penemuan atau paten apa pun yang terkait dengan kontribusi. Anda juga menyatakan bahwa Anda tidak diwajibkan secara hukum, baik dengan menandatangani perjanjian atau sebaliknya, dengan cara apa pun yang bertentangan dengan ketentuan lisensi ini.
Organisasi Harfang3D mengakui bahwa, kecuali secara eksplisit dijelaskan dalam Perjanjian ini, kontribusi apa pun yang Anda berikan adalah atas dasar "sebagaimana adanya", tanpa jaminan atau ketentuan dalam bentuk apa pun, baik tersurat maupun tersirat, termasuk, tanpa batasan, setiap jaminan atau ketentuan hak, non-pelanggaran, dapat diperdagangkan, atau kebugaran untuk tujuan tertentu.
Ada banyak cara untuk membantu Harfang menumbuhkan komunitasnya:
(The Nvidia USD Attic Menggunakan Harfang 3D AAA Renderer)
(Sun Temple, milik Open Research Content Archive (ORCA))
(Bistro, milik Open Research Content Archive (ORCA))
(Sponza atrium GLTF, milik Crytek/Themaister)
(Melodi laut, dengan resistensi Norwegia)