[{"data":1,"prerenderedAt":659},["ShallowReactive",2],{"8aESDCgOHd":3},{"title":4,"description":5,"parent":6,"type":7,"xrefs":8,"body":9,"_type":658,"_id":4},"VkImageStencilUsageCreateInfo","Specify separate usage flags for the stencil aspect of a depth-stencil image","VK_VERSION_1_2","structs",[],{"type":10,"children":11,"toc":656},"root",[12,28,238,243,308,371,398,459,524,573,650],{"type":13,"tag":14,"props":15,"children":16},"element","p",{},[17,20,26],{"type":18,"value":19},"text","The ",{"type":13,"tag":21,"props":22,"children":24},"code",{"className":23},[],[25],{"type":18,"value":4},{"type":18,"value":27}," structure is defined as:",{"type":13,"tag":29,"props":30,"children":31},"code-group",{},[32,113],{"type":13,"tag":33,"props":34,"children":40},"pre",{"className":35,"code":36,"filename":37,"language":38,"meta":39,"style":39},"language-c shiki shiki-themes github-light-default github-dark-default","typedef struct VkImageStencilUsageCreateInfo {\n    VkStructureType sType;\n    const void* pNext;\n    VkImageUsageFlags stencilUsage;\n} VkImageStencilUsageCreateInfo;\n","C","c","",[41],{"type":13,"tag":21,"props":42,"children":43},{"__ignoreMap":39},[44,67,76,95,104],{"type":13,"tag":45,"props":46,"children":49},"span",{"class":47,"line":48},"line",1,[50,56,61],{"type":13,"tag":45,"props":51,"children":53},{"style":52},"--shiki-default:#CF222E;--shiki-dark:#FF7B72",[54],{"type":18,"value":55},"typedef",{"type":13,"tag":45,"props":57,"children":58},{"style":52},[59],{"type":18,"value":60}," struct",{"type":13,"tag":45,"props":62,"children":64},{"style":63},"--shiki-default:#1F2328;--shiki-dark:#E6EDF3",[65],{"type":18,"value":66}," VkImageStencilUsageCreateInfo {\n",{"type":13,"tag":45,"props":68,"children":70},{"class":47,"line":69},2,[71],{"type":13,"tag":45,"props":72,"children":73},{"style":63},[74],{"type":18,"value":75},"    VkStructureType sType;\n",{"type":13,"tag":45,"props":77,"children":79},{"class":47,"line":78},3,[80,85,90],{"type":13,"tag":45,"props":81,"children":82},{"style":52},[83],{"type":18,"value":84},"    const",{"type":13,"tag":45,"props":86,"children":87},{"style":52},[88],{"type":18,"value":89}," void*",{"type":13,"tag":45,"props":91,"children":92},{"style":63},[93],{"type":18,"value":94}," pNext;\n",{"type":13,"tag":45,"props":96,"children":98},{"class":47,"line":97},4,[99],{"type":13,"tag":45,"props":100,"children":101},{"style":63},[102],{"type":18,"value":103},"    VkImageUsageFlags stencilUsage;\n",{"type":13,"tag":45,"props":105,"children":107},{"class":47,"line":106},5,[108],{"type":13,"tag":45,"props":109,"children":110},{"style":63},[111],{"type":18,"value":112},"} VkImageStencilUsageCreateInfo;\n",{"type":13,"tag":33,"props":114,"children":119},{"className":115,"code":116,"filename":117,"language":118,"meta":39,"style":39},"language-rs shiki shiki-themes github-light-default github-dark-default","pub struct ImageStencilUsageCreateInfo {\n    s_type: vk::StructureType,\n    p_next: *const c_void,\n    stencil_usage: vk::ImageUsageFlags,\n}\n","Rust","rs",[120],{"type":13,"tag":21,"props":121,"children":122},{"__ignoreMap":39},[123,146,179,201,230],{"type":13,"tag":45,"props":124,"children":125},{"class":47,"line":48},[126,131,135,141],{"type":13,"tag":45,"props":127,"children":128},{"style":52},[129],{"type":18,"value":130},"pub",{"type":13,"tag":45,"props":132,"children":133},{"style":52},[134],{"type":18,"value":60},{"type":13,"tag":45,"props":136,"children":138},{"style":137},"--shiki-default:#953800;--shiki-dark:#FFA657",[139],{"type":18,"value":140}," ImageStencilUsageCreateInfo",{"type":13,"tag":45,"props":142,"children":143},{"style":63},[144],{"type":18,"value":145}," {\n",{"type":13,"tag":45,"props":147,"children":148},{"class":47,"line":69},[149,154,159,164,169,174],{"type":13,"tag":45,"props":150,"children":151},{"style":63},[152],{"type":18,"value":153},"    s_type",{"type":13,"tag":45,"props":155,"children":156},{"style":52},[157],{"type":18,"value":158},":",{"type":13,"tag":45,"props":160,"children":161},{"style":137},[162],{"type":18,"value":163}," vk",{"type":13,"tag":45,"props":165,"children":166},{"style":52},[167],{"type":18,"value":168},"::",{"type":13,"tag":45,"props":170,"children":171},{"style":137},[172],{"type":18,"value":173},"StructureType",{"type":13,"tag":45,"props":175,"children":176},{"style":63},[177],{"type":18,"value":178},",\n",{"type":13,"tag":45,"props":180,"children":181},{"class":47,"line":78},[182,187,191,196],{"type":13,"tag":45,"props":183,"children":184},{"style":63},[185],{"type":18,"value":186},"    p_next",{"type":13,"tag":45,"props":188,"children":189},{"style":52},[190],{"type":18,"value":158},{"type":13,"tag":45,"props":192,"children":193},{"style":52},[194],{"type":18,"value":195}," *const",{"type":13,"tag":45,"props":197,"children":198},{"style":63},[199],{"type":18,"value":200}," c_void,\n",{"type":13,"tag":45,"props":202,"children":203},{"class":47,"line":97},[204,209,213,217,221,226],{"type":13,"tag":45,"props":205,"children":206},{"style":63},[207],{"type":18,"value":208},"    stencil_usage",{"type":13,"tag":45,"props":210,"children":211},{"style":52},[212],{"type":18,"value":158},{"type":13,"tag":45,"props":214,"children":215},{"style":137},[216],{"type":18,"value":163},{"type":13,"tag":45,"props":218,"children":219},{"style":52},[220],{"type":18,"value":168},{"type":13,"tag":45,"props":222,"children":223},{"style":137},[224],{"type":18,"value":225},"ImageUsageFlags",{"type":13,"tag":45,"props":227,"children":228},{"style":63},[229],{"type":18,"value":178},{"type":13,"tag":45,"props":231,"children":232},{"class":47,"line":106},[233],{"type":13,"tag":45,"props":234,"children":235},{"style":63},[236],{"type":18,"value":237},"}\n",{"type":13,"tag":14,"props":239,"children":240},{},[241],{"type":18,"value":242},"or the equivalent",{"type":13,"tag":29,"props":244,"children":245},{},[246,265],{"type":13,"tag":33,"props":247,"children":249},{"className":35,"code":248,"filename":37,"language":38,"meta":39,"style":39},"typedef VkImageStencilUsageCreateInfo VkImageStencilUsageCreateInfoEXT;\n",[250],{"type":13,"tag":21,"props":251,"children":252},{"__ignoreMap":39},[253],{"type":13,"tag":45,"props":254,"children":255},{"class":47,"line":48},[256,260],{"type":13,"tag":45,"props":257,"children":258},{"style":52},[259],{"type":18,"value":55},{"type":13,"tag":45,"props":261,"children":262},{"style":63},[263],{"type":18,"value":264}," VkImageStencilUsageCreateInfo VkImageStencilUsageCreateInfoEXT;\n",{"type":13,"tag":33,"props":266,"children":268},{"className":115,"code":267,"filename":117,"language":118,"meta":39,"style":39},"type ImageStencilUsageCreateInfoEXT = vk::ImageStencilUsageCreateInfo;\n",[269],{"type":13,"tag":21,"props":270,"children":271},{"__ignoreMap":39},[272],{"type":13,"tag":45,"props":273,"children":274},{"class":47,"line":48},[275,280,285,290,294,298,303],{"type":13,"tag":45,"props":276,"children":277},{"style":52},[278],{"type":18,"value":279},"type",{"type":13,"tag":45,"props":281,"children":282},{"style":137},[283],{"type":18,"value":284}," ImageStencilUsageCreateInfoEXT",{"type":13,"tag":45,"props":286,"children":287},{"style":52},[288],{"type":18,"value":289}," =",{"type":13,"tag":45,"props":291,"children":292},{"style":137},[293],{"type":18,"value":163},{"type":13,"tag":45,"props":295,"children":296},{"style":52},[297],{"type":18,"value":168},{"type":13,"tag":45,"props":299,"children":300},{"style":137},[301],{"type":18,"value":302},"ImageStencilUsageCreateInfo",{"type":13,"tag":45,"props":304,"children":305},{"style":63},[306],{"type":18,"value":307},";\n",{"type":13,"tag":309,"props":310,"children":311},"ul",{},[312,333,352],{"type":13,"tag":313,"props":314,"children":315},"li",{},[316,322,324,331],{"type":13,"tag":21,"props":317,"children":319},{"className":318},[],[320],{"type":18,"value":321},"sType",{"type":18,"value":323}," is a ",{"type":13,"tag":325,"props":326,"children":328},"a",{"href":327},"/man/VkStructureType",[329],{"type":18,"value":330},"VkStructureType",{"type":18,"value":332}," value identifying this structure.",{"type":13,"tag":313,"props":334,"children":335},{},[336,342,344,350],{"type":13,"tag":21,"props":337,"children":339},{"className":338},[],[340],{"type":18,"value":341},"pNext",{"type":18,"value":343}," is ",{"type":13,"tag":21,"props":345,"children":347},{"className":346},[],[348],{"type":18,"value":349},"NULL",{"type":18,"value":351}," or a pointer to a structure extending this\nstructure.",{"type":13,"tag":313,"props":353,"children":354},{},[355,361,363,369],{"type":13,"tag":21,"props":356,"children":358},{"className":357},[],[359],{"type":18,"value":360},"stencilUsage",{"type":18,"value":362}," is a bitmask of ",{"type":13,"tag":325,"props":364,"children":366},{"href":365},"/man/VkImageUsageFlagBits",[367],{"type":18,"value":368},"VkImageUsageFlagBits",{"type":18,"value":370}," describing\nthe intended usage of the stencil aspect of the image.",{"type":13,"tag":14,"props":372,"children":373},{},[374,376,381,383,389,391,396],{"type":18,"value":375},"If the ",{"type":13,"tag":21,"props":377,"children":379},{"className":378},[],[380],{"type":18,"value":341},{"type":18,"value":382}," chain of ",{"type":13,"tag":325,"props":384,"children":386},{"href":385},"/man/VkImageCreateInfo",[387],{"type":18,"value":388},"VkImageCreateInfo",{"type":18,"value":390}," includes a\n",{"type":13,"tag":21,"props":392,"children":394},{"className":393},[],[395],{"type":18,"value":4},{"type":18,"value":397}," structure, then that structure includes\nthe usage flags specific to the stencil aspect of the image for an image\nwith a depth-stencil format.",{"type":13,"tag":14,"props":399,"children":400},{},[401,403,408,410,414,416,421,423,428,430,435,436,440,442,445,446,450,451,457],{"type":18,"value":402},"This structure specifies image usages which only apply to the stencil aspect\nof a depth/stencil format image.\nWhen this structure is included in the ",{"type":13,"tag":21,"props":404,"children":406},{"className":405},[],[407],{"type":18,"value":341},{"type":18,"value":409}," chain of\n",{"type":13,"tag":325,"props":411,"children":412},{"href":385},[413],{"type":18,"value":388},{"type":18,"value":415},", the stencil aspect of the image ",{"type":13,"tag":417,"props":418,"children":420},"normative",{"type":419},"must",[],{"type":18,"value":422}," only be used\nas specified by ",{"type":13,"tag":21,"props":424,"children":426},{"className":425},[],[427],{"type":18,"value":360},{"type":18,"value":429},".\nWhen this structure is not included in the ",{"type":13,"tag":21,"props":431,"children":433},{"className":432},[],[434],{"type":18,"value":341},{"type":18,"value":409},{"type":13,"tag":325,"props":437,"children":438},{"href":385},[439],{"type":18,"value":388},{"type":18,"value":441},", the stencil aspect of an image ",{"type":13,"tag":417,"props":443,"children":444},{"type":419},[],{"type":18,"value":422},{"type":13,"tag":325,"props":447,"children":448},{"href":385},[449],{"type":18,"value":388},{"type":18,"value":168},{"type":13,"tag":21,"props":452,"children":454},{"className":453},[],[455],{"type":18,"value":456},"usage",{"type":18,"value":458},".\nUse of other aspects of an image are unaffected by this structure.",{"type":13,"tag":14,"props":460,"children":461},{},[462,464,468,470,475,476,482,484,490,491,496,497,502,504,509,511,516,517,522],{"type":18,"value":463},"This structure ",{"type":13,"tag":417,"props":465,"children":467},{"type":466},"can",[],{"type":18,"value":469}," also be included in the ",{"type":13,"tag":21,"props":471,"children":473},{"className":472},[],[474],{"type":18,"value":341},{"type":18,"value":409},{"type":13,"tag":325,"props":477,"children":479},{"href":478},"/man/VkPhysicalDeviceImageFormatInfo2",[480],{"type":18,"value":481},"VkPhysicalDeviceImageFormatInfo2",{"type":18,"value":483}," to query additional capabilities\nspecific to image creation parameter combinations including a separate set\nof usage flags for the stencil aspect of the image using\n",{"type":13,"tag":325,"props":485,"children":487},{"href":486},"/man/vkGetPhysicalDeviceImageFormatProperties2",[488],{"type":18,"value":489},"vkGetPhysicalDeviceImageFormatProperties2",{"type":18,"value":429},{"type":13,"tag":21,"props":492,"children":494},{"className":493},[],[495],{"type":18,"value":341},{"type":18,"value":409},{"type":13,"tag":21,"props":498,"children":500},{"className":499},[],[501],{"type":18,"value":481},{"type":18,"value":503}," then the implicit value of\n",{"type":13,"tag":21,"props":505,"children":507},{"className":506},[],[508],{"type":18,"value":360},{"type":18,"value":510}," matches that of\n",{"type":13,"tag":21,"props":512,"children":514},{"className":513},[],[515],{"type":18,"value":481},{"type":18,"value":168},{"type":13,"tag":21,"props":518,"children":520},{"className":519},[],[521],{"type":18,"value":456},{"type":18,"value":523},".",{"type":13,"tag":525,"props":526,"children":528},"validity-group",{"name":527},"Valid Usage",[529],{"type":13,"tag":530,"props":531,"children":533},"validity-field",{"name":532},"VUID-VkImageStencilUsageCreateInfo-stencilUsage-02539",[534],{"type":13,"tag":14,"props":535,"children":536},{},[537,539,544,546,552,554,557,559,565,567],{"type":18,"value":538},"If ",{"type":13,"tag":21,"props":540,"children":542},{"className":541},[],[543],{"type":18,"value":360},{"type":18,"value":545}," includes\n",{"type":13,"tag":21,"props":547,"children":549},{"className":548},[],[550],{"type":18,"value":551},"VK_IMAGE_USAGE_TRANSIENT_ATTACHMENT_BIT",{"type":18,"value":553},", it ",{"type":13,"tag":417,"props":555,"children":556},{"type":419},[],{"type":18,"value":558}," not include bits\nother than ",{"type":13,"tag":21,"props":560,"children":562},{"className":561},[],[563],{"type":18,"value":564},"VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT",{"type":18,"value":566}," or\n",{"type":13,"tag":21,"props":568,"children":570},{"className":569},[],[571],{"type":18,"value":572},"VK_IMAGE_USAGE_INPUT_ATTACHMENT_BIT",{"type":13,"tag":525,"props":574,"children":576},{"name":575},"Valid Usage (Implicit)",[577,602,626],{"type":13,"tag":530,"props":578,"children":580},{"name":579},"VUID-VkImageStencilUsageCreateInfo-sType-sType",[581],{"type":13,"tag":14,"props":582,"children":583},{},[584,589,591,594,596],{"type":13,"tag":21,"props":585,"children":587},{"className":586},[],[588],{"type":18,"value":321},{"type":18,"value":590}," ",{"type":13,"tag":417,"props":592,"children":593},{"type":419},[],{"type":18,"value":595}," be ",{"type":13,"tag":21,"props":597,"children":599},{"className":598},[],[600],{"type":18,"value":601},"VK_STRUCTURE_TYPE_IMAGE_STENCIL_USAGE_CREATE_INFO",{"type":13,"tag":530,"props":603,"children":605},{"name":604},"VUID-VkImageStencilUsageCreateInfo-stencilUsage-parameter",[606],{"type":13,"tag":14,"props":607,"children":608},{},[609,614,615,618,620,624],{"type":13,"tag":21,"props":610,"children":612},{"className":611},[],[613],{"type":18,"value":360},{"type":18,"value":590},{"type":13,"tag":417,"props":616,"children":617},{"type":419},[],{"type":18,"value":619}," be a valid combination of ",{"type":13,"tag":325,"props":621,"children":622},{"href":365},[623],{"type":18,"value":368},{"type":18,"value":625}," values",{"type":13,"tag":530,"props":627,"children":629},{"name":628},"VUID-VkImageStencilUsageCreateInfo-stencilUsage-requiredbitmask",[630],{"type":13,"tag":14,"props":631,"children":632},{},[633,638,639,642,644],{"type":13,"tag":21,"props":634,"children":636},{"className":635},[],[637],{"type":18,"value":360},{"type":18,"value":590},{"type":13,"tag":417,"props":640,"children":641},{"type":419},[],{"type":18,"value":643}," not be ",{"type":13,"tag":21,"props":645,"children":647},{"className":646},[],[648],{"type":18,"value":649},"0",{"type":13,"tag":651,"props":652,"children":653},"style",{},[654],{"type":18,"value":655},"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":39,"searchDepth":69,"depth":69,"links":657},[],"markdown",1725732558406]