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