KhronosGroup / KhronosGroup/Vulkan-Tutorial

Confusion at Chapters "Physical devices and queue families" and "Logical device and queues"

未关闭
#306 0 条评论 2 个 reaction 已指派 0 人 在 GitHub 查看
主要语言
C++
星标
418
派生
126
平均合并
11 天 6 小时
30 天内合并 PR
31

描述

### Problem 1:
In "03 / 00 / 03 Physical devices and queue families" multiple ways are shown to select the right device, but it is often worded as if the current snippet is the right way to do it.
It starts with:

> We’ll check if any of the physical devices meet the requirements that we’ll add to that function.

and adds simple code. Now i expect to use this code.

Then later

> Because we’re just starting out, Vulkan 1.3 support is the only thing we need, and therefore we’ll search for that and the extensions that we actually are going to be demonstrating:

Now there's completely different code, not even reusing the previous code. In addition to this, the new code snippet is much larger but lacks any further explanation.

### Problem 2

The way we find the right queue family constantly switches. Already in "Base device suitability checks" at the end, queue families are detected inline.

But then in the "Queue Families" sub-section this isn't mentioned at all and we do define an extra function. And this function returns the queue family index, no longer a bool, but this isn't even mentioned.

Then i looked at the "C++ code" to figure out what's right and there it is once-more inline, *but in yet another fashion*.

So then i think "Ok, inline it is!". But in "03 / 00 / 04 Logical device and queues" `findQueueFamilies(m_physicalDevice)` is called, so we actually need the function.
Also `m_physicalDevice` was never defined anywhere.

Edit: The queue problem continues in "03 / 01 / 00 Window surface". In this chapter, the inline code for queue selection contains multiple issues:
1) It doesn't match with the "c++ code" link at the bottom.
2) It doesn't use the `findQueueFamilies` function. However already at *physical device selection* we need to query support for surfaces to choose the right device. So the code should go into find `findQueueFamilies()`. The function should not throw an error though, because we search for the right device. Only the return value should indicate whether something was found and it only needs to be recorded during physical device selection. When we create the logical device, we already know the queues are valid.
3) It first checks for a graphics index, then if the graphics index also supports present, then for an index that supports both and then for a separate present index. There's a lot of redundancy, just write a single for-loop.
4) DeviceQueueCreateInfo does only link the graphicsIndex, even if a separate presentIndex exists.

It feels like the code does not align with the text and sometimes even the text of one subsection does not align with another subsection.

贡献指南

打开贡献指南

调研方向

Compare the chapters “Physical devices and queue families,” “Logical device and queues,” and “Window surface,” including their “C++ code” sections. Trace how device suitability and queue-family selection are introduced and reused, then align the prose and snippets so the intended approach, return values, surface checks, and queue creation are consistent across chapters.

由索引模型根据 Issue 内容生成。

评估

技术栈
cpp
领域
documentation
Issue 类型
文档
难度
4/5
预计耗时
3-5 天
活跃度
停滞
描述清晰度
基本清楚
新手友好度
38/100

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。