wgpu

其他 18.4k 1.6k Rust 上架 2026-11-08 访问官网 ↗ 在 GitHub 打开

wgpu是一个跨平台、安全、纯 Rust 的图形 API。它原生支持 Vulkan、Metal、D3D12 和 OpenGL；并且基于 wasm 上的 WebGL2 和 WebGPU。该 API 基...

#3D图形处理库

项目信息

所有者: gfx-rs
Star: 18.4k
Fork: 1.6k
开源协议: —
主要语言: Rust
发布时间: 2018-09-13
最近更新: 2026-10-27

项目更新

v30.0.12026-08-22
本次更新修复了三个后端的问题：Vulkan 在非 Windows 平台上误将未经等待的栅栏传给 vkAcquireNextImageKHR，自 v30.0.0 起每帧都会触发 VUID-vkAcquireNextImageKHR-fence-10066 校验错误，现已修正；Metal 改为动态解析色彩空间常量，避免硬编码带来的兼容问题；WebGPU 升级了内置的 WebGPU 绑定与 wasm-bindgen 至 0.2.127，解决了调用 requestAdapter() 失败时出现 “can't access property "info", arg0 is null” panic 的崩溃。使用 WebGPU 后端的用户建议尽快升级。
v29.0.42026-07-02
wgpu 本次更新涵盖一处新功能与两项修复。GLES 后端现在支持用 XCB 窗口句柄在 Linux 上初始化 OpenGL，此前这一路径缺失，Wayland 之外基于 X11 的窗口绑定要多绕一道弯。Metal 方面，v29 中被无故删除的 Queue::as_raw 已恢复，仍返回 &ProtocolObject<dyn MTLCommandQueue>，依赖该接口做原生命令队列交互的代码可以继续编译。Vulkan 后端修复了 VUID-RuntimeSpirv-vulkanMemoryModel-06265 校验报错：启用 Vulkan 内存模型时会同时打开 vulkanMemoryModelDeviceScope，因为 SPIR-V 后端生成的存储原子操作使用 Device 作用域，两者不一致会触发验证层报错。对应 PR 分别为 #9271、#9560、#9741。
v30.0.02026-07-01
本版四项改动都涉及迁移。VertexState 的 buffers 改为 &[Option<VertexBufferLayout>]，允许数组中留空并支持解绑顶点缓冲，对齐 WebGPU 规范，迁移时需给每个 layout 包上 Some。naga 不再默认把整型着色器 I/O 视作 @interpolate(flat)，WGSL 和 GLSL 都要显式标注 flat。长度为 0 的 BufferSlice 不再 panic，可以创建和映射，但不能用于绑定；BufferBinding 与 BindingResource 改为实现 TryFrom<BufferSlice>，BufferSlice::size() 也随之返回 u64。SurfaceConfiguration 新增 colorspace 字段，SurfaceCapabilities 新增 formatcapabilities，平台支持时可输出 HDR 与广色域，默认的 Auto 维持原有行为。
v29.0.32026-05-02
修复了未启用 cfg(debug_assertions) 时的编译错误。此前 wgpu-core v29.0.2 已被撤回（yank），依赖该版本的项目会构建失败，本次更新将依赖调整到可用版本，发布构建（非 debug 配置）可正常编译。
v29.0.22026-05-01
本版以问题修复为主。通用层面：相同的管线布局现在会正确刷新延迟绑定，此前会出现绑定不更新的情况；单独构建 wgpu-hal 的 gles/dx12 目标时，依赖特性缺失导致的编译失败也一并修好；TextureChannel 现在可以直接从 wgpu::TextureChannel 访问，不必再绕道类型路径。 DX12 修复了间接多绘制在步长校验时触发 debugassert 的问题，并纠正了 maxbindingarraysamplerelementspershaderstage 上限值报错的情况。Vulkan 调整了设备创建逻辑，只有用到 SHADERDRAWINDEX 时才请求 shaderDrawParameters，避免在不支持该特性的驱动（如 V3DV、SwiftShader）上直接创建失败。Metal 则修复了在 macOS 沙盒环境中创建 fence 时的崩溃。
v29.0.12026-03-26
v29.0.1 是一次补丁更新，同步发布 wgpu-core、wgpu-hal、naga、wgpu-naga-bridge 与 wgpu-types 的 29.0.1 版本，其余 crate 保持原版本。修复了几处问题：maxinterstageshadervariables 的上限比较逻辑有误，现已修正；Metal 后端为 CaptureMTLDevice 上未实现的特性检测方法加了保护，不再误调，同时修掉缓冲区上限过于保守的回归——代价是与 WebGPU 的上限校验不符，未来大版本会在原生端保留宽松上限，并允许按需启用 WebGPU 规定的校验（#9287）；GLES / OpenGL 后端修复了 create_texture 中纹理高度初始化错误；另外 CreateTextureViewError::TooMany{MipLevels,ArrayLayers} 的 Display 实现在基数与偏移溢出时不会再崩溃。
v29.0.02026-03-19
本版几处破坏性变更： Surface::getcurrenttexture 改为返回 CurrentSurfaceTexture 枚举，Result<SurfaceTexture, SurfaceError> 与 SurfaceError 一并删除，SurfaceTexture 的 suboptimal 字段改为 Suboptimal 变体。一个 match 即可覆盖成功、超时、遮挡、过期、丢失、校验错误等全部结果，分支意图比之前清晰： ``rust match surface.getcurrenttexture() { wgpu::CurrentSurfaceTexture::Success(frame) => { / 渲染 / } wgpu::CurrentSurfaceTexture::Timeout | wgpu::CurrentSurfaceTexture::Occluded => { / 跳过本帧 / } wgpu::CurrentSurfaceTexture::Outdated | wgpu::CurrentSurfaceTexture::Suboptimal(frame) => { / 重新配置 surface / } wgpu::CurrentSurfaceTexture::Lost => { / 重新配置，设备丢失则重建设备 / } wgpu::CurrentSurfaceTexture::Validation => { / 仅在注册了错误作用域或未捕获错误处理器时出现 / } } ` InstanceDescriptor 的 Default 与 fromenvordefault 被移除，换成四个强制区分是否使用显示句柄的方法：newwithdisplayhandle、newwithdisplayhandlefromenv、newwithoutdisplayhandle、newwithoutdisplayhandlefromenv。显示句柄是与窗口不同的系统级连接，用 winit 时可取 EventLoop::owneddisplay_handle。它在建实例时传一次即可，之后创建 surface 不必再传。 PipelineLayoutDescriptor::bindgrouplayouts 类型改为 &[Option<&BindGroupLayout>]，允许布局留空并支持解绑，对齐 WebGPU 规范；迁移时给原引用套上 Some 即可。 MSRV 降到 1.87，并确立新政策：只有确实带来收益才上调，且不超过 stable - 3`。
v28.0.12026-03-01
wgpu-core 与 wgpu-hal 升至 28.0.1，其余 crate 版本不变。本次以修复为主：解决了在 NVIDIA 显卡上从其他线程提交呈现时的崩溃问题；Vulkan 后端修复了部分 Mali 驱动在 Android 上的崩溃；Metal 后端则重新为 Apple A7 芯片加回 TRANSIENT 纹理支持，老设备上的相关功能得以恢复。
v28.0.0 - Mesh Shaders, Immediates, and More!2025-12-18
wgpu 26 正式支持 Mesh Shader，Vulkan 全功能可用，Metal 与 DX12 走 passthrough 着色器，WGSL 的解析与改写也已打通，可通过 WESL 或 nagaoil 使用。完整示例见 meshshader，规范文档在 docs/api-specs/mesh_shading.md。 Mesh Shader 管线替代传统顶点着色器管线，改由着色器直接生成图元交给光栅化，而不是逐个顶点再套静态索引缓冲。这类接近计算着色器的写法天然适配 meshlet 渲染：一组组小三角形整体做剔除与绘制，相邻三角形的计算可以合并，顶点与图元的对应关系也更可编程。它还能把不插值的逐图元数据直接传给片元着色器，与顶点解耦。配合 task 着色器，Mesh Shader 单独就能顶替顶点、曲面细分与几何着色器，用法灵活，能力相当强。
v26.0.62025-10-23
本次仅更新 wgpu-hal 至 26.0.6，其余 crate 版本保持不变。 Vulkan 后端修复了 Windows 上的一个帧节奏问题：AMD 和 NVIDIA 显卡在 Fifo、FifoRelaxed 呈现模式下卡顿、帧时间极不稳定。原因是驱动暗中改用 DXGI（Direct3D）交换链来实现这两种模式，其时序行为与预期相差甚远。本版通过绕开该路径加以规避，相关讨论见 issue #8310 与 #8354，修复由 #8420 提交。受影响的 Windows 玩家升级后帧率应明显更稳。