New documentation

README.md

@@ -2,26 +2,42 @@
 
 # NVIDIA Vulkan Ray Tracing Tutorials
 
-The focus of this project and the provided code is to showcase a basic integration of
-ray tracing within an existing Vulkan sample, using the
-[`VK_KHR_ray_tracing`](https://www.khronos.org/registry/vulkan/specs/1.2-extensions/html/vkspec.html#VK_KHR_ray_tracing) extension.
-The following tutorials starts from a the end of the previous ray tracing tutorial and provides step-by-step instructions to modify and add methods and functions.
-The sections are organized by components, with subsections identifying the modified functions.
-
-This project contains multiple tutorials all around Vulkan ray tracing.
-
-Instead of having examples fully functional, those tutorial starts from a program and guide the user to add what is necessary.
-
-## Ray Tracing Tutorial
-
-The first tutorial is starting from a Vulkan code example, which can load multiple OBJ and render them using the rasterizer, and adds step-by-step what is require to do ray tracing.
-
-### [**Start Ray Tracing Tutorial**](https://nvpro-samples.github.io/vk_raytracing_tutorial_KHR/)
-
 ![resultRaytraceShadowMedieval](docs/Images/resultRaytraceShadowMedieval.png)
 
-# Going Further
 
-From this point on, you can continue creating your own ray types and shaders, and experiment with more advanced ray tracing based algorithms.
+The focus of this repository and the provided code is to showcase a basic integration of
+ray tracing within an existing Vulkan sample, using the
+[`VK_KHR_ray_tracing`](https://www.khronos.org/registry/vulkan/specs/1.2-extensions/html/vkspec.html#VK_KHR_ray_tracing) extension.
 
-### [**All Extra Tutorials**](https://nvpro-samples.github.io/vk_raytracing_tutorial_KHR/vkrt_tuto_further.md.html)
+## Setup
+
+To be able to compile and run those examples, please follow the [setup](docs/setup.md) instructions. Find more over [nvpro-samples](https://github.com/nvpro-samples/build_all)
+
+## Tutorials 
+
+The [first tutorial] (https://nvpro-samples.github.io/vk_raytracing_tutorial_KHR/) starts from a very simple Vulkan application. It loads a OBJ file and use the rasterizer to render it. The tutorial is adding, **step-by-step**, all what is needed to be able to ray traced the scene.
+
+-------
+### Ray Tracing Tutorial -> [**Start **](https://nvpro-samples.github.io/vk_raytracing_tutorial_KHR/) <-
+
+-------
+
+
+## Extra Tutotrials
+
+All other tutorials starts from the end of the _first_ ray tracing tutorial and provides also step-by-step instructions to modify, add methods and functions for that
+extra section. 
+
+
+
+Tutorial | Details
+---------|--------
+![small](ray_tracing_anyhit/images/anyhit.png) | [Any Hit Shader](ray_tracing_anyhit)<br>Implements transparent materials by adding a new shader to the Hit group and using the material information to discard hits over time. Adding anyhit (.ahit) to the ray tracing pipeline. Randomly letting the ray hit or not which is making simple transparency.
+![small](ray_tracing_jitter_cam/images/antialiasing.png) | [Jitter Camera](ray_tracing_jitter_cam)<br>  Anti-aliases the image by accumulating small variations of rays over time. Random ray direction generation. Read/write/accumulate final image
+![img](ray_tracing_instances/images/instances.png) | [Thousands of Objects](ray_tracing_instances) <br> The current example allocates memory for each object, each of which has several buffers. This shows how to get around Vulkan's limits on the total number of memory allocations by using a memory allocator. Extend the limit of 4096 memory allocations. Using memory allocators: DMA, VMA
+![img](ray_tracing_reflections/images/reflections.png) | [Reflections](ray_tracing_reflections) <br> Reflections can be implemented by shooting new rays from the closest hit shader, or by iteratively shooting them from the raygen shader. This example shows the limitations and differences of these implementations. Calling traceRayEXT() from the closest hit shader (recursive). Adding more data to the ray payload to continue the ray from the raygen shader.
+![img](ray_tracing_manyhits/images/manyhits.png) | [Multiple Closest Hits Shader and Shader Records](ray_tracing_manyhits) <br> Multiple Closest Hits Shader and Shader Records. Explains how to add more closest hit shaders, choose which instance uses which shader, and add data per SBT that can be retrieved in the shader, and more. One closest hit shader per object. Sharing closest hit shaders for some object.Passing shader record to closest hit shader.
+![img](ray_tracing_animation/images/animation2.gif) | [Animation](ray_tracing_animation) <br> This tutorial shows how animating the transformation matrices of the instances (TLAS) and animating the vertices of an object (BLAS) in a compute shader, could be done. Refit of top level acceleration structure. Refit of bottom level acceleration structure.
+![img](ray_tracing_intersection/images/intersection.png) | [Intersectiom Shader](ray_tracing_intersection) <br> Adding thousands of implicit primitives and using an intersection shader to render spheres and cubes. The tutorial explains what is needed to get procedural hit group working. Intersection Shader. Sphere intersection. Axis aligned bounding box intersection.
+![img](ray_tracing_callable/images/callable.png) | [Callable Shader](ray_tracing_callable) <br> Replacing if/else by callable shaders. The code to execute the lighting is done in separate callable shaders instead of been part of the code. Adding multiple callable shaders. Calling ExecuteCallableEXT from the closest hit shader.
+![img](ray_tracing_rayquery/images/rayquery.png) | [Ray Query](ray_tracing_rayquery) <br> Invoking ray intersection queries directly from the fragment shader to cast shadow rays. Ray tracing directly from the fragment shader.