[{"data":1,"prerenderedAt":1518},["ShallowReactive",2],{"w0Yvelnfu3":3},{"title":4,"description":5,"parent":6,"type":7,"xrefs":8,"body":9,"_type":1517,"_id":4},"VkImageLayout","Layout of image and image subresources","VK_VERSION_1_0","enums",[],{"type":10,"children":11,"toc":1515},"root",[12,20,670,675,1451,1509],{"type":13,"tag":14,"props":15,"children":16},"element","p",{},[17],{"type":18,"value":19},"text","The set of image layouts consists of:",{"type":13,"tag":21,"props":22,"children":23},"code-group",{},[24,270],{"type":13,"tag":25,"props":26,"children":32},"pre",{"className":27,"code":28,"filename":29,"language":30,"meta":31,"style":31},"language-c shiki shiki-themes github-light-default github-dark-default","typedef enum VkImageLayout {\n    VK_IMAGE_LAYOUT_UNDEFINED = 0,\n    VK_IMAGE_LAYOUT_GENERAL = 1,\n    VK_IMAGE_LAYOUT_COLOR_ATTACHMENT_OPTIMAL = 2,\n    VK_IMAGE_LAYOUT_DEPTH_STENCIL_ATTACHMENT_OPTIMAL = 3,\n    VK_IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL = 4,\n    VK_IMAGE_LAYOUT_SHADER_READ_ONLY_OPTIMAL = 5,\n    VK_IMAGE_LAYOUT_TRANSFER_SRC_OPTIMAL = 6,\n    VK_IMAGE_LAYOUT_TRANSFER_DST_OPTIMAL = 7,\n    VK_IMAGE_LAYOUT_PREINITIALIZED = 8,\n} VkImageLayout;\n","C","c","",[33],{"type":13,"tag":34,"props":35,"children":36},"code",{"__ignoreMap":31},[37,60,85,107,129,151,173,195,217,239,261],{"type":13,"tag":38,"props":39,"children":42},"span",{"class":40,"line":41},"line",1,[43,49,54],{"type":13,"tag":38,"props":44,"children":46},{"style":45},"--shiki-default:#CF222E;--shiki-dark:#FF7B72",[47],{"type":18,"value":48},"typedef",{"type":13,"tag":38,"props":50,"children":51},{"style":45},[52],{"type":18,"value":53}," enum",{"type":13,"tag":38,"props":55,"children":57},{"style":56},"--shiki-default:#1F2328;--shiki-dark:#E6EDF3",[58],{"type":18,"value":59}," VkImageLayout {\n",{"type":13,"tag":38,"props":61,"children":63},{"class":40,"line":62},2,[64,69,74,80],{"type":13,"tag":38,"props":65,"children":66},{"style":56},[67],{"type":18,"value":68},"    VK_IMAGE_LAYOUT_UNDEFINED ",{"type":13,"tag":38,"props":70,"children":71},{"style":45},[72],{"type":18,"value":73},"=",{"type":13,"tag":38,"props":75,"children":77},{"style":76},"--shiki-default:#0550AE;--shiki-dark:#79C0FF",[78],{"type":18,"value":79}," 0",{"type":13,"tag":38,"props":81,"children":82},{"style":56},[83],{"type":18,"value":84},",\n",{"type":13,"tag":38,"props":86,"children":88},{"class":40,"line":87},3,[89,94,98,103],{"type":13,"tag":38,"props":90,"children":91},{"style":56},[92],{"type":18,"value":93},"    VK_IMAGE_LAYOUT_GENERAL ",{"type":13,"tag":38,"props":95,"children":96},{"style":45},[97],{"type":18,"value":73},{"type":13,"tag":38,"props":99,"children":100},{"style":76},[101],{"type":18,"value":102}," 1",{"type":13,"tag":38,"props":104,"children":105},{"style":56},[106],{"type":18,"value":84},{"type":13,"tag":38,"props":108,"children":110},{"class":40,"line":109},4,[111,116,120,125],{"type":13,"tag":38,"props":112,"children":113},{"style":56},[114],{"type":18,"value":115},"    VK_IMAGE_LAYOUT_COLOR_ATTACHMENT_OPTIMAL ",{"type":13,"tag":38,"props":117,"children":118},{"style":45},[119],{"type":18,"value":73},{"type":13,"tag":38,"props":121,"children":122},{"style":76},[123],{"type":18,"value":124}," 2",{"type":13,"tag":38,"props":126,"children":127},{"style":56},[128],{"type":18,"value":84},{"type":13,"tag":38,"props":130,"children":132},{"class":40,"line":131},5,[133,138,142,147],{"type":13,"tag":38,"props":134,"children":135},{"style":56},[136],{"type":18,"value":137},"    VK_IMAGE_LAYOUT_DEPTH_STENCIL_ATTACHMENT_OPTIMAL ",{"type":13,"tag":38,"props":139,"children":140},{"style":45},[141],{"type":18,"value":73},{"type":13,"tag":38,"props":143,"children":144},{"style":76},[145],{"type":18,"value":146}," 3",{"type":13,"tag":38,"props":148,"children":149},{"style":56},[150],{"type":18,"value":84},{"type":13,"tag":38,"props":152,"children":154},{"class":40,"line":153},6,[155,160,164,169],{"type":13,"tag":38,"props":156,"children":157},{"style":56},[158],{"type":18,"value":159},"    VK_IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL ",{"type":13,"tag":38,"props":161,"children":162},{"style":45},[163],{"type":18,"value":73},{"type":13,"tag":38,"props":165,"children":166},{"style":76},[167],{"type":18,"value":168}," 4",{"type":13,"tag":38,"props":170,"children":171},{"style":56},[172],{"type":18,"value":84},{"type":13,"tag":38,"props":174,"children":176},{"class":40,"line":175},7,[177,182,186,191],{"type":13,"tag":38,"props":178,"children":179},{"style":56},[180],{"type":18,"value":181},"    VK_IMAGE_LAYOUT_SHADER_READ_ONLY_OPTIMAL ",{"type":13,"tag":38,"props":183,"children":184},{"style":45},[185],{"type":18,"value":73},{"type":13,"tag":38,"props":187,"children":188},{"style":76},[189],{"type":18,"value":190}," 5",{"type":13,"tag":38,"props":192,"children":193},{"style":56},[194],{"type":18,"value":84},{"type":13,"tag":38,"props":196,"children":198},{"class":40,"line":197},8,[199,204,208,213],{"type":13,"tag":38,"props":200,"children":201},{"style":56},[202],{"type":18,"value":203},"    VK_IMAGE_LAYOUT_TRANSFER_SRC_OPTIMAL ",{"type":13,"tag":38,"props":205,"children":206},{"style":45},[207],{"type":18,"value":73},{"type":13,"tag":38,"props":209,"children":210},{"style":76},[211],{"type":18,"value":212}," 6",{"type":13,"tag":38,"props":214,"children":215},{"style":56},[216],{"type":18,"value":84},{"type":13,"tag":38,"props":218,"children":220},{"class":40,"line":219},9,[221,226,230,235],{"type":13,"tag":38,"props":222,"children":223},{"style":56},[224],{"type":18,"value":225},"    VK_IMAGE_LAYOUT_TRANSFER_DST_OPTIMAL ",{"type":13,"tag":38,"props":227,"children":228},{"style":45},[229],{"type":18,"value":73},{"type":13,"tag":38,"props":231,"children":232},{"style":76},[233],{"type":18,"value":234}," 7",{"type":13,"tag":38,"props":236,"children":237},{"style":56},[238],{"type":18,"value":84},{"type":13,"tag":38,"props":240,"children":242},{"class":40,"line":241},10,[243,248,252,257],{"type":13,"tag":38,"props":244,"children":245},{"style":56},[246],{"type":18,"value":247},"    VK_IMAGE_LAYOUT_PREINITIALIZED ",{"type":13,"tag":38,"props":249,"children":250},{"style":45},[251],{"type":18,"value":73},{"type":13,"tag":38,"props":253,"children":254},{"style":76},[255],{"type":18,"value":256}," 8",{"type":13,"tag":38,"props":258,"children":259},{"style":56},[260],{"type":18,"value":84},{"type":13,"tag":38,"props":262,"children":264},{"class":40,"line":263},11,[265],{"type":13,"tag":38,"props":266,"children":267},{"style":56},[268],{"type":18,"value":269},"} VkImageLayout;\n",{"type":13,"tag":25,"props":271,"children":276},{"className":272,"code":273,"filename":274,"language":275,"meta":31,"style":31},"language-rs shiki shiki-themes github-light-default github-dark-default","pub struct ImageLayout(u32);\nimpl ImageLayout {\n    pub const UNDEFINED: Self = 0;\n    pub const GENERAL: Self = 1;\n    pub const COLOR_ATTACHMENT_OPTIMAL: Self = 2;\n    pub const DEPTH_STENCIL_ATTACHMENT_OPTIMAL: Self = 3;\n    pub const DEPTH_STENCIL_READ_ONLY_OPTIMAL: Self = 4;\n    pub const SHADER_READ_ONLY_OPTIMAL: Self = 5;\n    pub const TRANSFER_SRC_OPTIMAL: Self = 6;\n    pub const TRANSFER_DST_OPTIMAL: Self = 7;\n    pub const PREINITIALIZED: Self = 8;\n}\n","Rust","rs",[277],{"type":13,"tag":34,"props":278,"children":279},{"__ignoreMap":31},[280,314,331,373,409,445,481,517,553,589,625,661],{"type":13,"tag":38,"props":281,"children":282},{"class":40,"line":41},[283,288,293,299,304,309],{"type":13,"tag":38,"props":284,"children":285},{"style":45},[286],{"type":18,"value":287},"pub",{"type":13,"tag":38,"props":289,"children":290},{"style":45},[291],{"type":18,"value":292}," struct",{"type":13,"tag":38,"props":294,"children":296},{"style":295},"--shiki-default:#953800;--shiki-dark:#FFA657",[297],{"type":18,"value":298}," ImageLayout",{"type":13,"tag":38,"props":300,"children":301},{"style":56},[302],{"type":18,"value":303},"(",{"type":13,"tag":38,"props":305,"children":306},{"style":295},[307],{"type":18,"value":308},"u32",{"type":13,"tag":38,"props":310,"children":311},{"style":56},[312],{"type":18,"value":313},");\n",{"type":13,"tag":38,"props":315,"children":316},{"class":40,"line":62},[317,322,326],{"type":13,"tag":38,"props":318,"children":319},{"style":45},[320],{"type":18,"value":321},"impl",{"type":13,"tag":38,"props":323,"children":324},{"style":295},[325],{"type":18,"value":298},{"type":13,"tag":38,"props":327,"children":328},{"style":56},[329],{"type":18,"value":330}," {\n",{"type":13,"tag":38,"props":332,"children":333},{"class":40,"line":87},[334,339,344,349,354,359,364,368],{"type":13,"tag":38,"props":335,"children":336},{"style":45},[337],{"type":18,"value":338},"    pub",{"type":13,"tag":38,"props":340,"children":341},{"style":45},[342],{"type":18,"value":343}," const",{"type":13,"tag":38,"props":345,"children":346},{"style":76},[347],{"type":18,"value":348}," UNDEFINED",{"type":13,"tag":38,"props":350,"children":351},{"style":45},[352],{"type":18,"value":353},":",{"type":13,"tag":38,"props":355,"children":356},{"style":76},[357],{"type":18,"value":358}," Self",{"type":13,"tag":38,"props":360,"children":361},{"style":45},[362],{"type":18,"value":363}," =",{"type":13,"tag":38,"props":365,"children":366},{"style":76},[367],{"type":18,"value":79},{"type":13,"tag":38,"props":369,"children":370},{"style":56},[371],{"type":18,"value":372},";\n",{"type":13,"tag":38,"props":374,"children":375},{"class":40,"line":109},[376,380,384,389,393,397,401,405],{"type":13,"tag":38,"props":377,"children":378},{"style":45},[379],{"type":18,"value":338},{"type":13,"tag":38,"props":381,"children":382},{"style":45},[383],{"type":18,"value":343},{"type":13,"tag":38,"props":385,"children":386},{"style":76},[387],{"type":18,"value":388}," GENERAL",{"type":13,"tag":38,"props":390,"children":391},{"style":45},[392],{"type":18,"value":353},{"type":13,"tag":38,"props":394,"children":395},{"style":76},[396],{"type":18,"value":358},{"type":13,"tag":38,"props":398,"children":399},{"style":45},[400],{"type":18,"value":363},{"type":13,"tag":38,"props":402,"children":403},{"style":76},[404],{"type":18,"value":102},{"type":13,"tag":38,"props":406,"children":407},{"style":56},[408],{"type":18,"value":372},{"type":13,"tag":38,"props":410,"children":411},{"class":40,"line":131},[412,416,420,425,429,433,437,441],{"type":13,"tag":38,"props":413,"children":414},{"style":45},[415],{"type":18,"value":338},{"type":13,"tag":38,"props":417,"children":418},{"style":45},[419],{"type":18,"value":343},{"type":13,"tag":38,"props":421,"children":422},{"style":76},[423],{"type":18,"value":424}," COLOR_ATTACHMENT_OPTIMAL",{"type":13,"tag":38,"props":426,"children":427},{"style":45},[428],{"type":18,"value":353},{"type":13,"tag":38,"props":430,"children":431},{"style":76},[432],{"type":18,"value":358},{"type":13,"tag":38,"props":434,"children":435},{"style":45},[436],{"type":18,"value":363},{"type":13,"tag":38,"props":438,"children":439},{"style":76},[440],{"type":18,"value":124},{"type":13,"tag":38,"props":442,"children":443},{"style":56},[444],{"type":18,"value":372},{"type":13,"tag":38,"props":446,"children":447},{"class":40,"line":153},[448,452,456,461,465,469,473,477],{"type":13,"tag":38,"props":449,"children":450},{"style":45},[451],{"type":18,"value":338},{"type":13,"tag":38,"props":453,"children":454},{"style":45},[455],{"type":18,"value":343},{"type":13,"tag":38,"props":457,"children":458},{"style":76},[459],{"type":18,"value":460}," DEPTH_STENCIL_ATTACHMENT_OPTIMAL",{"type":13,"tag":38,"props":462,"children":463},{"style":45},[464],{"type":18,"value":353},{"type":13,"tag":38,"props":466,"children":467},{"style":76},[468],{"type":18,"value":358},{"type":13,"tag":38,"props":470,"children":471},{"style":45},[472],{"type":18,"value":363},{"type":13,"tag":38,"props":474,"children":475},{"style":76},[476],{"type":18,"value":146},{"type":13,"tag":38,"props":478,"children":479},{"style":56},[480],{"type":18,"value":372},{"type":13,"tag":38,"props":482,"children":483},{"class":40,"line":175},[484,488,492,497,501,505,509,513],{"type":13,"tag":38,"props":485,"children":486},{"style":45},[487],{"type":18,"value":338},{"type":13,"tag":38,"props":489,"children":490},{"style":45},[491],{"type":18,"value":343},{"type":13,"tag":38,"props":493,"children":494},{"style":76},[495],{"type":18,"value":496}," DEPTH_STENCIL_READ_ONLY_OPTIMAL",{"type":13,"tag":38,"props":498,"children":499},{"style":45},[500],{"type":18,"value":353},{"type":13,"tag":38,"props":502,"children":503},{"style":76},[504],{"type":18,"value":358},{"type":13,"tag":38,"props":506,"children":507},{"style":45},[508],{"type":18,"value":363},{"type":13,"tag":38,"props":510,"children":511},{"style":76},[512],{"type":18,"value":168},{"type":13,"tag":38,"props":514,"children":515},{"style":56},[516],{"type":18,"value":372},{"type":13,"tag":38,"props":518,"children":519},{"class":40,"line":197},[520,524,528,533,537,541,545,549],{"type":13,"tag":38,"props":521,"children":522},{"style":45},[523],{"type":18,"value":338},{"type":13,"tag":38,"props":525,"children":526},{"style":45},[527],{"type":18,"value":343},{"type":13,"tag":38,"props":529,"children":530},{"style":76},[531],{"type":18,"value":532}," SHADER_READ_ONLY_OPTIMAL",{"type":13,"tag":38,"props":534,"children":535},{"style":45},[536],{"type":18,"value":353},{"type":13,"tag":38,"props":538,"children":539},{"style":76},[540],{"type":18,"value":358},{"type":13,"tag":38,"props":542,"children":543},{"style":45},[544],{"type":18,"value":363},{"type":13,"tag":38,"props":546,"children":547},{"style":76},[548],{"type":18,"value":190},{"type":13,"tag":38,"props":550,"children":551},{"style":56},[552],{"type":18,"value":372},{"type":13,"tag":38,"props":554,"children":555},{"class":40,"line":219},[556,560,564,569,573,577,581,585],{"type":13,"tag":38,"props":557,"children":558},{"style":45},[559],{"type":18,"value":338},{"type":13,"tag":38,"props":561,"children":562},{"style":45},[563],{"type":18,"value":343},{"type":13,"tag":38,"props":565,"children":566},{"style":76},[567],{"type":18,"value":568}," TRANSFER_SRC_OPTIMAL",{"type":13,"tag":38,"props":570,"children":571},{"style":45},[572],{"type":18,"value":353},{"type":13,"tag":38,"props":574,"children":575},{"style":76},[576],{"type":18,"value":358},{"type":13,"tag":38,"props":578,"children":579},{"style":45},[580],{"type":18,"value":363},{"type":13,"tag":38,"props":582,"children":583},{"style":76},[584],{"type":18,"value":212},{"type":13,"tag":38,"props":586,"children":587},{"style":56},[588],{"type":18,"value":372},{"type":13,"tag":38,"props":590,"children":591},{"class":40,"line":241},[592,596,600,605,609,613,617,621],{"type":13,"tag":38,"props":593,"children":594},{"style":45},[595],{"type":18,"value":338},{"type":13,"tag":38,"props":597,"children":598},{"style":45},[599],{"type":18,"value":343},{"type":13,"tag":38,"props":601,"children":602},{"style":76},[603],{"type":18,"value":604}," TRANSFER_DST_OPTIMAL",{"type":13,"tag":38,"props":606,"children":607},{"style":45},[608],{"type":18,"value":353},{"type":13,"tag":38,"props":610,"children":611},{"style":76},[612],{"type":18,"value":358},{"type":13,"tag":38,"props":614,"children":615},{"style":45},[616],{"type":18,"value":363},{"type":13,"tag":38,"props":618,"children":619},{"style":76},[620],{"type":18,"value":234},{"type":13,"tag":38,"props":622,"children":623},{"style":56},[624],{"type":18,"value":372},{"type":13,"tag":38,"props":626,"children":627},{"class":40,"line":263},[628,632,636,641,645,649,653,657],{"type":13,"tag":38,"props":629,"children":630},{"style":45},[631],{"type":18,"value":338},{"type":13,"tag":38,"props":633,"children":634},{"style":45},[635],{"type":18,"value":343},{"type":13,"tag":38,"props":637,"children":638},{"style":76},[639],{"type":18,"value":640}," PREINITIALIZED",{"type":13,"tag":38,"props":642,"children":643},{"style":45},[644],{"type":18,"value":353},{"type":13,"tag":38,"props":646,"children":647},{"style":76},[648],{"type":18,"value":358},{"type":13,"tag":38,"props":650,"children":651},{"style":45},[652],{"type":18,"value":363},{"type":13,"tag":38,"props":654,"children":655},{"style":76},[656],{"type":18,"value":256},{"type":13,"tag":38,"props":658,"children":659},{"style":56},[660],{"type":18,"value":372},{"type":13,"tag":38,"props":662,"children":664},{"class":40,"line":663},12,[665],{"type":13,"tag":38,"props":666,"children":667},{"style":56},[668],{"type":18,"value":669},"}\n",{"type":13,"tag":14,"props":671,"children":672},{},[673],{"type":18,"value":674},"The type(s) of device access supported by each layout are:",{"type":13,"tag":676,"props":677,"children":678},"ul",{},[679,726,790,801,818,829,861,888,913,936,959,969,979,989,999,1026,1060,1082,1097,1113,1151,1180,1217,1228,1271,1281,1317,1353,1409],{"type":13,"tag":680,"props":681,"children":682},"li",{},[683,689,691,696,698,702,704,710,712,719,721,724],{"type":13,"tag":34,"props":684,"children":686},{"className":685},[],[687],{"type":18,"value":688},"VK_IMAGE_LAYOUT_UNDEFINED",{"type":18,"value":690}," specifies that the layout is unknown.\nImage memory ",{"type":13,"tag":692,"props":693,"children":695},"normative",{"type":694},"cannot",[],{"type":18,"value":697}," be transitioned into this layout.\nThis layout ",{"type":13,"tag":692,"props":699,"children":701},{"type":700},"can",[],{"type":18,"value":703}," be used as the ",{"type":13,"tag":34,"props":705,"children":707},{"className":706},[],[708],{"type":18,"value":709},"initialLayout",{"type":18,"value":711}," member of\n",{"type":13,"tag":713,"props":714,"children":716},"a",{"href":715},"/man/VkImageCreateInfo",[717],{"type":18,"value":718},"VkImageCreateInfo",{"type":18,"value":720},".\nThis layout ",{"type":13,"tag":692,"props":722,"children":723},{"type":700},[],{"type":18,"value":725}," be used in place of the current image layout in a\nlayout transition, but doing so will cause the contents of the image’s\nmemory to be undefined:.",{"type":13,"tag":680,"props":727,"children":728},{},[729,735,737,740,742,745,746,749,750,755,756,760,762,765,767,772,774,780,782,788],{"type":13,"tag":34,"props":730,"children":732},{"className":731},[],[733],{"type":18,"value":734},"VK_IMAGE_LAYOUT_PREINITIALIZED",{"type":18,"value":736}," specifies that an image’s memory is\nin a defined layout and ",{"type":13,"tag":692,"props":738,"children":739},{"type":700},[],{"type":18,"value":741}," be populated by data, but that it has not\nyet been initialized by the driver.\nImage memory ",{"type":13,"tag":692,"props":743,"children":744},{"type":694},[],{"type":18,"value":697},{"type":13,"tag":692,"props":747,"children":748},{"type":700},[],{"type":18,"value":703},{"type":13,"tag":34,"props":751,"children":753},{"className":752},[],[754],{"type":18,"value":709},{"type":18,"value":711},{"type":13,"tag":713,"props":757,"children":758},{"href":715},[759],{"type":18,"value":718},{"type":18,"value":761},".\nThis layout is intended to be used as the initial layout for an image\nwhose contents are written by the host, and hence the data ",{"type":13,"tag":692,"props":763,"children":764},{"type":700},[],{"type":18,"value":766}," be\nwritten to memory immediately, without first executing a layout\ntransition.\nCurrently, ",{"type":13,"tag":34,"props":768,"children":770},{"className":769},[],[771],{"type":18,"value":734},{"type":18,"value":773}," is only useful with\n",{"type":13,"tag":713,"props":775,"children":777},{"href":776},"/404#glossary-linear-resource",[778],{"type":18,"value":779},"linear",{"type":18,"value":781}," images because there is not a\nstandard layout defined for ",{"type":13,"tag":34,"props":783,"children":785},{"className":784},[],[786],{"type":18,"value":787},"VK_IMAGE_TILING_OPTIMAL",{"type":18,"value":789}," images.",{"type":13,"tag":680,"props":791,"children":792},{},[793,799],{"type":13,"tag":34,"props":794,"children":796},{"className":795},[],[797],{"type":18,"value":798},"VK_IMAGE_LAYOUT_GENERAL",{"type":18,"value":800}," supports all types of device access.",{"type":13,"tag":680,"props":802,"children":803},{},[804,810,812,816],{"type":13,"tag":34,"props":805,"children":807},{"className":806},[],[808],{"type":18,"value":809},"VK_IMAGE_LAYOUT_ATTACHMENT_OPTIMAL",{"type":18,"value":811}," specifies a layout that ",{"type":13,"tag":692,"props":813,"children":815},{"type":814},"must",[],{"type":18,"value":817},"\nonly be used with attachment accesses in the graphics pipeline.",{"type":13,"tag":680,"props":819,"children":820},{},[821,827],{"type":13,"tag":34,"props":822,"children":824},{"className":823},[],[825],{"type":18,"value":826},"VK_IMAGE_LAYOUT_READ_ONLY_OPTIMAL",{"type":18,"value":828}," specifies a layout allowing read\nonly access as an attachment, or in shaders as a sampled image, combined\nimage/sampler, or input attachment.",{"type":13,"tag":680,"props":830,"children":831},{},[832,838,840,843,845,851,853,859],{"type":13,"tag":34,"props":833,"children":835},{"className":834},[],[836],{"type":18,"value":837},"VK_IMAGE_LAYOUT_COLOR_ATTACHMENT_OPTIMAL",{"type":18,"value":839}," ",{"type":13,"tag":692,"props":841,"children":842},{"type":814},[],{"type":18,"value":844}," only be used as a\ncolor or resolve attachment in a ",{"type":13,"tag":34,"props":846,"children":848},{"className":847},[],[849],{"type":18,"value":850},"VkFramebuffer",{"type":18,"value":852},".\nThis layout is valid only for image subresources of images created with\nthe ",{"type":13,"tag":34,"props":854,"children":856},{"className":855},[],[857],{"type":18,"value":858},"VK_IMAGE_USAGE_COLOR_ATTACHMENT_BIT",{"type":18,"value":860}," usage bit enabled.",{"type":13,"tag":680,"props":862,"children":863},{},[864,870,872,878,880,886],{"type":13,"tag":34,"props":865,"children":867},{"className":866},[],[868],{"type":18,"value":869},"VK_IMAGE_LAYOUT_DEPTH_STENCIL_ATTACHMENT_OPTIMAL",{"type":18,"value":871}," specifies a\nlayout for both the depth and stencil aspects of a depth/stencil format\nimage allowing read and write access as a depth/stencil attachment.\nIt is equivalent to ",{"type":13,"tag":34,"props":873,"children":875},{"className":874},[],[876],{"type":18,"value":877},"VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_OPTIMAL",{"type":18,"value":879}," and\n",{"type":13,"tag":34,"props":881,"children":883},{"className":882},[],[884],{"type":18,"value":885},"VK_IMAGE_LAYOUT_STENCIL_ATTACHMENT_OPTIMAL",{"type":18,"value":887},".",{"type":13,"tag":680,"props":889,"children":890},{},[891,897,899,905,906,912],{"type":13,"tag":34,"props":892,"children":894},{"className":893},[],[895],{"type":18,"value":896},"VK_IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL",{"type":18,"value":898}," specifies a layout\nfor both the depth and stencil aspects of a depth/stencil format image\nallowing read only access as a depth/stencil attachment or in shaders as\na sampled image, combined image/sampler, or input attachment.\nIt is equivalent to ",{"type":13,"tag":34,"props":900,"children":902},{"className":901},[],[903],{"type":18,"value":904},"VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL",{"type":18,"value":879},{"type":13,"tag":34,"props":907,"children":909},{"className":908},[],[910],{"type":18,"value":911},"VK_IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL",{"type":18,"value":887},{"type":13,"tag":680,"props":914,"children":915},{},[916,922,924,929,930,935],{"type":13,"tag":34,"props":917,"children":919},{"className":918},[],[920],{"type":18,"value":921},"VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_STENCIL_ATTACHMENT_OPTIMAL",{"type":18,"value":923},"\nspecifies a layout for depth/stencil format images allowing read and\nwrite access to the stencil aspect as a stencil attachment, and read\nonly access to the depth aspect as a depth attachment or in shaders as a\nsampled image, combined image/sampler, or input attachment.\nIt is equivalent to ",{"type":13,"tag":34,"props":925,"children":927},{"className":926},[],[928],{"type":18,"value":904},{"type":18,"value":879},{"type":13,"tag":34,"props":931,"children":933},{"className":932},[],[934],{"type":18,"value":885},{"type":18,"value":887},{"type":13,"tag":680,"props":937,"children":938},{},[939,945,947,952,953,958],{"type":13,"tag":34,"props":940,"children":942},{"className":941},[],[943],{"type":18,"value":944},"VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_STENCIL_READ_ONLY_OPTIMAL",{"type":18,"value":946},"\nspecifies a layout for depth/stencil format images allowing read and\nwrite access to the depth aspect as a depth attachment, and read only\naccess to the stencil aspect as a stencil attachment or in shaders as a\nsampled image, combined image/sampler, or input attachment.\nIt is equivalent to ",{"type":13,"tag":34,"props":948,"children":950},{"className":949},[],[951],{"type":18,"value":877},{"type":18,"value":879},{"type":13,"tag":34,"props":954,"children":956},{"className":955},[],[957],{"type":18,"value":911},{"type":18,"value":887},{"type":13,"tag":680,"props":960,"children":961},{},[962,967],{"type":13,"tag":34,"props":963,"children":965},{"className":964},[],[966],{"type":18,"value":877},{"type":18,"value":968}," specifies a layout for\nthe depth aspect of a depth/stencil format image allowing read and write\naccess as a depth attachment.",{"type":13,"tag":680,"props":970,"children":971},{},[972,977],{"type":13,"tag":34,"props":973,"children":975},{"className":974},[],[976],{"type":18,"value":904},{"type":18,"value":978}," specifies a layout for the\ndepth aspect of a depth/stencil format image allowing read-only access\nas a depth attachment or in shaders as a sampled image, combined\nimage/sampler, or input attachment.",{"type":13,"tag":680,"props":980,"children":981},{},[982,987],{"type":13,"tag":34,"props":983,"children":985},{"className":984},[],[986],{"type":18,"value":885},{"type":18,"value":988}," specifies a layout for\nthe stencil aspect of a depth/stencil format image allowing read and\nwrite access as a stencil attachment.",{"type":13,"tag":680,"props":990,"children":991},{},[992,997],{"type":13,"tag":34,"props":993,"children":995},{"className":994},[],[996],{"type":18,"value":911},{"type":18,"value":998}," specifies a layout for\nthe stencil aspect of a depth/stencil format image allowing read-only\naccess as a stencil attachment or in shaders as a sampled image,\ncombined image/sampler, or input attachment.",{"type":13,"tag":680,"props":1000,"children":1001},{},[1002,1008,1010,1016,1018,1024],{"type":13,"tag":34,"props":1003,"children":1005},{"className":1004},[],[1006],{"type":18,"value":1007},"VK_IMAGE_LAYOUT_SHADER_READ_ONLY_OPTIMAL",{"type":18,"value":1009}," specifies a layout\nallowing read-only access in a shader as a sampled image, combined\nimage/sampler, or input attachment.\nThis layout is valid only for image subresources of images created with\nthe ",{"type":13,"tag":34,"props":1011,"children":1013},{"className":1012},[],[1014],{"type":18,"value":1015},"VK_IMAGE_USAGE_SAMPLED_BIT",{"type":18,"value":1017}," or\n",{"type":13,"tag":34,"props":1019,"children":1021},{"className":1020},[],[1022],{"type":18,"value":1023},"VK_IMAGE_USAGE_INPUT_ATTACHMENT_BIT",{"type":18,"value":1025}," usage bits enabled.",{"type":13,"tag":680,"props":1027,"children":1028},{},[1029,1035,1036,1039,1041,1051,1053,1059],{"type":13,"tag":34,"props":1030,"children":1032},{"className":1031},[],[1033],{"type":18,"value":1034},"VK_IMAGE_LAYOUT_TRANSFER_SRC_OPTIMAL",{"type":18,"value":839},{"type":13,"tag":692,"props":1037,"children":1038},{"type":814},[],{"type":18,"value":1040}," only be used as a\nsource image of a transfer command (see the definition of\n",{"type":13,"tag":713,"props":1042,"children":1044},{"href":1043},"/man/VkPipelineStageFlagBits#synchronization-pipeline-stages-transfer",[1045],{"type":13,"tag":34,"props":1046,"children":1048},{"className":1047},[],[1049],{"type":18,"value":1050},"VK_PIPELINE_STAGE_TRANSFER_BIT",{"type":18,"value":1052},").\nThis layout is valid only for image subresources of images created with\nthe ",{"type":13,"tag":34,"props":1054,"children":1056},{"className":1055},[],[1057],{"type":18,"value":1058},"VK_IMAGE_USAGE_TRANSFER_SRC_BIT",{"type":18,"value":860},{"type":13,"tag":680,"props":1061,"children":1062},{},[1063,1069,1070,1073,1075,1081],{"type":13,"tag":34,"props":1064,"children":1066},{"className":1065},[],[1067],{"type":18,"value":1068},"VK_IMAGE_LAYOUT_TRANSFER_DST_OPTIMAL",{"type":18,"value":839},{"type":13,"tag":692,"props":1071,"children":1072},{"type":814},[],{"type":18,"value":1074}," only be used as a\ndestination image of a transfer command.\nThis layout is valid only for image subresources of images created with\nthe ",{"type":13,"tag":34,"props":1076,"children":1078},{"className":1077},[],[1079],{"type":18,"value":1080},"VK_IMAGE_USAGE_TRANSFER_DST_BIT",{"type":18,"value":860},{"type":13,"tag":680,"props":1083,"children":1084},{},[1085,1091,1092,1095],{"type":13,"tag":34,"props":1086,"children":1088},{"className":1087},[],[1089],{"type":18,"value":1090},"VK_IMAGE_LAYOUT_PRESENT_SRC_KHR",{"type":18,"value":839},{"type":13,"tag":692,"props":1093,"children":1094},{"type":814},[],{"type":18,"value":1096}," only be used for presenting\na presentable image for display.",{"type":13,"tag":680,"props":1098,"children":1099},{},[1100,1106,1108,1111],{"type":13,"tag":34,"props":1101,"children":1103},{"className":1102},[],[1104],{"type":18,"value":1105},"VK_IMAGE_LAYOUT_SHARED_PRESENT_KHR",{"type":18,"value":1107}," is valid only for shared\npresentable images, and ",{"type":13,"tag":692,"props":1109,"children":1110},{"type":814},[],{"type":18,"value":1112}," be used for any usage the image supports.",{"type":13,"tag":680,"props":1114,"children":1115},{},[1116,1122,1123,1126,1128,1134,1136,1142,1143,1149],{"type":13,"tag":34,"props":1117,"children":1119},{"className":1118},[],[1120],{"type":18,"value":1121},"VK_IMAGE_LAYOUT_FRAGMENT_SHADING_RATE_ATTACHMENT_OPTIMAL_KHR",{"type":18,"value":839},{"type":13,"tag":692,"props":1124,"children":1125},{"type":814},[],{"type":18,"value":1127},"\nonly be used as a\n",{"type":13,"tag":713,"props":1129,"children":1131},{"href":1130},"/chapters/primsrast#primsrast-fragment-shading-rate-attachment",[1132],{"type":18,"value":1133},"fragment shading rate\nattachment",{"type":18,"value":1135},"\nor\n",{"type":13,"tag":713,"props":1137,"children":1139},{"href":1138},"/chapters/primsrast#primsrast-shading-rate-image",[1140],{"type":18,"value":1141},"shading rate image",{"type":18,"value":852},{"type":13,"tag":34,"props":1144,"children":1146},{"className":1145},[],[1147],{"type":18,"value":1148},"VK_IMAGE_USAGE_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR",{"type":18,"value":1150}," usage\nbit enabled.",{"type":13,"tag":680,"props":1152,"children":1153},{},[1154,1160,1161,1164,1166,1172,1173,1179],{"type":13,"tag":34,"props":1155,"children":1157},{"className":1156},[],[1158],{"type":18,"value":1159},"VK_IMAGE_LAYOUT_FRAGMENT_DENSITY_MAP_OPTIMAL_EXT",{"type":18,"value":839},{"type":13,"tag":692,"props":1162,"children":1163},{"type":814},[],{"type":18,"value":1165}," only be\nused as a fragment density map attachment in a ",{"type":13,"tag":34,"props":1167,"children":1169},{"className":1168},[],[1170],{"type":18,"value":1171},"VkRenderPass",{"type":18,"value":852},{"type":13,"tag":34,"props":1174,"children":1176},{"className":1175},[],[1177],{"type":18,"value":1178},"VK_IMAGE_USAGE_FRAGMENT_DENSITY_MAP_BIT_EXT",{"type":18,"value":860},{"type":13,"tag":680,"props":1181,"children":1182},{},[1183,1189,1190,1193,1195,1201,1203,1209,1210,1216],{"type":13,"tag":34,"props":1184,"children":1186},{"className":1185},[],[1187],{"type":18,"value":1188},"VK_IMAGE_LAYOUT_VIDEO_DECODE_DST_KHR",{"type":18,"value":839},{"type":13,"tag":692,"props":1191,"children":1192},{"type":814},[],{"type":18,"value":1194}," only be used as a\n",{"type":13,"tag":713,"props":1196,"children":1198},{"href":1197},"/chapters/video-coding#decode-output-picture",[1199],{"type":18,"value":1200},"decode output picture",{"type":18,"value":1202}," in a\n",{"type":13,"tag":713,"props":1204,"children":1206},{"href":1205},"/chapters/video-coding#video-decode-operations",[1207],{"type":18,"value":1208},"video decode operation",{"type":18,"value":852},{"type":13,"tag":34,"props":1211,"children":1213},{"className":1212},[],[1214],{"type":18,"value":1215},"VK_IMAGE_USAGE_VIDEO_DECODE_DST_BIT_KHR",{"type":18,"value":860},{"type":13,"tag":680,"props":1218,"children":1219},{},[1220,1226],{"type":13,"tag":34,"props":1221,"children":1223},{"className":1222},[],[1224],{"type":18,"value":1225},"VK_IMAGE_LAYOUT_VIDEO_DECODE_SRC_KHR",{"type":18,"value":1227}," is reserved for future use.",{"type":13,"tag":680,"props":1229,"children":1230},{},[1231,1237,1238,1241,1243,1249,1251,1257,1259,1263,1264,1270],{"type":13,"tag":34,"props":1232,"children":1234},{"className":1233},[],[1235],{"type":18,"value":1236},"VK_IMAGE_LAYOUT_VIDEO_DECODE_DPB_KHR",{"type":18,"value":839},{"type":13,"tag":692,"props":1239,"children":1240},{"type":814},[],{"type":18,"value":1242}," only be used as an\noutput ",{"type":13,"tag":713,"props":1244,"children":1246},{"href":1245},"/chapters/video-coding#reconstructed-picture",[1247],{"type":18,"value":1248},"reconstructed picture",{"type":18,"value":1250}," or an input\n",{"type":13,"tag":713,"props":1252,"children":1254},{"href":1253},"/chapters/video-coding#reference-picture",[1255],{"type":18,"value":1256},"reference picture",{"type":18,"value":1258}," in a ",{"type":13,"tag":713,"props":1260,"children":1261},{"href":1205},[1262],{"type":18,"value":1208},{"type":18,"value":852},{"type":13,"tag":34,"props":1265,"children":1267},{"className":1266},[],[1268],{"type":18,"value":1269},"VK_IMAGE_USAGE_VIDEO_DECODE_DPB_BIT_KHR",{"type":18,"value":860},{"type":13,"tag":680,"props":1272,"children":1273},{},[1274,1280],{"type":13,"tag":34,"props":1275,"children":1277},{"className":1276},[],[1278],{"type":18,"value":1279},"VK_IMAGE_LAYOUT_VIDEO_ENCODE_DST_KHR",{"type":18,"value":1227},{"type":13,"tag":680,"props":1282,"children":1283},{},[1284,1290,1291,1294,1296,1302,1303,1309,1310,1316],{"type":13,"tag":34,"props":1285,"children":1287},{"className":1286},[],[1288],{"type":18,"value":1289},"VK_IMAGE_LAYOUT_VIDEO_ENCODE_SRC_KHR",{"type":18,"value":839},{"type":13,"tag":692,"props":1292,"children":1293},{"type":814},[],{"type":18,"value":1295}," only be used as an\n",{"type":13,"tag":713,"props":1297,"children":1299},{"href":1298},"/chapters/video-coding#encode-input-picture",[1300],{"type":18,"value":1301},"encode input picture",{"type":18,"value":1202},{"type":13,"tag":713,"props":1304,"children":1306},{"href":1305},"/chapters/video-coding#video-encode-operations",[1307],{"type":18,"value":1308},"video encode operation",{"type":18,"value":852},{"type":13,"tag":34,"props":1311,"children":1313},{"className":1312},[],[1314],{"type":18,"value":1315},"VK_IMAGE_USAGE_VIDEO_ENCODE_SRC_BIT_KHR",{"type":18,"value":860},{"type":13,"tag":680,"props":1318,"children":1319},{},[1320,1326,1327,1330,1331,1335,1336,1340,1341,1345,1346,1352],{"type":13,"tag":34,"props":1321,"children":1323},{"className":1322},[],[1324],{"type":18,"value":1325},"VK_IMAGE_LAYOUT_VIDEO_ENCODE_DPB_KHR",{"type":18,"value":839},{"type":13,"tag":692,"props":1328,"children":1329},{"type":814},[],{"type":18,"value":1242},{"type":13,"tag":713,"props":1332,"children":1333},{"href":1245},[1334],{"type":18,"value":1248},{"type":18,"value":1250},{"type":13,"tag":713,"props":1337,"children":1338},{"href":1253},[1339],{"type":18,"value":1256},{"type":18,"value":1258},{"type":13,"tag":713,"props":1342,"children":1343},{"href":1305},[1344],{"type":18,"value":1308},{"type":18,"value":852},{"type":13,"tag":34,"props":1347,"children":1349},{"className":1348},[],[1350],{"type":18,"value":1351},"VK_IMAGE_USAGE_VIDEO_ENCODE_DPB_BIT_KHR",{"type":18,"value":860},{"type":13,"tag":680,"props":1354,"children":1355},{},[1356,1362,1363,1366,1368,1373,1375,1381,1383,1388,1389,1395,1397,1402,1403,1408],{"type":13,"tag":34,"props":1357,"children":1359},{"className":1358},[],[1360],{"type":18,"value":1361},"VK_IMAGE_LAYOUT_ATTACHMENT_FEEDBACK_LOOP_OPTIMAL_EXT",{"type":18,"value":839},{"type":13,"tag":692,"props":1364,"children":1365},{"type":814},[],{"type":18,"value":1367}," only be\nused as either a color attachment or depth/stencil attachment in a\n",{"type":13,"tag":34,"props":1369,"children":1371},{"className":1370},[],[1372],{"type":18,"value":850},{"type":18,"value":1374}," and/or read-only access in a shader as a sampled\nimage, combined image/sampler, or input attachment.\nThis layout is valid only for image subresources of images created with\nthe ",{"type":13,"tag":34,"props":1376,"children":1378},{"className":1377},[],[1379],{"type":18,"value":1380},"VK_IMAGE_USAGE_ATTACHMENT_FEEDBACK_LOOP_BIT_EXT",{"type":18,"value":1382}," usage bit\nenabled and either the ",{"type":13,"tag":34,"props":1384,"children":1386},{"className":1385},[],[1387],{"type":18,"value":858},{"type":18,"value":1017},{"type":13,"tag":34,"props":1390,"children":1392},{"className":1391},[],[1393],{"type":18,"value":1394},"VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT",{"type":18,"value":1396}," and either the\n",{"type":13,"tag":34,"props":1398,"children":1400},{"className":1399},[],[1401],{"type":18,"value":1023},{"type":18,"value":1017},{"type":13,"tag":34,"props":1404,"children":1406},{"className":1405},[],[1407],{"type":18,"value":1015},{"type":18,"value":1025},{"type":13,"tag":680,"props":1410,"children":1411},{},[1412,1418,1419,1422,1424,1430,1432,1437,1439,1444,1445,1450],{"type":13,"tag":34,"props":1413,"children":1415},{"className":1414},[],[1416],{"type":18,"value":1417},"VK_IMAGE_LAYOUT_RENDERING_LOCAL_READ_KHR",{"type":18,"value":839},{"type":13,"tag":692,"props":1420,"children":1421},{"type":814},[],{"type":18,"value":1423}," only be used as\neither a storage image, or a color or depth/stencil attachment and an\ninput attachment.\nThis layout is valid only for image subresources of images created with\neither ",{"type":13,"tag":34,"props":1425,"children":1427},{"className":1426},[],[1428],{"type":18,"value":1429},"VK_IMAGE_USAGE_STORAGE_BIT",{"type":18,"value":1431},", or both\n",{"type":13,"tag":34,"props":1433,"children":1435},{"className":1434},[],[1436],{"type":18,"value":1023},{"type":18,"value":1438}," and either of\n",{"type":13,"tag":34,"props":1440,"children":1442},{"className":1441},[],[1443],{"type":18,"value":858},{"type":18,"value":1017},{"type":13,"tag":34,"props":1446,"children":1448},{"className":1447},[],[1449],{"type":18,"value":1394},{"type":18,"value":887},{"type":13,"tag":14,"props":1452,"children":1453},{},[1454,1456,1459,1461,1467,1469,1475,1477,1483,1485,1491,1493,1499,1501,1507],{"type":18,"value":1455},"The layout of each image subresource is not a state of the image subresource\nitself, but is rather a property of how the data in memory is organized, and\nthus for each mechanism of accessing an image in the API the application\n",{"type":13,"tag":692,"props":1457,"children":1458},{"type":814},[],{"type":18,"value":1460}," specify a parameter or structure member that indicates which image\nlayout the image subresource(s) are considered to be in when the image will\nbe accessed.\nFor transfer commands, this is a parameter to the command (see ",{"type":13,"tag":713,"props":1462,"children":1464},{"href":1463},"/chapters/clears#clears",[1465],{"type":18,"value":1466},"Clear Commands",{"type":18,"value":1468},"\nand ",{"type":13,"tag":713,"props":1470,"children":1472},{"href":1471},"/chapters/copies#copies",[1473],{"type":18,"value":1474},"Copy Commands",{"type":18,"value":1476},").\nFor use as a framebuffer attachment, this is a member in the substructures\nof the ",{"type":13,"tag":713,"props":1478,"children":1480},{"href":1479},"/man/VkRenderPassCreateInfo",[1481],{"type":18,"value":1482},"VkRenderPassCreateInfo",{"type":18,"value":1484}," (see ",{"type":13,"tag":713,"props":1486,"children":1488},{"href":1487},"/chapters/renderpass#renderpass",[1489],{"type":18,"value":1490},"Render Pass",{"type":18,"value":1492},").\nFor use in a descriptor set, this is a member in the\n",{"type":13,"tag":34,"props":1494,"children":1496},{"className":1495},[],[1497],{"type":18,"value":1498},"VkDescriptorImageInfo",{"type":18,"value":1500}," structure (see ",{"type":13,"tag":713,"props":1502,"children":1504},{"href":1503},"/chapters/descriptorsets#descriptorsets-updates",[1505],{"type":18,"value":1506},"Descriptor Set Updates",{"type":18,"value":1508},").",{"type":13,"tag":1510,"props":1511,"children":1512},"style",{},[1513],{"type":18,"value":1514},"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":31,"searchDepth":62,"depth":62,"links":1516},[],"markdown",1725732557587]