idistributed_compute_destination_buffer.h

Go to the documentation of this file.

 /******************************************************************************
 * Copyright 2023 NVIDIA Corporation. All rights reserved.
 *****************************************************************************/
 
#ifndef NVIDIA_INDEX_IDISTRIBUTED_COMPUTE_DESTINATION_BUFFER_H
#define NVIDIA_INDEX_IDISTRIBUTED_COMPUTE_DESTINATION_BUFFER_H
 
#include <mi/dice.h>
#include <mi/base/interface_declare.h>
 
#include <nv/index/idistributed_data_subset.h>
 
#include <nv/index/iirregular_volume_subset.h>
#include <nv/index/iparticle_volume_subset.h>
#include <nv/index/isparse_volume_subset.h>
#include <nv/index/isparse_volume_subset.h>
#include <nv/index/ivdb_subset.h>
 
namespace nv {
namespace index {
 
class IDistributed_compute_destination_buffer :
    public mi::base::Interface_declare<0xfaae5c5,0x2701,0x442e,0x8f,0x77,0xe3,0x3,0xed,0xd,0x6f,0x5c>
{
public:
    virtual mi::math::Bbox_struct<mi::Float32, 3>   get_subregion_bbox() const = 0;
 
    virtual mi::math::Bbox_struct<mi::Uint32, 2>    get_screen_space_area() const = 0;
 
    virtual mi::Sint32                              get_gpu_device_id() const = 0;
 
    struct Compute_frame_id {
        mi::Uint32      frame_id;   
        mi::Uint32      scope_id;   
        mi::Uint32      host_id;    
    };
 
    virtual Compute_frame_id                        get_compute_frame_id() const = 0;
 
    virtual void                                    notify_compute_completion() const = 0;
};
 
class IDistributed_compute_destination_buffer_3d_sparse_volume :
    public mi::base::Interface_declare<0x9da831bb,0x8425,0x4590,0xaa,0x10,0x8,0xcc,0x8d,0x5f,0x90,0xc1,
                                       nv::index::IDistributed_compute_destination_buffer>
{
public:
    virtual mi::math::Bbox_struct<mi::Sint32, 3> get_volume_subset_data_bbox() const = 0;
 
    virtual mi::math::Bbox_struct<mi::Sint32, 3> get_clipped_volume_subset_data_bbox() const = 0;
 
    virtual mi::math::Bbox_struct<mi::Sint32, 3> get_already_computed_volume_subset_data_bbox() const = 0;
 
    virtual ISparse_volume_subset* get_distributed_data_subset() = 0;
};
 
class IDistributed_compute_destination_buffer_irregular_volume :
    public mi::base::Interface_declare<0x384f6eca,0xd09c,0x47a1,0xa0,0x91,0x1e,0x5f,0xc3,0xfb,0x47,0x6,
                                       nv::index::IDistributed_compute_destination_buffer>
{
public:
    virtual mi::math::Bbox_struct<mi::Float32, 3> get_volume_subset_data_bbox() const = 0;
 
    virtual IIrregular_volume_subset* get_distributed_data_subset() = 0;
};
 
class IDistributed_compute_destination_buffer_VDB :
    public mi::base::Interface_declare<0x8993a772,0xbde1,0x4424,0x9b,0xec,0xc7,0x86,0xa1,0x38,0x85,0xac,
                                       nv::index::IDistributed_compute_destination_buffer>
{
public:
    virtual mi::math::Bbox_struct<mi::Float32, 3>   get_volume_subset_data_bbox() const = 0;
 
    virtual IVDB_subset*                            get_distributed_data_subset() = 0;
};
 
class IDistributed_compute_destination_buffer_particle_volume :
    public mi::base::Interface_declare<0x131bc471, 0xb557, 0x4e80, 0x8e, 0x71, 0xa1, 0x3a, 0x58, 0xd5, 0xa5, 0x1f,
                                       nv::index::IDistributed_compute_destination_buffer>
{
public:
    virtual mi::math::Bbox_struct<mi::Float32, 3>   get_volume_subset_data_bbox() const = 0;
 
    virtual IParticle_volume_subset*                get_distributed_data_subset() = 0;
};
 
 
class IDistributed_compute_intersection_points :
    public mi::base::Interface_declare<0xd985cb6a,0xe5c2,0x4c40,0x95,0xe3,0x29,0xa7,0x22,0x3e,0x35,0x9f,
                                       mi::neuraylib::ISerializable>
{
public:
    virtual const mi::math::Vector_struct<mi::Float32, 3>* generate_intersection_points(
        mi::Uint32& nb_points) = 0;
};
 
class IDistributed_compute_destination_buffer_2d_texture :
    public mi::base::Interface_declare<0x1ea87c20,0xdae0,0x4b81,0xa3,0x16,0xa0,0x52,0x2d,0xf7,0xb4,0x3c,
                                       nv::index::IDistributed_compute_destination_buffer>
{
public:
    enum Buffer_layout
    {
        ONE_DIMENSIONAL_ARRAY = 0,  
        TWO_DIMENSIONAL_ARRAY = 1   
    };
 
    enum Buffer_format
    {
        FORMAT_INVALID          = 0x00,
        FORMAT_SCALAR_UINT8     = 0x01,        
        FORMAT_RGBA_UINT8       = 0x02,        
        FORMAT_RGBA_FLOAT32     = 0x03         
    };
 
    struct Buffer_config
    {
        Buffer_layout                           layout;         
        Buffer_format                           format;         
        mi::math::Bbox_struct<mi::Float32, 2>   covered_area;   
        mi::math::Vector_struct<mi::Uint32, 2>  resolution;     
    };
 
    virtual bool generate_buffer_storage(const Buffer_config& buffer_cfg) = 0;
 
    virtual const Buffer_config& get_buffer_config() const = 0;
 
    virtual mi::Uint8* get_buffer_storage() const = 0;
 
    virtual const IDistributed_data_subset* get_subregion_geometry_data() const = 0;
 
 
    virtual mi::math::Bbox_struct<mi::Float32, 2> get_surface_area() const = 0;
 
    virtual IDistributed_compute_intersection_points* get_intersection_points() const = 0;
};
 
class IDistributed_compute_destination_buffer_2d_texture_LOD_configuration :
    public mi::base::Interface_declare<0xfb33be9,0x8b65,0x400d,0xb3,0xfe,0xc2,0x3a,0x47,0x2d,0x4e,0xcf>
{
public:
    struct LOD_level_info
    {
        mi::math::Vector_struct<mi::Uint32, 2>  mip_level_image_resolution;     
        mi::math::Bbox_struct<mi::Uint32, 2>    mip_level_image_tile_bounds;    
        mi::Float32                             mip_level_selection_distance;   
    };
 
    virtual mi::Uint32 get_nb_mipmap_levels() const = 0;
    virtual void set_nb_mipmap_levels(mi::Uint32 nb_mipmaps) = 0;
 
    virtual LOD_level_info get_mip_level_info(mi::Uint32 mip_level) const = 0;
    virtual void set_mip_level_info(
        mi::Uint32            mip_level,
        const LOD_level_info& mip_level_info) = 0;
};
 
class IDistributed_compute_destination_buffer_2d_texture_LOD :
    public mi::base::Interface_declare<0xb25d2721,0xab95,0x450c,0x8d,0x64,0xd0,0xc5,0xd1,0xaa,0xac,0xca,
                                       nv::index::IDistributed_compute_destination_buffer>
{
public:
    enum Buffer_format
    {
        FORMAT_INVALID          = 0x00,
        FORMAT_SCALAR_UINT8     = 0x01,        
        FORMAT_RGBA_UINT8       = 0x02,        
        FORMAT_RGBA_FLOAT32     = 0x03         
    };
 
    virtual IDistributed_compute_destination_buffer_2d_texture_LOD_configuration* generate_LOD_configuration(
        const mi::math::Vector_struct<mi::Uint32, 2>& global_texture_resolution,
        const mi::math::Bbox_struct<mi::Float32, 2>&  texture_tile_surface_area,
        mi::Uint32                                    texture_tile_border) const = 0;
 
    virtual bool generate_LOD_buffer_storage(
        const IDistributed_compute_destination_buffer_2d_texture_LOD_configuration* lod_config,
        Buffer_format                                                               texture_buffer_format) = 0;
 
    virtual bool is_LOD_buffer_storage_initialized() const = 0;
 
    virtual const IDistributed_compute_destination_buffer_2d_texture_LOD_configuration* get_active_LOD_configuration() const = 0;
 
 
    virtual Buffer_format get_texture_buffer_format() const = 0;
 
    virtual void set_active_LOD_level_range(
        const mi::math::Vector_struct<mi::Uint32, 2>& lod_level_range) = 0;
 
    virtual mi::math::Vector_struct<mi::Uint32, 2>  get_active_LOD_level_range() const = 0;
 
    virtual void get_required_LOD_levels(
        mi::Uint32&  nb_required_levels,
        mi::Uint32*& required_levels) const = 0;
 
    virtual mi::Uint8* get_LOD_level_buffer_storage(
        mi::Uint32 lod_level) = 0;
 
    virtual const IDistributed_data_subset* get_subregion_geometry_data() const = 0;
 
    virtual mi::math::Bbox_struct<mi::Float32, 2> get_surface_area() const = 0;
};
 
class IDistributed_compute_destination_buffer_container :
    public mi::base::Interface_declare<0xdb6a75e3,0x86c0,0x494a,0xac,0xd9,0x4a,0xd9,0x68,0x56,0xb7,0x3c>
{
public:
    virtual mi::Uint32                                  get_nb_destination_buffers() const = 0;
    virtual IDistributed_compute_destination_buffer*    get_destination_buffer(mi::Uint32 buffer_idx) const = 0;
};
 
} // namespace index
} // namespace nv
 
#endif // NVIDIA_INDEX_IDISTRIBUTED_COMPUTE_DESTINATION_BUFFER_H