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();
    // ...

classVulkanWindow :publicQWindow
{public: VulkanWindow() { setSurfaceType(VulkanSurface); }voidexposeEvent()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(); } } }boolevent(QEvent*e) {if(e->type()== ::UpdateRequest) QEvent::UpdateRequest) render();returnQWindow::event(e); }voidrender() {// ...requestUpdate();// 継続的にレンダリングする}private:boolm_initialized= false; };intmain(intargc, char **argv) { app(argc, argv) {...requestUpdate();// 継続的にレンダリングする。    QGuiApplicationapp(argc,argv)；    QVulkanInstanceもし(!inst.create())なら{。        qWarning("Vulkan not available");
       return 1; } VulkanWindow window; window.showMaximized();returnapp.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

create() の前にsetApiVersion() が呼び出されていない場合は、NULL バージョン番号を返します。

setApiVersion()も参照してください 。

[since 6.5] void QVulkanInstance::clearDebugOutputFilters()

installDebugOutputFilter() によって以前にインストールされたすべてのフィルター関数を削除する。

この関数は Qt 6.5 で導入されました。

installDebugOutputFilter()も参照してください 。

bool QVulkanInstance::create()

Vulkanライブラリを初期化し、新しいVulkanインスタンスを作成するか、既存のVulkanインスタンスを採用します。

成功した場合はtrueを返し、エラー時またはVulkanがサポートされていない場合はfalseを返します。

成功した場合、このQVulkanInstance へのポインタはvkInstance() を介して取得可能です。

このQVulkanInstance が存在する限り、またはdestroy() が呼び出されるまで、Vulkan インスタンスとライブラリは利用可能です。

デフォルトでは、VkInstanceはフラグVK_INSTANCE_CREATE_ENUMERATE_PORTABILITY_BIT_KHRが設定された状態で作成されます。これは、Vulkan Portability物理デバイスも列挙されることを意味します。これを望まない場合は、NoPortabilityDrivers フラグを設定します。

void QVulkanInstance::destroy()

基盤となるプラットフォームのインスタンスを破棄し、VkInstance（所有されている場合）を破棄します。create() を再度呼び出すことで、QVulkanInstance オブジェクトはまだ再利用可能です。

QVulkanDeviceFunctions *QVulkanInstance::deviceFunctions(VkDevice device)

デバイスレベルのコア Vulkan コマンドセットを公開し、クロスプラットフォームで機能することが保証されているQVulkanDeviceFunctions オブジェクトを返します。

コアVulkan 1.0 APIからの関数は常に利用可能です。1.1や1.2のような、より高いVulkanバージョンになると、QVulkanDeviceFunctions オブジェクトはそれらのコアAPI関数も解決しようとしますが、実行時のVulkan物理デバイスがそれらをサポートしていない場合、そのようなサポートされていない関数を呼び出すと、指定されていない動作になります。1.0より高いVulkanバージョンのサポートを適切に有効にするには、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

対応するQVulkanFunctions オブジェクトを返します。このオブジェクトは、デバイスレベル関数を除く、コア Vulkan コマンドセットを公開し、クロスプラットフォームでの動作が保証されています。

コア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() が成功し、インスタンスが有効であれば真を返す。

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ハンドルを作成する代わりに、既存のVkInstanceハンドルを採用する。

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()も参照してください 。