كيفية نسخ البكسلات إلى صورة Vulkan دون مخزن أوامر (VK_EXT_host_image_copy)

Example: VulkanExamples/p43_hostcopy

المنشور 43 في السلسلة (post 5: texture upload).

كل شيء في هذه السلسلة نقل بكسلات بمخازن أوامر: مخزن تجهيز → vkCmdCopyBufferToImage → إرسال → سياج. VK_EXT_host_image_copy يعرض بدائية أبسط جذريًا:

main.cpp (excerpt)
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:

main.cpp (excerpt)
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;
        }

الفحص

check.py
# 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")
example.sh
$ python3 check.py
OK: R/G checkerboard via host image copy + readback

كيف لا تستخدمه

  • لا تستخدمه كمسار سريع — النسخ متزامن على خيط الاستدعاء وقد يجهز المشغل داخليًا على أي حال. لرفعات كل إطار، حلقة التجهيز أو طابور النقل ما يزالان يفوزان؛ host_image_copy للأدوات وتفريغات التنقيح والتطبيقات البسيطة.
  • لا تنسَ eHostTransferEXT على الصورة — خطأ تحقق وإلا.
  • لا تتوقع أن يكون التبليط الأمثل قابلًا للكتابة — فقط eGeneral أو الصيغ/التخطيطات التي يعلنها المشغل في VkPhysicalDeviceHostImageCopyPropertiesEXT.

مربعات مرفوعة عبر vkCopyMemoryToImageEXT

كل كود المصدر في هذه السلسلة مطلق تحت CC0 1.0 Universal (CC0-1.0) — إهداء ملكية عامة، لا نسب مطلوب.


Check out similar posts by category: C++ Vulkan