layers/gpuav/shaders/validation_cmd/build_acceleration_structures.h

// Copyright (c) 2021-2026 The Khronos Group Inc.
// Copyright (c) 2021-2026 Valve Corporation
// Copyright (c) 2021-2026 LunarG, Inc.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
// Values used between the GLSL shaders and the GPU-AV logic

// NOTE: This header is included by the instrumentation shaders and glslang doesn't support #pragma once
#ifndef BUILD_ACCELERATION_STRUCTURES_H
#define BUILD_ACCELERATION_STRUCTURES_H

#define BUILD_AS_METADATA_VALID_BUFFER 1u
#define GET_BUILD_AS_METADATA_BUFFER_STATUS(metadata) ((metadata & (0x1 << 0u)) >> 0u)
#define SET_BUILD_AS_METADATA_BUFFER_STATUS(is_buffer_destroyed) ((uint32_t(is_buffer_destroyed) & 0x1) << 0u)

#define BUILD_AS_METADATA_AS_TYPE_BLAS 1u
#define GET_BUILD_AS_METADATA_AS_TYPE(metadata) ((metadata & (0x3 << 1u)) >> 1u)
#define SET_BUILD_AS_METADATA_AS_TYPE(as_type) ((uint32_t(as_type) & 0x3) << 1u)

#define BUILD_AS_METADATA_VALID_BUFFER_MEMORY 1u
#define GET_BUILD_AS_METADATA_BUFFER_MEMORY_STATUS(metadata) ((metadata & (0x1 << 3u)) >> 3u)
#define SET_BUILD_AS_METADATA_BUFFER_MEMORY_STATUS(is_memory_destroyed) ((uint32_t(is_memory_destroyed) & 0x1) << 3u)

#ifdef __cplusplus

#include <cstdint>

namespace gpuav {
namespace glsl {
using uint = uint32_t;
#else
#extension GL_ARB_gpu_shader_int64 : require
#extension GL_EXT_buffer_reference : require
#extension GL_EXT_buffer_reference2 : require
#extension GL_EXT_buffer_reference_uvec2 : require
#extension GL_EXT_scalar_block_layout : require
#endif

#ifdef __cplusplus
using PtrToBlasArray = uint64_t;
using PtrToBlasPtrArray = uint64_t;
using PtrToAccelerationStructureAddressArray = uint64_t;
using PtrToAccelerationStructureMetadataArray = uint64_t;
using PtrToAccelerationStructureBufferRangeArray = uint64_t;
using PtrtoPtrToAccelerationStructureArrays = uint64_t;
using PtrToBlasBuiltInCmd = uint64_t;

#else
struct VkAccelerationStructureInstance {
    mat3x4 transform;
    uint instanceCustomIndex_and_mask;
    uint instanceShaderBindingTableRecordOffset_and_flags;
    uint64_t accelerationStructureReference;
};

layout(buffer_reference, scalar) buffer VkAccelerationStructureInstancePtr { VkAccelerationStructureInstance as_instance; };

layout(buffer_reference, scalar) buffer PtrToAccelerationStructureAddressArray {
    uint count;
    uint pad_;
    uint64_t array[];
};

layout(buffer_reference, scalar) buffer PtrToAccelerationStructureMetadataArray { uint array[]; };

// Represent a [begin, end) range, where end is one past the last element held in range
struct Range {
    uint64_t begin;
    uint64_t end;
};

layout(buffer_reference, scalar) buffer PtrToAccelerationStructureBufferRangeArray { Range array[]; };
#endif

// "Struct of arrays" memory pattern to improve locality
struct AccelerationStructureArraysPtr {
    PtrToAccelerationStructureAddressArray addresses_ptr;
    PtrToAccelerationStructureMetadataArray metadata_ptr;
    PtrToAccelerationStructureBufferRangeArray buffer_ranges_ptr;
};

#ifndef __cplusplus
layout(buffer_reference, scalar) buffer PtrtoPtrToAccelerationStructureArrays { AccelerationStructureArraysPtr as_arrays_ptrs; };

layout(buffer_reference, scalar) buffer PtrToBlasArray { VkAccelerationStructureInstance blas_array[]; };

layout(buffer_reference, scalar) buffer PtrToBlasPtrArray { VkAccelerationStructureInstancePtr blas_ptr_array[]; };

layout(buffer_reference, scalar) buffer PtrToBlasBuiltInCmd { Range buffer_ranges[]; };
#endif

const uint kBuildASValidationMode_invalid_AS = 0;
const uint kBuildASValidationMode_memory_overlaps = 1;

struct TLASValidationShaderPushData {
    PtrtoPtrToAccelerationStructureArrays ptr_to_ptr_to_accel_structs_arrays;
    uint64_t valid_dummy_blas_addr;

    // BLAS arrays to validate
    // Either an array of VkAccelerationStructureInstance,
    // or pointers to such structs.
    PtrToBlasArray blas_array_start_addr;
    PtrToBlasPtrArray blas_ptr_array_start_addr;
    uint blas_array_size;
    uint is_array_of_pointers;
    uint blas_array_i;  // Used to find back invalid build cmd pInfos if an error is found
    uint validation_mode;

    PtrToBlasBuiltInCmd blas_built_in_cmd_array_ptr;
    uint blas_built_in_cmd_array_size;
};

const uint kBLASValidationMode_triangles_indices = 0;
const uint kBLASValidationMode_active_triangles = 1;
const uint kBLASValidationMode_aabbs = 2;
const uint kBLASValidationMode_transform_matrix = 3;

// #ARNO_TODO Vulkan only guarantees 128 bytes of push constants, need to move this to a buffer
struct BLASValidationShaderPushData {
    uint64_t address;  // Cast it appropriately according to index_type
    uint64_t address_2;
    uint64_t address_3;
    uint64_t update_time_stride;
    uint64_t build_time_stride;
    uint validation_mode;
    uint index_type;
    uint vertex_format;
    uint max_vertex;
    uint first_vertex;
    uint primitive_offset;
    uint primitive_count;
    uint error_info_i;
};

#ifdef __cplusplus
}  // namespace glsl
}  // namespace gpuav
#endif
#endif