[{"data":1,"prerenderedAt":434},["ShallowReactive",2],{"yByptGO9fy":3},{"title":4,"description":5,"parent":6,"type":7,"xrefs":8,"body":9,"_type":433,"_id":4},"vkCopyImageToMemory","Copy image data into host memory","VK_VERSION_1_4","protos",[],{"type":10,"children":11,"toc":431},"root",[12,20,259,302,329,368,425],{"type":13,"tag":14,"props":15,"children":16},"element","p",{},[17],{"type":18,"value":19},"text","To copy data from an image object to host memory, call:",{"type":13,"tag":21,"props":22,"children":23},"code-group",{},[24,110],{"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","VkResult vkCopyImageToMemoryEXT(\n    VkDevice device,\n    const VkCopyImageToMemoryInfo*    pCopyImageToMemoryInfo);\n","C","c","",[33],{"type":13,"tag":34,"props":35,"children":36},"code",{"__ignoreMap":31},[37,60,80],{"type":13,"tag":38,"props":39,"children":42},"span",{"class":40,"line":41},"line",1,[43,49,55],{"type":13,"tag":38,"props":44,"children":46},{"style":45},"--shiki-default:#1F2328;--shiki-dark:#E6EDF3",[47],{"type":18,"value":48},"VkResult ",{"type":13,"tag":38,"props":50,"children":52},{"style":51},"--shiki-default:#8250DF;--shiki-dark:#D2A8FF",[53],{"type":18,"value":54},"vkCopyImageToMemoryEXT",{"type":13,"tag":38,"props":56,"children":57},{"style":45},[58],{"type":18,"value":59},"(\n",{"type":13,"tag":38,"props":61,"children":63},{"class":40,"line":62},2,[64,69,75],{"type":13,"tag":38,"props":65,"children":66},{"style":45},[67],{"type":18,"value":68},"    VkDevice ",{"type":13,"tag":38,"props":70,"children":72},{"style":71},"--shiki-default:#953800;--shiki-dark:#FFA657",[73],{"type":18,"value":74},"device",{"type":13,"tag":38,"props":76,"children":77},{"style":45},[78],{"type":18,"value":79},",\n",{"type":13,"tag":38,"props":81,"children":83},{"class":40,"line":82},3,[84,90,95,100,105],{"type":13,"tag":38,"props":85,"children":87},{"style":86},"--shiki-default:#CF222E;--shiki-dark:#FF7B72",[88],{"type":18,"value":89},"    const",{"type":13,"tag":38,"props":91,"children":92},{"style":45},[93],{"type":18,"value":94}," VkCopyImageToMemoryInfo",{"type":13,"tag":38,"props":96,"children":97},{"style":86},[98],{"type":18,"value":99},"*",{"type":13,"tag":38,"props":101,"children":102},{"style":71},[103],{"type":18,"value":104},"    pCopyImageToMemoryInfo",{"type":13,"tag":38,"props":106,"children":107},{"style":45},[108],{"type":18,"value":109},");\n",{"type":13,"tag":25,"props":111,"children":116},{"className":112,"code":113,"filename":114,"language":115,"meta":31,"style":31},"language-rs shiki shiki-themes github-light-default github-dark-default","pub fn copy_image_to_memory_ext(\n    device: crate :: vk :: vk::Device,\n    p_copy_image_to_memory_info: *const vk::CopyImageToMemoryInfo,\n) -> vk::Result;\n","Rust","rs",[117],{"type":13,"tag":34,"props":118,"children":119},{"__ignoreMap":31},[120,142,193,227],{"type":13,"tag":38,"props":121,"children":122},{"class":40,"line":41},[123,128,133,138],{"type":13,"tag":38,"props":124,"children":125},{"style":86},[126],{"type":18,"value":127},"pub",{"type":13,"tag":38,"props":129,"children":130},{"style":86},[131],{"type":18,"value":132}," fn",{"type":13,"tag":38,"props":134,"children":135},{"style":51},[136],{"type":18,"value":137}," copy_image_to_memory_ext",{"type":13,"tag":38,"props":139,"children":140},{"style":45},[141],{"type":18,"value":59},{"type":13,"tag":38,"props":143,"children":144},{"class":40,"line":62},[145,150,155,160,165,170,175,180,184,189],{"type":13,"tag":38,"props":146,"children":147},{"style":45},[148],{"type":18,"value":149},"    device",{"type":13,"tag":38,"props":151,"children":152},{"style":86},[153],{"type":18,"value":154},":",{"type":13,"tag":38,"props":156,"children":157},{"style":86},[158],{"type":18,"value":159}," crate",{"type":13,"tag":38,"props":161,"children":162},{"style":86},[163],{"type":18,"value":164}," ::",{"type":13,"tag":38,"props":166,"children":167},{"style":45},[168],{"type":18,"value":169}," vk ",{"type":13,"tag":38,"props":171,"children":172},{"style":86},[173],{"type":18,"value":174},"::",{"type":13,"tag":38,"props":176,"children":177},{"style":71},[178],{"type":18,"value":179}," vk",{"type":13,"tag":38,"props":181,"children":182},{"style":86},[183],{"type":18,"value":174},{"type":13,"tag":38,"props":185,"children":186},{"style":71},[187],{"type":18,"value":188},"Device",{"type":13,"tag":38,"props":190,"children":191},{"style":45},[192],{"type":18,"value":79},{"type":13,"tag":38,"props":194,"children":195},{"class":40,"line":82},[196,201,205,210,214,218,223],{"type":13,"tag":38,"props":197,"children":198},{"style":45},[199],{"type":18,"value":200},"    p_copy_image_to_memory_info",{"type":13,"tag":38,"props":202,"children":203},{"style":86},[204],{"type":18,"value":154},{"type":13,"tag":38,"props":206,"children":207},{"style":86},[208],{"type":18,"value":209}," *const",{"type":13,"tag":38,"props":211,"children":212},{"style":71},[213],{"type":18,"value":179},{"type":13,"tag":38,"props":215,"children":216},{"style":86},[217],{"type":18,"value":174},{"type":13,"tag":38,"props":219,"children":220},{"style":71},[221],{"type":18,"value":222},"CopyImageToMemoryInfo",{"type":13,"tag":38,"props":224,"children":225},{"style":45},[226],{"type":18,"value":79},{"type":13,"tag":38,"props":228,"children":230},{"class":40,"line":229},4,[231,236,241,245,249,254],{"type":13,"tag":38,"props":232,"children":233},{"style":45},[234],{"type":18,"value":235},") ",{"type":13,"tag":38,"props":237,"children":238},{"style":86},[239],{"type":18,"value":240},"->",{"type":13,"tag":38,"props":242,"children":243},{"style":71},[244],{"type":18,"value":179},{"type":13,"tag":38,"props":246,"children":247},{"style":86},[248],{"type":18,"value":174},{"type":13,"tag":38,"props":250,"children":251},{"style":71},[252],{"type":18,"value":253},"Result",{"type":13,"tag":38,"props":255,"children":256},{"style":45},[257],{"type":18,"value":258},";\n",{"type":13,"tag":260,"props":261,"children":262},"ul",{},[263,282],{"type":13,"tag":264,"props":265,"children":266},"li",{},[267,272,274,280],{"type":13,"tag":34,"props":268,"children":270},{"className":269},[],[271],{"type":18,"value":74},{"type":18,"value":273}," is the device which owns\n",{"type":13,"tag":34,"props":275,"children":277},{"className":276},[],[278],{"type":18,"value":279},"pCopyImageToMemoryInfo→srcImage",{"type":18,"value":281},".",{"type":13,"tag":264,"props":283,"children":284},{},[285,291,293,300],{"type":13,"tag":34,"props":286,"children":288},{"className":287},[],[289],{"type":18,"value":290},"pCopyImageToMemoryInfo",{"type":18,"value":292}," is a pointer to a\n",{"type":13,"tag":294,"props":295,"children":297},"a",{"href":296},"/man/VkCopyImageToMemoryInfo",[298],{"type":18,"value":299},"VkCopyImageToMemoryInfo",{"type":18,"value":301}," structure describing the copy parameters.",{"type":13,"tag":14,"props":303,"children":304},{},[305,307,313,315,320,322,328],{"type":18,"value":306},"This command is functionally similar to ",{"type":13,"tag":294,"props":308,"children":310},{"href":309},"/man/vkCmdCopyImageToBuffer2",[311],{"type":18,"value":312},"vkCmdCopyImageToBuffer2",{"type":18,"value":314},",\nexcept it is executed on the host and writes to host memory instead of a\nbuffer.\nThe memory of ",{"type":13,"tag":34,"props":316,"children":318},{"className":317},[],[319],{"type":18,"value":279},{"type":18,"value":321}," is accessed by the host\nas if ",{"type":13,"tag":294,"props":323,"children":325},{"href":324},"/man/VkMemoryPropertyFlagBits#memory-coherent",[326],{"type":18,"value":327},"coherent",{"type":18,"value":281},{"type":13,"tag":330,"props":331,"children":332},"note",{},[333],{"type":13,"tag":14,"props":334,"children":335},{},[336,338,343,345,351,353,359,361,367],{"type":18,"value":337},"If the device has written to the image memory, it is not automatically made\navailable to the host.\nBefore this copy command can be called, a memory barrier for this image\n",{"type":13,"tag":339,"props":340,"children":342},"normative",{"type":341},"must",[],{"type":18,"value":344}," have been issued on the device with the second\n",{"type":13,"tag":294,"props":346,"children":348},{"href":347},"/chapters/synchronization#synchronization-dependencies-scopes",[349],{"type":18,"value":350},"synchronization scope",{"type":18,"value":352}," including\n",{"type":13,"tag":34,"props":354,"children":356},{"className":355},[],[357],{"type":18,"value":358},"VK_PIPELINE_STAGE_HOST_BIT",{"type":18,"value":360}," and ",{"type":13,"tag":34,"props":362,"children":364},{"className":363},[],[365],{"type":18,"value":366},"VK_ACCESS_HOST_READ_BIT",{"type":18,"value":281},{"type":13,"tag":369,"props":370,"children":372},"validity-group",{"name":371},"Valid Usage (Implicit)",[373,401],{"type":13,"tag":374,"props":375,"children":377},"validity-field",{"name":376},"VUID-vkCopyImageToMemory-device-parameter",[378],{"type":13,"tag":14,"props":379,"children":380},{},[381,386,388,391,393,399],{"type":13,"tag":34,"props":382,"children":384},{"className":383},[],[385],{"type":18,"value":74},{"type":18,"value":387}," ",{"type":13,"tag":339,"props":389,"children":390},{"type":341},[],{"type":18,"value":392}," be a valid ",{"type":13,"tag":294,"props":394,"children":396},{"href":395},"/man/VkDevice",[397],{"type":18,"value":398},"VkDevice",{"type":18,"value":400}," handle",{"type":13,"tag":374,"props":402,"children":404},{"name":403},"VUID-vkCopyImageToMemory-pCopyImageToMemoryInfo-parameter",[405],{"type":13,"tag":14,"props":406,"children":407},{},[408,413,414,417,419,423],{"type":13,"tag":34,"props":409,"children":411},{"className":410},[],[412],{"type":18,"value":290},{"type":18,"value":387},{"type":13,"tag":339,"props":415,"children":416},{"type":341},[],{"type":18,"value":418}," be a valid pointer to a valid ",{"type":13,"tag":294,"props":420,"children":421},{"href":296},[422],{"type":18,"value":299},{"type":18,"value":424}," structure",{"type":13,"tag":426,"props":427,"children":428},"style",{},[429],{"type":18,"value":430},"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":432},[],"markdown",1744876593885]