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

Aperta
#306 0 commenti 2 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
4/5
Tempo stimato
3-5 giorni
Idoneità per principianti
38/100
Tipo di issue
Documentazione
Chiarezza
Abbastanza chiara
Stato di attività
Ferma
Stack tecnologico
cpp
Ambito
documentation

Direzione di ricerca

Confronta i capitoli «Dispositivi fisici e famiglie di code», «Dispositivo logico e code» e «Superficie della finestra», comprese le relative sezioni «Codice C++». Traccia il modo in cui vengono introdotte e riutilizzate l’idoneità del dispositivo e la selezione delle famiglie di code, quindi allinea la prosa e gli snippet in modo che l’approccio previsto, i valori restituiti, i controlli della superficie e la creazione delle code siano coerenti tra i capitoli.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

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.

Lingua principale
C++
Stelle
424
Fork
127
Merge medio
2g 22h
PR unite (30g)
7

Guida per i contributori

Apri la guida per i contributori

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di KhronosGroup/Vulkan-Tutorial

Tutte le issue di KhronosGroup/Vulkan-Tutorial

Issue simili

Altre issue su C++

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.