From 9c3758afc849b7a34e2f1898e5d938fb29671ccc Mon Sep 17 00:00:00 2001 From: Krishna Ayyalasomayajula Date: Sat, 30 May 2026 17:59:16 -0500 Subject: [PATCH] fix: add missing glossary entry for surface-configuration --- docs/concepts/GLOSSARY.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/concepts/GLOSSARY.md b/docs/concepts/GLOSSARY.md index e21c414..6a102c4 100644 --- a/docs/concepts/GLOSSARY.md +++ b/docs/concepts/GLOSSARY.md @@ -110,6 +110,10 @@ Controls what happens to the [[framebuffer]](#framebuffer) at the end of a rende wgpu's connection to a window's display buffer. Created via `instance.create_surface(window)`, the surface is like a bound socket — it is tied to a specific window and cannot be unlinked. The surface manages the [[swapchain]](#swapchain) and provides new framebuffers via `surface.get_current_texture()`. If the window is resized, the surface must be reconfigured with a new `SurfaceConfiguration`. +## Surface Configuration + +The `SurfaceConfiguration` struct that allocates swapchain framebuffers: format, dimensions, present mode, and view formats. Reconfigured on window resize via `Surface::configure()`. + ## Swapchain A ring buffer of 2-3 [[framebuffer]](#framebuffer) textures managed by the GPU driver. The display hardware reads from the front buffer. The application renders to the back buffer. When the frame is complete, the buffers swap: the back buffer becomes the front (displayed), and the old front becomes the available back buffer for the next frame. This prevents screen tearing by ensuring the display never reads a frame mid-update.