xarray/osgverse

Última actividad de origen registrada: 14 de agosto de 2026 a las 09:24

Catálogo de SkillsMP actualizado: 29 de octubre de 2026 a las 18:30

skills recopiladas: 2

Estrellas en GitHub: 462
Forks en GitHub: 77

Instalar con un asistente de IA

Copia este prompt en el asistente de IA que estés usando.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/xarray/osgverse.

README del repositorio

Archivo de origen del README: README.md

Leer el README original

Mostrar README completo

![Image](https://gitee.com/xarray/osgverse/raw/master/assets/misc/logo.jpg) # osgVerse #### Introduction osgVerse, a complete 3D engine solution based on OpenSceneGraph. | Operating System | Compiler | Supported | Notes | |------------------|------------------------------|--------------------|-------| | Windows 10-11 | Visual Studio 2017-2026 | :heavy_check_mark: | | | Windows 7-11 | Visual Studio 2015 | :heavy_check_mark: | Requires VS2015 SP3 | | Windows 10-11 | MSYS2 (GCC 10.2) | :heavy_check_mark: | | | Windows 10-11 | Intel Compiler 2023 | :heavy_check_mark: | cmake -DCMAKE_C_COMPILER=icx -DCMAKE_CXX_COMPILER=icx -GNinja .. | | Windows 10 UWP | Visual Studio 2017-2022 | :heavy_check_mark: | (TODO) Need to compile an example app | | Ubuntu 18-26 | GCC 7.5 (or later) | :heavy_check_mark: | | | Debian 11.7.0 | GCC 10.2 (or later) | :heavy_check_mark: | | | Kylin v10-11 | GCC 8.3 (or later) | :heavy_check_mark: | If GL not found, set VERSE_FIND_LEGACY_OPENGL to ON | | NeoKylin v7 | GCC 8.5 (built manually) | :heavy_check_mark: | Must disable VERSE_USE_GLIBCXX11_ABI | | UOS v20 | GCC 8.3 (or later) | :heavy_check_mark: | | | Mac OS X >14.4 | XCode | :heavy_check_mark: | Use Googla Angle to switch to Metal | | Android | Android SDK 32 & NDK 27d | :heavy_check_mark: | (TODO) Need to compile an example app | | OpenHarmony | HarmonyCmd-26.0 (or later) | :heavy_check_mark: | (TODO) Need to compile an example app | | IOS | | :soon: | | | WebAssmebly | Emscripten 3.1.64 (or later) | :heavy_check_mark: | Supports GLES2 (WebGL1) and GLES3 (WebGL2) | #### Main Features (ongoing to v1.0) - [x] Supports from OSG 3.1.1 to the latest version, and GLSL 1.2 to 4.6, so to work with most hardware in the world. - [x] Supports PBR-based rendering and deferred pipeline, with real-time shadowing and deferred lighting. - [x] Supports physics simuation based on Box3D/Bullet3 library, and character animation based on OZZ library. - [x] Supports complex model simplication, optimizing and tiling, and saving to OSGB format for better efficiency. - [x] Provides database plugins (leveldb, mbtiles, odbc), for reading models and tiles from database rather than local folders. - [x] Provides media streaming plugin, which supports playing RTSP and streaming through WebRTC / Websockets. - [x] Provides video decoding plugins based on GPU (with NVCUVID or LibVA), without CPU copying overload. - [x] Provides scripting functionalities to support Python/JsonRPC scripting using OSGB serialization. - [x] Supports GL3 Core profile, GLES2 and GLES3. Google Angle is also supported for bridging low-level APIs like Vulkan and DirectX. - [x] Supports 3D Gaussian Splatting rendering and related formats: PLY, SPZ, SPLAT, PlayCanvas SOG and XGrids LCC. - [x] Supports dependency-free earth scene construction and high quality terrain/atmosphere/ocean rendering. (without osgEarth) - [ ] (PARTLY) Supports major desktop and mobile operating systems, including Windows, Linux, Mac OSX, Android, Harmony and IOS. - [x] Supports major embedded devices with GPU supports, including ARM and RISC-V. - [x] Supports Emscripten / WASM compilation and works with WebGL 1/2 based browsers. - [ ] Provides an initial visual scene editing tool, comparing with the famous Unity Editor. #### Screenshots * osgVerse_Viewer: PBR and deferred pipeline with Desktop GL ![Image](https://gitee.com/xarray/osgverse/raw/master/assets/misc/sponza.jpg) * osgVerse_ViewerWASM: PBR and deferred pipeline with WebGL 1.0/2.0, compiled from WASM ![Image](https://gitee.com/xarray/osgverse/raw/master/assets/misc/sponza_wasm.jpg) * osgVerse_JsCallerWASM: Scriptable osgb rendering with WebGL 1.0/2.0, compiled from WASM ![Image](https://gitee.com/xarray/osgverse/raw/master/assets/misc/osgb_wasm.jpg) * osgVerse_Test_3DGS: 3D Gaussian Splatting rendering (data from XGrids offical website) ![Image](https://gitee.com/xarray/osgverse/raw/master/assets/misc/3dgs_rendering.jpg) * osgVerse_Test_Earth: Earth rendering with DEM/DOM tiles, atmosphere and ocean supports ![Image](https://gitee.com/xarray/osgverse/raw/master/assets/misc/earth_rendering.jpg) * osgVerse_Test_Physics_Human: Human skeleton with physics and ragdoll supports ![Image](https://gitee.com/xarray/osgverse/raw/master/assets/misc/ragdoll_physics.jpg) * osgVerse_Test_Nanite: NANITE clustering and dynamic ‌scheduling demonstration ![Image](https://gitee.com/xarray/osgverse/raw/master/assets/misc/nanite_algorithm.jpg) #### User Gallery * Digital-twin city rendering by Pizza Team (Smart Yunzhou) ![Image](https://gitee.com/xarray/osgverse/raw/master/assets/misc/syz_city.jpg) * Vibe coding earth by Frank Lee (Mthreads Academy) ![Image](https://gitee.com/xarray/osgverse/raw/master/assets/misc/vibe_earth.jpg) #### Dependencies 1. Please use CMake 3.0 or higher version. (https://cmake.org/download/) 2. Please use a C++ compiler supporting C++ 14 at least. 3. OpenSceneGraph is always required for building osgVerse. (https://github.com/openscenegraph/OpenSceneGraph) Current project mainly depends on OSG 3.7.0, but can compile on OSG 3.1.1 or later versions. 4. Important (but optional) dependencies: - 4.1 SDL2 (https://github.com/libsdl-org/SDL): for windowing system supports on Android, IOS and WebAssembly builds. - 4.2 Google Angle (https://github.com/google/angle): for cross-Graphics API uses and Vulkan integrations. - 4.3 Emscripten SDK (https://emscripten.org/docs/getting_started/downloads.html): for WebAssembly builds. - 4.4 NVIDIA CUDA (https://developer.nvidia.com/cuda-downloads): for CUDA related functionalities. - With MooreThreads devices and VERSE_USE_MTT_DRIVER=ON, CUDA can be replaced with MUSA without extra operations. 5. Optional external dependencies: - 5.1 osgEarth 2.10.1 or later, for earth related applications and examples. (https://github.com/gwaldron/osgearth) - 5.2 Bullet 3.17 or later, for optional physics plugin verse_bullet. (https://github.com/bulletphysics/bullet3). Remember to enable INSTALL_LIBS (for correct installation) and USE_MSVC_RUNTIME_LIBRARY_DLL (for /MD flag) while compiling Bullet. - 5.3 Entwine 2.0 or later, for EPT point cloud octree constructing. (https://github.com/connormanning/entwine) - 5.4 Qt 5.5 or later, for Qt related applications and examples. (https://www.qt.io/licensing/open-source-lgpl-obligations) - 5.5 ZLMediaKit (git version), for media streaming plugin. (https://github.com/ZLMediaKit/ZLMediaKit) Remember to uncheck the ENABLE_MSVC_MT option while compiling. To support WebRTC-based cloud rendering, you may have to also enable WebRTC with SRTP and UsrSCTP supports. - 5.6 OpenVDB 10.0 or later, for VDB point cloud and 3D image reader/writer plugin. (https://github.com/AcademySoftwareFoundation/openvdb) - 5.7 libDraco 1.5 or later, for Draco mesh compression support in osgVerseReaderWriter library. (https://github.com/google/draco) - 5.8 libIGL 2.5 or later, for Quadriflow, ManifoldPlus and other functionalities in osgModeling library. (https://github.com/libigl/libigl) - 5.9 cinolib 1.0 or later, for Mesh Boolean and other functionalities in osgModeling library. (https://github.com/mlivesu/cinolib) - 5.10 Vulkan 1.3 or later, for Vulkan extensions based on Google Angle's cross-Graphics API. (https://vulkan.lunarg.com/sdk/home) - 5.11 Effekseer 1.70 or later, for particle support in osgVerseAnimation module and related examples. Remember to check the USE_MSVC_RUNTIME_LIBRARY_DLL option while compiling. (https://github.com/effekseer/Effekseer) - 5.12 libCEF 127.3 or later, for HTML5/CSS page rendering support in osgVerseAnimation module and related examples. (Binaries download: https://cef-builds.spotifycdn.com/index.html) - 5.13 mimalloc 2.17 or later, for general purpose memory allocator with excellent performance. (https://github.com/microsoft/mimalloc) - 5.14 NVIDIA Video Codec SDK 12 or later, for video decoding/encoding based on codec_nv plugin. (https://developer.nvidia.com/video-codec-sdk) - Linux & EGL developers can use libVA (apt install libva-dev) and libGBM (apt install libgbm-dev) to implement the codec_va plugin. - 5.15 The netCDF-C 4.9.3 or later, for NetCDF/HDF data reading plugin. (https://github.com/Unidata/netcdf-c) - 5.16 FFmpeg 6.0 or later, for video parsing and CPU based decoding/encoding. (https://github.com/FFmpeg/FFmpeg) - 5.17 GGML 0.13 or later, for AI/LLM based functionalities like human body reconstruction. (https://github.com/ggml-org/ggml) #### Supported Hardware To use osgVerse libraries and applications, OpenGL version must be higher than 2.0. Both core profile and compatible profile will work. Our project uses the GLSL functionality, and supports from GLSL 120 to the latest GLSL version. Our project is already tested on graphics cards listed as below: | Graphics Card | OpenGL Version | Supported | VerseViewer | Notes | |---------------------------|----------------|--------------------|-------------|-------| | NVIDIA RTX Series | 4.6 / GLSL 4.6 | :heavy_check_mark: | 60fps | | | NVIDIA 10** Series | 4.6 / GLSL 4.6 | :heavy_check_mark: | 60fps | | | NVIDIA 1070 (Nouveau) | 4.3 / GLSL 4.3 | :zap: | 60fps | Display has broken problems with Nouveau driver | | NVIDIA GT720 | 4.6 / GLSL 4.6 | :heavy_check_mark: | < 12fps | | | NVIDIA Quadro K2200 | 4.6 / GLSL 4.6 | :heavy_check_mark: | 60fps | | | AMD Radeon RX5500 | 4.6 / GLSL 4.6 | :heavy_check_mark: | 60fps | | | AMD Radeon (TM) Graphics | 4.6 / GLSL 4.6 | :heavy_check_mark: | < 15fps | | | Intel UHD Graphics | 4.6 / GLSL 4.6 | :heavy_check_mark: | ~= 30fps | | | MooreThreads X300 | 4.3 / GLSL 4.3 | :heavy_check_mark: | 60fps | Need VERSE_USE_MTT_DRIVER (automatically enabled with MUSA) | | MooreThreads S80/S1000 | 4.1 / GLSL 4.1 | :heavy_check_mark: | ~= 30fps | Need VERSE_USE_MTT_DRIVER (automatically enabled with MUSA) | | LISUAN 7G100 | 4.6 / GLSL 4.6 | :heavy_check_mark: | ~= 45fps | | | XiangDiXian FUXI R2900E | 4.6 / GLSL 4.6 | :heavy_plus_sign: | 60fps | PCF Shadow failed (VSM/ESM OK) | | Phytium D3000M (FTG340) | GLES 3.2 | :heavy_plus_sign: | < 10fps | GLES only; PCF Shadow failed (VSM/ESM OK) | | Phytium D2000+X100 | 3.0 / GLSL 3.3 | :heavy_plus_sign: | < 10fps | | | JingJia Micro JM7201 | 3.0 / GLSL 1.3 | :heavy_plus_sign: | < 5fps | Core only; PCF Shadow failed (VSM/ESM OK); glBlitFrameBuffer failed | | LJmicro GP201/202 | 4.0 / GLSL 4.0 | :heavy_plus_sign: | < 10fps | glBlitFrameBuffer failed | | Zhaoxin C-960 (SIS) | 3.2 / GLSL 1.5 | :zap: | | Segment fault in osg::Texture at present | | VirtualBox SVGA 3D | 4.1 / GLSL 4.1 | :heavy_check_mark: | 60fps | | | VirtualBox (Only Mesa) | 4.5 / GLSL 4.5 | :heavy_plus_sign: | < 5fps | glBlitFrameBuffer failed | #### Modules 1. osgVerseDependency: contains all embedded 3rdparty dependencies. 2. osgVersePipeline: modern rendering pipeline supporting PBR materials, realtime shadows, deferred lighting and effects. 3. osgVerseReaderWriter: full featured reader-writer support for FBX, GLTF and KTX formats, and for more later. 4. osgVerseAnimation: tween-based path animation, physics simulation, particle animation and character animation supports. 5. osgVerseModeling: model simplification pipeline, modeling operators, and computational geometry utilities 6. osgVerseUI: IMGUI based quick UI support, HTML based UI solution, and related utilities. 7. osgVerseScript: Scripting support based on OSG serialization functionalities. Currently Python and JsonRPC. 8. osgVerseAI: Artificial-Intelligence related classes, including navigation-mesh, AI models (onnx) loading and so on. 9. osgVerseWrappers: All serialzier wrappers of osgVerse and extended OSG classes. 10. TBD... ##### Module dependency chain | Name | Depended Module | Optional External Dependency | |--------------|-------------------------------------------|------------------------------| | Modeling | Dependency | libIGL, cinolib | | Pipeline | Dependency, Modeling | CUDA | | Script | Dependency, Pipeline | | | AI | Dependency, Modeling | | | Animation | Dependency, Pipeline, Modeling | Effekseer | | UI | Dependency, Modeling, Script | libCEF | | ReaderWriter | Dependency, Animation, Modeling, Pipeline | libDraco, SDL | | Wrappers | ALL | | #### Applications 1. osgVerse_SceneEditor: a forward-looking scene editor for osgVerse scene & components. 2. osgVerse_Viewer: a single-camera viewer with modern rendering pipeline support. 3. osgVerse_ViewerComposite: a multi-camera (multi-view) viewer with modern rendering pipeline support. 4. osgVerse_ViewerGLES: an example demostrating how to integrate osgVerse with SDL2, mainly with GLES2/3. 5. osgVerse_EarthViewer: an example demostrating how to integrate osgVerse with osgEarth. 6. osgVerse_QtViewer: an example demostrating how to integrate osgVerse with Qt. 7. osgVerse_ViewerWASM (wasm/pbr_demo): an example of WASM, with modern rendering pipeline support. 8. osgVerse_JsCallerWASM (wasm/script_demo): an example of WASM, demostrating how to use OSGB scripts with JS. 9. TBD... #### Examples and Tests 1. osgVerse_Test_Plugins: a quick utility to show dependencies of a plugin library. (TBD: show depended and missing dlls) 2. osgVerse_Test_Pipeline: an example program for simple cases and compatiblity tests of osgVerse pipeline. 3. osgVerse_Test_Report_Graph: a quick utility to show scene graph information in details. 4. osgVerse_Test_Shader_Library: an example to make use of the shader library with OSG programs. 5. osgVerse_Test_Shadow: an example for shadow algorithm debugging and optimizing. 6. osgVerse_Test_Forward_Pbr: an example demostrating PBR rendering in single forwarded pass. 7. osgVerse_Test_ImGui: an example demostrating the use of IMGUI in osg scene. (TBD: multi-view IMGUI usage) 8. osgVerse_Test_Media_Stream: an example for media streaming / pixel streaming, including server and pusher implementation. (TBD: switch puller/player) 9. osgVerse_Test_Pbr_Prerequisite: a quick utility to pre-compute global PBR textures and save them to IBL osgb files. 10. osgVerse_Test_Paging_Lod: a quick utility for paged LOD file combination, optimization and transferring to levelDB. 11. osgVerse_Test_Point_Cloud: an example for point cloud viewing and manipulating. (TBD: eye-dome rendering) 12. osgVerse_Test_Player_Animation: an example of character animation loading and playing. (TBD: simple UI) 13. osgVerse_Test_Symbols: an example for drawing with Blend2D and displaying massive symbols with icons and texts. 14. osgVerse_Test_Tween_Animation: an example for tween animations, like path and data-driven animations. (TBD: time-out events) 15. osgVerse_Test_Polygon2D: an eample of 2D polygon operations. (TBD: labeling, spline usage, loading MVT) 16. osgVerse_Test_Mesh_Process: an example of 3D mesh operations. (TBD: labeling, topology, NURBS, common shapes) 17. osgVerse_Test_Navigation: an example of navmesh based navigation. (TBD: simple UI) 18. osgVerse_Test_Physics_Basic: a physics world example supporting rigid bodies & kinematics, can switch between default Box3D and Bullet3. 19. osgVerse_Test_Particle_U3D: a Unity-like particle system example. (TBD: better fire/explosion example) 20. osgVerse_Test_Particle_Effekseer: another particle system example with Effekseer. (TBD: Effekseer scripting) 21. osgVerse_Test_Scripting: an example for scripting implementation based on OSGB serialization format. 22. osgVerse_Test_Video: an example for video demuxing, decoding and playing with multiple plugins. ##### Tests for specified goals 1. osgVerse_Test_Compressing: a test for KTX texture compression (DXT / ETC) and Draco geometry compressing. 2. osgVerse_Test_Thread: a test for using the Marl thread task scheduler along with osgViewer. 3. osgVerse_Test_Volume_Rendering: a test for different methods to implement volume rendering. 4. osgVerse_Test_Instance_Param: a test of comparing texture LUT and vertex-attrib divisor usages. 5. osgVerse_Test_Auto_LOD: a test of GeometryMerger usage: combination / indirect / octree. 6. osgVerse_Test_Sky_Box: a test of changable skybox and atmospheric scattering. 7. osgVerse_Test_Restful_Server: a test for restful HTTP API, which is based on libhv. 8. Deprecated tests: - osgVerse_Test_FastRtt: a quick test for using newly-introduced RTT draw callback. - osgVerse_Test_Obb_KDop: a quick test for creating a model's obb/kdop bounding volume. - osgVerse_Test_CubeRtt: a quick test for render-to-cubemap (6 faces) demonstaration. - osgVerse_Test_Mesh_Boolean: a quick test of mesh cutting with self-defined method. - osgVerse_Test_Auto_Imposter: a quick test to change models to crossed billboards - osgVerse_Test_Texture_Mapping: a test for GLSL texture tri-mapping implementation. - osgVerse_Test_Indirect_Draw: a demo program to demonstrate how to use indirect drawing of OpenGL 4.x. - osgVerse_Test_Tesselation: a demo program to demonstrate how to use tessellation shaders of OpenGL 4.x. - osgVerse_Test_MultiView_Shader: a test for using geometry shader to implement multi-view rendering. #### OSG-style Plugins 1. Mesh and mesh tiles: - osgdb_verse_fbx: a plugin with full-featured FBX format support. - osgdb_verse_gltf: a plugin with full-featured GLTF & GLB format support, also with .b3dm, .i3dm and .pnts. - osgdb_verse_mesh: a plugin for reading/writing common mesh formats like OBJ, PLY, STL and OFF. - osgdb_verse_terrain: a plugin for reading Cesium terrain format (quantized-mesh format). - osgdb_verse_tiles: a plugin for reading Cesium 3dtiles (tileset.json) and Osgb files (metadata.xml, or just the root folder). - osgdb_verse_tms: a plugin to read tiles from TMS geographic server and render them with paging LOD support. 2. Point cloud and 3D gaussian splatting: - osgdb_verse_3dgs: a plugin to read/writ 3D Gaussian Splatting data (.ply, .splat, .ksplat, .spz, .sog, .lcc and .lcc2). - osgdb_verse_ept: a plugin for massive point cloud based on Entwine and page them for rendering. - osgdb_verse_potree: a plugin for massive point cloud based on Potree and page them for rendering. - osgdb_verse_vdb: a plugin to read OpenVDB point volume and rendering it to point cloud or 3D image. 3. Vectors and features: - osgdb_verse_geojson: a plugin to read Mapbox GeoJSON (.json) geometry data. - osgdb_verse_mlt: a plugin to read MapLibre Tiles (.mlt) geometry data. - osgdb_verse_mvt: a plugin to read Mapbox Vector Tiles (.mvt / .pbf) geometry data. - osgdb_verse_osm: a plugin to read OpenStreetMap (.osm) geometry data. - osgdb_verse_shp: a plugin to read ESRI shapefiles (.shp) geometry data. 4. Images and videos: - osgdb_verse_image: a plugin for reading/writing common image formats like JPEG and PNG. It mainly works for WASM case. - osgdb_verse_ktx: a plugin for reading/writing KTX/BasisU image formats. It can work as a GLTF/3dtiles extension. - osgdb_verse_netcdf: a plugin to read NetCDF and HDF5 files and try parsing image data from them. - osgdb_verse_tiff: a plugin for TIFF and 3D TIFF image (experimental) reading. - osgdb_verse_webp: a plugin for reading/writing WEBP formats. It can work as a GLTF/3dtiles extension. - osgdb_verse_ffmpeg: a plugin for video decoding/encoding with FFmpeg (enhanced with demuxer support). - osgdb_verse_ms: a plugin for reading/writing from media streaming protocols like RTSP/RTMP/WebRTC (enhanced with demuxer support). - osgdb_verse_video: a plugin for demuxing common video formats and working with decoders to play them. 5. Video decoder and endcoder: - osgdb_codec_nv: a plugin for CUDA based video decoding/encoding support and connecting with demuxers/muxers and players. - osgdb_codec_va: a plugin for libVA / libGBM based video decoding support and connecting with demuxers and players. 6. Vision devices: - osgdb_device_inu: a plugin to implement interfaces of VisionDevice with InuDev RGBD cameras and sensors. - osgdb_device_webcam: a plugin to implement interfaces of VisionDevice with common webcams. (Windows / Linux) 7. Database supports: - osgdb_verse_leveldb: a plugin for reading/writing from LevelDB database. - osgdb_verse_mbtiles: a plugin for reading/writing from Sqlite database using MBTiles specification. - osgdb_verse_odbc: a plugin for reading/writing from ODBC database (e.g., mysql) and Sqlite. 8. Physics low-level engines: - osgdb_verse_bullet: a plugin to implement interfaces of PhysicsEngine with Bullet3. 9. Others: - osgdb_verse_web: a plugin for HTTP and more web protocols, which may replace the curl plugin. - osgdb_pbrlayout: a pseudo-plugin to change PBR textures' layout to osgVerse standard. It supports following options: - Diffuse (D), Specular (S), Normal (N), Metallic (M), Roughness (R), Occlusion (O), Emissive (E), Ambient (A), Omitted (X) - Every source texture is defined by a option character and a channel number (1-4), and separated with a ','. - Example input: model.fbx.D4,M1R1X2,N3.pbrlayout (Tex0 = Diffuse x 4, Tex1 = Metallic+Roughness, Tex2 = Normal) - All layouts will be converted to osgVerse standard: D4,N3,S4,O1R1M1,A3,E3 #### Assets 1. models: 3D models for test use, mainly in GLTF format. 2. shaders: Shaders for osgVerse rendering pipeline use. 3. skyboxes: Skyboxes for test use, may be one HDR image or 6 cubemaps. 4. misc: Chinese IME CiKu files, font files, screenshots... 5. tests: Some test data #### Prepare and build third-party libraries 1. By default, osgVerse will find third-party libraries as follows: - OpenGL: from the system. Note that some Linux distributions (e.g., Qilin) should enable VERSE_FIND_LEGACY_OPENGL first. - OpenSceneGraph: from environment variable $OSG_ROOT. - SDL, Draco, Bullet, etc.: from CMake variable ${VERSE_3RDPARTY_PATH}, which is `<osgverse_folder>`/../Dependencies by default. - Actually path to find includes and libraries will be automatically set to '${VERSE_3RDPARTY_PATH}/`<platform>`'. - For x86/x64 build: `<platform>` is 'x86_64', 'x64', or 'x86'. - For Android build: `<platform>` is 'android'. - For MacOSX/IOS build: `<platform>` is 'apple' or 'ios'. - For WebAssembly (WASM) build: `<platform>` is 'wasm' or 'wasm64'. - For Windows UWP build: `<platform>` is 'uwp'. - For ARM64 build: `<platform>` is 'aarch64'. 2. Build Draco: - Clone from https://github.com/google/draco.git - For WebAssembly (WASM): - $ export EMSCRIPTEN=`<emsdk_folder>`/upstream/emscripten - $ cmake -DCMAKE_TOOLCHAIN_FILE=$EMSCRIPTEN/cmake/Modules/Platform/Emscripten.cmake -DDRACO_WASM=ON -DDRACO_JS_GLUE=OFF -DCMAKE_INSTALL_PREFIX=`<your_path>`/Dependencies/wasm `<draco_folder>` - $ make install - For common platforms: - (Windows) $ make -DCMAKE_INSTALL_PREFIX=`<your_path>`/Dependencies/`<arch>` `<draco_folder>` & make install - (Linux) $ apt-get install libdraco-dev 3. Build ZLMediaKit: - Prepare related dependencies: - FFmpeg/x264: - (Windows) Download from https://github.com/ShiftMediaProject/FFmpeg/releases and https://github.com/ShiftMediaProject/x264/releases - (Linux) $ apt-get install libavdevice-dev libavformat-dev libavutil-dev libavcodec-dev libswscale-dev libswresample-dev libx264-dev - OpenSSL: (Win) vcpkg install openssl (Linux) $ apt-get install libcrypto++-dev libssl-dev - libFAAC: (Linux) $ apt-get install libfaac-dev - libSCTP: (Win) vcpkg install usrsctp (Linux) $ apt-get install libusrsctp-dev - libSRTP: (Win) vcpkg install libssrtp (Linux) $ apt-get install libsrtp2-dev - Clone recursively from https://github.com/ZLMediaKit/ZLMediaKit.git - $ cmake -DENABLE_API=ON -DENABLE_CXX_API=ON -DENABLE_FFMPEG=ON -DENABLE_OPENSSL=ON -DENABLE_SCTP=ON -DENABLE_SERVER=ON -DENABLE_WEBRTC=ON -DENABLE_X264=ON -DCMAKE_INSTALL_PREFIX=`<your_path>`/Dependencies/`<arch>` `<zlmediakit_folder>` - You may have to manually specify some library paths in cmake-gui - $ make install 4. Build Bullet3: - Clone from https://github.com/bulletphysics/bullet3.git - $ cmake -DINSTALL_LIBS=ON -DUSE_DOUBLE_PRECISION=ON -DCMAKE_INSTALL_PREFIX=`<your_path>`/Dependencies/`<arch>` `<bullet_folder>` - $ make install 5. TBD... #### Build osgverse from Source (with shell script) 0. Assume that osgVerse source code is already at `<osgverse_folder>`. 1. Linux Host - Run commands below in terminal: - $ cd `<osgverse_folder>` - $ ./Setup.sh `<optional_path>` - OSG source code will be downloaded automatically and placed at ../OpenSceneGraph - Select from the menu and start compiling all libraries: - `<0>`: OpenGL Compatible profile - Result will be saved at `<osgverse_folder>/build/sdk` - `<1>`: OpenGL Core profile - Result will be saved at `<osgverse_folder>/build/sdk_core` - `<2>`: OpenGL ES - `<optional_path>` must be set to path of libEGL.so and libGLESv2.so, e.g., `/usr/lib/x86_64-linux-gnu` - You may select to build GLES2 or GLES3 in the following steps. - Result will be saved at `<osgverse_folder>/build/sdk_es` - `<3>` or `<4>`: WebAssembly 1 or 2 - `<optional_path>` must be set to path of Emscripten SDK. - You may select to build WASM64 in the following steps. - More information about osgEarth related dependencies can be found below. - Result will be saved at `<osgverse_folder>/build/verse_wasm` or `<osgverse_folder>/build/verse_wasm2` - `<5>`: Android GLES3 - Java SDK and Gradle must be installed first. - Environment variable ANDROID_SDK and ANDROID_NDK must be set. 2. Windows Host - Run Visual Studio commandline prompt (x64) to make sure NMake can be found. - Run commands below: - $ cd `<osgverse_folder>` - $ Setup.bat `<optional_path>` - See `Linux Host` for more details #### Build osgverse from Source (traditional way) 0. Assume that osgVerse source code is already at `<osgverse_folder>`. 1. Desktop Windows / Linux - Make sure you have a compiler environment (e.g., Visual Studio). - Download and install CMake tool. - Download OSG prebuilt libraries or build them from source, extracting to `<osg_sdk_folder>`. - Declare an environment variable OSG_ROOT, to indicate OSG root directory: - (Windows) $ set OSG_ROOT=`<osg_sdk_folder>` - (Linux) $ export OSG_ROOT=`<osg_sdk_folder>` - Run commands below in terminal: - $ cd `<osgverse_folder>` - $ mkdir build - $ cd build - $ cmake .. - $ cmake --build . - You may also choose to use cmake-gui and set OSG related options in GUI mode. - For MinGW build (UCRT64): - First download OpenSceneGraph prebuilt libraries: - $ pacman -S mingw-w64-ucrt-x86_64-OpenSceneGraph - Run commands below in terminal: - $ cmake -G "MSYS Makefiles" `<osgverse_folder>` - For UWP build: - First download Windows Store SDK or latest Windows 11 SDK (with VS2022). - Download Angle for UWP: https://www.nuget.org/packages/ANGLE.WindowsStore - Rename the .nuget file to .zip and extract it. Find libraries and include files there. - Build OSG for GLES2/GLES3 (Desktop / GoogleAngle). See herlps/osg_builder/README.md for details. - Run commands below in terminal: - $ cmake -G "Visual Studio 17 2022" -DCMAKE_SYSTEM_NAME=WindowsStore -DCMAKE_SYSTEM_VERSION="10.0" `<osgverse_folder>` 2. Desktop Mac OSX - Prepare Ninja, Python3 and CMake first. (from Homebrew on MacOSX) - Download and compile GoogleAngle as described in helpers/osg_builder/README.md - Configure OpenSceneGraph with -DOPENGL_PROFILE=GLES3 - Configure osgverse to use the specified version of OpenSceneGraph and GoogleAngle as bridge 3. Android - Download OpenJDK 17 from: https://jdk.java.net/archive/ - Unzip and set the JAVA_HOME variable to `<jdk_folder>` - Download Android command-line tools from: https://developer.android.com/studio#command-line-tools-only - Install SDK following the instructions: https://developer.android.com/tools/sdkmanager - $ `<commandline_folder>`/bin/sdkmanager "platform-tools" "platforms;android-32" - Download Android NDK from: https://developer.android.com/ndk/downloads/ - Download Gradle and add `<gradle_folder>`/bin to PATH: https://gradle.org/releases/ - Under Windows, run commands below in terminal: - $ cd `<osgverse_folder>` - $ ./Setup.bat - Select "5. Android / GLES3" and start building. Note: local.properties and settings.gradle will be regenerated if necessary. - TBD... 4. HarmonyOS - Download OpenJDK 17 from: https://jdk.java.net/archive/ - Unzip and set the JAVA_HOME variable to `<jdk_folder>` - Download command-line tools from: https://developer.huawei.com/consumer/cn/download/ - Under Windows, run commands below in terminal: - $ set HARMONY_CMD=`<harmony_cmd_folder>` - $ cd `<osgverse_folder>` - $ ./Setup.bat - Select "6. Harmony / GLES3" and start building. - TBD... 5. IOS - TBD... 6. WebAssembly - Download emsdk from https://emscripten.org/docs/getting_started/downloads.html, extracting to `<emsdk_folder>`. - Update and activate emsdk as required at the page above. - Download OSG source code and extract it to `<osgverse_folder>`/../OpenSceneGraph - (Optional) Download osgEarth-WASM source code and extract it to `<osgverse_folder>`/../osgearth-wasm - Repository: https://gitee.com/xarray/osgearth-wasm - osgEarth-WASM can only be built with WebGL 2.0 - Build GDAL, GEOS, etc. (https://github.com/bugra9/gdal3.js) - Modify GDAL_EMCC_FLAGS.mk to add '-pthread' to flags - $ sudo apt install automake sqlite3 - $ curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash - $ nvm install node - $ npm install -g pnpm@8.0 - $ source `<emsdk_folder>`/emsdk_env.sh - $ pnpm install - $ pnpm run build - Copy bin/include/lib/share from gdal3.js\build\native\usr to `<osgverse_folder>`/../Dependencies/wasm - Under Windows with Ninja: - Run commands below in terminal: - $ `<emsdk_folder>`/emsdk_env.bat - $ cd `<osgverse_folder>` - $ ./Setup.bat - Under Linux or WSL (Windows Sub-System for Linux): - Start a UNIX ternimal (under Windows, please install WSL v1 and start it). - Run commands below in terminal: - $ cd `<osgverse_folder>` - $ ./Setup.sh `<emsdk_folder>` - Select "3. WASM / WebGL 1.0" or "4. WASM / WebGL 2.0" and start building WASM at `<osgverse_folder>`/build/verse_wasm. - Start an HTTPS server at `<osgverse_folder>`/build/verse_wasm/bin. See `<osgverse_folder>`/wasm/run_webserver.py as an example. - Copy `<osgverse_folder>`/assets to the same root folder of the server, and enjoy our WebGL examples. #### Core CMake options | Option | Type | Default Value | Notes | |-----------------------------|---------|---------------|-------| | OSG_INCLUDE_DIR | Path | | (Required) Set to path of osg/Node | | OSG_BUILD_INCLUDE_DIR | Path | | (Required) Set to path of osg/Version | | OSG_LIB_DIR | Path | | (Required) Set to path of libosg.a or osg.lib | | OSG_DEBUG_POSTFIX | String | d | Set a postfix for OSG debug built-libraries | | OSG_GLES_INCLUDE_DIR | Path | | Set to path of GLES2/gl2.h or GLES3/gl3.h, for GLES build only | | OSG_GLES_LIBRARY | Path | | Set to path of libGLESv2.so or libGLESv2.lib, for GLES build only | | OSG_EGL_LIBRARY | Path | | Set to path of libEGL.so or libEGL.lib, for GLES build only | | SDL2_INCLUDE_DIR | Path | | Set to path of SDL.h | | SDL2_LIB_DIR | Path | | Set to path of libSDL2.so or SDL2.lib | | VERSE_3RDPARTY_PATH | Path | | Set to path of third-party libraries | | VERSE_INSTALL_PDB_FILES | Boolean | ON | Enable to install PDB files along with executables and dynamic libraries | | VERSE_BUILD_EXPORTERS | Boolean | OFF | Enable build of exporters of other software (e.g., 3dsmax) | | VERSE_BUILD_3RDPARTIES | Boolean | ON | Enable build of common libraries like FreeType, Jpeg and PNG | | VERSE_BUILD_WITH_QT | Boolean | ON | Enable build of Qt based applications and tests | | VERSE_BUILD_WITH_CUDA | Boolean | ON | Enable build of NVIDIA CUDA based libraries and tests | | VERSE_BUILD_WITH_MUSA | Boolean | ON | Enable build of MooreThreads MUSA based libraries and tests | | VERSE_BUILD_WITH_ANGLE | Boolean | OFF | Enable to support Vulkan interface if use Google Angle as GLES interface | | VERSE_BUILD_DEPRECATED_TESTS| Boolean | OFF | Enable build of deprecated tests | | VERSE_SUPPORT_CPP17 | Boolean | ON | Enable build of libraries using C++ 17 standard | | VERSE_STATIC_BUILD | Boolean | OFF | Enable static build of osgVerse | | VERSE_USE_OSG_STATIC | Boolean | OFF | Use static build of OpenSceneGraph (will force osgVerse to be static) | | VERSE_USE_DWARF | Boolean | OFF | Enable detailed debug-info and symbols. 'libdw-dev' must be installed | | VERSE_USE_GLIBCXX11_ABI | Boolean | ON | Enable to use libraries built with GCC compiler newer than 4.9 | | VERSE_USE_MIMALLOC | Boolean | ON | If mimalloc is found, this option is used for improving memory allocation | | VERSE_USE_MTT_DRIVER | Boolean | OFF | Enable to use MooreThreads MTT drivers correctly | | VERSE_USE_FORCED_MULTIPLE | Boolean | OFF | Enable to solve LNK2005 problem when compiling OSG 3.2 and lower under MSVC | | VERSE_NO_SIMD_FEATURES | Boolean | OFF | Enable to ignore all SIMD features (when struggling with compile errors) | | VERSE_WASM_USE_PTHREAD | Boolean | ON | Enable Pthread for WASM, which requires COOP / COEP on server-side, for WASM build only | | VERSE_WASM_OPTIMIZE_SIZE | Boolean | OFF | Enable -O3 for WASM, which is slow but with small generated size | | VERSE_FIND_LEGACY_OPENGL | Boolean | OFF | Enable to use legacy mode to search OpenGL libraries, for some Linux systems like Kylin |

Cargando el README del repositorio…

Skills en este repositorio

Desarrolladores de software

1 categorías ocupacionales · 100% clasificado

skill

ocupación

descripción

actualizado

compiler

Desarrolladores de software

编译/构建osgVerse与OpenSceneGraph，使用Setup脚本切换图形接口平台（DEFAULT/CORE/GLES2/GLES3/WEBGL1/WEBGL2/ANDROID），处理编译失败、重置编译、依赖库安装等编译相关问题。当用户提到编译、构建、Setup脚本、构建失败、切换图形平台、重置编译时使用。

Idioma del texto original: chino

2026-08-14

project

Desarrolladores de software

基于osgVerse创建新的CMake工程、测试程序或插件库，编写osgVerse/OpenSceneGraph代码（几何体、纹理、GLSL着色器、渲染到纹理、动画、多线程、网络、UI、交互、读取器）并编译运行。当用户要求新建工程、编写osgVerse代码、参考代码模板、创建插件/可执行程序时使用。

Idioma del texto original: chino

2026-08-14

Mostrando 2 de 2 skills recopiladas.