Consider moving the pipeline barrier explanation closer to where the parameters are set
Mantenedores costumam responder em até 1 dia
Ninguém assumiu esta issue ainda.
Avaliação
- Dificuldade
- 2/5
- Tempo estimado
- 1-3 horas
- Facilidade para iniciantes
- 72/100
- Tipo de issue
- Documentação
- Clareza
- Claramente especificada
- Status de atividade
- Ativa
- Stack de tecnologia
- cpp
- Domínio
- documentation
Direção de pesquisa
Leia as seções Layout transitions e Transition barrier masks na página do tutorial vinculada e compare onde os parâmetros de pipelineBarrier() são explicados com onde as máscaras são definidas. Mova ou condense a explicação conforme proposto para que os leitores encontrem os detalhes junto com seu uso; o trabalho estará concluído quando a seção anterior mencionar brevemente que as máscaras serão explicadas adiante e a explicação detalhada aparecer em Transition barrier masks.
Escrita pelo modelo de indexação a partir do texto da issue.
Descrição
In the Layout transitions section, the tutorial says:
The right values depend on the old and new layout, so we’ll get back to this once we’ve figured out which transitions we’re going to use.
However, the tutorial then spends several paragraphs explaining the parameters of pipelineBarrier(), including pipeline stages, access types, eByRegion, and different types of memory barriers. The actual stage and access masks are not set until the later Transition barrier masks section.
I found this order a bit confusing for a few reasons:
- The tutorial tells readers that these parameters will be handled later, but immediately goes into a fairly detailed explanation of them.
- The two layout transitions (
UNDEFINED→TRANSFER_DST_OPTIMALandTRANSFER_DST_OPTIMAL→SHADER_READ_ONLY_OPTIMAL) have already been introduced at this point, so the reason given for postponing the parameters is also a little unclear. - By the time the parameters are actually set, the reader has already moved through several other topics.
I think it would be easier to follow if the earlier section briefly mentioned that the stage and access masks would be filled in later, and left the detailed explanation for the Transition barrier masks section, where readers can immediately see how those parameters are used.
I don't think leaving the implementation incomplete is a problem by itself. It's mainly the placement of the explanation that makes the section harder to follow.
- Linguagem predominante
- C++
- Estrelas
- 444
- Forks
- 145
- Métricas de merge de PRs
- Nenhum PR com merge em 30d
Preparar o ambiente
- Sem Dockerfile nem arquivo Docker Compose
- Sem modelo de pull request
- Ler o guia de contribuição
Primeiros passos
- Leia a issue inteira e depois o guia de contribuição do projeto.
- Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
- Faça um fork do repositório e trabalhe em uma branch.
- Abra um pull request que referencie o número da issue.
Mais de KhronosGroup/Vulkan-Tutorial
-
Dificuldade 1/5 Menos de uma hora Facilidade para iniciantes 85/100
KhronosGroup/Vulkan-Tutorial#545 ·
Mantenedores costumam responder em até 1 dia
-
Dificuldade 1/5 1-3 horas Facilidade para iniciantes 76/100
KhronosGroup/Vulkan-Tutorial#544 ·
Mantenedores costumam responder em até 1 dia
-
Clarify front-face culling when using a negative viewport heightTalvez já em andamento @1sgtpepper assumiu há 18 dias. Aberta
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 72/100
KhronosGroup/Vulkan-Tutorial#534 ·
Mantenedores costumam responder em até 1 dia
-
Stale GLSL-specific wording in the Vertex Input Description chapterTalvez já em andamento @gpx1000 assumiu há 27 dias. Aberta
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 65/100
KhronosGroup/Vulkan-Tutorial#528 · 1 responsável ·
Mantenedores costumam responder em até 1 dia
-
Clarify vertex input bindingsTalvez já em andamento @SaschaWillems assumiu há 27 dias. Aberta
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 78/100
KhronosGroup/Vulkan-Tutorial#527 · 1 responsável ·
Mantenedores costumam responder em até 1 dia
Todas as issues de KhronosGroup/Vulkan-Tutorial
Issues semelhantes
-
Documentation: Fix parameter markup, legacy branch link, and phrasing in Detachable Joints and Model Command tutorialsTalvez já em andamento @patelshivani2283-lab assumiu hoje. Aberta
Dificuldade 1/5 1-3 horas Facilidade para iniciantes 88/100
Mantenedores costumam responder em até 1 dia
-
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 68/100
Mantenedores costumam responder em até 1 dia
-
bug
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 82/100
-
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 75/100
Niko1221/Strata#6071 · 2 comentários ·
Mantenedores costumam responder em até 4 dias
-
pumpAberta
Dificuldade 1/5 Menos de uma hora Facilidade para iniciantes 68/100
dewenni/ESP_Buderus_KM271#191 ·