QVulkanInstance Class

    int main(int argc, char **argv)
    {
        QGuiApplication app(argc, argv);

        QVulkanInstance inst;
        if (!inst.create())
            return 1;

        // ...
        window->setVulkanInstance(&inst);
        window->show();

        return app.exec();
    }

    QVulkanInstance inst;

    // Enable validation layer, if supported. Messages go to qDebug by default.
    inst.setLayers({ "VK_LAYER_KHRONOS_validation" });

    bool ok = inst.create();
    if (!ok) {
        // ... Vulkan not available
    }

    if (!inst.layers().contains("VK_LAYER_KHRONOS_validation")) {
        // ... validation layer not available
    }

    QVulkanInstance inst;

    if (inst.supportedLayers().contains("VK_LAYER_KHRONOS_validation")) {
        // ...
    }
    bool ok = inst.create();
    // ...

class VulkanWindow : public QWindow
{
public:
    VulkanWindow() {
        setSurfaceType(VulkanSurface);
    }

    void exposeEvent(QExposeEvent*) {
        if (isExposed()) {
            if (!m_initialized) {
                m_initialized = true;
                // 디바이스, 스왑체인 등을 초기화합니다.
                QVulkanInstance*inst = vulkanInstance();
                QVulkanFunctions*f = inst->functions();
                uint32_t devCount = 0;
                f->vkEnumeratePhysicalDevices(inst->vkInstance(), &devCount, nullptr);
                // ...
               // 첫 번째 프레임 생성
                render();
            }
        }
    }

    bool event(QEvent*e) {
        if (e->type()== QEvent::UpdateRequest)
            render();
        return QWindow::event(e);
    }

   void render() {
       // ...
       requestUpdate(); // 지속적으로 렌더링
    }

private:
    bool m_initialized = false;
};

int main(int argc, char**argv)
{
    QGuiApplication app(argc, argv);

    QVulkanInstance inst;
    if (!inst.create()) {
        qWarning("Vulkan not available");
       return 1;
    }

    VulkanWindow window;
    window.showMaximized();

    return app.exec();

}

bool myDebugFilter(VkDebugReportFlagsEXT flags, VkDebugReportObjectTypeEXT objectType, uint64_t object,
                   size_t location, int32_t messageCode, const char *pLayerPrefix, const char *pMessage)

std::function<bool(DebugMessageSeverityFlags severity, DebugMessageTypeFlags type, const void *message)>;

멤버 함수 문서

QVulkanInstance::QVulkanInstance()

새로운 인스턴스를 생성합니다.

[noexcept] QVulkanInstance::~QVulkanInstance()

소멸자.

QVersionNumber QVulkanInstance::apiVersion() const

애플리케이션이 실행될 것으로 예상하는 요청된 Vulkan API 버전을 반환하거나, create() 호출 전에 setApiVersion()이 호출되지 않은 경우 null 버전 번호를 반환합니다.

setApiVersion()도 참조하십시오 .

[since 6.5] void QVulkanInstance::clearDebugOutputFilters()

installDebugOutputFilter() 함수를 통해 이전에 설치된 모든 필터 함수를 제거합니다.

이 함수는 Qt 6.5에서 도입되었습니다.

installDebugOutputFilter()도 참조하십시오 .

bool QVulkanInstance::create()

Vulkan 라이브러리를 초기화하고, 새로운 Vulkan 인스턴스를 생성하거나 기존 인스턴스를 채택합니다.

성공하면 true를 반환하고, 오류가 발생하거나 Vulkan이 지원되지 않을 경우 false를 반환합니다.

성공 시, vkInstance()를 통해 이 QVulkanInstance 에 대한 포인터를 가져올 수 있습니다.

이 ` QVulkanInstance `가 존재하는 동안, 또는 ` destroy()`가 호출될 때까지 Vulkan 인스턴스와 라이브러리를 사용할 수 있습니다.

기본적으로 VkInstance는 VK_INSTANCE_CREATE_ENUMERATE_PORTABILITY_BIT_KHR 플래그가 설정된 상태로 생성됩니다. 이는 Vulkan Portability 물리 장치도 함께 열거됨을 의미합니다. 이를 원하지 않는 경우, NoPortabilityDrivers 플래그를 설정하십시오.

void QVulkanInstance::destroy()

기본 플랫폼 인스턴스를 삭제하며, 이에 따라 VkInstance도 삭제됩니다(소유 중인 경우). QVulkanInstance 객체는 create()을 다시 호출하여 재사용할 수 있습니다.

QVulkanDeviceFunctions *QVulkanInstance::deviceFunctions(VkDevice device)

장치 수준의 핵심 Vulkan 명령어 세트를 노출하며, 크로스 플랫폼에서 정상 작동이 보장되는 QVulkanDeviceFunctions 객체를 반환합니다.

Vulkan 1.0 핵심 API의 함수들은 항상 사용할 수 있습니다. 1.1 및 1.2와 같은 더 높은 버전의 Vulkan의 경우, QVulkanDeviceFunctions 객체는 해당 버전에 대한 핵심 API 함수도 해결하려고 시도하지만, 실행 시점에 Vulkan 물리 장치가 이를 지원하지 않는다면, 지원되지 않는 함수를 호출하면 정의되지 않은 동작이 발생할 수 있습니다. Vulkan 1.0보다 높은 버전에 대한 지원을 올바르게 활성화하려면, create()를 호출하기 전에 setApiVersion()를 호출하여 적절한 인스턴스 API 버전을 설정해야 할 수 있습니다. 또한, 애플리케이션은 VkPhysicalDeviceProperties에서 물리적 장치의 apiVersion 를 확인해야 합니다.

functions() 및 resetDeviceFunctions()도 참조하십시오 .

VkResult QVulkanInstance::errorCode() const

create() 호출이 실패한 경우 Vulkan 오류 코드를 반환하며, 그렇지 않은 경우 VK_SUCCESS 를 반환합니다.

이 값은 일반적으로 vkCreateInstance()의 반환값입니다(기존 인스턴스를 채택하는 대신 새로운 Vulkan 인스턴스를 생성하는 경우). 단, 플랫폼 플러그인이 Vulkan을 지원하지 않는 경우에는 VK_NOT_READY 가 반환될 수도 있습니다.

QByteArrayList QVulkanInstance::extensions() const

create()가 호출되어 성공적으로 완료된 경우, 활성화된 인스턴스 확장 기능을 반환합니다. 그렇지 않은 경우 요청된 확장 기능을 반환합니다.

setExtensions()도 참조하십시오 .

QVulkanInstance::Flags QVulkanInstance::flags() const

요청된 플래그를 반환합니다.

setFlags()도 참조하십시오 .

QVulkanFunctions *QVulkanInstance::functions() const

디바이스 수준 함수를 제외한 핵심 Vulkan 명령어 세트를 노출하며, 크로스 플랫폼에서 정상 작동이 보장되는 해당 ` QVulkanFunctions ` 객체를 반환합니다.

Vulkan 1.0 핵심 API의 함수는 항상 사용할 수 있습니다. 1.1 및 1.2와 같은 더 높은 버전의 Vulkan의 경우, ` QVulkanFunctions ` 객체는 해당 버전에 대한 핵심 API 함수도 해결하려고 시도하지만, 런타임 시 Vulkan 인스턴스 구현이 이를 지원하지 않는다면, 지원되지 않는 함수를 호출하면 정의되지 않은 동작이 발생합니다. 또한, 1.0보다 높은 버전의 Vulkan에 대한 지원을 올바르게 활성화하려면, ` create()`를 호출하기 전에 ` setApiVersion()`를 호출하여 적절한 인스턴스 API 버전을 설정해야 할 수도 있습니다. Vulkan 구현의 인스턴스 수준 버전을 조회하려면 ` supportedApiVersion()`를 호출하십시오.

deviceFunctions() 및 supportedApiVersion()도 참조하십시오 .

PFN_vkVoidFunction QVulkanInstance::getInstanceProcAddr(const char *name)

지정된 name 를 사용하여 Vulkan 함수를 해결합니다.

핵심 Vulkan 명령어의 경우, 대신 functions() 및 deviceFunctions()에서 제공되는 함수 래퍼를 사용하는 것이 좋습니다.

[since 6.5] void QVulkanInstance::installDebugOutputFilter(QVulkanInstance::DebugUtilsFilter filter)

모든 Vulkan 디버그 메시지가 발생할 때마다 호출되는 filter 함수를 등록합니다. 콜백이 true 를 반환하면 해당 메시지는 차단(필터링)되어 디버그 출력에 표시되지 않습니다.

이 함수는 Qt 6.5에서 도입되었습니다.

clearDebugOutputFilters()도 참조하십시오 .

void QVulkanInstance::installDebugOutputFilter(QVulkanInstance::DebugFilter filter)

모든 Vulkan 디버그 메시지가 발생할 때마다 호출되는 ` filter ` 함수를 등록합니다. 콜백이 ` true`를 반환하면 해당 메시지는 차단(필터링)되어 디버그 출력에 표시되지 않습니다.

removeDebugOutputFilter()도 참조하십시오 .

bool QVulkanInstance::isValid() const

create() 호출이 성공했고 인스턴스가 유효한 경우 true를 반환합니다.

QByteArrayList QVulkanInstance::layers() const

create()가 호출되어 성공적으로 완료된 경우, 활성화된 인스턴스 레이어를 반환합니다. 그렇지 않은 경우 요청된 레이어를 반환합니다.

setLayers()도 참조하십시오 .

void QVulkanInstance::presentAboutToBeQueued(QWindow *window)

이 함수는 애플리케이션의 렌더러가 window 에 대한 프리젠트 작업을 큐에 넣기 전에 호출해야 합니다.

일부 플랫폼에서는 이 함수가 아무런 작업도 수행하지 않지만, 일부 플랫폼에서는 윈도우 시스템에 따라 동기화 작업을 수행할 수 있습니다. 예를 들어, Wayland에서는 드라이버가 최소화된 창으로 인해 차단되는 것을 방지하기 위해 wl_surface.frame 요청을 전송합니다.

void QVulkanInstance::presentQueued(QWindow *window)

이 함수는 애플리케이션의 렌더러가 window 에 대한 프리젠트 작업을 큐에 넣은 후에 호출해야 합니다.

일부 플랫폼에서는 이 함수가 아무런 작업도 수행하지 않지만, 일부 플랫폼에서는 윈도우 시스템에 따라 동기화 작업을 수행할 수도 있습니다. 예를 들어, X11 환경에서는 이 함수가 ` _NET_WM_SYNC_REQUEST_COUNTER`를 업데이트합니다.

void QVulkanInstance::removeDebugOutputFilter(QVulkanInstance::DebugFilter filter)

installDebugOutputFilter() 함수를 통해 이전에 설치된 ‘ filter ’ 함수를 제거합니다.

installDebugOutputFilter()도 참조하십시오 .

void QVulkanInstance::resetDeviceFunctions(VkDevice device)

지정된 device 에 대한 QVulkanDeviceFunctions 객체를 무효화하고 파괴합니다.

deviceFunctions()가 호출된 VkDevice가 소멸될 때, 애플리케이션이 계속 실행될 예정이며 추후 새로운 논리적 Vulkan 장치를 생성할 가능성이 있는 경우 이 함수를 호출해야 합니다.

QVulkanInstance 를 소멸시키기 전에 이 함수를 호출할 필요는 없으며, 이 경우 정리 작업이 자동으로 수행됩니다.

deviceFunctions()도 참조하십시오 .

void QVulkanInstance::setApiVersion(const QVersionNumber &vulkanVersion)

애플리케이션이 사용하도록 설계된 Vulkan API의 최고 버전을 지정합니다.

기본적으로 ` vulkanVersion `의 값은 0이며, 이는 Vulkan 1.0에 해당합니다.

애플리케이션 개발자는 Vulkan 사양서의 apiVersion 관련 설명을 숙지할 것을 권장합니다.

apiVersion() 및 supportedApiVersion()도 참조하십시오 .

void QVulkanInstance::setExtensions(const QByteArrayList &extensions)

활성화할 추가 인스턴스 extensions 목록을 지정합니다. 지원되지 않는 확장 기능을 지정해도 안전합니다. 실행 시 지원되지 않는 경우 해당 항목은 무시되기 때문입니다.

extensions()도 참조하십시오 .

void QVulkanInstance::setFlags(QVulkanInstance::Flags flags)

flags 에 따라 create()의 동작을 설정합니다.

flags()도 참조하십시오 .

void QVulkanInstance::setLayers(const QByteArrayList &layers)

활성화할 인스턴스 layers 목록을 지정합니다. 지원되지 않는 레이어를 지정해도 안전합니다. 실행 시 지원되지 않는 레이어는 무시되기 때문입니다.

layers()도 참조하십시오 .

void QVulkanInstance::setVkInstance(VkInstance existingVkInstance)

QVulkanInstance 가 새로운 VkInstance 핸들을 생성하는 대신 기존 핸들을 사용하도록 합니다.

Qt는 이미 생성된 VkInstance에서 레이어와 확장을 활성화할 수 있는 방법이 없습니다. 따라서 existingVkInstance 가 Qt와 함께 사용하기에 적합한지 확인하는 것은 호출자의 책임입니다. QRhi 기반 렌더링이 포함된 경우, QRhiVulkanInitParams::preferredInstanceExtensions()를 호출하여 위에서 언급한 확장 기능 외에도 existingVkInstance 의 생성자가 활성화해야 할 추가 인스턴스 확장 기능 목록을 조회하십시오. 단, 이러한 확장 기능은 런타임 시 시스템에서 사용 가능하고 지원되어야 합니다.

참조: vkInstance().

QVersionNumber QVulkanInstance::supportedApiVersion() const

Vulkan 구현체에서 지원하는 인스턴스 수준 기능의 버전을 반환합니다.

실제로는 해당 함수가 사용 가능한 경우(Vulkan 1.1 이상) vkEnumerateInstanceVersion에서 반환된 값이 되거나, 그렇지 않은 경우 1.0이 반환됩니다.

실행 시점에 사용 가능한 Vulkan 버전에 따라 Vulkan 기능 및 API 사용을 분기 처리하려는 애플리케이션은, 이 함수를 사용하여 create()을 호출하기 전에 setApiVersion()에 전달할 버전을 결정할 수 있습니다.

setApiVersion()도 참조하십시오 .

QVulkanInfoVector<QVulkanExtension> QVulkanInstance::supportedExtensions() const

지원되는 인스턴스 수준 확장 기능의 목록을 반환합니다.

QVulkanInfoVector<QVulkanLayer> QVulkanInstance::supportedLayers() const

지원되는 인스턴스 수준 레이어 목록을 반환합니다.

bool QVulkanInstance::supportsPresent(VkPhysicalDevice physicalDevice, uint32_t queueFamilyIndex, QWindow *window)

physicalDevice 내의 queueFamilyIndex 를 가진 큐 패밀리가 window 로의 프레젠테이션을 지원하는 경우 true를 반환합니다.

프레젠테이션 수행에 사용할 수 있는 큐를 결정하기 위해, 주어진 Vulkan 장치의 큐를 검사할 때 이 함수를 호출하십시오.

[static] VkSurfaceKHR QVulkanInstance::surfaceForWindow(QWindow *window)

지정된 window 에 대한 VkSurfaceKHR 핸들을 생성하거나 이미 존재하는 경우 이를 가져옵니다.

Vulkan 표면 핸들을 반환하며, 실패 시 0을 반환합니다.

VkInstance QVulkanInstance::vkInstance() const

QVulkanInstance 가 래핑하는 VkInstance 핸들을 반환하거나, create()가 아직 성공적으로 호출되지 않았고 setVkInstance()를 통해 기존 인스턴스가 제공되지 않은 경우에는 nullptr 를 반환합니다.

setVkInstance()도 참조하십시오 .