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 버전을 반환하거나 setApiVersion()가 create() 이전에 호출되지 않은 경우 null 버전 번호를 반환합니다.

setApiVersion()도 참조하세요 .

[since 6.5] void QVulkanInstance::clearDebugOutputFilters()

installDebugOutputFilter()에 의해 이전에 설치된 모든 필터 기능을 제거합니다.

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

installDebugOutputFilter()도 참조하십시오 .

bool QVulkanInstance::create()

벌칸 라이브러리를 초기화하고 새 벌칸 인스턴스 또는 기존 벌칸 인스턴스를 생성합니다.

성공하면 참을 반환하고, 오류가 발생하거나 Vulkan이 지원되지 않으면 거짓을 반환합니다.

성공하면 vkInstance()를 통해 이 QVulkanInstance 포인터를 검색할 수 있습니다.

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

기본적으로 VkInstance는 플래그 VK_INSTANCE_CREATE_ENUMERATE_PORTABILITY_BIT_KHR이 설정된 상태로 생성됩니다. 즉, 벌칸 포터빌리티 물리적 디바이스도 열거됩니다. 이를 원하지 않는 경우 NoPortabilityDrivers 플래그를 설정하세요.

void QVulkanInstance::destroy()

기본 플랫폼 인스턴스를 파괴하여 (소유하고 있는 경우) VkInstance를 파괴합니다. QVulkanInstance 객체는 create()을 다시 호출하여 계속 재사용할 수 있습니다.

QVulkanDeviceFunctions *QVulkanInstance::deviceFunctions(VkDevice device)

디바이스 수준의 핵심 Vulkan 명령 집합을 노출하고 플랫폼 간 작동이 보장되는 QVulkanDeviceFunctions 객체를 반환합니다.

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

functions() 및 resetDeviceFunctions()도 참조하세요 .

VkResult QVulkanInstance::errorCode() const

실패한 경우 create(), 그렇지 않으면 VK_SUCCESS 을 반환합니다.

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

QByteArrayList QVulkanInstance::extensions() const

create()가 호출되어 성공한 경우 활성화된 인스턴스 확장을 반환합니다. 그렇지 않으면 요청된 확장을 반환합니다.

setExtensions()도 참조하세요 .

QVulkanInstance::Flags QVulkanInstance::flags() const

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

setFlags()도 참조하세요 .

QVulkanFunctions *QVulkanInstance::functions() const

디바이스 수준 기능을 제외한 핵심 벌칸 명령 집합을 노출하고 플랫폼 간 작동이 보장되는 해당 QVulkanFunctions 객체를 반환합니다.

핵심 Vulkan 1.0 API의 함수는 항상 사용할 수 있습니다. 1.1 및 1.2와 같은 상위 버전의 경우 QVulkanFunctions 객체는 해당 버전에 대한 핵심 API 함수도 해결하려고 시도하지만 런타임에 Vulkan 인스턴스 구현이 해당 함수를 지원하지 않는 경우 지원되지 않는 함수를 호출하면 지정되지 않은 동작이 발생할 수 있습니다. 또한 1.0 이상의 Vulkan 버전을 제대로 지원하려면 create() 앞에 setApiVersion()를 호출하여 적절한 인스턴스 API 버전을 설정해야 할 수 있습니다. 벌칸 구현의 인스턴스 수준 버전을 쿼리하려면 supportedApiVersion()를 호출하세요.

deviceFunctions() 및 supportedApiVersion()도 참조하세요 .

PFN_vkVoidFunction QVulkanInstance::getInstanceProcAddr(const char *name)

주어진 name 으로 Vulkan 함수를 확인합니다.

핵심 벌칸 명령의 경우 functions() 및 deviceFunctions()에서 검색 가능한 함수 래퍼를 대신 사용하는 것을 선호합니다.

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

모든 벌칸 디버그 메시지에 대해 호출되는 filter 함수를 설치합니다. 콜백이 true 을 반환하면 메시지가 중지(필터링)되고 디버그 출력에 표시되지 않습니다.

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

clearDebugOutputFilters()도 참조하세요 .

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

이 함수는 오버로드된 함수입니다.

모든 벌칸 디버그 메시지에 대해 호출되는 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에 매핑됩니다.

애플리케이션 개발자는 벌칸 사양의 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 핸들을 채택하도록 합니다.

vkInstance()도 참조하세요 .

QVersionNumber QVulkanInstance::supportedApiVersion() const

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

실제로 이 값은 해당 함수를 사용할 수 있는 경우(Vulkan 1.1 이상에서) vkEnumerateInstanceVersion에서 반환되는 값 또는 1.0입니다.

런타임에 사용 가능한 벌칸 버전에 따라 벌칸 기능 및 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 핸들을 생성하거나 검색합니다.

불칸 서피스 핸들을 반환하거나 실패하면 0을 반환합니다.

VkInstance QVulkanInstance::vkInstance() const

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

setVkInstance()도 참조하세요 .