[{"data":1,"prerenderedAt":882},["ShallowReactive",2],{"zxPvHPbjrb":3},{"title":4,"description":5,"parent":6,"cmd_buf_level":7,"render_pass_scope":10,"supported_queue_types":11,"tasks":13,"type":15,"xrefs":16,"body":17,"_type":881,"_id":4},"vkCmdSetSampleMaskEXT","Specify the sample mask dynamically for a command buffer","VK_EXT_extended_dynamic_state3, VK_EXT_shader_object",[8,9],"primary","secondary","both",[12],"graphics",[14],"state","protos",[],{"type":18,"children":19,"toc":879},"root",[20,37,272,330,380,465,490,757,781,809,823,827,873],{"type":21,"tag":22,"props":23,"children":24},"element","p",{},[25,28,35],{"type":26,"value":27},"text","To ",{"type":21,"tag":29,"props":30,"children":32},"a",{"href":31},"/chapters/pipelines#pipelines-dynamic-state",[33],{"type":26,"value":34},"dynamically set",{"type":26,"value":36}," the sample mask, call:",{"type":21,"tag":38,"props":39,"children":40},"code-group",{},[41,145],{"type":21,"tag":42,"props":43,"children":49},"pre",{"className":44,"code":45,"filename":46,"language":47,"meta":48,"style":48},"language-c shiki shiki-themes github-light-default github-dark-default","void vkCmdSetSampleMaskEXT(\n    VkCommandBuffer commandBuffer,\n    VkSampleCountFlagBits  samples,\n    const VkSampleMask*    pSampleMask);\n","C","c","",[50],{"type":21,"tag":51,"props":52,"children":53},"code",{"__ignoreMap":48},[54,78,98,116],{"type":21,"tag":55,"props":56,"children":59},"span",{"class":57,"line":58},"line",1,[60,66,72],{"type":21,"tag":55,"props":61,"children":63},{"style":62},"--shiki-default:#CF222E;--shiki-dark:#FF7B72",[64],{"type":26,"value":65},"void",{"type":21,"tag":55,"props":67,"children":69},{"style":68},"--shiki-default:#8250DF;--shiki-dark:#D2A8FF",[70],{"type":26,"value":71}," vkCmdSetSampleMaskEXT",{"type":21,"tag":55,"props":73,"children":75},{"style":74},"--shiki-default:#1F2328;--shiki-dark:#E6EDF3",[76],{"type":26,"value":77},"(\n",{"type":21,"tag":55,"props":79,"children":81},{"class":57,"line":80},2,[82,87,93],{"type":21,"tag":55,"props":83,"children":84},{"style":74},[85],{"type":26,"value":86},"    VkCommandBuffer ",{"type":21,"tag":55,"props":88,"children":90},{"style":89},"--shiki-default:#953800;--shiki-dark:#FFA657",[91],{"type":26,"value":92},"commandBuffer",{"type":21,"tag":55,"props":94,"children":95},{"style":74},[96],{"type":26,"value":97},",\n",{"type":21,"tag":55,"props":99,"children":101},{"class":57,"line":100},3,[102,107,112],{"type":21,"tag":55,"props":103,"children":104},{"style":74},[105],{"type":26,"value":106},"    VkSampleCountFlagBits  ",{"type":21,"tag":55,"props":108,"children":109},{"style":89},[110],{"type":26,"value":111},"samples",{"type":21,"tag":55,"props":113,"children":114},{"style":74},[115],{"type":26,"value":97},{"type":21,"tag":55,"props":117,"children":119},{"class":57,"line":118},4,[120,125,130,135,140],{"type":21,"tag":55,"props":121,"children":122},{"style":62},[123],{"type":26,"value":124},"    const",{"type":21,"tag":55,"props":126,"children":127},{"style":74},[128],{"type":26,"value":129}," VkSampleMask",{"type":21,"tag":55,"props":131,"children":132},{"style":62},[133],{"type":26,"value":134},"*",{"type":21,"tag":55,"props":136,"children":137},{"style":89},[138],{"type":26,"value":139},"    pSampleMask",{"type":21,"tag":55,"props":141,"children":142},{"style":74},[143],{"type":26,"value":144},");\n",{"type":21,"tag":42,"props":146,"children":151},{"className":147,"code":148,"filename":149,"language":150,"meta":48,"style":48},"language-rs shiki shiki-themes github-light-default github-dark-default","pub fn cmd_set_sample_mask_ext(\n    command_buffer: vk::CommandBuffer,\n    samples: SampleCountFlags,\n    p_sample_mask: *const vk::SampleMask,\n);\n","Rust","rs",[152],{"type":21,"tag":51,"props":153,"children":154},{"__ignoreMap":48},[155,177,209,230,264],{"type":21,"tag":55,"props":156,"children":157},{"class":57,"line":58},[158,163,168,173],{"type":21,"tag":55,"props":159,"children":160},{"style":62},[161],{"type":26,"value":162},"pub",{"type":21,"tag":55,"props":164,"children":165},{"style":62},[166],{"type":26,"value":167}," fn",{"type":21,"tag":55,"props":169,"children":170},{"style":68},[171],{"type":26,"value":172}," cmd_set_sample_mask_ext",{"type":21,"tag":55,"props":174,"children":175},{"style":74},[176],{"type":26,"value":77},{"type":21,"tag":55,"props":178,"children":179},{"class":57,"line":80},[180,185,190,195,200,205],{"type":21,"tag":55,"props":181,"children":182},{"style":74},[183],{"type":26,"value":184},"    command_buffer",{"type":21,"tag":55,"props":186,"children":187},{"style":62},[188],{"type":26,"value":189},":",{"type":21,"tag":55,"props":191,"children":192},{"style":89},[193],{"type":26,"value":194}," vk",{"type":21,"tag":55,"props":196,"children":197},{"style":62},[198],{"type":26,"value":199},"::",{"type":21,"tag":55,"props":201,"children":202},{"style":89},[203],{"type":26,"value":204},"CommandBuffer",{"type":21,"tag":55,"props":206,"children":207},{"style":74},[208],{"type":26,"value":97},{"type":21,"tag":55,"props":210,"children":211},{"class":57,"line":100},[212,217,221,226],{"type":21,"tag":55,"props":213,"children":214},{"style":74},[215],{"type":26,"value":216},"    samples",{"type":21,"tag":55,"props":218,"children":219},{"style":62},[220],{"type":26,"value":189},{"type":21,"tag":55,"props":222,"children":223},{"style":89},[224],{"type":26,"value":225}," SampleCountFlags",{"type":21,"tag":55,"props":227,"children":228},{"style":74},[229],{"type":26,"value":97},{"type":21,"tag":55,"props":231,"children":232},{"class":57,"line":118},[233,238,242,247,251,255,260],{"type":21,"tag":55,"props":234,"children":235},{"style":74},[236],{"type":26,"value":237},"    p_sample_mask",{"type":21,"tag":55,"props":239,"children":240},{"style":62},[241],{"type":26,"value":189},{"type":21,"tag":55,"props":243,"children":244},{"style":62},[245],{"type":26,"value":246}," *const",{"type":21,"tag":55,"props":248,"children":249},{"style":89},[250],{"type":26,"value":194},{"type":21,"tag":55,"props":252,"children":253},{"style":62},[254],{"type":26,"value":199},{"type":21,"tag":55,"props":256,"children":257},{"style":89},[258],{"type":26,"value":259},"SampleMask",{"type":21,"tag":55,"props":261,"children":262},{"style":74},[263],{"type":26,"value":97},{"type":21,"tag":55,"props":265,"children":267},{"class":57,"line":266},5,[268],{"type":21,"tag":55,"props":269,"children":270},{"style":74},[271],{"type":26,"value":144},{"type":21,"tag":273,"props":274,"children":275},"ul",{},[276,287,305],{"type":21,"tag":277,"props":278,"children":279},"li",{},[280,285],{"type":21,"tag":51,"props":281,"children":283},{"className":282},[],[284],{"type":26,"value":92},{"type":26,"value":286}," is the command buffer into which the command will be\nrecorded.",{"type":21,"tag":277,"props":288,"children":289},{},[290,295,297,303],{"type":21,"tag":51,"props":291,"children":293},{"className":292},[],[294],{"type":26,"value":111},{"type":26,"value":296}," specifies the number of sample bits in the\n",{"type":21,"tag":51,"props":298,"children":300},{"className":299},[],[301],{"type":26,"value":302},"pSampleMask",{"type":26,"value":304},".",{"type":21,"tag":277,"props":306,"children":307},{},[308,313,315,321,323,328],{"type":21,"tag":51,"props":309,"children":311},{"className":310},[],[312],{"type":26,"value":302},{"type":26,"value":314}," is a pointer to an array of ",{"type":21,"tag":29,"props":316,"children":318},{"href":317},"/man/VkSampleMask",[319],{"type":26,"value":320},"VkSampleMask",{"type":26,"value":322},"\nvalues, where the array size is based on the ",{"type":21,"tag":51,"props":324,"children":326},{"className":325},[],[327],{"type":26,"value":111},{"type":26,"value":329}," parameter.",{"type":21,"tag":22,"props":331,"children":332},{},[333,335,341,343,349,351,357,358,364,366,372,373,378],{"type":26,"value":334},"This command sets the sample mask for subsequent drawing commands\nwhen drawing using ",{"type":21,"tag":29,"props":336,"children":338},{"href":337},"/chapters/shaders#shaders-objects",[339],{"type":26,"value":340},"shader objects",{"type":26,"value":342},", or\nwhen the graphics pipeline is created with\n",{"type":21,"tag":51,"props":344,"children":346},{"className":345},[],[347],{"type":26,"value":348},"VK_DYNAMIC_STATE_SAMPLE_MASK_EXT",{"type":26,"value":350}," set in\n",{"type":21,"tag":29,"props":352,"children":354},{"href":353},"/man/VkPipelineDynamicStateCreateInfo",[355],{"type":26,"value":356},"VkPipelineDynamicStateCreateInfo",{"type":26,"value":199},{"type":21,"tag":51,"props":359,"children":361},{"className":360},[],[362],{"type":26,"value":363},"pDynamicStates",{"type":26,"value":365},".\nOtherwise, this state is specified by the\n",{"type":21,"tag":29,"props":367,"children":369},{"href":368},"/man/VkPipelineMultisampleStateCreateInfo",[370],{"type":26,"value":371},"VkPipelineMultisampleStateCreateInfo",{"type":26,"value":199},{"type":21,"tag":51,"props":374,"children":376},{"className":375},[],[377],{"type":26,"value":302},{"type":26,"value":379}," value used to\ncreate the currently active pipeline.",{"type":21,"tag":381,"props":382,"children":384},"validity-group",{"name":383},"Valid Usage",[385,434],{"type":21,"tag":386,"props":387,"children":389},"validity-field",{"name":388},"VUID-vkCmdSetSampleMaskEXT-None-09423",[390,414],{"type":21,"tag":22,"props":391,"children":392},{},[393,395,400,402,412],{"type":26,"value":394},"At least one of the following ",{"type":21,"tag":396,"props":397,"children":399},"normative",{"type":398},"must",[],{"type":26,"value":401}," be true:- The ",{"type":21,"tag":29,"props":403,"children":405},{"href":404},"/man/VkPhysicalDeviceExtendedDynamicState3FeaturesEXT#features-extendedDynamicState3SampleMask",[406],{"type":21,"tag":51,"props":407,"children":409},{"className":408},[],[410],{"type":26,"value":411},"extendedDynamicState3SampleMask",{"type":26,"value":413}," feature is\nenabled",{"type":21,"tag":273,"props":415,"children":416},{},[417],{"type":21,"tag":277,"props":418,"children":419},{},[420,422,432],{"type":26,"value":421},"The ",{"type":21,"tag":29,"props":423,"children":425},{"href":424},"/man/VkPhysicalDeviceShaderObjectFeaturesEXT#features-shaderObject",[426],{"type":21,"tag":51,"props":427,"children":429},{"className":428},[],[430],{"type":26,"value":431},"shaderObject",{"type":26,"value":433}," feature is enabled\n::",{"type":21,"tag":381,"props":435,"children":437},{"name":436},"Valid Usage (Implicit)",[438],{"type":21,"tag":386,"props":439,"children":441},{"name":440},"VUID-vkCmdSetSampleMaskEXT-commandBuffer-parameter",[442],{"type":21,"tag":22,"props":443,"children":444},{},[445,450,452,455,457,463],{"type":21,"tag":51,"props":446,"children":448},{"className":447},[],[449],{"type":26,"value":92},{"type":26,"value":451}," ",{"type":21,"tag":396,"props":453,"children":454},{"type":398},[],{"type":26,"value":456}," be a valid ",{"type":21,"tag":29,"props":458,"children":460},{"href":459},"/man/VkCommandBuffer",[461],{"type":26,"value":462},"VkCommandBuffer",{"type":26,"value":464}," handle",{"type":21,"tag":386,"props":466,"children":468},{"name":467},"VUID-vkCmdSetSampleMaskEXT-samples-parameter",[469],{"type":21,"tag":22,"props":470,"children":471},{},[472,477,478,481,482,488],{"type":21,"tag":51,"props":473,"children":475},{"className":474},[],[476],{"type":26,"value":111},{"type":26,"value":451},{"type":21,"tag":396,"props":479,"children":480},{"type":398},[],{"type":26,"value":456},{"type":21,"tag":29,"props":483,"children":485},{"href":484},"/man/VkSampleCountFlagBits",[486],{"type":26,"value":487},"VkSampleCountFlagBits",{"type":26,"value":489}," value",{"type":21,"tag":386,"props":491,"children":493},{"name":492},"VUID-vkCmdSetSampleMaskEXT-pSampleMask-parameter",[494],{"type":21,"tag":22,"props":495,"children":496},{},[497,502,503,506,508,750,751,755],{"type":21,"tag":51,"props":498,"children":500},{"className":499},[],[501],{"type":26,"value":302},{"type":26,"value":451},{"type":21,"tag":396,"props":504,"children":505},{"type":398},[],{"type":26,"value":507}," be a valid pointer to an array of ",{"type":21,"tag":55,"props":509,"children":512},{"className":510},[511],"katex",[513,596],{"type":21,"tag":55,"props":514,"children":517},{"className":515},[516],"katex-mathml",[518],{"type":21,"tag":519,"props":520,"children":522},"math",{"xmlns":521},"http://www.w3.org/1998/Math/MathML",[523],{"type":21,"tag":524,"props":525,"children":526},"semantics",{},[527,589],{"type":21,"tag":528,"props":529,"children":530},"mrow",{},[531,538,584],{"type":21,"tag":532,"props":533,"children":535},"mo",{"stretchy":534},"false",[536],{"type":26,"value":537},"⌈",{"type":21,"tag":539,"props":540,"children":541},"mfrac",{},[542,578],{"type":21,"tag":528,"props":543,"children":544},{},[545,551,555,560,564,569,574],{"type":21,"tag":546,"props":547,"children":548},"mi",{},[549],{"type":26,"value":550},"s",{"type":21,"tag":546,"props":552,"children":553},{},[554],{"type":26,"value":29},{"type":21,"tag":546,"props":556,"children":557},{},[558],{"type":26,"value":559},"m",{"type":21,"tag":546,"props":561,"children":562},{},[563],{"type":26,"value":22},{"type":21,"tag":546,"props":565,"children":566},{},[567],{"type":26,"value":568},"l",{"type":21,"tag":546,"props":570,"children":571},{},[572],{"type":26,"value":573},"e",{"type":21,"tag":546,"props":575,"children":576},{},[577],{"type":26,"value":550},{"type":21,"tag":579,"props":580,"children":581},"mn",{},[582],{"type":26,"value":583},"32",{"type":21,"tag":532,"props":585,"children":586},{"stretchy":534},[587],{"type":26,"value":588},"⌉",{"type":21,"tag":590,"props":591,"children":593},"annotation",{"encoding":592},"application/x-tex",[594],{"type":26,"value":595},"\\lceil{\\mathit{samples} \\over 32}\\rceil",{"type":21,"tag":55,"props":597,"children":601},{"className":598,"ariaHidden":600},[599],"katex-html","true",[602],{"type":21,"tag":55,"props":603,"children":606},{"className":604},[605],"base",[607,613,619,745],{"type":21,"tag":55,"props":608,"children":612},{"className":609,"style":611},[610],"strut","height:1.2772em;vertical-align:-0.345em;",[],{"type":21,"tag":55,"props":614,"children":617},{"className":615},[616],"mopen",[618],{"type":26,"value":537},{"type":21,"tag":55,"props":620,"children":623},{"className":621},[622],"mord",[624],{"type":21,"tag":55,"props":625,"children":627},{"className":626},[622],[628,633,740],{"type":21,"tag":55,"props":629,"children":632},{"className":630},[616,631],"nulldelimiter",[],{"type":21,"tag":55,"props":634,"children":636},{"className":635},[539],[637],{"type":21,"tag":55,"props":638,"children":642},{"className":639},[640,641],"vlist-t","vlist-t2",[643,728],{"type":21,"tag":55,"props":644,"children":647},{"className":645},[646],"vlist-r",[648,721],{"type":21,"tag":55,"props":649,"children":653},{"className":650,"style":652},[651],"vlist","height:0.9322em;",[654,681,695],{"type":21,"tag":55,"props":655,"children":657},{"style":656},"top:-2.655em;",[658,664],{"type":21,"tag":55,"props":659,"children":663},{"className":660,"style":662},[661],"pstrut","height:3em;",[],{"type":21,"tag":55,"props":665,"children":671},{"className":666},[667,668,669,670],"sizing","reset-size6","size3","mtight",[672],{"type":21,"tag":55,"props":673,"children":675},{"className":674},[622,670],[676],{"type":21,"tag":55,"props":677,"children":679},{"className":678},[622,670],[680],{"type":26,"value":583},{"type":21,"tag":55,"props":682,"children":684},{"style":683},"top:-3.23em;",[685,689],{"type":21,"tag":55,"props":686,"children":688},{"className":687,"style":662},[661],[],{"type":21,"tag":55,"props":690,"children":694},{"className":691,"style":693},[692],"frac-line","border-bottom-width:0.04em;",[],{"type":21,"tag":55,"props":696,"children":698},{"style":697},"top:-3.4461em;",[699,703],{"type":21,"tag":55,"props":700,"children":702},{"className":701,"style":662},[661],[],{"type":21,"tag":55,"props":704,"children":706},{"className":705},[667,668,669,670],[707],{"type":21,"tag":55,"props":708,"children":710},{"className":709},[622,670],[711],{"type":21,"tag":55,"props":712,"children":714},{"className":713},[622,670],[715],{"type":21,"tag":55,"props":716,"children":719},{"className":717},[622,718,670],"mathit",[720],{"type":26,"value":111},{"type":21,"tag":55,"props":722,"children":725},{"className":723},[724],"vlist-s",[726],{"type":26,"value":727},"​",{"type":21,"tag":55,"props":729,"children":731},{"className":730},[646],[732],{"type":21,"tag":55,"props":733,"children":736},{"className":734,"style":735},[651],"height:0.345em;",[737],{"type":21,"tag":55,"props":738,"children":739},{},[],{"type":21,"tag":55,"props":741,"children":744},{"className":742},[743,631],"mclose",[],{"type":21,"tag":55,"props":746,"children":748},{"className":747},[743],[749],{"type":26,"value":588},{"type":26,"value":451},{"type":21,"tag":29,"props":752,"children":753},{"href":317},[754],{"type":26,"value":320},{"type":26,"value":756}," values",{"type":21,"tag":386,"props":758,"children":760},{"name":759},"VUID-vkCmdSetSampleMaskEXT-commandBuffer-recording",[761],{"type":21,"tag":22,"props":762,"children":763},{},[764,769,770,773,775],{"type":21,"tag":51,"props":765,"children":767},{"className":766},[],[768],{"type":26,"value":92},{"type":26,"value":451},{"type":21,"tag":396,"props":771,"children":772},{"type":398},[],{"type":26,"value":774}," be in the ",{"type":21,"tag":29,"props":776,"children":778},{"href":777},"/chapters/commandbuffers#commandbuffers-lifecycle",[779],{"type":26,"value":780},"recording state",{"type":21,"tag":386,"props":782,"children":784},{"name":783},"VUID-vkCmdSetSampleMaskEXT-commandBuffer-cmdpool",[785],{"type":21,"tag":22,"props":786,"children":787},{},[788,789,795,797,802,804,807],{"type":26,"value":421},{"type":21,"tag":51,"props":790,"children":792},{"className":791},[],[793],{"type":26,"value":794},"VkCommandPool",{"type":26,"value":796}," that ",{"type":21,"tag":51,"props":798,"children":800},{"className":799},[],[801],{"type":26,"value":92},{"type":26,"value":803}," was allocated from ",{"type":21,"tag":396,"props":805,"children":806},{"type":398},[],{"type":26,"value":808}," support graphics operations",{"type":21,"tag":386,"props":810,"children":812},{"name":811},"VUID-vkCmdSetSampleMaskEXT-videocoding",[813],{"type":21,"tag":22,"props":814,"children":815},{},[816,818,821],{"type":26,"value":817},"This command ",{"type":21,"tag":396,"props":819,"children":820},{"type":398},[],{"type":26,"value":822}," only be called outside of a video coding scope",{"type":21,"tag":22,"props":824,"children":825},{},[826],{"type":26,"value":199},{"type":21,"tag":828,"props":829,"children":831},"validity-box",{"name":830},"Host Synchronization",[832],{"type":21,"tag":273,"props":833,"children":834},{},[835,851],{"type":21,"tag":277,"props":836,"children":837},{},[838,840,845,846,849],{"type":26,"value":839},"Host access to ",{"type":21,"tag":51,"props":841,"children":843},{"className":842},[],[844],{"type":26,"value":92},{"type":26,"value":451},{"type":21,"tag":396,"props":847,"children":848},{"type":398},[],{"type":26,"value":850}," be externally synchronized",{"type":21,"tag":277,"props":852,"children":853},{},[854,856,861,862,867,868,871],{"type":26,"value":855},"Host access to the ",{"type":21,"tag":51,"props":857,"children":859},{"className":858},[],[860],{"type":26,"value":794},{"type":26,"value":796},{"type":21,"tag":51,"props":863,"children":865},{"className":864},[],[866],{"type":26,"value":92},{"type":26,"value":803},{"type":21,"tag":396,"props":869,"children":870},{"type":398},[],{"type":26,"value":872}," be externally synchronized\n::",{"type":21,"tag":874,"props":875,"children":876},"style",{},[877],{"type":26,"value":878},"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":48,"searchDepth":80,"depth":80,"links":880},[],"markdown",1729612506332]