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