+ 
+
+
+
+ 
+
+
+# Table of Contents
+
+1. [Showcase](#showcase)
+2. [Features](#features)
+ - [The Nabla Core Profile](#-the-nabla-core-profile)
+ - [Physical Device Selection and Filtering](#-physical-device-selection-and-filteration)
+ - [SPIR-V and Vulkan as First-Class Citizens](#-spir-v-and-vulkan-as-first-class-citizens)
+ - [Integration of Renderdoc](#-integration-of-renderdoc)
+ - [Nabla Event Handler: Seamless GPU-CPU Synchronization](#-nabla-event-handler-seamless-gpu-cpu-synchronization)
+ - [GPU Object Lifecycle Tracking](#-gpu-object-lifecycle-tracking)
+ - [HLSL2021 Standard Template Library](#-hlsl2021-standard-template-library)
+ - [Full Embrace of Buffer Device Address and Descriptor Indexing](#-full-embrace-of-buffer-device-address-and-descriptor-indexing)
+ - [Minimally Invasive Design](#-minimally-invasive-design)
+ - [Designed for Interoperation](#-designed-for-interoperation)
+ - [Cancellable Future-based Async I/O](#-cancellable-future-based-async-io)
+ - [Data Transfer Utilities](#-data-transfer-utilities)
+ - [Virtual File System](#-virtual-file-system)
+ - [Asset System](#-asset-system)
+ - [Asset Converter (CPU to GPU)](#-asset-converter-cpu-to-gpu)
+ - [Unit-Tested BxDFs for Physically Based Rendering](#-unit-tested-bxdfs-for-physically-based-rendering)
+ - [Property Pools (GPU Entity Component System)](#-in-progress-property-pools-gpu-entity-component-system)
+ - [SPIR-V Introspection and Layout Creation](#-spir-v-introspection-and-layout-creation)
+ - [Nabla Extensions](#-nabla-extensions)
+3. [Coming Soon](#-coming-soon)
+4. [Need Our Expertise?](#-need-our-expertise)
+5. [Join Our Team](#join-our-team)
+
+# Showcase
+
+| + Ray Tracing + | ++ Emulated shaderFloat64 + | +
|
+ |
+
+ |
+
| + MSDF Hatches + | ++ Porting GDI to Nabla + | +
|
+ |
+
+ |
+
| + SDF function manipulator + | ++ Fluid 3D + | +
|
+ |
+
+ |
+
| + Nabla Shader Compiler & Godbolt docker integration + | ++ ImGUI render backend & extensions + | +
|
+ |
+
+ |
+
+
+ 
+ 
+ 
+
+
-Use [`ISwapchain getSurfaceTransform()`](https://github.com/Devsh-Graphics-Programming/Nabla/tree/master/include/nbl/video/ISwapchain.h) to get the transformation from swapchain.
+### 🧩 **Designed for Interoperation**
+Nabla is built with interoperation in mind, supporting memory export and import between different compute and graphics APIs.
-- When generating projection matricies, take into account the aspect ratio (which is changed when rotating 90 or 270 degrees). For this, we have helper functions in both GLSL and the ISurface class:
- - [`float getTransformedAspectRatio(const E_SURFACE_TRANSFORM_FLAGS transform, uint32_t w, uint32_t h)`](https://github.com/Devsh-Graphics-Programming/Nabla/tree/master/include/nbl/video/surface/ISurface.h)
- - [`nbl_glsl_surface_transform_transformedExtents`](https://github.com/Devsh-Graphics-Programming/Nabla/tree/master/include/nbl/builtin/glsl/utils/surface_transform.glsl)
+### 🧩 **Cancellable Future based Async I/O**
-- On the swapchain rendering pass, perform **one** of the following transforms:
- - If rendering **directly to the swapchain**, you can apply the (post) transform matrix to your projection or combined view-projection matrix **for rendering** (don't pre-multiply with projection matrix for use outside rendering):
- - [`matrix4SIMD ISurface::getSurfaceTransformationMatrix(const E_SURFACE_TRANSFORM_FLAGS transform)`](https://github.com/Devsh-Graphics-Programming/Nabla/tree/master/include/nbl/video/surface/ISurface.h)
- - [`nbl_glsl_surface_transform_applyToNDC`](https://github.com/Devsh-Graphics-Programming/Nabla/tree/master/include/nbl/builtin/glsl/utils/surface_transform.glsl) (This takes in an NDC coordinate and multiplies it with the transform matrix in one function)
+File I/O is fully asynchronous, using [nbl::system::future_t](https://github.com/Devsh-Graphics-Programming/Nabla/blob/ff07cd71c4e21bc51fa416ccd151b2e92efea028/include/nbl/system/ISystem.h#L26), a cancellable MPSC circular buffer-based future implementation.
- - If using `imageStore` to write **directly to the swapchain**, you can either:
- - Apply a transform to the screen-space coordinates being written to the swapchain:
- - [`nbl_glsl_surface_transform_applyToScreenSpaceCoordinate`](https://github.com/Devsh-Graphics-Programming/Nabla/tree/master/include/nbl/builtin/glsl/utils/surface_transform.glsl)
- - Apply an **inverse** transform to the screen-space coordinates (taken from `gl_GlobalInvocationID.xy`) before turning them into UV/world-space coordinates for rendering:
- - [`nbl_glsl_surface_transform_applyInverseToScreenSpaceCoordinate`](https://github.com/Devsh-Graphics-Programming/Nabla/tree/master/include/nbl/builtin/glsl/utils/surface_transform.glsl)
+Requests start in a **PENDING** state and can be invalidated before execution if needed. This enables efficient async file reads and GPU memory writes, ensuring non-blocking execution:
-# Continuous integration
+```cpp
+ISystem::future_t