Skip to content

README

Introduction

Is KDGpu for me?

Have you ever wanted to be productive with Vulkan but can't get your head around the verbose syntax, managing object lifetimes, and the intricacies of just getting something working without drowning in synchronization and memory handling?

If the answer is yes, then KDGpu is the library for you!

KDGpu is a thin wrapper around Vulkan (and perhaps later other modern graphics APIs) with the aim of making modern graphics available to mortals and to massively reduce the amount of verbosity involved.

KDGpu also aims to make it easy to teach the concepts of modern graphics programming without having to be bogged down in the intricacies.

KDGpu is independent of any particular windowing system. You can use it purely with platform native APIs or you can checkout the included KDGpuExample library which makes it trivial to use KDGpu with KDGui::Window. Check out the handy KDBindings repository too for some more syntactic sugar.

More information can be found in the documentation.

What does KDGpu provide?

  • The KDGpu library
  • An example framework called KDGpuExample that provides integration with KDGui to make it easy to experiment. Let us take care of the boring bits so you can make pretty pictures.
  • A set of illustrative examples showing how to use KDGpu for common rendering tasks.

How do I get up and running with KDGpu?

  • Install the Vulkan SDK
  • Clone this repository
  • Open up the directory in VS Code with the CMakeTools extension loaded
  • Configure and Build - all of the dependencies will be pulled down via CMake's FetchContent feature (see cmake/dependencies.cmake)
  • Try running the examples

What does KDGpu code look like?

A typical render function for KDGPu looks something like this:

1
2
3
4
5
6
7
8
    auto opaquePass = commandRecorder.beginRenderPass(m_opaquePassOptions);
    opaquePass.setPipeline(m_pipeline);
    opaquePass.setVertexBuffer(0, m_buffer);
    opaquePass.setBindGroup(0, m_textureBindGroup);
    opaquePass.draw(DrawCommand{ .vertexCount = 4 });
    renderImGuiOverlay(&opaquePass);
    opaquePass.end();
    m_commandBuffer = commandRecorder.finish();

Creating GPU resources is just as easy and intuitive. Creating a Buffer that resides on the GPU and can be uploaded to and used as a vertex buffer is as simple as:

1
2
3
4
5
6
7
    const DeviceSize dataByteSize = vertexData.size() * sizeof(Vertex);
    BufferOptions bufferOptions = {
        .size = dataByteSize,
        .usage = BufferUsageFlagBits::VertexBufferBit | BufferUsageFlagBits::TransferDstBit,
        .memoryUsage = MemoryUsage::GpuOnly
    };
    m_buffer = m_device.createBuffer(bufferOptions);

This pattern of usings options structs and initializing them with C++20 designated initializers permeates through the API. It makes it easily discoverable, extensible and trivial to queue up for deferred invocations.

Uploading data to the above buffer is just as easy:

1
2
3
4
5
6
7
8
    const BufferUploadOptions uploadOptions = {
        .destinationBuffer = m_buffer,
        .dstStages = PipelineStageFlagBit::VertexAttributeInputBit,
        .dstMask = AccessFlagBit::VertexAttributeReadBit,
        .data = vertexData.data(),
        .byteSize = dataByteSize
    };
    m_queue.uploadBufferData(uploadOptions);

Contact

Stay up-to-date with KDAB product announcements:

Licensing

KDGpu is (C) 2022-2023, Klarälvdalens Datakonsult AB, and is available under the terms of the MIT license.

Contact KDAB at info@kdab.com if you need different licensing options.

KDGpu includes these source files, also available under the terms of the MIT license:

doctest.h - the lightest feature-rich C++ single-header testing framework for unit tests and TDD (C) 2016-2021 Viktor Kirilov vik.kirilov@gmail.com

Get Involved

Please submit your contributions or issue reports from our GitHub space at https://github.com/KDAB/KDGpu.

Contact info@kdab.com for more information.

About KDAB

KDGpu is supported and maintained by Klarälvdalens Datakonsult AB (KDAB).

The KDAB Group is the global No.1 software consultancy for Qt, C++ and OpenGL applications across desktop, embedded and mobile platforms.

The KDAB Group provides consulting and mentoring for developing Qt applications from scratch and in porting from all popular and legacy frameworks to Qt. We continue to help develop parts of Qt and are one of the major contributors to the Qt Project. We can give advanced or standard trainings anywhere around the globe on Qt as well as C++, OpenGL, 3D and more.

Please visit https://www.kdab.com to meet the people who write code like this.