bluenoise-raytracer/docs/setup.md
Mathias Heyer d2ade024c4 Bulk update nvpro-samples 05/17/21
Changing license from BSD-3 to Apache2
2021-05-17 13:10:30 -07:00

65 lines
No EOL
2.1 KiB
Markdown

# Environment Setup
## Repositories
Besides the current repository, you will also need to clone or download the following repositories:
* [nvpro_core](https://github.com/nvpro-samples/nvpro_core): The primary framework that all samples depend on.
Cloning all repositories
~~~~~
git clone --recursive --shallow-submodules https://github.com/nvpro-samples/nvpro_core.git
git clone https://github.com/nvpro-samples/vk_raytracing_tutorial_KHR.git
~~~~~
The directory structure should be looking like this:
~~~~
C:\Vulkan\nvpro-samples
|
+---nvpro_core
+---vk_raytracing_tutorial_KHR
| +---ray_tracing__simple
| +---ray_tracing_...
| \---...
~~~~
See also [build_all](https://github.com/nvpro-samples/build_all) from nvpro-samples.
## Latest Vulkan SDK
This repository tries to always be up to date with the latest Vulkan SDK, therefore we suggest to download and install it.
Version 1.2.162.0 and up has ray tracing extensions support.
**Vulkan SDK**: https://vulkan.lunarg.com/sdk/home
## Driver
NVIDIA driver 450.0 and up support Vulkan ray tracing.
* Standard driver: https://www.nvidia.com/Download/index.aspx
* Vulkan beta driver: https://developer.nvidia.com/vulkan-driver
## CMake
The CMakefile will use other makefiles from `nvpro_core` and look for Vulkan environment variables for the installation of the SDK. Therefore, it is important to have all the above installed before running Cmake in the
`vk_raytracing_tutorial_KHR` directory.
**Note:** Ray tracing only works with 64 bit environment. Therefore, make sure to choose the right build environment.
**Note:** If you are using your own Vulkan header files, it is possible to overide the default search path.
Modify `VULKAN > VULKAN_HEADERS_OVERRIDE_INCLUDE_DIR` to the path to beta vulkan headers.
## Starting From Extra Tutorial
All _extra_ tutorials are starting from the end result of the _first tutorial_. The directory of the _extra_ tutorials is the end result of doing it.
To start the tutorial from the begining.
* Make a copy of the ray_tutorial__simple (backup)
* Follow the tutorial by modifying ray_tutorial__simple