Vulkan Bootstrapping Iibrary
Go to file
2020-03-07 17:19:58 -07:00
example Refactor of queue selection and getting 2020-03-07 17:02:01 -07:00
ext Got vk-bootstrap compiling on Windows and fixed class/struct inconsistency 2020-02-27 20:58:38 -07:00
src Ammended readme and moved around code for better readability 2020-03-07 17:19:58 -07:00
tests Renamed many InstanceBuilder functions, added SystemInfo struct. 2020-03-07 01:46:25 -07:00
.clang-format modified clang format again 2020-02-06 17:42:10 -07:00
.gitignore First commit of Vk-Bootstrap 2020-01-30 01:20:18 -07:00
.gitmodules Added glfw as git submodule + Catch2 2020-01-30 01:47:41 -07:00
CMakeLists.txt Renamed many InstanceBuilder functions, added SystemInfo struct. 2020-03-07 01:46:25 -07:00
LICENSE.txt moved triangle.cpp to its own folder, updated readme & license 2020-02-03 20:34:46 -07:00
README.md Ammended readme and moved around code for better readability 2020-03-07 17:19:58 -07:00

Vk-Bootstrap

A Vulkan utility library meant to jump start any Vulkan Application

This library simplifies the tedious process of:

  • Instance Creation
  • Picking a Physical Device
  • Device Creation
  • Getting Queues
  • Swapchain Creation

It also adds several conveniences for:

  • enabling validation layers
  • setting up a debug callback
  • select a gpu based on a set of common criteria like features, extensions, memory, etc.

Example


#include "VkBootstrap.h"

void init_vulkan()
{
    vkb::InstanceBuilder builder;
    builder.request_validation_layers()
           .set_app_name ("Example Vulkan Application")
           .use_default_debug_messenger ();
    auto inst_ret = builder.build();
    if (!inst_ret.has_value()) {
        // error
    }
    vkb::Instance vkb_inst = inst_ret.value();

    vkb::PhysicalDeviceSelector selector{ inst };
    selector.set_surface (/* from user created window*/)
            .set_minimum_version (1, 1) //require a vulkan 1.1 capable device
            .require_dedicated_transfer_queue();
    auto phys_ret = selector.select ();
    if (!phys_ret.has_value()) {
        // error
    }

    vkb::DeviceBuilder device_builder{ phys_ret.value() };
    auto dev_ret = device_builder.build ();
    if (!dev_ret.has_value()){
        // error
    }
    vkb::Device dev = dev_ret.value();

    // Get the VkDevice handle used in the rest of a vulkan application
    VkDevice device = dev.device;

    // Get the graphics queue with a helper function
    auto graphics_queue_ret = dev.get_queue(vkb::QueueType::graphics);
    if (!graphics_queue_ret.has_value()){
        // error
    }
    VkQueue graphics_queue = graphics_queue_ret.value();

    // Turned 400-500 lines of boilerplate into less than fifty.
}

See example/triangle.cpp for an example that renders a triangle to the screen.

Setting up vk-bootstrap

Simple

This library has no external dependencies. Simply copy the src/VkBootstrap.h and src/VkBootstrap.cpp files into your project and compile them as you normally would

With git-submodule + CMake

Add this project as a git-submodule

git submodule add https://github.com/charles-lunarg/vk-bootstrap

With CMake, add the project as a subdirectory

add_subdirectory(vk-bootstrap)

target_link_libraries(your_application_name vk-bootstrap)

Manually Building

git clone https://github.com/charles-lunarg/vk-bootstrap
cd vk-bootstrap
mkdir build
cd build
cmake ..

Testing

To test, glfw and Catch2 are automatically included using git submodules.

In the project directory, run the following to get the required dependencies to test.

git submodule update --init

In the build directory, enable tests by adding -DVK_BOOTSTRAP_TEST to the cmake command line arguments

cmake ../path/to/vk-bootstrap/ -DVK_BOOTSTRAP_TEST=ON

Todo's

  • Package library to be usable
  • More examples
  • Testing
  • Documenting API