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) andvkCmdBeginRendering(VkRenderingInfo); bits set in one but not the other trip VUIDs. - عرض المرفق يجب أن يكون عرض مصفوفة طبقات.
single-layer
e2Dview on a 2-layer image only writes layer 0; declaree2DArraywithlayerCount ≥ 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;viewMaskselects which get primitives. SettinglayerCount=1withviewMask=0b11is 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.
If this post helped you, please consider buying me a coffee or donating via PayPal to support research & publishing of new posts on TechOverflow