[{"data":1,"prerenderedAt":814},["ShallowReactive",2],{"nVhgeodJxs":3},{"title":4,"description":5,"parent":6,"type":7,"xrefs":8,"body":9,"_type":813,"_id":4},"vkCmdSetScissorWithCount","Set the scissor count and scissor rectangular bounds dynamically for a command buffer","VK_VERSION_1_3","protos",[],{"type":10,"children":11,"toc":811},"root",[12,29,264,301,358,608,759,805],{"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}," the scissor count and\nscissor rectangular bounds, call:",{"type":13,"tag":30,"props":31,"children":32},"code-group",{},[33,137],{"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 vkCmdSetScissorWithCountEXT(\n    VkCommandBuffer commandBuffer,\n    uint32_t scissorCount,\n    const VkRect2D* pScissors);\n","C","c","",[42],{"type":13,"tag":43,"props":44,"children":45},"code",{"__ignoreMap":40},[46,70,90,108],{"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}," vkCmdSetScissorWithCountEXT",{"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":54},[97],{"type":18,"value":98},"    uint32_t",{"type":13,"tag":47,"props":100,"children":101},{"style":81},[102],{"type":18,"value":103}," scissorCount",{"type":13,"tag":47,"props":105,"children":106},{"style":66},[107],{"type":18,"value":89},{"type":13,"tag":47,"props":109,"children":111},{"class":49,"line":110},4,[112,117,122,127,132],{"type":13,"tag":47,"props":113,"children":114},{"style":54},[115],{"type":18,"value":116},"    const",{"type":13,"tag":47,"props":118,"children":119},{"style":66},[120],{"type":18,"value":121}," VkRect2D",{"type":13,"tag":47,"props":123,"children":124},{"style":54},[125],{"type":18,"value":126},"*",{"type":13,"tag":47,"props":128,"children":129},{"style":81},[130],{"type":18,"value":131}," pScissors",{"type":13,"tag":47,"props":133,"children":134},{"style":66},[135],{"type":18,"value":136},");\n",{"type":13,"tag":34,"props":138,"children":143},{"className":139,"code":140,"filename":141,"language":142,"meta":40,"style":40},"language-rs shiki shiki-themes github-light-default github-dark-default","pub fn cmd_set_scissor_with_count_ext(\n    command_buffer: vk::CommandBuffer,\n    scissor_count: u32,\n    p_scissors: *const vk::Rect2D,\n);\n","Rust","rs",[144],{"type":13,"tag":43,"props":145,"children":146},{"__ignoreMap":40},[147,169,201,222,256],{"type":13,"tag":47,"props":148,"children":149},{"class":49,"line":50},[150,155,160,165],{"type":13,"tag":47,"props":151,"children":152},{"style":54},[153],{"type":18,"value":154},"pub",{"type":13,"tag":47,"props":156,"children":157},{"style":54},[158],{"type":18,"value":159}," fn",{"type":13,"tag":47,"props":161,"children":162},{"style":60},[163],{"type":18,"value":164}," cmd_set_scissor_with_count_ext",{"type":13,"tag":47,"props":166,"children":167},{"style":66},[168],{"type":18,"value":69},{"type":13,"tag":47,"props":170,"children":171},{"class":49,"line":72},[172,177,182,187,192,197],{"type":13,"tag":47,"props":173,"children":174},{"style":66},[175],{"type":18,"value":176},"    command_buffer",{"type":13,"tag":47,"props":178,"children":179},{"style":54},[180],{"type":18,"value":181},":",{"type":13,"tag":47,"props":183,"children":184},{"style":81},[185],{"type":18,"value":186}," vk",{"type":13,"tag":47,"props":188,"children":189},{"style":54},[190],{"type":18,"value":191},"::",{"type":13,"tag":47,"props":193,"children":194},{"style":81},[195],{"type":18,"value":196},"CommandBuffer",{"type":13,"tag":47,"props":198,"children":199},{"style":66},[200],{"type":18,"value":89},{"type":13,"tag":47,"props":202,"children":203},{"class":49,"line":92},[204,209,213,218],{"type":13,"tag":47,"props":205,"children":206},{"style":66},[207],{"type":18,"value":208},"    scissor_count",{"type":13,"tag":47,"props":210,"children":211},{"style":54},[212],{"type":18,"value":181},{"type":13,"tag":47,"props":214,"children":215},{"style":81},[216],{"type":18,"value":217}," u32",{"type":13,"tag":47,"props":219,"children":220},{"style":66},[221],{"type":18,"value":89},{"type":13,"tag":47,"props":223,"children":224},{"class":49,"line":110},[225,230,234,239,243,247,252],{"type":13,"tag":47,"props":226,"children":227},{"style":66},[228],{"type":18,"value":229},"    p_scissors",{"type":13,"tag":47,"props":231,"children":232},{"style":54},[233],{"type":18,"value":181},{"type":13,"tag":47,"props":235,"children":236},{"style":54},[237],{"type":18,"value":238}," *const",{"type":13,"tag":47,"props":240,"children":241},{"style":81},[242],{"type":18,"value":186},{"type":13,"tag":47,"props":244,"children":245},{"style":54},[246],{"type":18,"value":191},{"type":13,"tag":47,"props":248,"children":249},{"style":81},[250],{"type":18,"value":251},"Rect2D",{"type":13,"tag":47,"props":253,"children":254},{"style":66},[255],{"type":18,"value":89},{"type":13,"tag":47,"props":257,"children":259},{"class":49,"line":258},5,[260],{"type":13,"tag":47,"props":261,"children":262},{"style":66},[263],{"type":18,"value":136},{"type":13,"tag":265,"props":266,"children":267},"ul",{},[268,279,290],{"type":13,"tag":269,"props":270,"children":271},"li",{},[272,277],{"type":13,"tag":43,"props":273,"children":275},{"className":274},[],[276],{"type":18,"value":84},{"type":18,"value":278}," is the command buffer into which the command will be\nrecorded.",{"type":13,"tag":269,"props":280,"children":281},{},[282,288],{"type":13,"tag":43,"props":283,"children":285},{"className":284},[],[286],{"type":18,"value":287},"scissorCount",{"type":18,"value":289}," specifies the scissor count.",{"type":13,"tag":269,"props":291,"children":292},{},[293,299],{"type":13,"tag":43,"props":294,"children":296},{"className":295},[],[297],{"type":18,"value":298},"pScissors",{"type":18,"value":300}," specifies the scissors to use for drawing.",{"type":13,"tag":14,"props":302,"children":303},{},[304,306,312,314,320,322,328,329,335,337,343,344,349,351,356],{"type":18,"value":305},"This command sets the scissor count and scissor rectangular bounds state for\nsubsequent drawing commands\nwhen drawing using ",{"type":13,"tag":21,"props":307,"children":309},{"href":308},"/chapters/shaders#shaders-objects",[310],{"type":18,"value":311},"shader objects",{"type":18,"value":313},", or\nwhen the graphics pipeline is created with\n",{"type":13,"tag":43,"props":315,"children":317},{"className":316},[],[318],{"type":18,"value":319},"VK_DYNAMIC_STATE_SCISSOR_WITH_COUNT",{"type":18,"value":321}," set in\n",{"type":13,"tag":21,"props":323,"children":325},{"href":324},"/man/VkPipelineDynamicStateCreateInfo",[326],{"type":18,"value":327},"VkPipelineDynamicStateCreateInfo",{"type":18,"value":191},{"type":13,"tag":43,"props":330,"children":332},{"className":331},[],[333],{"type":18,"value":334},"pDynamicStates",{"type":18,"value":336},".\nOtherwise, this state is specified by the corresponding\n",{"type":13,"tag":21,"props":338,"children":340},{"href":339},"/man/VkPipelineViewportStateCreateInfo",[341],{"type":18,"value":342},"VkPipelineViewportStateCreateInfo",{"type":18,"value":191},{"type":13,"tag":43,"props":345,"children":347},{"className":346},[],[348],{"type":18,"value":287},{"type":18,"value":350}," and\n",{"type":13,"tag":43,"props":352,"children":354},{"className":353},[],[355],{"type":18,"value":298},{"type":18,"value":357}," values used to create the currently active pipeline.",{"type":13,"tag":359,"props":360,"children":362},"validity-group",{"name":361},"Valid Usage",[363,380,421,458,508,543,575],{"type":13,"tag":364,"props":365,"children":367},"validity-field",{"name":366},"VUID-vkCmdSetScissorWithCount-None-08971",[368],{"type":13,"tag":14,"props":369,"children":370},{},[371,373,378],{"type":18,"value":372},"At least one of the following ",{"type":13,"tag":374,"props":375,"children":377},"normative",{"type":376},"must",[],{"type":18,"value":379}," be true:",{"type":13,"tag":364,"props":381,"children":383},{"name":382},"VUID-vkCmdSetScissorWithCount-scissorCount-03397",[384],{"type":13,"tag":14,"props":385,"children":386},{},[387,392,394,397,399,405,406,412,413,419],{"type":13,"tag":43,"props":388,"children":390},{"className":389},[],[391],{"type":18,"value":287},{"type":18,"value":393}," ",{"type":13,"tag":374,"props":395,"children":396},{"type":376},[],{"type":18,"value":398}," be between ",{"type":13,"tag":43,"props":400,"children":402},{"className":401},[],[403],{"type":18,"value":404},"1",{"type":18,"value":350},{"type":13,"tag":43,"props":407,"children":409},{"className":408},[],[410],{"type":18,"value":411},"VkPhysicalDeviceLimits",{"type":18,"value":191},{"type":13,"tag":43,"props":414,"children":416},{"className":415},[],[417],{"type":18,"value":418},"maxViewports",{"type":18,"value":420},", inclusive",{"type":13,"tag":364,"props":422,"children":424},{"name":423},"VUID-vkCmdSetScissorWithCount-scissorCount-03398",[425],{"type":13,"tag":14,"props":426,"children":427},{},[428,430,440,442,447,448,451,453],{"type":18,"value":429},"If the ",{"type":13,"tag":21,"props":431,"children":433},{"href":432},"/man/VkPhysicalDeviceFeatures#features-multiViewport",[434],{"type":13,"tag":43,"props":435,"children":437},{"className":436},[],[438],{"type":18,"value":439},"multiViewport",{"type":18,"value":441}," feature is not\nenabled, ",{"type":13,"tag":43,"props":443,"children":445},{"className":444},[],[446],{"type":18,"value":287},{"type":18,"value":393},{"type":13,"tag":374,"props":449,"children":450},{"type":376},[],{"type":18,"value":452}," be ",{"type":13,"tag":43,"props":454,"children":456},{"className":455},[],[457],{"type":18,"value":404},{"type":13,"tag":364,"props":459,"children":461},{"name":460},"VUID-vkCmdSetScissorWithCount-x-03399",[462],{"type":13,"tag":14,"props":463,"children":464},{},[465,467,473,475,481,483,489,491,496,497,500,502],{"type":18,"value":466},"The ",{"type":13,"tag":43,"props":468,"children":470},{"className":469},[],[471],{"type":18,"value":472},"x",{"type":18,"value":474}," and ",{"type":13,"tag":43,"props":476,"children":478},{"className":477},[],[479],{"type":18,"value":480},"y",{"type":18,"value":482}," members of ",{"type":13,"tag":43,"props":484,"children":486},{"className":485},[],[487],{"type":18,"value":488},"offset",{"type":18,"value":490}," member of any element of\n",{"type":13,"tag":43,"props":492,"children":494},{"className":493},[],[495],{"type":18,"value":298},{"type":18,"value":393},{"type":13,"tag":374,"props":498,"children":499},{"type":376},[],{"type":18,"value":501}," be greater than or equal to ",{"type":13,"tag":43,"props":503,"children":505},{"className":504},[],[506],{"type":18,"value":507},"0",{"type":13,"tag":364,"props":509,"children":511},{"name":510},"VUID-vkCmdSetScissorWithCount-offset-03400",[512],{"type":13,"tag":14,"props":513,"children":514},{},[515,517,523,525,531,533,536,538],{"type":18,"value":516},"Evaluation of (",{"type":13,"tag":43,"props":518,"children":520},{"className":519},[],[521],{"type":18,"value":522},"offset.x",{"type":18,"value":524}," +  ",{"type":13,"tag":43,"props":526,"children":528},{"className":527},[],[529],{"type":18,"value":530},"extent.width",{"type":18,"value":532},") ",{"type":13,"tag":374,"props":534,"children":535},{"type":376},[],{"type":18,"value":537}," not\ncause a signed integer addition overflow for any element of\n",{"type":13,"tag":43,"props":539,"children":541},{"className":540},[],[542],{"type":18,"value":298},{"type":13,"tag":364,"props":544,"children":546},{"name":545},"VUID-vkCmdSetScissorWithCount-offset-03401",[547],{"type":13,"tag":14,"props":548,"children":549},{},[550,551,557,558,564,565,568,570],{"type":18,"value":516},{"type":13,"tag":43,"props":552,"children":554},{"className":553},[],[555],{"type":18,"value":556},"offset.y",{"type":18,"value":524},{"type":13,"tag":43,"props":559,"children":561},{"className":560},[],[562],{"type":18,"value":563},"extent.height",{"type":18,"value":532},{"type":13,"tag":374,"props":566,"children":567},{"type":376},[],{"type":18,"value":569},"\nnot cause a signed integer addition overflow for any element of\n",{"type":13,"tag":43,"props":571,"children":573},{"className":572},[],[574],{"type":18,"value":298},{"type":13,"tag":364,"props":576,"children":578},{"name":577},"VUID-vkCmdSetScissorWithCount-commandBuffer-04820",[579],{"type":13,"tag":14,"props":580,"children":581},{},[582,587,588,591,593,599,600,606],{"type":13,"tag":43,"props":583,"children":585},{"className":584},[],[586],{"type":18,"value":84},{"type":18,"value":393},{"type":13,"tag":374,"props":589,"children":590},{"type":376},[],{"type":18,"value":592}," not have\n",{"type":13,"tag":21,"props":594,"children":596},{"href":595},"/man/VkCommandBufferInheritanceViewportScissorInfoNV",[597],{"type":18,"value":598},"VkCommandBufferInheritanceViewportScissorInfoNV",{"type":18,"value":191},{"type":13,"tag":43,"props":601,"children":603},{"className":602},[],[604],{"type":18,"value":605},"viewportScissor2D",{"type":18,"value":607},"\nenabled",{"type":13,"tag":359,"props":609,"children":611},{"name":610},"Valid Usage (Implicit)",[612,638,670,694,722,736],{"type":13,"tag":364,"props":613,"children":615},{"name":614},"VUID-vkCmdSetScissorWithCount-commandBuffer-parameter",[616],{"type":13,"tag":14,"props":617,"children":618},{},[619,624,625,628,630,636],{"type":13,"tag":43,"props":620,"children":622},{"className":621},[],[623],{"type":18,"value":84},{"type":18,"value":393},{"type":13,"tag":374,"props":626,"children":627},{"type":376},[],{"type":18,"value":629}," be a valid ",{"type":13,"tag":21,"props":631,"children":633},{"href":632},"/man/VkCommandBuffer",[634],{"type":18,"value":635},"VkCommandBuffer",{"type":18,"value":637}," handle",{"type":13,"tag":364,"props":639,"children":641},{"name":640},"VUID-vkCmdSetScissorWithCount-pScissors-parameter",[642],{"type":13,"tag":14,"props":643,"children":644},{},[645,650,651,654,656,661,662,668],{"type":13,"tag":43,"props":646,"children":648},{"className":647},[],[649],{"type":18,"value":298},{"type":18,"value":393},{"type":13,"tag":374,"props":652,"children":653},{"type":376},[],{"type":18,"value":655}," be a valid pointer to an array of ",{"type":13,"tag":43,"props":657,"children":659},{"className":658},[],[660],{"type":18,"value":287},{"type":18,"value":393},{"type":13,"tag":21,"props":663,"children":665},{"href":664},"/man/VkRect2D",[666],{"type":18,"value":667},"VkRect2D",{"type":18,"value":669}," structures",{"type":13,"tag":364,"props":671,"children":673},{"name":672},"VUID-vkCmdSetScissorWithCount-commandBuffer-recording",[674],{"type":13,"tag":14,"props":675,"children":676},{},[677,682,683,686,688],{"type":13,"tag":43,"props":678,"children":680},{"className":679},[],[681],{"type":18,"value":84},{"type":18,"value":393},{"type":13,"tag":374,"props":684,"children":685},{"type":376},[],{"type":18,"value":687}," be in the ",{"type":13,"tag":21,"props":689,"children":691},{"href":690},"/chapters/commandbuffers#commandbuffers-lifecycle",[692],{"type":18,"value":693},"recording state",{"type":13,"tag":364,"props":695,"children":697},{"name":696},"VUID-vkCmdSetScissorWithCount-commandBuffer-cmdpool",[698],{"type":13,"tag":14,"props":699,"children":700},{},[701,702,708,710,715,717,720],{"type":18,"value":466},{"type":13,"tag":43,"props":703,"children":705},{"className":704},[],[706],{"type":18,"value":707},"VkCommandPool",{"type":18,"value":709}," that ",{"type":13,"tag":43,"props":711,"children":713},{"className":712},[],[714],{"type":18,"value":84},{"type":18,"value":716}," was allocated from ",{"type":13,"tag":374,"props":718,"children":719},{"type":376},[],{"type":18,"value":721}," support graphics operations",{"type":13,"tag":364,"props":723,"children":725},{"name":724},"VUID-vkCmdSetScissorWithCount-videocoding",[726],{"type":13,"tag":14,"props":727,"children":728},{},[729,731,734],{"type":18,"value":730},"This command ",{"type":13,"tag":374,"props":732,"children":733},{"type":376},[],{"type":18,"value":735}," only be called outside of a video coding scope",{"type":13,"tag":364,"props":737,"children":739},{"name":738},"VUID-vkCmdSetScissorWithCount-scissorCount-arraylength",[740],{"type":13,"tag":14,"props":741,"children":742},{},[743,748,749,752,754],{"type":13,"tag":43,"props":744,"children":746},{"className":745},[],[747],{"type":18,"value":287},{"type":18,"value":393},{"type":13,"tag":374,"props":750,"children":751},{"type":376},[],{"type":18,"value":753}," be greater than ",{"type":13,"tag":43,"props":755,"children":757},{"className":756},[],[758],{"type":18,"value":507},{"type":13,"tag":760,"props":761,"children":763},"validity-box",{"name":762},"Host Synchronization",[764],{"type":13,"tag":265,"props":765,"children":766},{},[767,783],{"type":13,"tag":269,"props":768,"children":769},{},[770,772,777,778,781],{"type":18,"value":771},"Host access to ",{"type":13,"tag":43,"props":773,"children":775},{"className":774},[],[776],{"type":18,"value":84},{"type":18,"value":393},{"type":13,"tag":374,"props":779,"children":780},{"type":376},[],{"type":18,"value":782}," be externally synchronized",{"type":13,"tag":269,"props":784,"children":785},{},[786,788,793,794,799,800,803],{"type":18,"value":787},"Host access to the ",{"type":13,"tag":43,"props":789,"children":791},{"className":790},[],[792],{"type":18,"value":707},{"type":18,"value":709},{"type":13,"tag":43,"props":795,"children":797},{"className":796},[],[798],{"type":18,"value":84},{"type":18,"value":716},{"type":13,"tag":374,"props":801,"children":802},{"type":376},[],{"type":18,"value":804}," be externally synchronized\n::",{"type":13,"tag":806,"props":807,"children":808},"style",{},[809],{"type":18,"value":810},"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":812},[],"markdown",1725732610084]