How to render multiple views in one Vulkan pass with multiview (VK_KHR_multiview)

Example: VulkanExamples/p45_multiview

المنشور 45 في السلسلة (المنشور 4: الرندر الديناميكي, post 29: multi-threaded recording).

VK_KHR_multiview (مطوي في نواة Vulkan 1.1) يرسم استدعاء رسم واحدًا في N طبقات مرفق دفعة واحدة. vertex shader يعمل مرة لكل عرض؛ gl_ViewIndex في الـ shader يقول أي طبقة يستهدف كل استدعاء. يوجد لـ VR ستيريو (العينان في مرور واحد)، لكنه مفيد بالقدر نفسه لجدار كاميرا: نفس الهندسة منضوحة في 9 طبقات لصورة واحدة، تنويع لكل-عرض مجانًا.

المفاتيح الثلاثة

main.cpp (excerpt)
// 1. device feature (Vulkan 1.1)
vk::PhysicalDeviceVulkan11Features f11{};
f11.setMultiview(VK_TRUE);
vk.createDevice({}, &f11);

// 2. a multi-layer attachment + one 2D-array view covering all
//    views (layerCount must cover the viewMask bits)
ici.setArrayLayers(2);
vi.setViewType(vk::ImageViewType::e2DArray)
  .setSubresourceRange({vk::ImageAspectFlagBits::eColor, 0,1, 0,2});

// 3. viewMask in the pipeline's RenderingCreateInfo AND the
//    RenderingInfo — they must match
rendering.setViewMask(0b11);   // pipeline creation
ri.setViewMask(0b11)           // vkCmdBeginRendering
  .setLayerCount(2);

In the fragment shader enable the GLSL side:

s.frag
#extension GL_EXT_multiview : require
outColor = (gl_ViewIndex == 0) ? vec4(1,0.2,0.2,1)
                             : vec4(0.2,0.2,1,1);

c.draw(3,1,0,0) واحد يملأ كلا الطبقتين الآن — إعادة القراءة تثبته:

example.sh
layer0 mid: (255, 51, 51)
layer1 mid: (51, 51, 255)

الفحص

check.py
# SPDX-License-Identifier: CC0-1.0
import subprocess

subprocess.run(["./app", "--headless", "out.ppm"], check=True)

def px(path, x, y):
    d = open(path, "rb").read().split(b"255\n", 1)[1]
    i = (y * 384 + x) * 3
    return d[i], d[i + 1], d[i + 2]

assert px("out.ppm", 192, 192)     == (255, 51, 51)
assert px("out.ppm_l1.ppm", 192, 192) == (51, 51, 255)
print("OK: one draw -> layer0 red, layer1 blue (gl_ViewIndex)")

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

  • عدم تطابق viewMask = خطأ تحقق. القناع مكرر in pipeline creation (VkPipelineRenderingCreateInfo) and vkCmdBeginRendering (VkRenderingInfo); bits set in one but not the other trip VUIDs.
  • عرض المرفق يجب أن يكون عرض مصفوفة طبقات. single-layer e2D view on a 2-layer image only writes layer 0; declare e2DArray with layerCount ≥ maxViewBit.
  • تضخيم الهندسة لكل-عرض، لا لكل-أساسية. whole vertex stage runs N times — for truly different geometry per view you need a geometry shader or per-view vertex fetch via gl_ViewIndex, not separate draws.
  • layerCount في Rendering-Info لا يزال يعد كل الطبقات التي attachment logically has; viewMask selects which get primitives. Setting layerCount=1 with viewMask=0b11 is a validation error.
  • instancing gl_InstanceIndex لا يزال موجودًا — multiview هو orthogonal: draw(N, instances) runs N·views·instances invocations; don’t multiply instance counts by view counts.

كل الشفرة المصدرية في هذه السلسلة منشورة تحت CC0 1.0 Universal (CC0-1.0) — public domain dedication, no attribution required.


Check out similar posts by category: C++ Vulkan