RV_Instance.h

Go to the documentation of this file.

/*
 * PROPRIETARY INFORMATION.  This software is proprietary to
 * Side Effects Software Inc., and is not to be reproduced,
 * transmitted, or disclosed in any way without written permission.
 *
 * NAME:        RV_Instance.h ( RV Library, C++)
 *
 * COMMENTS:
 *      Main interface to Vulkan
 */
#ifndef RV_Instance_h
#define RV_Instance_h

#include "RV_API.h"

#include "RV_Type.h"

#include <VE/VE_VK.h>

#include <UT/UT_Array.h>
#include <UT/UT_UniquePtr.h>

#include <VE/VE_PhysicalDeviceFeatures.h>

class rv_InstanceData;

class RV_DescriptorAllocator;
class RV_Render;
class RV_VKQueue;
class RV_VKCommandPool;
class RV_VKCommandBuffer;
class RV_VKCommandBufferAllocator;
class RV_VKExt;
class RV_VKMemAllocator;
class UT_WorkBuffer;

/// Handle to the main interface of Vulkan
class RV_API RV_Instance
{
public:
    /// The global vulkan instance, creating it if it hasn't been created yet.
    static RV_Instance* getInstance();
    /// Returns whether the global vulkan instance exists
    static bool         hasInstance();
    /// Destroy the global instance. For system exit.
    static void         destroyInstance();
    /// The exit callback that's called when the vulkan instance is about to be
    /// destroyed.
    static void         exitCallback(void*);

    /// Create the global vulkan instance. Used only at startup.
    static RV_Instance* create();
    
    ~RV_Instance();

    /// Set up Vulkan once the instance is created
    bool                initializeDevice();

    /// Get the raw vulkan device assocated with this instance.
    VkDevice            getDevice();
    /// Get the raw vulkan physical device assocated with this instance.
    VkPhysicalDevice    getPhysicalDevice();
    /// Get the raw vulkan instance.
    VkInstance          getVkInst();

    /// Raw Vulkan memory properties of the physical device
    const VkPhysicalDeviceMemoryProperties* getMemoryProps() const;

    /// Main Queue supporting graphics, compute and transfer
    RV_VKQueue&              getGraphicsQueue() { return *myGraphicsQueue; }
    /// Our Vulkan memory allocator implementation
    RV_VKMemAllocator&       getMemAllocator() { return *myAllocator; }
    /// Our Vulkan descriptor set allocator
    RV_DescriptorAllocator&  getDescAllocator(){return *myDescriptorAllocator;}

    /// Get text information about the current driver and device
    void                     fetchDriverInfo(UT_WorkBuffer &info);

    static uint32_t     getInstanceVersion();

    /// The Vulkan version as implemented by the device driver
    uint32_t            getDeviceVersion();
    /// The vendor of the device (AMD, Intel, NVidia, MoltenVK)
    RV_GraphicsDevice   getDeviceVendor() const;

    /// True if the debug validation layers are active
    static bool         usingDebugValidation();

    /// True if Vulkan multithreading env var is set to true
    static bool         usingVulkanMultithreading();

    /// Maximum supported number of color samples in a multisample framebuffer
    int                 getMaxColorSamples() const;

    /// Maximum supported number of depth samples in a multisample framebuffer
    int                 getMaxDepthSamples() const;

    /// Maximum size of 2D texture
    int                 getMaxTextureSize2D() const;

    /// Maximum size of 3D texture
    int                 getMaxTextureSize3D() const;

    /// Granularity of Line width setting
    float               getLineWidthGranularity() const;

    /// Object containing function pointers to Vulkan extensions
    RV_VKExt*           getExt() { return myExtensions.get(); }

    /// Query if the given Vulkan extension is enabled in the device
    bool                extEnabled( const char* vk_ext_name ) const;

    /// Block until the device has finished all commands (Call with care!)
    void                 waitDeviceIdle();

    /// Returns the physical device features that have been enabled on our
    /// device
    const VE_PhysicalDeviceFeatures &getPhysicalDeviceFeatures() const;

private:
    RV_Instance();


    UT_UniquePtr<rv_InstanceData> myInstance;
    UT_UniquePtr<RV_VKMemAllocator> myAllocator;
    UT_UniquePtr<RV_DescriptorAllocator> myDescriptorAllocator;
    UT_UniquePtr<RV_VKQueue> myGraphicsQueue;

    UT_UniquePtr<RV_VKExt> myExtensions;

    VE_PhysicalDeviceFeatures myEnabledDeviceFeatures;
    UT_Array<const char*> myEnabledDevExtensions;
    UT_Array<const char*> myEnabledInstExtensions;
};

#endif