Files
learn-wgpu/docs/README.md

29 lines
1.2 KiB
Markdown

# learn-wgpu
An educational book teaching Rust graphics programming with wgpu 29 + winit 0.30.
Built for backend/systems Rust developers who know Rust thoroughly but have zero
graphics programming experience. Every sentence teaches GPU concepts — not Rust syntax.
## Required Reading Order
1. [The Graphics Pipeline](concepts/graphics-pipeline.md) — GPU vs CPU, the 5-stage pipeline
2. [Coordinate Systems](concepts/coordinate-systems.md) — NDC, homogeneous coordinates, viewport
3. [Shader Basics](concepts/shader-basics.md) — WGSL, vertex/fragment shaders, interpolation
4. [Build a Rainbow Triangle](01-rainbow-triangle.md) — The complete step-by-step guide
5. [Troubleshooting](TROUBLESHOOTING.md) — Common errors and fixes (reference as needed)
6. [Glossary](concepts/GLOSSARY.md) — Every term defined (reference as needed)
> **Reading order matters:** Coordinate systems must be understood before shader basics,
> because the shader walkthrough references NDC coordinates.
## Guides
- **01 — Rainbow Triangle** — The minimal complete program: one triangle, smooth color interpolation
- More guides coming soon (textures, lighting, compute)
## Prerequisites
- Rust stable (edition 2024)
- Linux x86_64 with Vulkan drivers (`libvulkan1`)