Troubleshooting

Troubleshooting

Tool crashes without any error message

Recent releases moved the viewport to a new system based on a library called Veldrid. This allows for the tool to work with various 3D APIs (OpenGL, Direct3D, OpenGL, metal) depending on the platform and the hardware capabilities. It will try to find the best option at start-up. On Windows and Linux, this will be typically be 'Vulkan' (macOS will generally use metal). On some configurations, the Vulkan drivers may be buggy or incomplete and this results in a failure that the tool cannot recover from.

You can force the use of a different option by passing --graphicsMode with one of the following values :

"vulkan" : use vulkan

"opengl" : use OpenGL

"d3d11" : use Direct3D 11 (Windows-only)

"metal" : use metal (macOS-only)

For example:

Windows (editing shortcut, for example)

c:\Program Files\Variance421\Variance.exe --graphicsMode "opengl"

Linux terminal:

dotnet /opt/variance421/Variance.Gtk.dll --graphicsMode "opengl"