Clarify vertex input bindings

Open Beginner friendly
#527 0 comments 0 reactions 1 assignee View on GitHub

Maintainers usually reply within 1 day

@SaschaWillems is already working on this.

Since Oct 19, 2026.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
78/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Active
Domain
documentation

Research direction

Start with the 'Binding descriptions' section of the vertex input description chapter in the tutorial, which the issue links and quotes. The issue proposes replacement wording that first defines a vertex input binding as a numbered slot, then covers stride and inputRate, then notes that bindVertexBuffers() comes in the next chapter. Done means the section reads in that order, and a diagram is optional. The payload does not name the source file, so find it from the section heading.

Written by the indexing model from the issue text.

Description

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.

Dominant language
C++
Stars
444
Forks
145
PR merge metrics
No merged PRs in 30d

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from KhronosGroup/Vulkan-Tutorial

All issues in KhronosGroup/Vulkan-Tutorial

Similar issues

More C++ issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.