[{"data":1,"prerenderedAt":442},["ShallowReactive",2],{"TK3yNPyYsn":3},{"title":4,"description":5,"parent":6,"cmd_buf_level":7,"render_pass_scope":10,"supported_queue_types":11,"tasks":14,"type":16,"xrefs":17,"body":18,"_type":441,"_id":4},"vkCmdInsertDebugUtilsLabelEXT","Insert a label into a command buffer","VK_EXT_debug_utils",[8,9],"primary","secondary","both",[12,13],"graphics","compute",[15],"action","protos",[],{"type":19,"children":20,"toc":439},"root",[21,29,225,260,387,433],{"type":22,"tag":23,"props":24,"children":25},"element","p",{},[26],{"type":27,"value":28},"text","A single debug label can be inserted into a command buffer by calling:",{"type":22,"tag":30,"props":31,"children":32},"code-group",{},[33,119],{"type":22,"tag":34,"props":35,"children":41},"pre",{"className":36,"code":37,"filename":38,"language":39,"meta":40,"style":40},"language-c shiki shiki-themes github-light-default github-dark-default","void vkCmdInsertDebugUtilsLabelEXT(\n    VkCommandBuffer commandBuffer,\n    const VkDebugUtilsLabelEXT* pLabelInfo);\n","C","c","",[42],{"type":22,"tag":43,"props":44,"children":45},"code",{"__ignoreMap":40},[46,70,90],{"type":22,"tag":47,"props":48,"children":51},"span",{"class":49,"line":50},"line",1,[52,58,64],{"type":22,"tag":47,"props":53,"children":55},{"style":54},"--shiki-default:#CF222E;--shiki-dark:#FF7B72",[56],{"type":27,"value":57},"void",{"type":22,"tag":47,"props":59,"children":61},{"style":60},"--shiki-default:#8250DF;--shiki-dark:#D2A8FF",[62],{"type":27,"value":63}," vkCmdInsertDebugUtilsLabelEXT",{"type":22,"tag":47,"props":65,"children":67},{"style":66},"--shiki-default:#1F2328;--shiki-dark:#E6EDF3",[68],{"type":27,"value":69},"(\n",{"type":22,"tag":47,"props":71,"children":73},{"class":49,"line":72},2,[74,79,85],{"type":22,"tag":47,"props":75,"children":76},{"style":66},[77],{"type":27,"value":78},"    VkCommandBuffer ",{"type":22,"tag":47,"props":80,"children":82},{"style":81},"--shiki-default:#953800;--shiki-dark:#FFA657",[83],{"type":27,"value":84},"commandBuffer",{"type":22,"tag":47,"props":86,"children":87},{"style":66},[88],{"type":27,"value":89},",\n",{"type":22,"tag":47,"props":91,"children":93},{"class":49,"line":92},3,[94,99,104,109,114],{"type":22,"tag":47,"props":95,"children":96},{"style":54},[97],{"type":27,"value":98},"    const",{"type":22,"tag":47,"props":100,"children":101},{"style":66},[102],{"type":27,"value":103}," VkDebugUtilsLabelEXT",{"type":22,"tag":47,"props":105,"children":106},{"style":54},[107],{"type":27,"value":108},"*",{"type":22,"tag":47,"props":110,"children":111},{"style":81},[112],{"type":27,"value":113}," pLabelInfo",{"type":22,"tag":47,"props":115,"children":116},{"style":66},[117],{"type":27,"value":118},");\n",{"type":22,"tag":34,"props":120,"children":125},{"className":121,"code":122,"filename":123,"language":124,"meta":40,"style":40},"language-rs shiki shiki-themes github-light-default github-dark-default","pub fn cmd_insert_debug_utils_label_ext(\n    command_buffer: vk::CommandBuffer,\n    p_label_info: *const vk::DebugUtilsLabelEXT,\n);\n","Rust","rs",[126],{"type":22,"tag":43,"props":127,"children":128},{"__ignoreMap":40},[129,151,183,217],{"type":22,"tag":47,"props":130,"children":131},{"class":49,"line":50},[132,137,142,147],{"type":22,"tag":47,"props":133,"children":134},{"style":54},[135],{"type":27,"value":136},"pub",{"type":22,"tag":47,"props":138,"children":139},{"style":54},[140],{"type":27,"value":141}," fn",{"type":22,"tag":47,"props":143,"children":144},{"style":60},[145],{"type":27,"value":146}," cmd_insert_debug_utils_label_ext",{"type":22,"tag":47,"props":148,"children":149},{"style":66},[150],{"type":27,"value":69},{"type":22,"tag":47,"props":152,"children":153},{"class":49,"line":72},[154,159,164,169,174,179],{"type":22,"tag":47,"props":155,"children":156},{"style":66},[157],{"type":27,"value":158},"    command_buffer",{"type":22,"tag":47,"props":160,"children":161},{"style":54},[162],{"type":27,"value":163},":",{"type":22,"tag":47,"props":165,"children":166},{"style":81},[167],{"type":27,"value":168}," vk",{"type":22,"tag":47,"props":170,"children":171},{"style":54},[172],{"type":27,"value":173},"::",{"type":22,"tag":47,"props":175,"children":176},{"style":81},[177],{"type":27,"value":178},"CommandBuffer",{"type":22,"tag":47,"props":180,"children":181},{"style":66},[182],{"type":27,"value":89},{"type":22,"tag":47,"props":184,"children":185},{"class":49,"line":92},[186,191,195,200,204,208,213],{"type":22,"tag":47,"props":187,"children":188},{"style":66},[189],{"type":27,"value":190},"    p_label_info",{"type":22,"tag":47,"props":192,"children":193},{"style":54},[194],{"type":27,"value":163},{"type":22,"tag":47,"props":196,"children":197},{"style":54},[198],{"type":27,"value":199}," *const",{"type":22,"tag":47,"props":201,"children":202},{"style":81},[203],{"type":27,"value":168},{"type":22,"tag":47,"props":205,"children":206},{"style":54},[207],{"type":27,"value":173},{"type":22,"tag":47,"props":209,"children":210},{"style":81},[211],{"type":27,"value":212},"DebugUtilsLabelEXT",{"type":22,"tag":47,"props":214,"children":215},{"style":66},[216],{"type":27,"value":89},{"type":22,"tag":47,"props":218,"children":220},{"class":49,"line":219},4,[221],{"type":22,"tag":47,"props":222,"children":223},{"style":66},[224],{"type":27,"value":118},{"type":22,"tag":226,"props":227,"children":228},"ul",{},[229,240],{"type":22,"tag":230,"props":231,"children":232},"li",{},[233,238],{"type":22,"tag":43,"props":234,"children":236},{"className":235},[],[237],{"type":27,"value":84},{"type":27,"value":239}," is the command buffer into which the command is\nrecorded.",{"type":22,"tag":230,"props":241,"children":242},{},[243,249,251,258],{"type":22,"tag":43,"props":244,"children":246},{"className":245},[],[247],{"type":27,"value":248},"pInfo",{"type":27,"value":250}," is a pointer to a ",{"type":22,"tag":252,"props":253,"children":255},"a",{"href":254},"/man/VkDebugUtilsLabelEXT",[256],{"type":27,"value":257},"VkDebugUtilsLabelEXT",{"type":27,"value":259}," structure\nspecifying parameters of the label to insert.",{"type":22,"tag":261,"props":262,"children":264},"validity-group",{"name":263},"Valid Usage (Implicit)",[265,295,320,344,373],{"type":22,"tag":266,"props":267,"children":269},"validity-field",{"name":268},"VUID-vkCmdInsertDebugUtilsLabelEXT-commandBuffer-parameter",[270],{"type":22,"tag":23,"props":271,"children":272},{},[273,278,280,285,287,293],{"type":22,"tag":43,"props":274,"children":276},{"className":275},[],[277],{"type":27,"value":84},{"type":27,"value":279}," ",{"type":22,"tag":281,"props":282,"children":284},"normative",{"type":283},"must",[],{"type":27,"value":286}," be a valid ",{"type":22,"tag":252,"props":288,"children":290},{"href":289},"/man/VkCommandBuffer",[291],{"type":27,"value":292},"VkCommandBuffer",{"type":27,"value":294}," handle",{"type":22,"tag":266,"props":296,"children":298},{"name":297},"VUID-vkCmdInsertDebugUtilsLabelEXT-pLabelInfo-parameter",[299],{"type":22,"tag":23,"props":300,"children":301},{},[302,308,309,312,314,318],{"type":22,"tag":43,"props":303,"children":305},{"className":304},[],[306],{"type":27,"value":307},"pLabelInfo",{"type":27,"value":279},{"type":22,"tag":281,"props":310,"children":311},{"type":283},[],{"type":27,"value":313}," be a valid pointer to a valid ",{"type":22,"tag":252,"props":315,"children":316},{"href":254},[317],{"type":27,"value":257},{"type":27,"value":319}," structure",{"type":22,"tag":266,"props":321,"children":323},{"name":322},"VUID-vkCmdInsertDebugUtilsLabelEXT-commandBuffer-recording",[324],{"type":22,"tag":23,"props":325,"children":326},{},[327,332,333,336,338],{"type":22,"tag":43,"props":328,"children":330},{"className":329},[],[331],{"type":27,"value":84},{"type":27,"value":279},{"type":22,"tag":281,"props":334,"children":335},{"type":283},[],{"type":27,"value":337}," be in the ",{"type":22,"tag":252,"props":339,"children":341},{"href":340},"/chapters/commandbuffers#commandbuffers-lifecycle",[342],{"type":27,"value":343},"recording state",{"type":22,"tag":266,"props":345,"children":347},{"name":346},"VUID-vkCmdInsertDebugUtilsLabelEXT-commandBuffer-cmdpool",[348],{"type":22,"tag":23,"props":349,"children":350},{},[351,353,359,361,366,368,371],{"type":27,"value":352},"The ",{"type":22,"tag":43,"props":354,"children":356},{"className":355},[],[357],{"type":27,"value":358},"VkCommandPool",{"type":27,"value":360}," that ",{"type":22,"tag":43,"props":362,"children":364},{"className":363},[],[365],{"type":27,"value":84},{"type":27,"value":367}," was allocated from ",{"type":22,"tag":281,"props":369,"children":370},{"type":283},[],{"type":27,"value":372}," support graphics, or compute operations",{"type":22,"tag":266,"props":374,"children":376},{"name":375},"VUID-vkCmdInsertDebugUtilsLabelEXT-videocoding",[377],{"type":22,"tag":23,"props":378,"children":379},{},[380,382,385],{"type":27,"value":381},"This command ",{"type":22,"tag":281,"props":383,"children":384},{"type":283},[],{"type":27,"value":386}," only be called outside of a video coding scope",{"type":22,"tag":388,"props":389,"children":391},"validity-box",{"name":390},"Host Synchronization",[392],{"type":22,"tag":226,"props":393,"children":394},{},[395,411],{"type":22,"tag":230,"props":396,"children":397},{},[398,400,405,406,409],{"type":27,"value":399},"Host access to ",{"type":22,"tag":43,"props":401,"children":403},{"className":402},[],[404],{"type":27,"value":84},{"type":27,"value":279},{"type":22,"tag":281,"props":407,"children":408},{"type":283},[],{"type":27,"value":410}," be externally synchronized",{"type":22,"tag":230,"props":412,"children":413},{},[414,416,421,422,427,428,431],{"type":27,"value":415},"Host access to the ",{"type":22,"tag":43,"props":417,"children":419},{"className":418},[],[420],{"type":27,"value":358},{"type":27,"value":360},{"type":22,"tag":43,"props":423,"children":425},{"className":424},[],[426],{"type":27,"value":84},{"type":27,"value":367},{"type":22,"tag":281,"props":429,"children":430},{"type":283},[],{"type":27,"value":432}," be externally synchronized\n::",{"type":22,"tag":434,"props":435,"children":436},"style",{},[437],{"type":27,"value":438},"html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":40,"searchDepth":72,"depth":72,"links":440},[],"markdown",1725732606624]