[{"data":1,"prerenderedAt":1546},["ShallowReactive",2],{"wdvbv8Pptm":3},{"title":4,"description":5,"parent":6,"type":7,"xrefs":8,"body":9,"_type":1545,"_id":4},"VkHostImageLayoutTransitionInfo","Structure specifying the parameters of a host-side image layout transition","VK_VERSION_1_4","structs",[],{"type":10,"children":11,"toc":1543},"root",[12,28,351,356,421,537,569,578,627,1389,1537],{"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,140],{"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 VkHostImageLayoutTransitionInfo {\n    VkStructureType sType;\n    const void* pNext;\n    VkImage image;\n    VkImageLayout oldLayout;\n    VkImageLayout newLayout;\n    VkImageSubresourceRange subresourceRange;\n} VkHostImageLayoutTransitionInfo;\n","C","c","",[41],{"type":13,"tag":21,"props":42,"children":43},{"__ignoreMap":39},[44,67,76,95,104,113,122,131],{"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}," VkHostImageLayoutTransitionInfo {\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},"    VkImage image;\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},"    VkImageLayout oldLayout;\n",{"type":13,"tag":45,"props":114,"children":116},{"class":47,"line":115},6,[117],{"type":13,"tag":45,"props":118,"children":119},{"style":63},[120],{"type":18,"value":121},"    VkImageLayout newLayout;\n",{"type":13,"tag":45,"props":123,"children":125},{"class":47,"line":124},7,[126],{"type":13,"tag":45,"props":127,"children":128},{"style":63},[129],{"type":18,"value":130},"    VkImageSubresourceRange subresourceRange;\n",{"type":13,"tag":45,"props":132,"children":134},{"class":47,"line":133},8,[135],{"type":13,"tag":45,"props":136,"children":137},{"style":63},[138],{"type":18,"value":139},"} VkHostImageLayoutTransitionInfo;\n",{"type":13,"tag":33,"props":141,"children":146},{"className":142,"code":143,"filename":144,"language":145,"meta":39,"style":39},"language-rs shiki shiki-themes github-light-default github-dark-default","pub struct HostImageLayoutTransitionInfo {\n    s_type: vk::StructureType,\n    p_next: *const c_void,\n    image: vk::Image,\n    old_layout: vk::ImageLayout,\n    new_layout: vk::ImageLayout,\n    subresource_range: vk::ImageSubresourceRange,\n}\n","Rust","rs",[147],{"type":13,"tag":21,"props":148,"children":149},{"__ignoreMap":39},[150,173,206,228,257,286,314,343],{"type":13,"tag":45,"props":151,"children":152},{"class":47,"line":48},[153,158,162,168],{"type":13,"tag":45,"props":154,"children":155},{"style":52},[156],{"type":18,"value":157},"pub",{"type":13,"tag":45,"props":159,"children":160},{"style":52},[161],{"type":18,"value":60},{"type":13,"tag":45,"props":163,"children":165},{"style":164},"--shiki-default:#953800;--shiki-dark:#FFA657",[166],{"type":18,"value":167}," HostImageLayoutTransitionInfo",{"type":13,"tag":45,"props":169,"children":170},{"style":63},[171],{"type":18,"value":172}," {\n",{"type":13,"tag":45,"props":174,"children":175},{"class":47,"line":69},[176,181,186,191,196,201],{"type":13,"tag":45,"props":177,"children":178},{"style":63},[179],{"type":18,"value":180},"    s_type",{"type":13,"tag":45,"props":182,"children":183},{"style":52},[184],{"type":18,"value":185},":",{"type":13,"tag":45,"props":187,"children":188},{"style":164},[189],{"type":18,"value":190}," vk",{"type":13,"tag":45,"props":192,"children":193},{"style":52},[194],{"type":18,"value":195},"::",{"type":13,"tag":45,"props":197,"children":198},{"style":164},[199],{"type":18,"value":200},"StructureType",{"type":13,"tag":45,"props":202,"children":203},{"style":63},[204],{"type":18,"value":205},",\n",{"type":13,"tag":45,"props":207,"children":208},{"class":47,"line":78},[209,214,218,223],{"type":13,"tag":45,"props":210,"children":211},{"style":63},[212],{"type":18,"value":213},"    p_next",{"type":13,"tag":45,"props":215,"children":216},{"style":52},[217],{"type":18,"value":185},{"type":13,"tag":45,"props":219,"children":220},{"style":52},[221],{"type":18,"value":222}," *const",{"type":13,"tag":45,"props":224,"children":225},{"style":63},[226],{"type":18,"value":227}," c_void,\n",{"type":13,"tag":45,"props":229,"children":230},{"class":47,"line":97},[231,236,240,244,248,253],{"type":13,"tag":45,"props":232,"children":233},{"style":63},[234],{"type":18,"value":235},"    image",{"type":13,"tag":45,"props":237,"children":238},{"style":52},[239],{"type":18,"value":185},{"type":13,"tag":45,"props":241,"children":242},{"style":164},[243],{"type":18,"value":190},{"type":13,"tag":45,"props":245,"children":246},{"style":52},[247],{"type":18,"value":195},{"type":13,"tag":45,"props":249,"children":250},{"style":164},[251],{"type":18,"value":252},"Image",{"type":13,"tag":45,"props":254,"children":255},{"style":63},[256],{"type":18,"value":205},{"type":13,"tag":45,"props":258,"children":259},{"class":47,"line":106},[260,265,269,273,277,282],{"type":13,"tag":45,"props":261,"children":262},{"style":63},[263],{"type":18,"value":264},"    old_layout",{"type":13,"tag":45,"props":266,"children":267},{"style":52},[268],{"type":18,"value":185},{"type":13,"tag":45,"props":270,"children":271},{"style":164},[272],{"type":18,"value":190},{"type":13,"tag":45,"props":274,"children":275},{"style":52},[276],{"type":18,"value":195},{"type":13,"tag":45,"props":278,"children":279},{"style":164},[280],{"type":18,"value":281},"ImageLayout",{"type":13,"tag":45,"props":283,"children":284},{"style":63},[285],{"type":18,"value":205},{"type":13,"tag":45,"props":287,"children":288},{"class":47,"line":115},[289,294,298,302,306,310],{"type":13,"tag":45,"props":290,"children":291},{"style":63},[292],{"type":18,"value":293},"    new_layout",{"type":13,"tag":45,"props":295,"children":296},{"style":52},[297],{"type":18,"value":185},{"type":13,"tag":45,"props":299,"children":300},{"style":164},[301],{"type":18,"value":190},{"type":13,"tag":45,"props":303,"children":304},{"style":52},[305],{"type":18,"value":195},{"type":13,"tag":45,"props":307,"children":308},{"style":164},[309],{"type":18,"value":281},{"type":13,"tag":45,"props":311,"children":312},{"style":63},[313],{"type":18,"value":205},{"type":13,"tag":45,"props":315,"children":316},{"class":47,"line":124},[317,322,326,330,334,339],{"type":13,"tag":45,"props":318,"children":319},{"style":63},[320],{"type":18,"value":321},"    subresource_range",{"type":13,"tag":45,"props":323,"children":324},{"style":52},[325],{"type":18,"value":185},{"type":13,"tag":45,"props":327,"children":328},{"style":164},[329],{"type":18,"value":190},{"type":13,"tag":45,"props":331,"children":332},{"style":52},[333],{"type":18,"value":195},{"type":13,"tag":45,"props":335,"children":336},{"style":164},[337],{"type":18,"value":338},"ImageSubresourceRange",{"type":13,"tag":45,"props":340,"children":341},{"style":63},[342],{"type":18,"value":205},{"type":13,"tag":45,"props":344,"children":345},{"class":47,"line":133},[346],{"type":13,"tag":45,"props":347,"children":348},{"style":63},[349],{"type":18,"value":350},"}\n",{"type":13,"tag":14,"props":352,"children":353},{},[354],{"type":18,"value":355},"or the equivalent",{"type":13,"tag":29,"props":357,"children":358},{},[359,378],{"type":13,"tag":33,"props":360,"children":362},{"className":35,"code":361,"filename":37,"language":38,"meta":39,"style":39},"typedef VkHostImageLayoutTransitionInfo VkHostImageLayoutTransitionInfoEXT;\n",[363],{"type":13,"tag":21,"props":364,"children":365},{"__ignoreMap":39},[366],{"type":13,"tag":45,"props":367,"children":368},{"class":47,"line":48},[369,373],{"type":13,"tag":45,"props":370,"children":371},{"style":52},[372],{"type":18,"value":55},{"type":13,"tag":45,"props":374,"children":375},{"style":63},[376],{"type":18,"value":377}," VkHostImageLayoutTransitionInfo VkHostImageLayoutTransitionInfoEXT;\n",{"type":13,"tag":33,"props":379,"children":381},{"className":142,"code":380,"filename":144,"language":145,"meta":39,"style":39},"type HostImageLayoutTransitionInfoEXT = vk::HostImageLayoutTransitionInfo;\n",[382],{"type":13,"tag":21,"props":383,"children":384},{"__ignoreMap":39},[385],{"type":13,"tag":45,"props":386,"children":387},{"class":47,"line":48},[388,393,398,403,407,411,416],{"type":13,"tag":45,"props":389,"children":390},{"style":52},[391],{"type":18,"value":392},"type",{"type":13,"tag":45,"props":394,"children":395},{"style":164},[396],{"type":18,"value":397}," HostImageLayoutTransitionInfoEXT",{"type":13,"tag":45,"props":399,"children":400},{"style":52},[401],{"type":18,"value":402}," =",{"type":13,"tag":45,"props":404,"children":405},{"style":164},[406],{"type":18,"value":190},{"type":13,"tag":45,"props":408,"children":409},{"style":52},[410],{"type":18,"value":195},{"type":13,"tag":45,"props":412,"children":413},{"style":164},[414],{"type":18,"value":415},"HostImageLayoutTransitionInfo",{"type":13,"tag":45,"props":417,"children":418},{"style":63},[419],{"type":18,"value":420},";\n",{"type":13,"tag":422,"props":423,"children":424},"ul",{},[425,446,465,476,495,511],{"type":13,"tag":426,"props":427,"children":428},"li",{},[429,435,437,444],{"type":13,"tag":21,"props":430,"children":432},{"className":431},[],[433],{"type":18,"value":434},"sType",{"type":18,"value":436}," is a ",{"type":13,"tag":438,"props":439,"children":441},"a",{"href":440},"/man/VkStructureType",[442],{"type":18,"value":443},"VkStructureType",{"type":18,"value":445}," value identifying this structure.",{"type":13,"tag":426,"props":447,"children":448},{},[449,455,457,463],{"type":13,"tag":21,"props":450,"children":452},{"className":451},[],[453],{"type":18,"value":454},"pNext",{"type":18,"value":456}," is ",{"type":13,"tag":21,"props":458,"children":460},{"className":459},[],[461],{"type":18,"value":462},"NULL",{"type":18,"value":464}," or a pointer to a structure extending this\nstructure.",{"type":13,"tag":426,"props":466,"children":467},{},[468,474],{"type":13,"tag":21,"props":469,"children":471},{"className":470},[],[472],{"type":18,"value":473},"image",{"type":18,"value":475}," is a handle to the image affected by this layout transition.",{"type":13,"tag":426,"props":477,"children":478},{},[479,485,487,493],{"type":13,"tag":21,"props":480,"children":482},{"className":481},[],[483],{"type":18,"value":484},"oldLayout",{"type":18,"value":486}," is the old layout in an\n",{"type":13,"tag":438,"props":488,"children":490},{"href":489},"/chapters/synchronization#synchronization-image-layout-transitions",[491],{"type":18,"value":492},"image layout transition",{"type":18,"value":494},".",{"type":13,"tag":426,"props":496,"children":497},{},[498,504,506,510],{"type":13,"tag":21,"props":499,"children":501},{"className":500},[],[502],{"type":18,"value":503},"newLayout",{"type":18,"value":505}," is the new layout in an\n",{"type":13,"tag":438,"props":507,"children":508},{"href":489},[509],{"type":18,"value":492},{"type":18,"value":494},{"type":13,"tag":426,"props":512,"children":513},{},[514,520,522,528,530,535],{"type":13,"tag":21,"props":515,"children":517},{"className":516},[],[518],{"type":18,"value":519},"subresourceRange",{"type":18,"value":521}," describes the ",{"type":13,"tag":438,"props":523,"children":525},{"href":524},"/chapters/resources#resources-image-views",[526],{"type":18,"value":527},"image\nsubresource range",{"type":18,"value":529}," within ",{"type":13,"tag":21,"props":531,"children":533},{"className":532},[],[534],{"type":18,"value":473},{"type":18,"value":536}," that is affected by this layout\ntransition.",{"type":13,"tag":14,"props":538,"children":539},{},[540,546,548,553,555,560,562,568],{"type":13,"tag":21,"props":541,"children":543},{"className":542},[],[544],{"type":18,"value":545},"vkTransitionImageLayout",{"type":18,"value":547}," does not check whether the device memory\nassociated with an image is currently in use before performing the layout\ntransition.\nThe application ",{"type":13,"tag":549,"props":550,"children":552},"normative",{"type":551},"must",[],{"type":18,"value":554}," guarantee that any previously submitted command that\nreads from or writes to this subresource has completed before the host\nperforms the layout transition.\nThe memory of ",{"type":13,"tag":21,"props":556,"children":558},{"className":557},[],[559],{"type":18,"value":473},{"type":18,"value":561}," is accessed by the host as if ",{"type":13,"tag":438,"props":563,"children":565},{"href":564},"/man/VkMemoryPropertyFlagBits#memory-coherent",[566],{"type":18,"value":567},"coherent",{"type":18,"value":494},{"type":13,"tag":570,"props":571,"children":572},"note",{},[573],{"type":13,"tag":14,"props":574,"children":575},{},[576],{"type":18,"value":577},"Image layout transitions performed on the host do not require queue family\nownership transfers as the physical layout of the image will not vary\nbetween queue families for the layouts supported by this function.",{"type":13,"tag":570,"props":579,"children":580},{},[581,614],{"type":13,"tag":14,"props":582,"children":583},{},[584,586,589,591,597,599,605,607,613],{"type":18,"value":585},"If the device has written to the image memory, it is not automatically made\navailable to the host.\nBefore this command can be called, a memory barrier for this image ",{"type":13,"tag":549,"props":587,"children":588},{"type":551},[],{"type":18,"value":590},"\nhave been issued on the device with the second\n",{"type":13,"tag":438,"props":592,"children":594},{"href":593},"/chapters/synchronization#synchronization-dependencies-scopes",[595],{"type":18,"value":596},"synchronization scope",{"type":18,"value":598}," including\n",{"type":13,"tag":21,"props":600,"children":602},{"className":601},[],[603],{"type":18,"value":604},"VK_PIPELINE_STAGE_HOST_BIT",{"type":18,"value":606}," and ",{"type":13,"tag":21,"props":608,"children":610},{"className":609},[],[611],{"type":18,"value":612},"VK_ACCESS_HOST_READ_BIT",{"type":18,"value":494},{"type":13,"tag":14,"props":615,"children":616},{},[617,619,625],{"type":18,"value":618},"Because queue submissions ",{"type":13,"tag":438,"props":620,"children":622},{"href":621},"/chapters/synchronization#synchronization-submission-host-writes",[623],{"type":18,"value":624},"automatically make host memory visible to the device",{"type":18,"value":626},", there would not be a\nneed for a memory barrier before using the results of this layout transition\non the device.",{"type":13,"tag":628,"props":629,"children":631},"validity-group",{"name":630},"Valid Usage",[632,658,700,762,798,855,883,923,967,1027,1085,1137,1195,1249,1283,1314,1361],{"type":13,"tag":633,"props":634,"children":636},"validity-field",{"name":635},"VUID-VkHostImageLayoutTransitionInfo-image-09055",[637],{"type":13,"tag":14,"props":638,"children":639},{},[640,645,647,650,652],{"type":13,"tag":21,"props":641,"children":643},{"className":642},[],[644],{"type":18,"value":473},{"type":18,"value":646}," ",{"type":13,"tag":549,"props":648,"children":649},{"type":551},[],{"type":18,"value":651}," have been created with\n",{"type":13,"tag":21,"props":653,"children":655},{"className":654},[],[656],{"type":18,"value":657},"VK_IMAGE_USAGE_HOST_TRANSFER_BIT",{"type":13,"tag":633,"props":659,"children":661},{"name":660},"VUID-VkHostImageLayoutTransitionInfo-subresourceRange-01486",[662],{"type":13,"tag":14,"props":663,"children":664},{},[665,671,672,675,677,683,685,691,693,698],{"type":13,"tag":21,"props":666,"children":668},{"className":667},[],[669],{"type":18,"value":670},"subresourceRange.baseMipLevel",{"type":18,"value":646},{"type":13,"tag":549,"props":673,"children":674},{"type":551},[],{"type":18,"value":676}," be less than the\n",{"type":13,"tag":21,"props":678,"children":680},{"className":679},[],[681],{"type":18,"value":682},"mipLevels",{"type":18,"value":684}," specified in ",{"type":13,"tag":438,"props":686,"children":688},{"href":687},"/man/VkImageCreateInfo",[689],{"type":18,"value":690},"VkImageCreateInfo",{"type":18,"value":692}," when ",{"type":13,"tag":21,"props":694,"children":696},{"className":695},[],[697],{"type":18,"value":473},{"type":18,"value":699},"\nwas created",{"type":13,"tag":633,"props":701,"children":703},{"name":702},"VUID-VkHostImageLayoutTransitionInfo-subresourceRange-01724",[704],{"type":13,"tag":14,"props":705,"children":706},{},[707,709,715,717,723,725,730,732,737,738,741,743,748,749,753,755,760],{"type":18,"value":708},"If ",{"type":13,"tag":21,"props":710,"children":712},{"className":711},[],[713],{"type":18,"value":714},"subresourceRange.levelCount",{"type":18,"value":716}," is not\n",{"type":13,"tag":21,"props":718,"children":720},{"className":719},[],[721],{"type":18,"value":722},"VK_REMAINING_MIP_LEVELS",{"type":18,"value":724},", ",{"type":13,"tag":21,"props":726,"children":728},{"className":727},[],[729],{"type":18,"value":670},{"type":18,"value":731},"\n+  ",{"type":13,"tag":21,"props":733,"children":735},{"className":734},[],[736],{"type":18,"value":714},{"type":18,"value":646},{"type":13,"tag":549,"props":739,"children":740},{"type":551},[],{"type":18,"value":742}," be less than or equal to\nthe ",{"type":13,"tag":21,"props":744,"children":746},{"className":745},[],[747],{"type":18,"value":682},{"type":18,"value":684},{"type":13,"tag":438,"props":750,"children":751},{"href":687},[752],{"type":18,"value":690},{"type":18,"value":754}," when\n",{"type":13,"tag":21,"props":756,"children":758},{"className":757},[],[759],{"type":18,"value":473},{"type":18,"value":761}," was created",{"type":13,"tag":633,"props":763,"children":765},{"name":764},"VUID-VkHostImageLayoutTransitionInfo-subresourceRange-01488",[766],{"type":13,"tag":14,"props":767,"children":768},{},[769,775,776,779,780,786,787,791,792,797],{"type":13,"tag":21,"props":770,"children":772},{"className":771},[],[773],{"type":18,"value":774},"subresourceRange.baseArrayLayer",{"type":18,"value":646},{"type":13,"tag":549,"props":777,"children":778},{"type":551},[],{"type":18,"value":676},{"type":13,"tag":21,"props":781,"children":783},{"className":782},[],[784],{"type":18,"value":785},"arrayLayers",{"type":18,"value":684},{"type":13,"tag":438,"props":788,"children":789},{"href":687},[790],{"type":18,"value":690},{"type":18,"value":692},{"type":13,"tag":21,"props":793,"children":795},{"className":794},[],[796],{"type":18,"value":473},{"type":18,"value":699},{"type":13,"tag":633,"props":799,"children":801},{"name":800},"VUID-VkHostImageLayoutTransitionInfo-subresourceRange-01725",[802],{"type":13,"tag":14,"props":803,"children":804},{},[805,806,812,813,819,820,825,827,832,833,836,838,843,844,848,849,854],{"type":18,"value":708},{"type":13,"tag":21,"props":807,"children":809},{"className":808},[],[810],{"type":18,"value":811},"subresourceRange.layerCount",{"type":18,"value":716},{"type":13,"tag":21,"props":814,"children":816},{"className":815},[],[817],{"type":18,"value":818},"VK_REMAINING_ARRAY_LAYERS",{"type":18,"value":205},{"type":13,"tag":21,"props":821,"children":823},{"className":822},[],[824],{"type":18,"value":774},{"type":18,"value":826}," +\n",{"type":13,"tag":21,"props":828,"children":830},{"className":829},[],[831],{"type":18,"value":811},{"type":18,"value":646},{"type":13,"tag":549,"props":834,"children":835},{"type":551},[],{"type":18,"value":837}," be less than or equal to the\n",{"type":13,"tag":21,"props":839,"children":841},{"className":840},[],[842],{"type":18,"value":785},{"type":18,"value":684},{"type":13,"tag":438,"props":845,"children":846},{"href":687},[847],{"type":18,"value":690},{"type":18,"value":692},{"type":13,"tag":21,"props":850,"children":852},{"className":851},[],[853],{"type":18,"value":473},{"type":18,"value":699},{"type":13,"tag":633,"props":856,"children":858},{"name":857},"VUID-VkHostImageLayoutTransitionInfo-image-01932",[859],{"type":13,"tag":14,"props":860,"children":861},{},[862,863,868,870,873,875,881],{"type":18,"value":708},{"type":13,"tag":21,"props":864,"children":866},{"className":865},[],[867],{"type":18,"value":473},{"type":18,"value":869}," is non-sparse then it ",{"type":13,"tag":549,"props":871,"children":872},{"type":551},[],{"type":18,"value":874}," be bound completely and\ncontiguously to a single ",{"type":13,"tag":21,"props":876,"children":878},{"className":877},[],[879],{"type":18,"value":880},"VkDeviceMemory",{"type":18,"value":882}," object",{"type":13,"tag":633,"props":884,"children":886},{"name":885},"VUID-VkHostImageLayoutTransitionInfo-image-09241",[887],{"type":13,"tag":14,"props":888,"children":889},{},[890,891,896,898,904,906,911,912,915,917],{"type":18,"value":708},{"type":13,"tag":21,"props":892,"children":894},{"className":893},[],[895],{"type":18,"value":473},{"type":18,"value":897}," has a color format\nthat is single-plane,\nthen the ",{"type":13,"tag":21,"props":899,"children":901},{"className":900},[],[902],{"type":18,"value":903},"aspectMask",{"type":18,"value":905}," member of ",{"type":13,"tag":21,"props":907,"children":909},{"className":908},[],[910],{"type":18,"value":519},{"type":18,"value":646},{"type":13,"tag":549,"props":913,"children":914},{"type":551},[],{"type":18,"value":916}," be\n",{"type":13,"tag":21,"props":918,"children":920},{"className":919},[],[921],{"type":18,"value":922},"VK_IMAGE_ASPECT_COLOR_BIT",{"type":13,"tag":633,"props":924,"children":926},{"name":925},"VUID-VkHostImageLayoutTransitionInfo-image-09242",[927],{"type":13,"tag":14,"props":928,"children":929},{},[930,931,936,938,944,946,951,952,957,958,961,962],{"type":18,"value":708},{"type":13,"tag":21,"props":932,"children":934},{"className":933},[],[935],{"type":18,"value":473},{"type":18,"value":937}," has a color format and is not ",{"type":13,"tag":939,"props":940,"children":941},"em",{},[942],{"type":18,"value":943},"disjoint",{"type":18,"value":945},", then the\n",{"type":13,"tag":21,"props":947,"children":949},{"className":948},[],[950],{"type":18,"value":903},{"type":18,"value":905},{"type":13,"tag":21,"props":953,"children":955},{"className":954},[],[956],{"type":18,"value":519},{"type":18,"value":646},{"type":13,"tag":549,"props":959,"children":960},{"type":551},[],{"type":18,"value":916},{"type":13,"tag":21,"props":963,"children":965},{"className":964},[],[966],{"type":18,"value":922},{"type":13,"tag":633,"props":968,"children":970},{"name":969},"VUID-VkHostImageLayoutTransitionInfo-image-01672",[971],{"type":13,"tag":14,"props":972,"children":973},{},[974,975,980,982,988,990,994,996,1001,1003,1008,1009,1012,1014,1020,1022],{"type":18,"value":708},{"type":13,"tag":21,"props":976,"children":978},{"className":977},[],[979],{"type":18,"value":473},{"type":18,"value":981}," has a ",{"type":13,"tag":438,"props":983,"children":985},{"href":984},"/chapters/formats#formats-multiplanar",[986],{"type":18,"value":987},"multi-planar format",{"type":18,"value":989}," and\nthe image is ",{"type":13,"tag":939,"props":991,"children":992},{},[993],{"type":18,"value":943},{"type":18,"value":995},", then the ",{"type":13,"tag":21,"props":997,"children":999},{"className":998},[],[1000],{"type":18,"value":903},{"type":18,"value":1002}," member of\n",{"type":13,"tag":21,"props":1004,"children":1006},{"className":1005},[],[1007],{"type":18,"value":519},{"type":18,"value":646},{"type":13,"tag":549,"props":1010,"children":1011},{"type":551},[],{"type":18,"value":1013}," include at least one\n",{"type":13,"tag":438,"props":1015,"children":1017},{"href":1016},"/chapters/formats#formats-multiplanar-image-aspect",[1018],{"type":18,"value":1019},"multi-planar aspect mask",{"type":18,"value":1021}," bit or\n",{"type":13,"tag":21,"props":1023,"children":1025},{"className":1024},[],[1026],{"type":18,"value":922},{"type":13,"tag":633,"props":1028,"children":1030},{"name":1029},"VUID-VkHostImageLayoutTransitionInfo-image-03320",[1031],{"type":13,"tag":14,"props":1032,"children":1033},{},[1034,1035,1040,1042,1052,1054,1059,1060,1065,1066,1069,1071,1077,1079],{"type":18,"value":708},{"type":13,"tag":21,"props":1036,"children":1038},{"className":1037},[],[1039],{"type":18,"value":473},{"type":18,"value":1041}," has a depth/stencil format with both depth and stencil\nand the ",{"type":13,"tag":438,"props":1043,"children":1045},{"href":1044},"/man/VkPhysicalDeviceSeparateDepthStencilLayoutsFeatures#features-separateDepthStencilLayouts",[1046],{"type":13,"tag":21,"props":1047,"children":1049},{"className":1048},[],[1050],{"type":18,"value":1051},"separateDepthStencilLayouts",{"type":18,"value":1053}," feature is not enabled,\nthen the ",{"type":13,"tag":21,"props":1055,"children":1057},{"className":1056},[],[1058],{"type":18,"value":903},{"type":18,"value":905},{"type":13,"tag":21,"props":1061,"children":1063},{"className":1062},[],[1064],{"type":18,"value":519},{"type":18,"value":646},{"type":13,"tag":549,"props":1067,"children":1068},{"type":551},[],{"type":18,"value":1070}," include\nboth ",{"type":13,"tag":21,"props":1072,"children":1074},{"className":1073},[],[1075],{"type":18,"value":1076},"VK_IMAGE_ASPECT_DEPTH_BIT",{"type":18,"value":1078}," and\n",{"type":13,"tag":21,"props":1080,"children":1082},{"className":1081},[],[1083],{"type":18,"value":1084},"VK_IMAGE_ASPECT_STENCIL_BIT",{"type":13,"tag":633,"props":1086,"children":1088},{"name":1087},"VUID-VkHostImageLayoutTransitionInfo-image-03319",[1089],{"type":13,"tag":14,"props":1090,"children":1091},{},[1092,1093,1098,1099,1107,1109,1114,1115,1120,1121,1124,1126,1131,1132],{"type":18,"value":708},{"type":13,"tag":21,"props":1094,"children":1096},{"className":1095},[],[1097],{"type":18,"value":473},{"type":18,"value":1041},{"type":13,"tag":438,"props":1100,"children":1101},{"href":1044},[1102],{"type":13,"tag":21,"props":1103,"children":1105},{"className":1104},[],[1106],{"type":18,"value":1051},{"type":18,"value":1108}," feature is enabled, then the\n",{"type":13,"tag":21,"props":1110,"children":1112},{"className":1111},[],[1113],{"type":18,"value":903},{"type":18,"value":905},{"type":13,"tag":21,"props":1116,"children":1118},{"className":1117},[],[1119],{"type":18,"value":519},{"type":18,"value":646},{"type":13,"tag":549,"props":1122,"children":1123},{"type":551},[],{"type":18,"value":1125}," include either\nor both ",{"type":13,"tag":21,"props":1127,"children":1129},{"className":1128},[],[1130],{"type":18,"value":1076},{"type":18,"value":1078},{"type":13,"tag":21,"props":1133,"children":1135},{"className":1134},[],[1136],{"type":18,"value":1084},{"type":13,"tag":633,"props":1138,"children":1140},{"name":1139},"VUID-VkHostImageLayoutTransitionInfo-aspectMask-08702",[1141],{"type":13,"tag":14,"props":1142,"children":1143},{},[1144,1146,1151,1152,1157,1159,1164,1165,1170,1171,1176,1179,1181,1187,1189],{"type":18,"value":1145},"If the ",{"type":13,"tag":21,"props":1147,"children":1149},{"className":1148},[],[1150],{"type":18,"value":903},{"type":18,"value":905},{"type":13,"tag":21,"props":1153,"children":1155},{"className":1154},[],[1156],{"type":18,"value":519},{"type":18,"value":1158}," includes\n",{"type":13,"tag":21,"props":1160,"children":1162},{"className":1161},[],[1163],{"type":18,"value":1076},{"type":18,"value":724},{"type":13,"tag":21,"props":1166,"children":1168},{"className":1167},[],[1169],{"type":18,"value":484},{"type":18,"value":606},{"type":13,"tag":21,"props":1172,"children":1174},{"className":1173},[],[1175],{"type":18,"value":503},{"type":13,"tag":549,"props":1177,"children":1178},{"type":551},[],{"type":18,"value":1180}," not be one of ",{"type":13,"tag":21,"props":1182,"children":1184},{"className":1183},[],[1185],{"type":18,"value":1186},"VK_IMAGE_LAYOUT_STENCIL_ATTACHMENT_OPTIMAL",{"type":18,"value":1188}," or\n",{"type":13,"tag":21,"props":1190,"children":1192},{"className":1191},[],[1193],{"type":18,"value":1194},"VK_IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL",{"type":13,"tag":633,"props":1196,"children":1198},{"name":1197},"VUID-VkHostImageLayoutTransitionInfo-aspectMask-08703",[1199],{"type":13,"tag":14,"props":1200,"children":1201},{},[1202,1203,1208,1209,1214,1215,1220,1221,1226,1227,1232,1235,1236,1242,1243],{"type":18,"value":1145},{"type":13,"tag":21,"props":1204,"children":1206},{"className":1205},[],[1207],{"type":18,"value":903},{"type":18,"value":905},{"type":13,"tag":21,"props":1210,"children":1212},{"className":1211},[],[1213],{"type":18,"value":519},{"type":18,"value":1158},{"type":13,"tag":21,"props":1216,"children":1218},{"className":1217},[],[1219],{"type":18,"value":1084},{"type":18,"value":724},{"type":13,"tag":21,"props":1222,"children":1224},{"className":1223},[],[1225],{"type":18,"value":484},{"type":18,"value":606},{"type":13,"tag":21,"props":1228,"children":1230},{"className":1229},[],[1231],{"type":18,"value":503},{"type":13,"tag":549,"props":1233,"children":1234},{"type":551},[],{"type":18,"value":1180},{"type":13,"tag":21,"props":1237,"children":1239},{"className":1238},[],[1240],{"type":18,"value":1241},"VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_OPTIMAL",{"type":18,"value":1188},{"type":13,"tag":21,"props":1244,"children":1246},{"className":1245},[],[1247],{"type":18,"value":1248},"VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL",{"type":13,"tag":633,"props":1250,"children":1252},{"name":1251},"VUID-VkHostImageLayoutTransitionInfo-subresourceRange-09601",[1253],{"type":13,"tag":14,"props":1254,"children":1255},{},[1256,1262,1263,1266,1268,1274,1276,1281],{"type":13,"tag":21,"props":1257,"children":1259},{"className":1258},[],[1260],{"type":18,"value":1261},"subresourceRange.aspectMask",{"type":18,"value":646},{"type":13,"tag":549,"props":1264,"children":1265},{"type":551},[],{"type":18,"value":1267}," be valid for the ",{"type":13,"tag":21,"props":1269,"children":1271},{"className":1270},[],[1272],{"type":18,"value":1273},"format",{"type":18,"value":1275},"\nthe ",{"type":13,"tag":21,"props":1277,"children":1279},{"className":1278},[],[1280],{"type":18,"value":473},{"type":18,"value":1282}," was created with",{"type":13,"tag":633,"props":1284,"children":1286},{"name":1285},"VUID-VkHostImageLayoutTransitionInfo-oldLayout-09229",[1287],{"type":13,"tag":14,"props":1288,"children":1289},{},[1290,1295,1296,1299,1301,1307,1309],{"type":13,"tag":21,"props":1291,"children":1293},{"className":1292},[],[1294],{"type":18,"value":484},{"type":18,"value":646},{"type":13,"tag":549,"props":1297,"children":1298},{"type":551},[],{"type":18,"value":1300}," be either ",{"type":13,"tag":21,"props":1302,"children":1304},{"className":1303},[],[1305],{"type":18,"value":1306},"VK_IMAGE_LAYOUT_UNDEFINED",{"type":18,"value":1308}," or the\ncurrent layout of the image subresources as specified in\n",{"type":13,"tag":21,"props":1310,"children":1312},{"className":1311},[],[1313],{"type":18,"value":519},{"type":13,"tag":633,"props":1315,"children":1317},{"name":1316},"VUID-VkHostImageLayoutTransitionInfo-oldLayout-09230",[1318],{"type":13,"tag":14,"props":1319,"children":1320},{},[1321,1322,1327,1329,1334,1335,1341,1343,1346,1348,1354,1355],{"type":18,"value":708},{"type":13,"tag":21,"props":1323,"children":1325},{"className":1324},[],[1326],{"type":18,"value":484},{"type":18,"value":1328}," is not ",{"type":13,"tag":21,"props":1330,"children":1332},{"className":1331},[],[1333],{"type":18,"value":1306},{"type":18,"value":1188},{"type":13,"tag":21,"props":1336,"children":1338},{"className":1337},[],[1339],{"type":18,"value":1340},"VK_IMAGE_LAYOUT_PREINITIALIZED",{"type":18,"value":1342},", it ",{"type":13,"tag":549,"props":1344,"children":1345},{"type":551},[],{"type":18,"value":1347}," be one of the layouts in\n",{"type":13,"tag":438,"props":1349,"children":1351},{"href":1350},"/man/VkPhysicalDeviceHostImageCopyProperties",[1352],{"type":18,"value":1353},"VkPhysicalDeviceHostImageCopyProperties",{"type":18,"value":195},{"type":13,"tag":21,"props":1356,"children":1358},{"className":1357},[],[1359],{"type":18,"value":1360},"pCopySrcLayouts",{"type":13,"tag":633,"props":1362,"children":1364},{"name":1363},"VUID-VkHostImageLayoutTransitionInfo-newLayout-09057",[1365],{"type":13,"tag":14,"props":1366,"children":1367},{},[1368,1373,1374,1377,1378,1382,1383],{"type":13,"tag":21,"props":1369,"children":1371},{"className":1370},[],[1372],{"type":18,"value":503},{"type":18,"value":646},{"type":13,"tag":549,"props":1375,"children":1376},{"type":551},[],{"type":18,"value":1347},{"type":13,"tag":438,"props":1379,"children":1380},{"href":1350},[1381],{"type":18,"value":1353},{"type":18,"value":195},{"type":13,"tag":21,"props":1384,"children":1386},{"className":1385},[],[1387],{"type":18,"value":1388},"pCopyDstLayouts",{"type":13,"tag":628,"props":1390,"children":1392},{"name":1391},"Valid Usage (Implicit)",[1393,1417,1439,1465,1490,1512],{"type":13,"tag":633,"props":1394,"children":1396},{"name":1395},"VUID-VkHostImageLayoutTransitionInfo-sType-sType",[1397],{"type":13,"tag":14,"props":1398,"children":1399},{},[1400,1405,1406,1409,1411],{"type":13,"tag":21,"props":1401,"children":1403},{"className":1402},[],[1404],{"type":18,"value":434},{"type":18,"value":646},{"type":13,"tag":549,"props":1407,"children":1408},{"type":551},[],{"type":18,"value":1410}," be ",{"type":13,"tag":21,"props":1412,"children":1414},{"className":1413},[],[1415],{"type":18,"value":1416},"VK_STRUCTURE_TYPE_HOST_IMAGE_LAYOUT_TRANSITION_INFO",{"type":13,"tag":633,"props":1418,"children":1420},{"name":1419},"VUID-VkHostImageLayoutTransitionInfo-pNext-pNext",[1421],{"type":13,"tag":14,"props":1422,"children":1423},{},[1424,1429,1430,1433,1434],{"type":13,"tag":21,"props":1425,"children":1427},{"className":1426},[],[1428],{"type":18,"value":454},{"type":18,"value":646},{"type":13,"tag":549,"props":1431,"children":1432},{"type":551},[],{"type":18,"value":1410},{"type":13,"tag":21,"props":1435,"children":1437},{"className":1436},[],[1438],{"type":18,"value":462},{"type":13,"tag":633,"props":1440,"children":1442},{"name":1441},"VUID-VkHostImageLayoutTransitionInfo-image-parameter",[1443],{"type":13,"tag":14,"props":1444,"children":1445},{},[1446,1451,1452,1455,1457,1463],{"type":13,"tag":21,"props":1447,"children":1449},{"className":1448},[],[1450],{"type":18,"value":473},{"type":18,"value":646},{"type":13,"tag":549,"props":1453,"children":1454},{"type":551},[],{"type":18,"value":1456}," be a valid ",{"type":13,"tag":438,"props":1458,"children":1460},{"href":1459},"/man/VkImage",[1461],{"type":18,"value":1462},"VkImage",{"type":18,"value":1464}," handle",{"type":13,"tag":633,"props":1466,"children":1468},{"name":1467},"VUID-VkHostImageLayoutTransitionInfo-oldLayout-parameter",[1469],{"type":13,"tag":14,"props":1470,"children":1471},{},[1472,1477,1478,1481,1482,1488],{"type":13,"tag":21,"props":1473,"children":1475},{"className":1474},[],[1476],{"type":18,"value":484},{"type":18,"value":646},{"type":13,"tag":549,"props":1479,"children":1480},{"type":551},[],{"type":18,"value":1456},{"type":13,"tag":438,"props":1483,"children":1485},{"href":1484},"/man/VkImageLayout",[1486],{"type":18,"value":1487},"VkImageLayout",{"type":18,"value":1489}," value",{"type":13,"tag":633,"props":1491,"children":1493},{"name":1492},"VUID-VkHostImageLayoutTransitionInfo-newLayout-parameter",[1494],{"type":13,"tag":14,"props":1495,"children":1496},{},[1497,1502,1503,1506,1507,1511],{"type":13,"tag":21,"props":1498,"children":1500},{"className":1499},[],[1501],{"type":18,"value":503},{"type":18,"value":646},{"type":13,"tag":549,"props":1504,"children":1505},{"type":551},[],{"type":18,"value":1456},{"type":13,"tag":438,"props":1508,"children":1509},{"href":1484},[1510],{"type":18,"value":1487},{"type":18,"value":1489},{"type":13,"tag":633,"props":1513,"children":1515},{"name":1514},"VUID-VkHostImageLayoutTransitionInfo-subresourceRange-parameter",[1516],{"type":13,"tag":14,"props":1517,"children":1518},{},[1519,1524,1525,1528,1529,1535],{"type":13,"tag":21,"props":1520,"children":1522},{"className":1521},[],[1523],{"type":18,"value":519},{"type":18,"value":646},{"type":13,"tag":549,"props":1526,"children":1527},{"type":551},[],{"type":18,"value":1456},{"type":13,"tag":438,"props":1530,"children":1532},{"href":1531},"/man/VkImageSubresourceRange",[1533],{"type":18,"value":1534},"VkImageSubresourceRange",{"type":18,"value":1536}," structure",{"type":13,"tag":1538,"props":1539,"children":1540},"style",{},[1541],{"type":18,"value":1542},"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":1544},[],"markdown",1744876549750]