{"id":1308,"date":"2018-05-18T10:44:49","date_gmt":"2018-05-18T16:44:49","guid":{"rendered":"https:\/\/www.lunarg.com\/?p=1308"},"modified":"2025-01-15T18:14:59","modified_gmt":"2025-01-16T01:14:59","slug":"new-tutorial-for-vulkan-debug-utilities-extension","status":"publish","type":"post","link":"https:\/\/www.lunarg.com\/new-tutorial-for-vulkan-debug-utilities-extension\/","title":{"rendered":"Tutorial available for new Vulkan Debug Utilities extension"},"content":{"rendered":"

LunarG improved the debugging functionality of the Vulkan API by creating a new extension: <\/span>VK_EXT_debug_utils. We developed a comprehensive tutorial on the use of the new extension. Read on for more details.<\/span><\/p>\n

<\/p>\n

The Vulkan API is now two years old, and as with all things, it is showing areas that require improvement. Debugging is one of the areas where we can make small changes that produce a large benefit for the Vulkan community. After soliciting input from IHVs and several game companies, and reviewing feedback from GitHub users, we decided to improve the debugging functionality exposed by both <\/span>VK_EXT_debug_report<\/span> and <\/span>VK_EXT_debug_marker<\/span>. As we investigated, we decided that replacing the extension was the proper decision going forward instead of trying to shoehorn new functionality into the existing extensions. The changes resulted in the creation of a new extension: <\/span>VK_EXT_debug_utils<\/span>.<\/span><\/p>\n

Why the New Debug Extension?<\/strong><\/h2>\n

The Vulkan Working Group received feedback from developers at several software companies asking for more information from each debug message to help them isolate the trigger in their own code. Validation messages created a special concern since an application can create multiple Vulkan objects, and only one of those objects may be handled incorrectly.<\/span><\/p>\n

To help software developers isolate issues more efficiently, LunarG decided to combine the functionality of <\/span>VK_EXT_debug_report<\/span> and <\/span>VK_EXT_debug_marker<\/span> to produce more useful debug messages. However, while attempting to coordinate the work between these two separate extensions, we recognized a fundamental problem. <\/span>VK_EXT_debug_report<\/span> is an instance extension, while <\/span>VK_EXT_debug_marker<\/span> is a device extension, and there is no easy and clean way to indicate that functionality in an instance extension is dependent upon a device extension being present and enabled. To simplify things, we decided we could just define a new instance extension that supplied all the necessary items in one place.<\/span><\/p>\n

We also expanded the information that is returned to a user\u2019s debug callback. This change could have been made with the old extensions, but it would require adding items to the <\/span>pNext<\/span> chain of most structures. While doable, it added more complexity than we thought was worthwhile since every debug callback would have to care about the <\/span>pNext<\/span> chain. Of course, we still may add functionality to the new <\/span>pNext<\/span> chain in the future.<\/span><\/p>\n

Finally, the <\/span>VK_EXT_debug_report<\/span> extension uses a special internal enumeration to track object types, <\/span>VkDebugReportObjectTypeEXT<\/span>. This enumeration was supported for a time and even used by the <\/span>VK_EXT_debug_marker<\/span> extension. However, the latest versions of the Vulkan spec replace this structure with a new core object type enumeration, <\/span>VkObjectType<\/span>. Due to this spec change, \u00a0Khronos decided to stop expanding <\/span>VkDebugReportObjectTypeEXT <\/span>and instead support adding new enumeration values only to <\/span>VkObjectType. <\/span>Consequently, the <\/span>VkDebugReportObjectTypeEXT<\/span> enumeration will grow stale over time.<\/span><\/p>\n

With all these factors under consideration, LunarG decided to create this new Vulkan debug utility from scratch.<\/span><\/p>\n

Read the Tutorial<\/strong><\/h2>\n

LunarG created a comprehensive tutorial to share the benefits of the new extension and how to use it. We also provided application usage examples for your review. If you are interested in learning more about the new Vulkan Debug Utilities extension, check out the tutorial.<\/p>\n

Click here to view the tutorial describing the new extension.<\/a><\/strong><\/p>\n

New extension available in LunarG’s Vulkan SDK<\/strong><\/h2>\n

This new Vulkan Debug Utilities extension can be found in the LunarG SDK, available on the LunarXchange website<\/a>.<\/strong><\/p>\n

Info about LunarG, Inc.<\/strong><\/h2>\n

LunarG’s software engineering experts create innovative products and services for open source and commercial customers using leading-edge 3D graphics and compute technologies, including OpenGL, Vulkan, OpenXR, and SPIR-V. We have strengths in performance analysis and tuning, runtime and tools development, shader optimizations, driver development, and porting engines and applications to Vulkan. Our software engineering team is based in Fort Collins, Colorado. LunarG was founded by software experts who are passionate about 3D graphics.<\/p>\n

For more information about LunarG, check out our website<\/a><\/strong>.<\/p>\n","protected":false},"excerpt":{"rendered":"

LunarG improved the debugging functionality of the Vulkan API by creating a new extension: VK_EXT_debug_utils. We developed a comprehensive tutorial on the use of the new extension. Read on for more details.<\/p>\n","protected":false},"author":14,"featured_media":1968,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"_relevanssi_hide_post":"","_relevanssi_hide_content":"","_relevanssi_pin_for_all":"","_relevanssi_pin_keywords":"","_relevanssi_unpin_keywords":"","_relevanssi_related_keywords":"","_relevanssi_related_include_ids":"","_relevanssi_related_exclude_ids":"","_relevanssi_related_no_append":"","_relevanssi_related_not_related":"","_relevanssi_related_posts":"","_relevanssi_noindex_reason":"","footnotes":"","_links_to":"","_links_to_target":""},"categories":[130],"tags":[26],"class_list":["post-1308","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-blog","tag-debug"],"acf":[],"yoast_head":"\nTutorial available for new Vulkan Debug Utilities extension - LunarG<\/title>\n<meta name=\"description\" content=\"LunarG improved the debugging functionality of the Vulkan API by creating a new extension: VK_EXT_debug_utils. We developed a comprehensive tutorial on the use of the new extension.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.lunarg.com\/new-tutorial-for-vulkan-debug-utilities-extension\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Tutorial available for new Vulkan Debug Utilities extension - LunarG\" \/>\n<meta property=\"og:description\" content=\"LunarG improved the debugging functionality of the Vulkan API by creating a new extension: VK_EXT_debug_utils. We developed a comprehensive tutorial on the use of the new extension.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.lunarg.com\/new-tutorial-for-vulkan-debug-utilities-extension\/\" \/>\n<meta property=\"og:site_name\" content=\"LunarG\" \/>\n<meta property=\"article:published_time\" content=\"2018-05-18T16:44:49+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2025-01-16T01:14:59+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/www.lunarg.com\/wp-content\/uploads\/2018\/05\/iStock-1159581586-1.jpg\" \/>\n\t<meta property=\"og:image:width\" content=\"755\" \/>\n\t<meta property=\"og:image:height\" content=\"395\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/jpeg\" \/>\n<meta name=\"author\" content=\"Dave Desormeaux\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Dave Desormeaux\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"3 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\/\/www.lunarg.com\/new-tutorial-for-vulkan-debug-utilities-extension\/#article\",\"isPartOf\":{\"@id\":\"https:\/\/www.lunarg.com\/new-tutorial-for-vulkan-debug-utilities-extension\/\"},\"author\":{\"name\":\"Dave Desormeaux\",\"@id\":\"https:\/\/www.lunarg.com\/#\/schema\/person\/493f4ece901c822208cfda3feb80420a\"},\"headline\":\"Tutorial available for new Vulkan Debug Utilities extension\",\"datePublished\":\"2018-05-18T16:44:49+00:00\",\"dateModified\":\"2025-01-16T01:14:59+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/www.lunarg.com\/new-tutorial-for-vulkan-debug-utilities-extension\/\"},\"wordCount\":675,\"publisher\":{\"@id\":\"https:\/\/www.lunarg.com\/#organization\"},\"image\":{\"@id\":\"https:\/\/www.lunarg.com\/new-tutorial-for-vulkan-debug-utilities-extension\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/www.lunarg.com\/wp-content\/uploads\/2018\/05\/iStock-1159581586-1.jpg\",\"keywords\":[\"Debug\"],\"articleSection\":[\"Blog\"],\"inLanguage\":\"en-US\"},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/www.lunarg.com\/new-tutorial-for-vulkan-debug-utilities-extension\/\",\"url\":\"https:\/\/www.lunarg.com\/new-tutorial-for-vulkan-debug-utilities-extension\/\",\"name\":\"Tutorial available for new Vulkan Debug Utilities extension - LunarG\",\"isPartOf\":{\"@id\":\"https:\/\/www.lunarg.com\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/www.lunarg.com\/new-tutorial-for-vulkan-debug-utilities-extension\/#primaryimage\"},\"image\":{\"@id\":\"https:\/\/www.lunarg.com\/new-tutorial-for-vulkan-debug-utilities-extension\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/www.lunarg.com\/wp-content\/uploads\/2018\/05\/iStock-1159581586-1.jpg\",\"datePublished\":\"2018-05-18T16:44:49+00:00\",\"dateModified\":\"2025-01-16T01:14:59+00:00\",\"description\":\"LunarG improved the debugging functionality of the Vulkan API by creating a new extension: VK_EXT_debug_utils. We developed a comprehensive tutorial on the use of the new extension.\",\"breadcrumb\":{\"@id\":\"https:\/\/www.lunarg.com\/new-tutorial-for-vulkan-debug-utilities-extension\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.lunarg.com\/new-tutorial-for-vulkan-debug-utilities-extension\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/www.lunarg.com\/new-tutorial-for-vulkan-debug-utilities-extension\/#primaryimage\",\"url\":\"https:\/\/www.lunarg.com\/wp-content\/uploads\/2018\/05\/iStock-1159581586-1.jpg\",\"contentUrl\":\"https:\/\/www.lunarg.com\/wp-content\/uploads\/2018\/05\/iStock-1159581586-1.jpg\",\"width\":755,\"height\":395,\"caption\":\"3d abstract neon background, glowing rectangular frame in cyber space, fantastic scene in virtual reality, road between walls of blocks under the night sky\"},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.lunarg.com\/new-tutorial-for-vulkan-debug-utilities-extension\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/www.lunarg.com\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Tutorial available for new Vulkan Debug Utilities extension\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/www.lunarg.com\/#website\",\"url\":\"https:\/\/www.lunarg.com\/\",\"name\":\"LunarG\",\"description\":\"3D Graphics Software Solutions\",\"publisher\":{\"@id\":\"https:\/\/www.lunarg.com\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/www.lunarg.com\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/www.lunarg.com\/#organization\",\"name\":\"LunarG\",\"url\":\"https:\/\/www.lunarg.com\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/www.lunarg.com\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/www.lunarg.com\/wp-content\/uploads\/2020\/05\/logo.png\",\"contentUrl\":\"https:\/\/www.lunarg.com\/wp-content\/uploads\/2020\/05\/logo.png\",\"width\":767,\"height\":304,\"caption\":\"LunarG\"},\"image\":{\"@id\":\"https:\/\/www.lunarg.com\/#\/schema\/logo\/image\/\"}},{\"@type\":\"Person\",\"@id\":\"https:\/\/www.lunarg.com\/#\/schema\/person\/493f4ece901c822208cfda3feb80420a\",\"name\":\"Dave Desormeaux\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/www.lunarg.com\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/89944424b10c09db4e6c6e62b6ef1722?s=96&d=retro&r=pg\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/89944424b10c09db4e6c6e62b6ef1722?s=96&d=retro&r=pg\",\"caption\":\"Dave Desormeaux\"},\"sameAs\":[\"http:\/\/www.lunarg.com\"],\"url\":\"https:\/\/www.lunarg.com\/author\/dave-d\/\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Tutorial available for new Vulkan Debug Utilities extension - LunarG","description":"LunarG improved the debugging functionality of the Vulkan API by creating a new extension: VK_EXT_debug_utils. We developed a comprehensive tutorial on the use of the new extension.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.lunarg.com\/new-tutorial-for-vulkan-debug-utilities-extension\/","og_locale":"en_US","og_type":"article","og_title":"Tutorial available for new Vulkan Debug Utilities extension - LunarG","og_description":"LunarG improved the debugging functionality of the Vulkan API by creating a new extension: VK_EXT_debug_utils. We developed a comprehensive tutorial on the use of the new extension.","og_url":"https:\/\/www.lunarg.com\/new-tutorial-for-vulkan-debug-utilities-extension\/","og_site_name":"LunarG","article_published_time":"2018-05-18T16:44:49+00:00","article_modified_time":"2025-01-16T01:14:59+00:00","og_image":[{"width":755,"height":395,"url":"https:\/\/www.lunarg.com\/wp-content\/uploads\/2018\/05\/iStock-1159581586-1.jpg","type":"image\/jpeg"}],"author":"Dave Desormeaux","twitter_card":"summary_large_image","twitter_misc":{"Written by":"Dave Desormeaux","Est. reading time":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/www.lunarg.com\/new-tutorial-for-vulkan-debug-utilities-extension\/#article","isPartOf":{"@id":"https:\/\/www.lunarg.com\/new-tutorial-for-vulkan-debug-utilities-extension\/"},"author":{"name":"Dave Desormeaux","@id":"https:\/\/www.lunarg.com\/#\/schema\/person\/493f4ece901c822208cfda3feb80420a"},"headline":"Tutorial available for new Vulkan Debug Utilities extension","datePublished":"2018-05-18T16:44:49+00:00","dateModified":"2025-01-16T01:14:59+00:00","mainEntityOfPage":{"@id":"https:\/\/www.lunarg.com\/new-tutorial-for-vulkan-debug-utilities-extension\/"},"wordCount":675,"publisher":{"@id":"https:\/\/www.lunarg.com\/#organization"},"image":{"@id":"https:\/\/www.lunarg.com\/new-tutorial-for-vulkan-debug-utilities-extension\/#primaryimage"},"thumbnailUrl":"https:\/\/www.lunarg.com\/wp-content\/uploads\/2018\/05\/iStock-1159581586-1.jpg","keywords":["Debug"],"articleSection":["Blog"],"inLanguage":"en-US"},{"@type":"WebPage","@id":"https:\/\/www.lunarg.com\/new-tutorial-for-vulkan-debug-utilities-extension\/","url":"https:\/\/www.lunarg.com\/new-tutorial-for-vulkan-debug-utilities-extension\/","name":"Tutorial available for new Vulkan Debug Utilities extension - LunarG","isPartOf":{"@id":"https:\/\/www.lunarg.com\/#website"},"primaryImageOfPage":{"@id":"https:\/\/www.lunarg.com\/new-tutorial-for-vulkan-debug-utilities-extension\/#primaryimage"},"image":{"@id":"https:\/\/www.lunarg.com\/new-tutorial-for-vulkan-debug-utilities-extension\/#primaryimage"},"thumbnailUrl":"https:\/\/www.lunarg.com\/wp-content\/uploads\/2018\/05\/iStock-1159581586-1.jpg","datePublished":"2018-05-18T16:44:49+00:00","dateModified":"2025-01-16T01:14:59+00:00","description":"LunarG improved the debugging functionality of the Vulkan API by creating a new extension: VK_EXT_debug_utils. We developed a comprehensive tutorial on the use of the new extension.","breadcrumb":{"@id":"https:\/\/www.lunarg.com\/new-tutorial-for-vulkan-debug-utilities-extension\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.lunarg.com\/new-tutorial-for-vulkan-debug-utilities-extension\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.lunarg.com\/new-tutorial-for-vulkan-debug-utilities-extension\/#primaryimage","url":"https:\/\/www.lunarg.com\/wp-content\/uploads\/2018\/05\/iStock-1159581586-1.jpg","contentUrl":"https:\/\/www.lunarg.com\/wp-content\/uploads\/2018\/05\/iStock-1159581586-1.jpg","width":755,"height":395,"caption":"3d abstract neon background, glowing rectangular frame in cyber space, fantastic scene in virtual reality, road between walls of blocks under the night sky"},{"@type":"BreadcrumbList","@id":"https:\/\/www.lunarg.com\/new-tutorial-for-vulkan-debug-utilities-extension\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.lunarg.com\/"},{"@type":"ListItem","position":2,"name":"Tutorial available for new Vulkan Debug Utilities extension"}]},{"@type":"WebSite","@id":"https:\/\/www.lunarg.com\/#website","url":"https:\/\/www.lunarg.com\/","name":"LunarG","description":"3D Graphics Software Solutions","publisher":{"@id":"https:\/\/www.lunarg.com\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.lunarg.com\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/www.lunarg.com\/#organization","name":"LunarG","url":"https:\/\/www.lunarg.com\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.lunarg.com\/#\/schema\/logo\/image\/","url":"https:\/\/www.lunarg.com\/wp-content\/uploads\/2020\/05\/logo.png","contentUrl":"https:\/\/www.lunarg.com\/wp-content\/uploads\/2020\/05\/logo.png","width":767,"height":304,"caption":"LunarG"},"image":{"@id":"https:\/\/www.lunarg.com\/#\/schema\/logo\/image\/"}},{"@type":"Person","@id":"https:\/\/www.lunarg.com\/#\/schema\/person\/493f4ece901c822208cfda3feb80420a","name":"Dave Desormeaux","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.lunarg.com\/#\/schema\/person\/image\/","url":"https:\/\/secure.gravatar.com\/avatar\/89944424b10c09db4e6c6e62b6ef1722?s=96&d=retro&r=pg","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/89944424b10c09db4e6c6e62b6ef1722?s=96&d=retro&r=pg","caption":"Dave Desormeaux"},"sameAs":["http:\/\/www.lunarg.com"],"url":"https:\/\/www.lunarg.com\/author\/dave-d\/"}]}},"_links":{"self":[{"href":"https:\/\/www.lunarg.com\/wp-json\/wp\/v2\/posts\/1308","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.lunarg.com\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.lunarg.com\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.lunarg.com\/wp-json\/wp\/v2\/users\/14"}],"replies":[{"embeddable":true,"href":"https:\/\/www.lunarg.com\/wp-json\/wp\/v2\/comments?post=1308"}],"version-history":[{"count":0,"href":"https:\/\/www.lunarg.com\/wp-json\/wp\/v2\/posts\/1308\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.lunarg.com\/wp-json\/wp\/v2\/media\/1968"}],"wp:attachment":[{"href":"https:\/\/www.lunarg.com\/wp-json\/wp\/v2\/media?parent=1308"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.lunarg.com\/wp-json\/wp\/v2\/categories?post=1308"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.lunarg.com\/wp-json\/wp\/v2\/tags?post=1308"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}