KhronosGroup / KhronosGroup/Vulkan-Tutorial
Confusion at Chapters "Physical devices and queue families" and "Logical device and queues"
- Ngôn ngữ chính
- C++
- Star
- 418
- Fork
- 126
- Merge trung bình
- 11 ngày 6 giờ
- Pull request đã merge (30 ngày)
- 31
Mô tả
### 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.
Hướng dẫn đóng góp
Hướng nghiên cứu
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.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Đánh giá
- Công nghệ
- cpp
- Lĩnh vực
- documentation
- Loại issue
- Tài liệu
- Độ khó
- 4/5
- Thời gian dự kiến
- 3-5 ngày
- Mức độ hoạt động
- Đình trệ
- Độ rõ ràng
- Khá rõ ràng
- Mức phù hợp với người mới
- 38/100