[{"data":1,"prerenderedAt":568},["ShallowReactive",2],{"sPVoQPvy5Q":3},{"title":4,"description":5,"parent":6,"type":7,"xrefs":8,"body":9,"_type":567,"_id":4},"VkImageAlignmentControlCreateInfoMESA","Specify image alignment","VK_MESA_image_alignment_control","structs",[],{"type":10,"children":11,"toc":565},"root",[12,45,57,264,317,369,437,531,559],{"type":13,"tag":14,"props":15,"children":16},"element","p",{},[17,20,27,29,36,38,43],{"type":18,"value":19},"text","If the ",{"type":13,"tag":21,"props":22,"children":24},"code",{"className":23},[],[25],{"type":18,"value":26},"pNext",{"type":18,"value":28}," list of ",{"type":13,"tag":30,"props":31,"children":33},"a",{"href":32},"/man/VkImageCreateInfo",[34],{"type":18,"value":35},"VkImageCreateInfo",{"type":18,"value":37}," includes a\n",{"type":13,"tag":21,"props":39,"children":41},{"className":40},[],[42],{"type":18,"value":4},{"type":18,"value":44}," structure, then that structure\ndescribes desired alignment for this image.",{"type":13,"tag":14,"props":46,"children":47},{},[48,50,55],{"type":18,"value":49},"The ",{"type":13,"tag":21,"props":51,"children":53},{"className":52},[],[54],{"type":18,"value":4},{"type":18,"value":56}," structure is defined as:",{"type":13,"tag":58,"props":59,"children":60},"code-group",{},[61,147],{"type":13,"tag":62,"props":63,"children":69},"pre",{"className":64,"code":65,"filename":66,"language":67,"meta":68,"style":68},"language-c shiki shiki-themes github-light-default github-dark-default","typedef struct VkImageAlignmentControlCreateInfoMESA {\n    VkStructureType sType;\n    const void* pNext;\n    uint32_t maximumRequestedAlignment;\n} VkImageAlignmentControlCreateInfoMESA;\n","C","c","",[70],{"type":13,"tag":21,"props":71,"children":72},{"__ignoreMap":68},[73,96,105,124,138],{"type":13,"tag":74,"props":75,"children":78},"span",{"class":76,"line":77},"line",1,[79,85,90],{"type":13,"tag":74,"props":80,"children":82},{"style":81},"--shiki-default:#CF222E;--shiki-dark:#FF7B72",[83],{"type":18,"value":84},"typedef",{"type":13,"tag":74,"props":86,"children":87},{"style":81},[88],{"type":18,"value":89}," struct",{"type":13,"tag":74,"props":91,"children":93},{"style":92},"--shiki-default:#1F2328;--shiki-dark:#E6EDF3",[94],{"type":18,"value":95}," VkImageAlignmentControlCreateInfoMESA {\n",{"type":13,"tag":74,"props":97,"children":99},{"class":76,"line":98},2,[100],{"type":13,"tag":74,"props":101,"children":102},{"style":92},[103],{"type":18,"value":104},"    VkStructureType sType;\n",{"type":13,"tag":74,"props":106,"children":108},{"class":76,"line":107},3,[109,114,119],{"type":13,"tag":74,"props":110,"children":111},{"style":81},[112],{"type":18,"value":113},"    const",{"type":13,"tag":74,"props":115,"children":116},{"style":81},[117],{"type":18,"value":118}," void*",{"type":13,"tag":74,"props":120,"children":121},{"style":92},[122],{"type":18,"value":123}," pNext;\n",{"type":13,"tag":74,"props":125,"children":127},{"class":76,"line":126},4,[128,133],{"type":13,"tag":74,"props":129,"children":130},{"style":81},[131],{"type":18,"value":132},"    uint32_t",{"type":13,"tag":74,"props":134,"children":135},{"style":92},[136],{"type":18,"value":137}," maximumRequestedAlignment;\n",{"type":13,"tag":74,"props":139,"children":141},{"class":76,"line":140},5,[142],{"type":13,"tag":74,"props":143,"children":144},{"style":92},[145],{"type":18,"value":146},"} VkImageAlignmentControlCreateInfoMESA;\n",{"type":13,"tag":62,"props":148,"children":153},{"className":149,"code":150,"filename":151,"language":152,"meta":68,"style":68},"language-rs shiki shiki-themes github-light-default github-dark-default","pub struct ImageAlignmentControlCreateInfoMESA {\n    s_type: vk::StructureType,\n    p_next: *const c_void,\n    maximum_requested_alignment: u32,\n}\n","Rust","rs",[154],{"type":13,"tag":21,"props":155,"children":156},{"__ignoreMap":68},[157,180,213,235,256],{"type":13,"tag":74,"props":158,"children":159},{"class":76,"line":77},[160,165,169,175],{"type":13,"tag":74,"props":161,"children":162},{"style":81},[163],{"type":18,"value":164},"pub",{"type":13,"tag":74,"props":166,"children":167},{"style":81},[168],{"type":18,"value":89},{"type":13,"tag":74,"props":170,"children":172},{"style":171},"--shiki-default:#953800;--shiki-dark:#FFA657",[173],{"type":18,"value":174}," ImageAlignmentControlCreateInfoMESA",{"type":13,"tag":74,"props":176,"children":177},{"style":92},[178],{"type":18,"value":179}," {\n",{"type":13,"tag":74,"props":181,"children":182},{"class":76,"line":98},[183,188,193,198,203,208],{"type":13,"tag":74,"props":184,"children":185},{"style":92},[186],{"type":18,"value":187},"    s_type",{"type":13,"tag":74,"props":189,"children":190},{"style":81},[191],{"type":18,"value":192},":",{"type":13,"tag":74,"props":194,"children":195},{"style":171},[196],{"type":18,"value":197}," vk",{"type":13,"tag":74,"props":199,"children":200},{"style":81},[201],{"type":18,"value":202},"::",{"type":13,"tag":74,"props":204,"children":205},{"style":171},[206],{"type":18,"value":207},"StructureType",{"type":13,"tag":74,"props":209,"children":210},{"style":92},[211],{"type":18,"value":212},",\n",{"type":13,"tag":74,"props":214,"children":215},{"class":76,"line":107},[216,221,225,230],{"type":13,"tag":74,"props":217,"children":218},{"style":92},[219],{"type":18,"value":220},"    p_next",{"type":13,"tag":74,"props":222,"children":223},{"style":81},[224],{"type":18,"value":192},{"type":13,"tag":74,"props":226,"children":227},{"style":81},[228],{"type":18,"value":229}," *const",{"type":13,"tag":74,"props":231,"children":232},{"style":92},[233],{"type":18,"value":234}," c_void,\n",{"type":13,"tag":74,"props":236,"children":237},{"class":76,"line":126},[238,243,247,252],{"type":13,"tag":74,"props":239,"children":240},{"style":92},[241],{"type":18,"value":242},"    maximum_requested_alignment",{"type":13,"tag":74,"props":244,"children":245},{"style":81},[246],{"type":18,"value":192},{"type":13,"tag":74,"props":248,"children":249},{"style":171},[250],{"type":18,"value":251}," u32",{"type":13,"tag":74,"props":253,"children":254},{"style":92},[255],{"type":18,"value":212},{"type":13,"tag":74,"props":257,"children":258},{"class":76,"line":140},[259],{"type":13,"tag":74,"props":260,"children":261},{"style":92},[262],{"type":18,"value":263},"}\n",{"type":13,"tag":265,"props":266,"children":267},"ul",{},[268,288,306],{"type":13,"tag":269,"props":270,"children":271},"li",{},[272,278,280,286],{"type":13,"tag":21,"props":273,"children":275},{"className":274},[],[276],{"type":18,"value":277},"sType",{"type":18,"value":279}," is a ",{"type":13,"tag":30,"props":281,"children":283},{"href":282},"/man/VkStructureType",[284],{"type":18,"value":285},"VkStructureType",{"type":18,"value":287}," value identifying this structure.",{"type":13,"tag":269,"props":289,"children":290},{},[291,296,298,304],{"type":13,"tag":21,"props":292,"children":294},{"className":293},[],[295],{"type":18,"value":26},{"type":18,"value":297}," is ",{"type":13,"tag":21,"props":299,"children":301},{"className":300},[],[302],{"type":18,"value":303},"NULL",{"type":18,"value":305}," or a pointer to a structure extending this\nstructure.",{"type":13,"tag":269,"props":307,"children":308},{},[309,315],{"type":13,"tag":21,"props":310,"children":312},{"className":311},[],[313],{"type":18,"value":314},"maximumRequestedAlignment",{"type":18,"value":316}," specifies the maximum alignment for the\nimage.",{"type":13,"tag":14,"props":318,"children":319},{},[320,322,327,329,334,336,341,343,349,350,356,358,361,363,367],{"type":18,"value":321},"If ",{"type":13,"tag":21,"props":323,"children":325},{"className":324},[],[326],{"type":18,"value":314},{"type":18,"value":328}," is not 0, the implementation ",{"type":13,"tag":330,"props":331,"children":333},"normative",{"type":332},"should",[],{"type":18,"value":335},"\nchoose an image memory layout that requires an alignment no larger than\n",{"type":13,"tag":21,"props":337,"children":339},{"className":338},[],[340],{"type":18,"value":314},{"type":18,"value":342}," as reported in\n",{"type":13,"tag":30,"props":344,"children":346},{"href":345},"/man/VkMemoryRequirements",[347],{"type":18,"value":348},"VkMemoryRequirements",{"type":18,"value":202},{"type":13,"tag":21,"props":351,"children":353},{"className":352},[],[354],{"type":18,"value":355},"alignment",{"type":18,"value":357},".\nIf such a layout does not exist for the given image creation parameters, the\nimplementation ",{"type":13,"tag":330,"props":359,"children":360},{"type":332},[],{"type":18,"value":362}," return the smallest alignment which is supported in\n",{"type":13,"tag":30,"props":364,"children":365},{"href":345},[366],{"type":18,"value":348},{"type":18,"value":368},".",{"type":13,"tag":14,"props":370,"children":371},{},[372,374,379,381,384,386,391,393,396,398,408,410,414,416,422,424,430,432,435],{"type":18,"value":373},"If an implementation needs to disable image compression for\n",{"type":13,"tag":21,"props":375,"children":377},{"className":376},[],[378],{"type":18,"value":314},{"type":18,"value":380}," to be honored -\nwhere a larger alignment would enable image compression -\nthe implementation ",{"type":13,"tag":330,"props":382,"children":383},{"type":332},[],{"type":18,"value":385}," not use ",{"type":13,"tag":21,"props":387,"children":389},{"className":388},[],[390],{"type":18,"value":314},{"type":18,"value":392},", and\n",{"type":13,"tag":330,"props":394,"children":395},{"type":332},[],{"type":18,"value":397}," return the smallest alignment which does not compromise compression.\nIf ",{"type":13,"tag":30,"props":399,"children":401},{"href":400},"/man/VkPhysicalDeviceImageCompressionControlFeaturesEXT#features-imageCompressionControl",[402],{"type":13,"tag":21,"props":403,"children":405},{"className":404},[],[406],{"type":18,"value":407},"imageCompressionControl",{"type":18,"value":409}," is\nenabled, the application ",{"type":13,"tag":330,"props":411,"children":413},{"type":412},"can",[],{"type":18,"value":415}," chain a ",{"type":13,"tag":30,"props":417,"children":419},{"href":418},"/man/VkImageCompressionControlEXT",[420],{"type":18,"value":421},"VkImageCompressionControlEXT",{"type":18,"value":423},"\nwith ",{"type":13,"tag":21,"props":425,"children":427},{"className":426},[],[428],{"type":18,"value":429},"VK_IMAGE_COMPRESSION_DISABLED_EXT",{"type":18,"value":431},".\nIn this case, image compression considerations ",{"type":13,"tag":330,"props":433,"children":434},{"type":332},[],{"type":18,"value":436}," not apply when\nimplementation decides alignment.",{"type":13,"tag":438,"props":439,"children":441},"validity-group",{"name":440},"Valid Usage",[442,471,508],{"type":13,"tag":443,"props":444,"children":446},"validity-field",{"name":445},"VUID-VkImageAlignmentControlCreateInfoMESA-maximumRequestedAlignment-09655",[447],{"type":13,"tag":14,"props":448,"children":449},{},[450,451,456,458,463,465,469],{"type":18,"value":321},{"type":13,"tag":21,"props":452,"children":454},{"className":453},[],[455],{"type":18,"value":314},{"type":18,"value":457}," is not 0,\n",{"type":13,"tag":21,"props":459,"children":461},{"className":460},[],[462],{"type":18,"value":314},{"type":18,"value":464}," ",{"type":13,"tag":330,"props":466,"children":468},{"type":467},"must",[],{"type":18,"value":470}," be a power of two",{"type":13,"tag":443,"props":472,"children":474},{"name":473},"VUID-VkImageAlignmentControlCreateInfoMESA-maximumRequestedAlignment-09656",[475],{"type":13,"tag":14,"props":476,"children":477},{},[478,479,484,486,491,493,503,506],{"type":18,"value":321},{"type":13,"tag":21,"props":480,"children":482},{"className":481},[],[483],{"type":18,"value":314},{"type":18,"value":485}," is not 0, the bitwise-and of\n",{"type":13,"tag":21,"props":487,"children":489},{"className":488},[],[490],{"type":18,"value":314},{"type":18,"value":492}," and\n",{"type":13,"tag":30,"props":494,"children":496},{"href":495},"/man/VkPhysicalDeviceImageAlignmentControlPropertiesMESA#limits-supportedImageAlignmentMask",[497],{"type":13,"tag":21,"props":498,"children":500},{"className":499},[],[501],{"type":18,"value":502},"supportedImageAlignmentMask",{"type":13,"tag":330,"props":504,"children":505},{"type":467},[],{"type":18,"value":507}," be non-zero",{"type":13,"tag":443,"props":509,"children":511},{"name":510},"VUID-VkImageAlignmentControlCreateInfoMESA-imageAlignmentControl-09657",[512],{"type":13,"tag":14,"props":513,"children":514},{},[515,525,526,529],{"type":13,"tag":30,"props":516,"children":518},{"href":517},"/man/VkPhysicalDeviceImageAlignmentControlFeaturesMESA#features-imageAlignmentControl",[519],{"type":13,"tag":21,"props":520,"children":522},{"className":521},[],[523],{"type":18,"value":524},"imageAlignmentControl",{"type":18,"value":464},{"type":13,"tag":330,"props":527,"children":528},{"type":467},[],{"type":18,"value":530}," be\nenabled on the device",{"type":13,"tag":438,"props":532,"children":534},{"name":533},"Valid Usage (Implicit)",[535],{"type":13,"tag":443,"props":536,"children":538},{"name":537},"VUID-VkImageAlignmentControlCreateInfoMESA-sType-sType",[539],{"type":13,"tag":14,"props":540,"children":541},{},[542,547,548,551,553],{"type":13,"tag":21,"props":543,"children":545},{"className":544},[],[546],{"type":18,"value":277},{"type":18,"value":464},{"type":13,"tag":330,"props":549,"children":550},{"type":467},[],{"type":18,"value":552}," be ",{"type":13,"tag":21,"props":554,"children":556},{"className":555},[],[557],{"type":18,"value":558},"VK_STRUCTURE_TYPE_IMAGE_ALIGNMENT_CONTROL_CREATE_INFO_MESA",{"type":13,"tag":560,"props":561,"children":562},"style",{},[563],{"type":18,"value":564},"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":68,"searchDepth":98,"depth":98,"links":566},[],"markdown",1725732556462]