¶ Welcome Window
When launching Volinga Suite, the Welcome Window provides quick access to your workflow. It displays recently opened scenes and three main creation entry points.
¶ Overview
The Welcome Window is composed of the following elements:
-
1) Version Info
Displays the current application version. The Check Updates button allows you to update Volinga Suite. -
2) Scene Selector
Allows you to select a recently opened scene. -
3) Recent Scene Preview
Displays the project name and a preview of the scene. -
4) New Project
Creates a new project with the required folder structure. -
5) New Scene
Creates a new empty scene inside an existing project. -
6) New Asset
Starts the workflow to create a new 3D Gaussian Splatting asset from source data. -
7) Information Panel
Displays help messages and contextual information.
¶ Creating a New Project
To create a new project, define a destination folder and a project name.
Once confirmed, Volinga Suite automatically initializes the project structure and creates a default empty scene named: main.vscene
This provides a clean starting point for your work.
¶ Creating a New Scene
The Blank Scene workflow allows you to create a new scene inside an existing project. If no project is currently selected, you will be prompted to create one.
Once named, the scene is saved as a .vscene file within the project structure.
¶ Alternative Method: Creating a Scene from the Top Menu
You can also create a new scene while working inside an existing project using the top menu.
Navigate to: File → New → Scene
This will open the same New Scene workflow, allowing you to define the scene name and create a .vscene file within the current project.
Once selected, the system will prompt you to configure and confirm the creation of the new scene within your active project.
¶ Creating a New Asset
Assets are the fundamental building blocks of Volinga Suite.
A new asset is created by generating an NVOL file, either from source media (training a 3D Gaussian Splatting model) or by converting existing 3DGS PLY files.
When creating a new asset, you must first select the target project. If no project exists, the system will guide you through the project creation workflow.
The Media Importer Wizard supports the following input types:
-
Images / Videos (
.png,.jpg,.jpeg,.mp4,.mov)
A minimum of 20 images or an equivalent video is required. -
OpenEXR files (
.exr)
Processed according to ACES 2065-1 specifications.
See: EXR Files for ACES -
3DGS PLY files (
.ply)
Can be converted directly into NVOL format for use in Volinga Suite. -
COLMAP models
Imported using the Import COLMAP Registration option.
¶ Alternative Method: Creating a Asset from the Top Menu
You can also create a new asset while working inside an existing project using the top menu.
Navigate to: File → New → Asset
This action opens the same New Asset workflow described above, allowing you to select input data and configure the asset creation process.
Once selected, Volinga Suite will guide you through the Media Importer Wizard, where you can define the source data and start the asset generation pipeline.
This method is recommended when you are already working within a project and want to quickly add new assets without returning to the Welcome Window.
¶ Training Parameters
The Trainer in Volinga Suite defines how a 3D Gaussian Splatting asset is optimized from input data. The following parameters control performance, quality, and scene representation during training.
¶ Strategy
Strategy: Defines the optimization algorithm used during training.
- MCMC (Markov Chain Monte Carlo)
- Probabilistic optimization approach based on stochastic sampling (SGLD).
- Better exploration of complex scenes.
- Improves reconstruction of challenging real-world data.
- Often produces a softer or more “painterly” appearance.
- Can result in a more scattered Gaussian distribution and larger outputs.
- ADC (Adaptive Density Control)
- Traditional heuristic-based method.
- Dynamically adds, removes, and splits Gaussians based on density.
- More efficient and stable.
- Produces smaller and lighter outputs.
- Best suited for structured or high-resolution scenes.
- May struggle with highly complex or unstructured geometry.
¶ Iterations
Iterations: Defines the total number of training iterations.
- Higher values generally improve reconstruction quality.
- Improvements tend to plateau after a certain threshold.
- Very high values significantly increase training time.
¶ Checkpoint Iterations
Checkpoint Iterations: Defines how often training checkpoints are saved.
- Example: 7000 saves a checkpoint every 7000 iterations.
- Useful for progress recovery and intermediate evaluation.
¶ Max Gaussians
Max Gaussians: Defines the maximum number of Gaussians allowed in the model.
- Acts as an upper bound for scene complexity.
- Higher values increase detail but also memory usage and file size.
- In MCMC mode, it directly influences the final Gaussian distribution.
¶ Resize Factor
- Resize Factor: Controls the input image resolution used for training.
- Available values: Full,50%,25%,12.5%
- Lower values improve performance and reduce memory usage.
- Higher values improve reconstruction quality and detail.
¶ Background Color
Background Color: Defines the background representation during training.
- Options:
- Black: Uses a constant black background.
- Random: Uses per-pixel random background values.
- Random mode can improve robustness in difficult lighting or segmentation conditions.
¶ 16-bit Training
16-bit Training: Enables loading images in 16-bit format.
- Improves precision in high dynamic range or fine gradient scenes.
- Increases memory usage compared to 8-bit training.
¶ Training Execution
Adjusting the Resize Factor and enabling 16-bit Training allows you to balance GPU memory usage, training stability, and output quality. Lower resize factors reduce memory consumption and speed up training, while higher values preserve finer detail at the cost of increased computational load. Enabling 16-bit training improves precision in scenes with high dynamic range or subtle gradients, but increases memory requirements.
If your system meets the recommended hardware specifications—specifically with at least 24GB of VRAM—you can safely train using Full resolution, 16-bit training, and higher Gaussian limits without significant performance issues.
Once all parameters are configured, you can start training immediately or queue the job:
- Begin Training: Starts the selected job immediately. If another job is currently running, it will be interrupted and replaced by the new one.
- Send to Queue: Adds the job to the end of the processing queue. If no job is currently running, the asset will start processing immediately.
More details about how the job queue system works in Volinga Suite are provided in the following section.
¶ Job Queue Manager
The Job Queue Manager (JQM) allows monitoring and controlling asset processing tasks. It provides real-time progress updates, job prioritization, and log details, ensuring efficient processing management.
On the top part of the JQM, the list of jobs in the queue can be found. The jobs are executed by priority order, and only one job can be executed at the same time. Jobs can have the following status:
- Queued: Job is queued and waiting to be executed.
- Running: Job is being executed right now.
- Paused: Job started to execute but was paused by the user.
- Completed: Job has finished processing.
- Failed: An error occurred during job execution.
You can reprioritize jobs in the queue by selecting a job and clicking the "Change Priority" button. Assigning priority 1 to a job will immediately move it to the front of the queue and start its execution, pausing any job that is currently running.
Resuming a paused job will also start it immediately and move it to the top of the queue, interrupting any active job in progress.
Removing a job from the queue will delete it, while stopping a running job will cancel its execution and remove it from the list entirely.
Finally, the "Queue Job" button allows you to add a new job to the queue by launching the new asset creation workflow.
¶ Updating Volinga Suite
Volinga Suite includes a built-in update system that allows you to easily install new versions when they become available.
¶ From the Welcome Window
On the left side of the Welcome Window, you will see:
- The current installed version
- A Check Updates button (if an update is available)
To update:
- Click the Check Updates button
- The installer / component manager wizard will open
- Make sure the option “Update Components” is selected
- Click Next to start the update process
¶ Verifying Your Version
You can check your current version at any time:
- From the Welcome Window (left panel, below the Volinga logo)
- From inside the application via:
Toolbar Menu → About
After updating, you can continue working normally with the latest version installed.