Qt GUIにおけるQVulkanInstance::installDebugOutputFilter()のサンプルコード

Qt GUIにおけるQVulkanInstance::installDebugOutputFilter()の詳細解説

QVulkanInstance::installDebugOutputFilter()は、Qt GUIアプリケーションでVulkan APIのデバッグ出力フィルタリングを有効にするための関数です。この関数は、Vulkan APIからのデバッグメッセージをフィルタリングし、特定の種類のメッセージのみを出力するように設定できます。

使用方法

QVulkanInstance::installDebugOutputFilter()を使用するには、以下の手順が必要です。

1. QVulkanInstanceオブジェクトを作成します。
2. QVulkanDebugOutputFilterオブジェクトを作成します。
3. デバッグメッセージの出力レベルを設定します。
4. QVulkanInstance::installDebugOutputFilter()関数を呼び出し、QVulkanDebugOutputFilterオブジェクトを渡します。

例

// Qt GUIアプリケーションでVulkan APIのデバッグ出力フィルタリングを有効にする例

#include <QtVulkan>

int main() {
  // QVulkanInstanceオブジェクトを作成します
  QVulkanInstance instance;

  // QVulkanDebugOutputFilterオブジェクトを作成します
  QVulkanDebugOutputFilter filter;

  // デバッグメッセージの出力レベルを設定します
  filter.setVerbosity(QVulkanDebugOutputFilter::Verbose);

  // デバッグメッセージの出力フィルタを設定します
  filter.setFilterFlags(QVulkanDebugOutputFilter::All);

  // QVulkanInstance::installDebugOutputFilter()関数を呼び出し、QVulkanDebugOutputFilterオブジェクトを渡します
  instance.installDebugOutputFilter(&filter);

  // ...

  return 0;
}

出力レベル

QVulkanDebugOutputFilterオブジェクトには、以下の出力レベルが定義されています。

• QVulkanDebugOutputFilter::Fatal：致命的エラーメッセージのみを出力します。
• QVulkanDebugOutputFilter::Verbose：すべてのメッセージを出力します。

出力フィルタ

QVulkanDebugOutputFilterオブジェクトには、以下の出力フィルタが定義されています。

• QVulkanDebugOutputFilter::Api：Vulkan APIからのメッセージのみを出力します。
• QVulkanDebugOutputFilter::Application：アプリケーションからのメッセージのみを出力します。

補足

• QVulkanInstance::installDebugOutputFilter()関数は、Qt 5.14以降で利用可能です。
• デバッグ出力フィルタリングは、開発時のみ有効にすることをおすすめします。

Qt GUIにおけるQVulkanInstance::installDebugOutputFilter()のサンプルコード

すべてのメッセージを出力する

#include <QtVulkan>

int main() {
  QVulkanInstance instance;
  QVulkanDebugOutputFilter filter;

  filter.setVerbosity(QVulkanDebugOutputFilter::Verbose);
  filter.setFilterFlags(QVulkanDebugOutputFilter::All);

  instance.installDebugOutputFilter(&filter);

  // ...

  return 0;
}

エラーメッセージのみを出力する

#include <QtVulkan>

int main() {
  QVulkanInstance instance;
  QVulkanDebugOutputFilter filter;

  filter.setVerbosity(QVulkanDebugOutputFilter::Error);
  filter.setFilterFlags(QVulkanDebugOutputFilter::All);

  instance.installDebugOutputFilter(&filter);

  // ...

  return 0;
}

Vulkan APIからのメッセージのみを出力する

#include <QtVulkan>

int main() {
  QVulkanInstance instance;
  QVulkanDebugOutputFilter filter;

  filter.setVerbosity(QVulkanDebugOutputFilter::Verbose);
  filter.setFilterFlags(QVulkanDebugOutputFilter::Api);

  instance.installDebugOutputFilter(&filter);

  // ...

  return 0;
}

アプリケーションからのメッセージのみを出力する

#include <QtVulkan>

int main() {
  QVulkanInstance instance;
  QVulkanDebugOutputFilter filter;

  filter.setVerbosity(QVulkanDebugOutputFilter::Verbose);
  filter.setFilterFlags(QVulkanDebugOutputFilter::Application);

  instance.installDebugOutputFilter(&filter);

  // ...

  return 0;
}

レイヤーからのメッセージのみを出力する

#include <QtVulkan>

int main() {
  QVulkanInstance instance;
  QVulkanDebugOutputFilter filter;

  filter.setVerbosity(QVulkanDebugOutputFilter::Verbose);
  filter.setFilterFlags(QVulkanDebugOutputFilter::Layer);

  instance.installDebugOutputFilter(&filter);

  // ...

  return 0;
}

ドライバーからのメッセージのみを出力する

#include <QtVulkan>

int main() {
  QVulkanInstance instance;
  QVulkanDebugOutputFilter filter;

  filter.setVerbosity(QVulkanDebugOutputFilter::Verbose);
  filter.setFilterFlags(QVulkanDebugOutputFilter::Driver);

  instance.installDebugOutputFilter(&filter);

  // ...

  return 0;
}

注意

• これらのサンプルコードは、Qt 5.14以降で使用可能です。

Qt GUIにおけるVulkan APIのデバッグ出力フィルタリングの他の方法

VK_EXT_debug_utils拡張機能は、Vulkan APIにデバッグ出力フィルタリング機能を追加する拡張機能です。この拡張機能を使用するには、以下の手順が必要です。

1. アプリケーションでVK_EXT_debug_utils拡張機能を有効にする。
2. VkDebugUtilsMessengerCreateInfoEXT構造体を生成する。
3. vkCreateDebugUtilsMessengerEXT()関数を使用して、VkDebugUtilsMessengerEXTオブジェクトを作成する。
4. vkSetDebugUtilsObjectTagEXT()関数を使用して、デバッグオブジェクトにタグを設定する。
5. vkSubmitDebugUtilsMessageEXT()関数を使用して、デバッグメッセージを送信する。

VK_EXT_debug_utils拡張機能の詳細については、Vulkanドキュメント: [無効な URL を削除しました]。

Qt独自のデバッグ出力機能を使用する

Qtには、独自のデバッグ出力機能が用意されています。この機能を使用するには、以下の手順が必要です。

1. QDebugクラスを使用