Added WebGPU. (#3544)

bkaradzic · web-flow · commit 868c66e1ed73 · 2026-01-10T04:09:39.000Z
diff --git a/README.md b/README.md
@@ -43,6 +43,7 @@ Supported rendering backends:
  * Vulkan
  * WebGL 1.0
  * WebGL 2.0
+ * WebGPU (Dawn Native only)
 
 Supported platforms:
 
diff --git a/bindings/bf/bgfx.bf b/bindings/bf/bgfx.bf
@@ -1419,6 +1419,11 @@ public static class bgfx
 		/// </summary>
 		Vulkan,
 	
+		/// <summary>
+		/// WebGPU
+		/// </summary>
+		WebGPU,
+	
 		Count
 	}
 	
diff --git a/bindings/c3/bgfx.c3 b/bindings/c3/bgfx.c3
@@ -896,6 +896,9 @@ enum RendererType : uint
 	// Vulkan
 	VULKAN,
 
+	// WebGPU
+	WEBGPU,
+
 	COUNT
 }
 
diff --git a/bindings/cs/bgfx.cs b/bindings/cs/bgfx.cs
@@ -1416,6 +1416,11 @@ public enum RendererType
 		/// </summary>
 		Vulkan,
 	
+		/// <summary>
+		/// WebGPU
+		/// </summary>
+		WebGPU,
+	
 		Count
 	}
 	
diff --git a/bindings/d/impl.d b/bindings/d/impl.d
@@ -26,7 +26,7 @@ extern(C++, "bgfx") package final abstract class Fatal{
 }
 extern(C++, "bgfx") package final abstract class RendererType{
 	enum Enum{
-		noop,agc,direct3D11,direct3D12,gnm,metal,nvn,openGLES,openGL,vulkan,count
+		noop,agc,direct3D11,direct3D12,gnm,metal,nvn,openGLES,openGL,vulkan,webGPU,count
 	}
 }
 extern(C++, "bgfx") package final abstract class Access{
diff --git a/bindings/d/package.d b/bindings/d/package.d
@@ -599,6 +599,7 @@ enum RendererType: bgfx.impl.RendererType.Enum{
 	openGLES = bgfx.impl.RendererType.Enum.openGLES,
 	openGL = bgfx.impl.RendererType.Enum.openGL,
 	vulkan = bgfx.impl.RendererType.Enum.vulkan,
+	webGPU = bgfx.impl.RendererType.Enum.webGPU,
 	count = bgfx.impl.RendererType.Enum.count,
 }
 
diff --git a/bindings/zig/bgfx.zig b/bindings/zig/bgfx.zig
@@ -867,6 +867,9 @@ pub const RendererType = enum(c_int) {
     /// Vulkan
     Vulkan,
 
+    /// WebGPU
+    WebGPU,
+
     Count
 };
 
diff --git a/docs/overview.rst b/docs/overview.rst
@@ -28,6 +28,7 @@ Supported rendering backends
 -  Vulkan
 -  WebGL 1.0
 -  WebGL 2.0
+-  WebGPU (Dawn Native only)
 
 Supported Platforms
 ~~~~~~~~~~~~~~~~~~~
diff --git a/examples/common/args.h b/examples/common/args.h
@@ -23,6 +23,10 @@ struct Args
 		{
 			m_type = bgfx::RendererType::Vulkan;
 		}
+		else if (cmdLine.hasArg("wgpu") )
+		{
+			m_type = bgfx::RendererType::WebGPU;
+		}
 		else if (cmdLine.hasArg("noop") )
 		{
 			m_type = bgfx::RendererType::Noop;
diff --git a/examples/common/bgfx_utils.cpp b/examples/common/bgfx_utils.cpp
@@ -112,6 +112,7 @@ static bgfx::ShaderHandle loadShader(bx::FileReaderI* _reader, const bx::StringV
 	case bgfx::RendererType::OpenGL:     filePath.join("glsl");  break;
 	case bgfx::RendererType::OpenGLES:   filePath.join("essl");  break;
 	case bgfx::RendererType::Vulkan:     filePath.join("spirv"); break;
+	case bgfx::RendererType::WebGPU:     filePath.join("wgsl");  break;
 
 	case bgfx::RendererType::Count:
 		BX_ASSERT(false, "You should not be here!");
diff --git a/include/bgfx/bgfx.h b/include/bgfx/bgfx.h
@@ -63,6 +63,7 @@ namespace bgfx
 			OpenGLES,     //!< OpenGL ES 2.0+
 			OpenGL,       //!< OpenGL 2.1+
 			Vulkan,       //!< Vulkan
+			WebGPU,       //!< WebGPU
 
 			Count
 		};
diff --git a/include/bgfx/c99/bgfx.h b/include/bgfx/c99/bgfx.h
@@ -90,6 +90,7 @@ typedef enum bgfx_renderer_type
     BGFX_RENDERER_TYPE_OPENGLES,              /** ( 7) OpenGL ES 2.0+                 */
     BGFX_RENDERER_TYPE_OPENGL,                /** ( 8) OpenGL 2.1+                    */
     BGFX_RENDERER_TYPE_VULKAN,                /** ( 9) Vulkan                         */
+    BGFX_RENDERER_TYPE_WEBGPU,                /** (10) WebGPU                         */
 
     BGFX_RENDERER_TYPE_COUNT
 
diff --git a/include/bgfx/embedded_shader.h b/include/bgfx/embedded_shader.h
@@ -81,7 +81,11 @@
 #endif // BGFX_PLATFORM_SUPPORTS_SPIRV
 
 #ifndef BGFX_PLATFORM_SUPPORTS_WGSL
-#	define BGFX_PLATFORM_SUPPORTS_WGSL 0
+#	define BGFX_PLATFORM_SUPPORTS_WGSL (0 \
+		|| BX_PLATFORM_LINUX              \
+		|| BX_PLATFORM_WINDOWS            \
+		|| BX_PLATFORM_OSX                \
+		)
 #endif // BGFX_PLATFORM_SUPPORTS_WGSL
 
 ///
diff --git a/scripts/bgfx.idl b/scripts/bgfx.idl
@@ -468,6 +468,7 @@ enum.RendererType { comment = "Renderer types:" }
 	.OpenGLES   --- OpenGL ES 2.0+
 	.OpenGL     --- OpenGL 2.1+
 	.Vulkan     --- Vulkan
+	.WebGPU     --- WebGPU
 	()
 
 --- Access mode enum.
diff --git a/src/amalgamated.cpp b/src/amalgamated.cpp
@@ -18,6 +18,7 @@
 #include "renderer_noop.cpp"
 #include "renderer_nvn.cpp"
 #include "renderer_vk.cpp"
+#include "renderer_webgpu.cpp"
 #include "shader.cpp"
 #include "shader_dxbc.cpp"
 #include "shader_spirv.cpp"
diff --git a/src/bgfx.cpp b/src/bgfx.cpp
@@ -2727,6 +2727,7 @@ namespace bgfx
 		{ gl::rendererCreate,     gl::rendererDestroy,     BGFX_RENDERER_OPENGL_NAME,     !!BGFX_CONFIG_RENDERER_OPENGLES   }, // OpenGLES
 		{ gl::rendererCreate,     gl::rendererDestroy,     BGFX_RENDERER_OPENGL_NAME,     !!BGFX_CONFIG_RENDERER_OPENGL     }, // OpenGL
 		{ vk::rendererCreate,     vk::rendererDestroy,     BGFX_RENDERER_VULKAN_NAME,     !!BGFX_CONFIG_RENDERER_VULKAN     }, // Vulkan
+		{ wgpu::rendererCreate,   wgpu::rendererDestroy,   BGFX_RENDERER_WEBGPU_NAME,     !!BGFX_CONFIG_RENDERER_WEBGPU     }, // WebGPU
 	};
 	static_assert(BX_COUNTOF(s_rendererCreator) == RendererType::Count);
 
diff --git a/src/bgfx_p.h b/src/bgfx_p.h
@@ -240,6 +240,7 @@ namespace stl = std;
 #define BGFX_RENDERER_METAL_NAME      "Metal"
 #define BGFX_RENDERER_NVN_NAME        "NVN"
 #define BGFX_RENDERER_VULKAN_NAME     "Vulkan"
+#define BGFX_RENDERER_WEBGPU_NAME     "WebGPU"
 
 #if BGFX_CONFIG_RENDERER_OPENGL
 #	if BGFX_CONFIG_RENDERER_OPENGL >= 31 && BGFX_CONFIG_RENDERER_OPENGL <= 33
diff --git a/src/config.h b/src/config.h
@@ -27,7 +27,8 @@
  && !defined(BGFX_CONFIG_RENDERER_NVN)        \
  && !defined(BGFX_CONFIG_RENDERER_OPENGL)     \
  && !defined(BGFX_CONFIG_RENDERER_OPENGLES)   \
- && !defined(BGFX_CONFIG_RENDERER_VULKAN)
+ && !defined(BGFX_CONFIG_RENDERER_VULKAN)     \
+ && !defined(BGFX_CONFIG_RENDERER_WEBGPU)
 
 #	ifndef BGFX_CONFIG_RENDERER_AGC
 #		define BGFX_CONFIG_RENDERER_AGC (0 \
@@ -109,6 +110,15 @@
 					? 1 : 0)
 #	endif // BGFX_CONFIG_RENDERER_VULKAN
 
+#	ifndef BGFX_CONFIG_RENDERER_WEBGPU
+#		define BGFX_CONFIG_RENDERER_WEBGPU (0     \
+					/*|| BX_PLATFORM_EMSCRIPTEN*/ \
+					|| BX_PLATFORM_LINUX          \
+					|| BX_PLATFORM_OSX            \
+					|| BX_PLATFORM_WINDOWS        \
+					? 1 : 0)
+#	endif // BGFX_CONFIG_RENDERER_WEBGPU
+
 #else
 #	ifndef BGFX_CONFIG_RENDERER_AGC
 #		define BGFX_CONFIG_RENDERER_AGC 0
@@ -145,6 +155,10 @@
 #	ifndef BGFX_CONFIG_RENDERER_VULKAN
 #		define BGFX_CONFIG_RENDERER_VULKAN 0
 #	endif // BGFX_CONFIG_RENDERER_VULKAN
+
+#	ifndef BGFX_CONFIG_RENDERER_WEBGPU
+#		define BGFX_CONFIG_RENDERER_WEBGPU 0
+#	endif // BGFX_CONFIG_RENDERER_WEBGPU
 #endif // !defined...
 
 #if BGFX_CONFIG_RENDERER_OPENGL && BGFX_CONFIG_RENDERER_OPENGL < 21
diff --git a/src/makefile b/src/makefile
@@ -31,6 +31,8 @@ define shader-embedded
 	-@cat "$(SHADER_TMP)" >> $(@)
 	-$(SILENT) $(SHADERC) --type $(1) --platform linux   -p spirv      -f $(<) -o "$(SHADER_TMP)" --bin2c $(basename $(<))_spv
 	-@cat "$(SHADER_TMP)" >> $(@)
+	-$(SILENT) $(SHADERC) --type $(1) --platform linux   -p wgsl       -f $(<) -o "$(SHADER_TMP)" --bin2c $(basename $(<))_wgsl
+	-@cat "$(SHADER_TMP)" >> $(@)
 	-$(SILENT) $(SHADERC) --type $(1) --platform windows -p $(2)  -O 3 -f $(<) -o "$(SHADER_TMP)" --bin2c $(basename $(<))_dx11
 	-@cat "$(SHADER_TMP)" >> $(@)
 	-$(SILENT) $(SHADERC) --type $(1) --platform ios     -p metal -O 3 -f $(<) -o "$(SHADER_TMP)" --bin2c $(basename $(<))_mtl
diff --git a/src/renderer_webgpu.cpp b/src/renderer_webgpu.cpp
diff --git a/src/renderer_webgpu.h b/src/renderer_webgpu.h
diff --git a/src/vertexlayout.cpp b/src/vertexlayout.cpp

Original file line number	Diff line number	Diff line change
`@@ -896,6 +896,9 @@ enum RendererType : uint`
`896`	`896`	`// Vulkan`
`897`	`897`	`VULKAN,`
`898`	`898`
	`899`	`+ // WebGPU`
	`900`	`+ WEBGPU,`
	`901`	`+`
`899`	`902`	`COUNT`
`900`	`903`	`}`
`901`	`904`
Original file line number	Diff line number	Diff line change
`@@ -26,7 +26,7 @@ extern(C++, "bgfx") package final abstract class Fatal{`
`26`	`26`	`}`
`27`	`27`	`extern(C++, "bgfx") package final abstract class RendererType{`
`28`	`28`	`enum Enum{`
`29`		`- noop,agc,direct3D11,direct3D12,gnm,metal,nvn,openGLES,openGL,vulkan,count`
	`29`	`+ noop,agc,direct3D11,direct3D12,gnm,metal,nvn,openGLES,openGL,vulkan,webGPU,count`
`30`	`30`	`}`
`31`	`31`	`}`
`32`	`32`	`extern(C++, "bgfx") package final abstract class Access{`
Original file line number	Diff line number	Diff line change
`@@ -599,6 +599,7 @@ enum RendererType: bgfx.impl.RendererType.Enum{`
`599`	`599`	`openGLES = bgfx.impl.RendererType.Enum.openGLES,`
`600`	`600`	`openGL = bgfx.impl.RendererType.Enum.openGL,`
`601`	`601`	`vulkan = bgfx.impl.RendererType.Enum.vulkan,`
	`602`	`+ webGPU = bgfx.impl.RendererType.Enum.webGPU,`
`602`	`603`	`count = bgfx.impl.RendererType.Enum.count,`
`603`	`604`	`}`
`604`	`605`
Original file line number	Diff line number	Diff line change
`@@ -23,6 +23,10 @@ struct Args`
`23`	`23`	`{`
`24`	`24`	`m_type = bgfx::RendererType::Vulkan;`
`25`	`25`	`}`
	`26`	`+ else if (cmdLine.hasArg("wgpu") )`
	`27`	`+ {`
	`28`	`+ m_type = bgfx::RendererType::WebGPU;`
	`29`	`+ }`
`26`	`30`	`else if (cmdLine.hasArg("noop") )`
`27`	`31`	`{`
`28`	`32`	`m_type = bgfx::RendererType::Noop;`