Example: VulkanExamples/p43_hostcopy
المنشور 43 في السلسلة (post 5: texture upload).
كل شيء في هذه السلسلة نقل بكسلات بمخازن أوامر: مخزن تجهيز → vkCmdCopyBufferToImage → إرسال → سياج. VK_EXT_host_image_copy يعرض بدائية أبسط جذريًا:
vk::MemoryToImageCopyEXT region{};
region.setPHostPointer(src.data()) // plain CPU pointer!
.setMemoryRowLength(0) // 0 = tightly packed
.setImageSubresource(
{vk::ImageAspectFlagBits::eColor, 0, 0, 1})
.setImageExtent({W, H, 1});
vk::CopyMemoryToImageInfoEXT cmi{};
cmi.setDstImage(tex.img.get())
.setDstImageLayout(vk::ImageLayout::eGeneral)
.setRegions(region);
vk.device->copyMemoryToImageEXT(cmi, dldi); // synchronous call
لا مخزن أوامر، لا مخزن تجهيز، لا إرسال طابور — ينسخ المشغل من مؤشرك إلى الصورة داخليًا ويعود عند الانتهاء. الاتجاه المعكوس هو vkCopyImageToMemoryEXT.
المتطلبات
- امتداد جهاز
VK_EXT_host_image_copy+ ميزةhostImageCopyفيVkPhysicalDeviceHostImageCopyFeaturesEXT. - صورة منشأة باستخدام
vk::ImageUsageFlagBits::eHostTransferEXT. - يجب أن تكون الصورة في
eGeneralأو أحد التخطيطات المدرجة فيVkPhysicalDeviceHostImageCopyPropertiesEXT::pCopyDstLayouts/pCopySrcLayouts—eGeneralآمن دائمًا. - استخدام
eHostTransferEXTعلى صورة يجعلها غير متوافقة مع الاستخدام العادي على بعض المشغلات — افحص، لا تفترض.
من يدعمه — ولماذا يوجد
على صندوق الاختبار: Intel iGPU ✅، llvmpipe ✅، Radeon dGPU ❌. ذلك ليس صدفة — يتألق الامتداد حيث ذاكرة المضيف قابلة للوصول من GPU بالفعل (ذاكرة iGPU الموحدة). على GPU منفصل يجب على المشغل فعل ارتداد PCIe حقيقي على أي حال، لذا تتخطاه عدة مشغلات سطح مكتب.
النمط الذي يتدرج: عدّ الأجهزة، فضّل واحدًا داعمًا للامتداد، وإلا تراجع للتجهيز — نفس عقد كشف القدرات كـالمنشور 40:
for (auto& d : vk.instance->enumeratePhysicalDevices())
for (auto& e : d.enumerateDeviceExtensionProperties())
if (!strcmp(e.extensionName,
VK_EXT_HOST_IMAGE_COPY_EXTENSION_NAME)) {
vk.phys = d; break;
}الفحص
# SPDX-License-Identifier: CC0-1.0
import re, subprocess
o = subprocess.run(["./app", "--headless", "out.ppm"],
capture_output=True, text=True).stdout
if "SKIP:" in o:
print("OK: no host-image-copy device -> clean skip")
else:
assert "host->image copy done" in o, o
assert "roundtrip: exact" in o, o # vkCopyImageToMemoryEXT byte-exact
d = open("out.ppm", "rb").read()
m = re.match(rb"P6\s+(\d+)\s+(\d+)\s+(\d+)\s", d)
w, h = int(m.group(1)), int(m.group(2))
px = d[m.end():m.end() + w * h * 3]
cells = {tuple(px[(y * w + x) * 3:(y * w + x) * 3 + 3])
for y in range(0, h, 16) for x in range(0, w, 16)}
assert cells == {(0, 255, 0), (255, 0, 0)}, cells
print("OK: R/G checkerboard via host image copy + readback")$ python3 check.py
OK: R/G checkerboard via host image copy + readback
كيف لا تستخدمه
- لا تستخدمه كمسار سريع — النسخ متزامن على خيط الاستدعاء وقد يجهز المشغل داخليًا على أي حال. لرفعات كل إطار، حلقة التجهيز أو طابور النقل ما يزالان يفوزان؛
host_image_copyللأدوات وتفريغات التنقيح والتطبيقات البسيطة. - لا تنسَ
eHostTransferEXTعلى الصورة — خطأ تحقق وإلا. - لا تتوقع أن يكون التبليط الأمثل قابلًا للكتابة — فقط
eGeneralأو الصيغ/التخطيطات التي يعلنها المشغل فيVkPhysicalDeviceHostImageCopyPropertiesEXT.
كل كود المصدر في هذه السلسلة مطلق تحت CC0 1.0 Universal (CC0-1.0) — إهداء ملكية عامة، لا نسب مطلوب.
