Hacktoberfest 2026:維護者為十月標記出來的 issue,仍然開放、適合新手。 瀏覽 Hacktoberfest issue

Clarify vertex input bindings

未關閉 適合新手
#527 0 則留言 0 個 reaction 已指派 0 人 在 GitHub 檢視

還沒有人認領這個 Issue。

評估

難度
2/5
預估耗時
1-3 小時
新手友好度
78/100
Issue 類型
文件
描述清晰度
描述清楚
活躍度
活躍
領域
documentation

研究方向

從教學中頂點輸入描述章節的「Binding descriptions」小節開始,這是 issue 連結並引用的內容。issue 提議了替換文字:先將頂點輸入綁定定義為有編號的插槽,接著介紹 stride 和 inputRate,最後說明 bindVertexBuffers() 將在下一章介紹。當該小節依此順序閱讀時即視為完成;圖示為選用。payload 沒有提供原始檔名,請根據小節標題找到它。

由索引模型根據 Issue 內容生成。

描述

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.

主要語言
C++
星號
434
分支
135
平均合併
1 天 9 小時
30 天內合併 PR
4

環境準備

  • 沒有 Dockerfile 或 Docker Compose 檔案
  • 沒有 Pull Request 範本
  • 閱讀貢獻指南

從這裡開始

  1. 先讀完整個 Issue,再讀專案的貢獻指南。
  2. 在 Issue 下留言說明你要接手 —— 這能避免兩個人做同樣的事。
  3. Fork 儲存庫,在一個分支上完成修改。
  4. 送出 Pull Request,並在描述裡引用這個 Issue 編號。

KhronosGroup/Vulkan-Tutorial 的其他 Issue

查看 KhronosGroup/Vulkan-Tutorial 的全部 Issue

相似的 Issue

更多 C++ Issue

把新 issue 寄到你的電子郵件信箱

精選適合新手參與的 GitHub issue 摘要。