Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

Clarify vertex input bindings

Abierto Apto para principiantes
#527 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
2/5
Tiempo estimado
1-3 horas
Aptitud para principiantes
78/100
Tipo de issue
Documentación
Claridad
Bien especificado
Estado de actividad
Activo

Línea de trabajo

Empieza con la sección «Binding descriptions» del capítulo sobre la descripción de la entrada de vértices en el tutorial, que el issue enlaza y cita. El issue propone un texto de reemplazo que primero define un binding de entrada de vértices como una ranura numerada, luego trata stride e inputRate, y por último indica que bindVertexBuffers() se explica en el siguiente capítulo. Está terminado cuando la sección se lee en ese orden; un diagrama es opcional. El payload no indica el archivo fuente, así que búscalo a partir del título de la sección.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

In the Binding descriptions section, the tutorial introduces vertex input bindings with the following explanation:

A vertex binding describes at which rate to load data from memory throughout the vertices. It specifies the number of bytes between data entries and whether to move to the next data entry after each vertex or after each instance.

I found this explanation confusing because it describes the properties of a vertex input binding, particularly stride and inputRate, without first explaining what a vertex input binding actually represents.

My understanding is that a vertex input binding is a numbered input slot that can be associated with a vertex buffer. The binding description specifies how data from that slot should be accessed, while vertex attribute descriptions specify which binding supplies each attribute.

The actual vertex buffer is associated with the slot separately, using bindVertexBuffers(), which is introduced in the next chapter

I think the section would be easier to follow if it first introduced the concept of a vertex input binding before explaining its properties.

For example, the explanation could be revised to:

A vertex input binding is a numbered slot used to supply vertex attribute data. Multiple vertex attributes can reference the same binding.

Each binding has a description that specifies the stride between consecutive data entries and whether the data is accessed per vertex or per instance.

At this point, we're only describing how the data should be accessed. In the next chapter, we'll use bindVertexBuffers() to associate an actual vertex buffer with this binding.

This would clarify the distinction between a binding itself, its description, and the actual buffer associated with it. Even better, we can use a diagram to illustrate this.

Lenguaje dominante
C++
Estrellas
434
Forks
135
Merge medio
1 d 9 h
PR fusionados (30 d)
4

Preparar el entorno

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de KhronosGroup/Vulkan-Tutorial

Todos los issues de KhronosGroup/Vulkan-Tutorial

Issues similares

Más issues de C++

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.