GaussianSplatting Plugin
The GaussianSplatting plugin allows importing 3D Gaussian Splatting (*.ply) files into a UNIGINE application and rendering them in real time.
See Also#
- Gaussian Splatting sample in CPP SIM Samples
Launching GaussianSplatting Plugin#
To use the GaussianSplatting plugin, load it via the plugin_load console command or specify the extern_plugin command line option on the application start-up:
Shell commands
-extern_plugin "UnigineGaussianSplatting"
Using GaussianSplatting Plugin#
To add a Gaussian Splatting file to the scene, do the following:
- Create a Node Dummy and assign the gaussian property to it (this property is available in the project as a part of the plugin).
- In the property parameter Gaussian Ply File, assign the *.ply file that you want to render.
- Adjust other parameters, if necessary.
Gaussian Property Parameters#
The Gaussian property contains the following parameters available for adjustment:
Gaussian Ply File | The *.ply file containing 3D Gaussian splatting [3DGS] scene. |
---|---|
Render Order | The order of rendering the 3DGS object. The object with the highest render order will be rendered last (on top of all other 3DGS objects). |
Gaussian Render Material | The material used for rendering the gaussians. It has a set of parameters that can be changed to adjust the look of the 3DGS render. |
Gaussian Utils Material | Utility material used to initialize Gaussian data and calculate distance from camera for each Gaussian splat. |
Sorting Material | Material used for Gaussian sorting based on their distance from the camera. |
SH Order | The spherical harmonics order used for rendering the gaussians, which determines the visual fidelity of the gaussians. The SH order equal to zero represents only the perspective-indepent base color, while higher orders encode more persective-dependent details, such as shininess, reflections, etc. |
SH Compression | Compressing the spherical harmonics data to improve VRAM usage efficiency. |
Sort Interval | Frame interval between sorting gaussian splats. Higher values can be set for a relatively static camera to save performance. |
Sort VR Per Eye | Enabling sorting for each eye in VR. If disabled, the Gaussian data will be sorted once and reused for the other eye. |
Gaussian Property Parameters#
The gaussian_render.basemat material contains the following parameters available for adjustment:
Sh Only | Using only the spherical harmonics components with the order > 0, i.e. without the base color, to see how they affect the final color. |
---|---|
Debug Cubes | Rendering primitive quads instead of guassians. Intended for debugging purposes. |
Culling Frustum Dilation | The scalar factor controlling how much the view frustum is expanded to include 3D Gaussians whose centers lie outside the original frustum but remain visible due to their large covariance. |
Culling Alpha Threshold | The alpha threshold for culling gaussians. Gaussians with alpha lower than this value will not be drawn. |
Splat Opacity Scale | The gaussian splat opacity (alpha) scale factor. Adjust this value to make the gaussians more/less opaque. |
Splat Size Scale | The gaussian splat size scale. Adjust this value to make the gaussians larger/smaller. |
The information on this page is valid for UNIGINE 2.20 SDK.
Last update:
30.06.2025
Помогите сделать статью лучше
Была ли эта статья полезной?
(или выберите слово/фразу и нажмите Ctrl+Enter