Vulkan & OpenGL & Command-list Sample using "Thread-Workers"
With the official release of Vulkan, NVIDIA and the "Devtech-Proviz" Team released new samples on professional graphics repository.
The Purpose of this Blog post is to give more details on what is happening in the Sample called
gl_vk_bk3dthreaded (available here).
How to build the sample
For now, I am sorry to say that the sample might only run on Windows. I didn't consolidate it for Linux, yet.
This sample requires the following:
- LunarG SDK v184.108.40.206 : just install it from https://vulkan.lunarg.com : cmake should be able to locate it
- shared sources : this folder contains few helper files and additional cmake information needed to build the project
- shared external : this folder a is a convenient way to gather all external tool that our samples rely on. Rather than trying to find back the right versions of zlib, AntTweakbar etc, this folder contains all the needed external projects that our samples need:
- zlib: to read gz files (3D model(s) )
- SvcMfCUI: a simple UI based on Windows MFC. No fancy but convenient
- AntTweakBar (not used in this sample... yet. SvcMfCUI used instead)
- Optionally: NSight nvTX custom markers
- the submarine model: when you will configure the project with cmake, cmake script will perform a wget to get the model and store it locally:
MODEL_DOWNLOAD_SUBMARINEChecked. The model is 32Mb and will be stored in a shared folder called
Optionally, be aware that other bk3d models could be used in this sample. But to avoid heavy download, only the submarine will be taken by default. Check
MODEL_DOWNLOAD_MORE On for more models...
How does the sample work
The sample will run by default with the submarine model and some camera animation. So if you want to freely move the camera, don't forget to stop the animation (UI or 'a' key)
If you give as cmd-line argument another model (*.bk3d.gz or *.bk3d), the sample should be able to render it but the animation will be turned off; and it is possible that the camera won't focus exactly over the new model...
Vulkan renderer will be the default one at startup. You can switch between:
- OpenGL & Command-lists: an example on how to feed the token-buffers
- OpenGL: a basic implementation of how would you render 3D with OpenGL
- Vulkan: the default renderer
Note: toggles are preceded by a character between quotes: when the viewport has the focus, you can use the keyboard instead.
- Use Workers: checked for multi-threading. Unchecked: only the main thread will update the draw commands (cmd-buffers)
- command-buffer amount: by default, 16 secondary command-buffers will be created to render everything. In the multi-threading case, thread-workers will get spawned and will work on building them: when 'c' toggle is checked (command-buffer continuous refresh)
- Cmd-buf-style: this model came from a CAD application. It turns out that at the time this model was created, primitives were issued depending on their 'parts', rather than depending on their primitive type and/or materials (hence shaders). "sort on primitive type" would allow to first render triangles; then strips; then lines...
- MSAA: Multispampling mode
- 'c', &g_bRefreshCmdBuffers, "c: toggles command buffer continuous refresh\n");
- , &m_realtime.bNonStopRendering, "space: toggles continuous rendering\n");
- toggles from 'o'to '5' are obvious options... just give a try
- -v (VBO max Size)
- -m (bk3d model)
- -c 0 or 1 : use command-lists
- -o 0 or 1 : display meshes
- -g 0 or 1 : display grid
- -s 0 or 1 : stats
- -a 0 or 1 : animate camera
- -d 0 or 1 : debug stuff (ui)
- -m (bk3d file) : load a specific model
- (bk3d file name) : load a specific model
- -q (msaa) : MSAA
special Key with the mouse allows few to move around the model. The camera is always targeting a focus point and is essentially working in "polar coordinates" (TODO: I need to display the focus point with a cross...)
- mouse wheel: zoom in/out from the focus point
- left mouse button: rotate around the focus point
- right mouse button: rotate around Ox axis and zoom in/out from focus point
- right mouse button + Ctrl: will push forward/backward the focus point
- middle mouse button: pan left/right up/down the focus point along camera axis
- arrows: rotate around the focus point
- Pg-up/Pg-down: zoom in/out
- Pg-up/Pg-down + Ctrl: push forward/backward the focus point along camera axis
the 3D model comes from a pre-baked format (see here ). There is no value to understand how it is working: main interest is that it loads fast (baked format... saving us parsing time) and that I managed to 'capture' some models as they were issued by various applications.
The sample will load the model, then attach it to the renderers. The resource creation will thus depend on which Graphic API is being used.
More technical details
Here are more details in separate sub-sections :
- Rendering Modes : details on what is this sample rendering and how
- Rendering with Vulkan
: key steps in order to make Vulkan API work for this sample, including
- Vulkan Code Style : helper file that allows to write Vulkan code in a more compact fashion
- Multithreading : based on "Thread-workers", and how to use Vulkan in this case
- Results / performances
- NSight captures : some NSight captures showing what is happening
Copyright (c) 2016, NVIDIA CORPORATION. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. * Neither the name of NVIDIA CORPORATION nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.