[{"data":1,"prerenderedAt":414},["ShallowReactive",2],{"eh4T2teiYs":3},{"title":4,"description":5,"parent":6,"type":7,"xrefs":8,"body":9,"_type":413,"_id":4},"vkCopyMemoryToImage","Copy data from host memory into an image","VK_VERSION_1_4","protos",[],{"type":10,"children":11,"toc":411},"root",[12,20,259,302,329,346,405],{"type":13,"tag":14,"props":15,"children":16},"element","p",{},[17],{"type":18,"value":19},"text","To copy data from host memory to an image object, 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 vkCopyMemoryToImageEXT(\n    VkDevice device,\n    const VkCopyMemoryToImageInfo*    pCopyMemoryToImageInfo);\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},"vkCopyMemoryToImageEXT",{"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}," VkCopyMemoryToImageInfo",{"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},"    pCopyMemoryToImageInfo",{"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_memory_to_image_ext(\n    device: crate :: vk :: vk::Device,\n    p_copy_memory_to_image_info: *const vk::CopyMemoryToImageInfo,\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_memory_to_image_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_memory_to_image_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},"CopyMemoryToImageInfo",{"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},"pCopyMemoryToImageInfo→dstImage",{"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},"pCopyMemoryToImageInfo",{"type":18,"value":292}," is a pointer to a\n",{"type":13,"tag":294,"props":295,"children":297},"a",{"href":296},"/man/VkCopyMemoryToImageInfo",[298],{"type":18,"value":299},"VkCopyMemoryToImageInfo",{"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/vkCmdCopyBufferToImage2",[311],{"type":18,"value":312},"vkCmdCopyBufferToImage2",{"type":18,"value":314},",\nexcept it is executed on the host and reads from 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,344],{"type":18,"value":337},"Because queue submissions ",{"type":13,"tag":294,"props":339,"children":341},{"href":340},"/chapters/synchronization#synchronization-submission-host-writes",[342],{"type":18,"value":343},"automatically make host memory visible to the device",{"type":18,"value":345},", there would not be a\nneed for a memory barrier before using the results of this copy operation on\nthe device.",{"type":13,"tag":347,"props":348,"children":350},"validity-group",{"name":349},"Valid Usage (Implicit)",[351,381],{"type":13,"tag":352,"props":353,"children":355},"validity-field",{"name":354},"VUID-vkCopyMemoryToImage-device-parameter",[356],{"type":13,"tag":14,"props":357,"children":358},{},[359,364,366,371,373,379],{"type":13,"tag":34,"props":360,"children":362},{"className":361},[],[363],{"type":18,"value":74},{"type":18,"value":365}," ",{"type":13,"tag":367,"props":368,"children":370},"normative",{"type":369},"must",[],{"type":18,"value":372}," be a valid ",{"type":13,"tag":294,"props":374,"children":376},{"href":375},"/man/VkDevice",[377],{"type":18,"value":378},"VkDevice",{"type":18,"value":380}," handle",{"type":13,"tag":352,"props":382,"children":384},{"name":383},"VUID-vkCopyMemoryToImage-pCopyMemoryToImageInfo-parameter",[385],{"type":13,"tag":14,"props":386,"children":387},{},[388,393,394,397,399,403],{"type":13,"tag":34,"props":389,"children":391},{"className":390},[],[392],{"type":18,"value":290},{"type":18,"value":365},{"type":13,"tag":367,"props":395,"children":396},{"type":369},[],{"type":18,"value":398}," be a valid pointer to a valid ",{"type":13,"tag":294,"props":400,"children":401},{"href":296},[402],{"type":18,"value":299},{"type":18,"value":404}," structure",{"type":13,"tag":406,"props":407,"children":408},"style",{},[409],{"type":18,"value":410},"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":412},[],"markdown",1744876593896]