Release v29 (#9260)

This commit is contained in:
Connor Fitzgerald authored and GitHub committed 2026-03-18 20:23:53 -04:00
1 parent e4dae053c0
commit 06e2c7d24a
11 files changed
+120 -87

No files matched your search

+69 -37
View File
@@ -42,6 +42,8 @@ Bottom level categories:
## Unreleased
## v29.0.0 (2026-03-18)
### Major Changes
#### `Surface::get_current_texture` now returns `CurrentSurfaceTexture` enum
@@ -65,9 +67,11 @@ match surface.get_current_texture() {
}
```
By @cwfitzgerald, @Wumpf, and @emilk in [#9141](https://github.com/gfx-rs/wgpu/pull/9141) and [#????](https://github.com/gfx-rs/wgpu/pull/????).
By @cwfitzgerald, @Wumpf, and @emilk in [#9141](https://github.com/gfx-rs/wgpu/pull/9141) and [#9257](https://github.com/gfx-rs/wgpu/pull/9257).
#### `InstanceDescriptor` initialization APIs
#### `InstanceDescriptor` initialization APIs and display handle changes
A display handle represents a connection to the platform's display server (e.g. a Wayland or X11 connection on Linux). This is distinct from a window — a display handle is the system-level connection through which windows are created and managed.
`InstanceDescriptor`'s convenience constructors (an implementation of `Default` and the static `from_env_or_default` method) have been removed. In their place are new static methods that force recognition of whether a display handle is used:
@@ -76,11 +80,22 @@ By @cwfitzgerald, @Wumpf, and @emilk in [#9141](https://github.com/gfx-rs/wgpu/p
- `new_without_display_handle`
- `new_without_display_handle_from_env`
If you are using `winit`, this can be populated using `EventLoop::owned_display_handle`.
```diff
- InstanceDescriptor::default();
- InstanceDescriptor::from_env_or_default();
+ InstanceDescriptor::new_with_display_handle(Box::new(event_loop.owned_display_handle()));
+ InstanceDescriptor::new_with_display_handle_from_env(Box::new(event_loop.owned_display_handle()));
```
Additionally, `DisplayHandle` is now optional when creating a surface if a display handle was already passed to `InstanceDescriptor`. This means that once you've provided the display handle at instance creation time, you no longer need to pass it again for each surface you create.
By @MarijnS95 in [#8782](https://github.com/gfx-rs/wgpu/pull/8782)
#### Bind group layouts now optional in `PipelineLayoutDescriptor`
Allow gaps in bind group layouts and added full support for unbinding. As a result of this `PipelineLayoutDescriptor`'s `bind_group_layouts` field now has type of `&[Option<&BindGroupLayout>]`, making this a breaking change. To migrate wrap bind group layout references in `Some`:
This allows gaps in bind group layouts and adds full support for unbinding, bring us in compliance with the WebGPU spec. As a result of this `PipelineLayoutDescriptor`'s `bind_group_layouts` field now has type of `&[Option<&BindGroupLayout>]`. To migrate wrap bind group layout references in `Some`:
```diff
let pl_desc = wgpu::PipelineLayoutDescriptor {
@@ -101,6 +116,14 @@ By @teoxoy in [#9034](https://github.com/gfx-rs/wgpu/pull/9034).
By @cwfitzgerald in [#8999](https://github.com/gfx-rs/wgpu/pull/8999).
#### `WriteOnly`
To ensure memory safety when accessing mapped GPU memory, `MapMode::Write` buffer mappings (`BufferViewMut` and also `QueueWriteBufferView`) can no longer be dereferenced to Rust `&mut [u8]`. Instead, they must be used through the new pointer type `wgpu::WriteOnly<[u8]>`, which does not allow reading at all.
`WriteOnly<[u8]>` is designed to offer similar functionality to `&mut [u8]` and have almost no performance overhead, but you will probably need to make some changes for anything more complicated than `get_mapped_range_mut().copy_from_slice(my_data)`; in particular, replacing `view[start..end]` with `view.slice(start..end)`.
By @kpreid in [#9042](https://github.com/gfx-rs/wgpu/pull/9042).
#### Depth/stencil state changes
The `depth_write_enabled` and `depth_compare` members of `DepthStencilState` are now optional, and may be omitted when they do not apply, to match WebGPU.
@@ -177,13 +200,28 @@ If the Agility SDK fails to load (e.g. version mismatch, missing DLL, or unsuppo
By @cwfitzgerald in [#9130](https://github.com/gfx-rs/wgpu/pull/9130).
#### `WriteOnly`
#### `primitive_index` is now a WGSL `enable` extension
To ensure memory safety when accessing mapped GPU memory, `MapMode::Write` buffer mappings (`BufferViewMut` and also `QueueWriteBufferView`) can no longer be dereferenced to Rust `&mut [u8]`. Instead, they must be used through the new pointer type `wgpu::WriteOnly<[u8]>`, which does not allow reading at all.
WGSL shaders using `@builtin(primitive_index)` must now request it with `enable primitive_index;`. The `SHADER_PRIMITIVE_INDEX` feature has been renamed to `PRIMITIVE_INDEX` and moved from `FeaturesWGPU` to `FeaturesWebGPU`. By @inner-daemons in [#8879](https://github.com/gfx-rs/wgpu/pull/8879) and @andyleiserson in [#9101](https://github.com/gfx-rs/wgpu/pull/9101).
`WriteOnly<[u8]>` is designed to offer similar functionality to `&mut [u8]` and have almost no performance overhead, but you will probably need to make some changes for anything more complicated than `get_mapped_range_mut().copy_from_slice(my_data)`; in particular, replacing `view[start..end]` with `view.slice(start..end)`.
```diff
- device.features().contains(wgpu::FeaturesWGPU::SHADER_PRIMITIVE_INDEX)
+ device.features().contains(wgpu::FeaturesWebGPU::PRIMITIVE_INDEX)
```
By @kpreid in [#9042](https://github.com/gfx-rs/wgpu/pull/9042).
```wgsl
// WGSL shaders must now include this directive:
enable primitive_index;
```
#### `maxInterStageShaderComponents` replaced by `maxInterStageShaderVariables`
Migrated from the `max_inter_stage_shader_components` limit to `max_inter_stage_shader_variables`, following the latest WebGPU spec. Components counted individual scalars (e.g. a `vec4` = 4 components), while variables counts locations (e.g. a `vec4` = 1 variable). This changes validation in a way that should not affect most programs. By @ErichDonGubler in [#8652](https://github.com/gfx-rs/wgpu/pull/8652), [#8792](https://github.com/gfx-rs/wgpu/pull/8792).
```diff
- limits.max_inter_stage_shader_components
+ limits.max_inter_stage_shader_variables
```
#### Other Breaking Changes
@@ -193,7 +231,7 @@ By @kpreid in [#9042](https://github.com/gfx-rs/wgpu/pull/9042).
#### General
- Added TLAS binding array support via `ACCELERATION_STRUCTURE_BINDING_ARRAY`. By @kvark in #8923.
- Added TLAS binding array support via `ACCELERATION_STRUCTURE_BINDING_ARRAY`. By @kvark in [#8923](https://github.com/gfx-rs/wgpu/pull/8923).
- Added `wgpu-naga-bridge` crate with conversions between `naga` and `wgpu-types` (features to capabilities, storage format mapping, shader stage mapping). By @atlv24 in [#9201](https://github.com/gfx-rs/wgpu/pull/9201).
- Added support for cooperative load/store operations in shaders. Currently only WGSL on the input and SPIR-V, METAL, and WGSL on the output are supported. By @kvark in [#8251](https://github.com/gfx-rs/wgpu/issues/8251).
- Added support for per-vertex attributes in fragment shaders. Currently only WGSL input is supported, and only SPIR-V or WGSL output is supported. By @atlv24 in [#8821](https://github.com/gfx-rs/wgpu/issues/8821).
@@ -201,6 +239,21 @@ By @kpreid in [#9042](https://github.com/gfx-rs/wgpu/pull/9042).
- Added support for obtaining `AdapterInfo` from `Device`. By @sagudev in [#8807](https://github.com/gfx-rs/wgpu/pull/8807).
- Added `Limits::or_worse_values_from`. By @atlv24 in [#8870](https://github.com/gfx-rs/wgpu/pull/8870).
- Added `Features::FLOAT32_BLENDABLE` on Vulkan and Metal. By @timokoesters in [#8963](https://github.com/gfx-rs/wgpu/pull/8963) and @andyleiserson in [#9032](https://github.com/gfx-rs/wgpu/pull/9032).
- Added `Dx12BackendOptions::force_shader_model` to allow using advanced features in passthrough shaders without bundling DXC. By @inner-daemons in [#8984](https://github.com/gfx-rs/wgpu/pull/8984).
- Changed passthrough shaders to not require an entry point parameter, so that the same shader module may be used in multiple entry points. Also added support for metallib passthrough. By @inner-daemons in [#8886](https://github.com/gfx-rs/wgpu/pull/8886).
- Added `Dx12Compiler::Auto` to automatically use static or dynamic DXC if available, before falling back to FXC. By @inner-daemons in [#8882](https://github.com/gfx-rs/wgpu/pull/8882).
- Added support for `insert_debug_marker`, `push_debug_group` and `pop_debug_group` on WebGPU. By @evilpie in [#9017](https://github.com/gfx-rs/wgpu/pull/9017).
- Added support for `@builtin(draw_index)` to the vulkan backend. By @inner-daemons in [#8883](https://github.com/gfx-rs/wgpu/pull/8883).
- Added `TextureFormat::channels` method to get some information about which color channels are covered by the texture format. By @TornaxO7 in [#9167](https://github.com/gfx-rs/wgpu/pull/9167)
- BREAKING: Add `V6_8` variant to `DxcShaderModel` and `naga::back::hlsl::ShaderModel`. By @inner-daemons in [#8882](https://github.com/gfx-rs/wgpu/pull/8882) and @ErichDonGubler in [#9083](https://github.com/gfx-rs/wgpu/pull/9083).
- BREAKING: Add `V6_9` variant to `DxcShaderModel` and `naga::back::hlsl::ShaderModel`. By @ErichDonGubler in [#9083](https://github.com/gfx-rs/wgpu/pull/9083).
#### naga
- Initial wgsl-in ray tracing pipelines. By @Vecvec in [#8570](https://github.com/gfx-rs/wgpu/pull/8570).
- wgsl-out ray tracing pipelines. By @Vecvec in [#8970](https://github.com/gfx-rs/wgpu/pull/8970).
- Allow parsing shaders which make use of `SPV_KHR_non_semantic_info` for debug info. Also removes `naga::front::spv::SUPPORTED_EXT_SETS`. By @inner-daemons in [#8827](https://github.com/gfx-rs/wgpu/pull/8827).
- Added memory decorations for storage buffers: `coherent`, supported on all native backends, and `volatile`, only on Vulkan and GL. By @atlv24 in [#9168](https://github.com/gfx-rs/wgpu/pull/9168).
- Made the following available in `const` contexts; by @ErichDonGubler in [#8943](https://github.com/gfx-rs/wgpu/pull/8943):
- `naga`
- `Arena::len`
@@ -209,23 +262,6 @@ By @kpreid in [#9042](https://github.com/gfx-rs/wgpu/pull/9042).
- `front::wgsl::Frontend::set_options`
- `ir::Block::is_empty`
- `ir::Block::len`
- Added `Dx12BackendOptions::force_shader_model` to allow using advanced features in passthrough shaders without bundling DXC. By @inner-daemons in [#8984](https://github.com/gfx-rs/wgpu/pull/8984).
- Changed passthrough shaders to not require an entry point parameter, so that the same shader module may be used in multiple entry points. Also added support for metallib passthrough. By @inner-daemons in #8886.
- Added `Dx12Compiler::Auto` to automatically use static or dynamic DXC if available, before falling back to FXC. By @inner-daemons in [#8882](https://github.com/gfx-rs/wgpu/pull/8882).
- Added support for `insert_debug_marker`, `push_debug_group` and `pop_debug_group` on WebGPU. By @evilpie in [#9017](https://github.com/gfx-rs/wgpu/pull/9017).
- Added support for `@builtin(draw_index)` to the vulkan backend. By @inner-daemons in #8883.
- BREAKING: WGSL shaders using `@builtin(primitive_index)` must now request it with `enable primitive_index;`. The `SHADER_PRIMITIVE_INDEX` feature has been renamed to `PRIMITIVE_INDEX` and moved from `FeaturesWGPU` to `FeaturesWebGPU`. By @inner-daemons in #8879 and @andyleiserson in [#9101](https://github.com/gfx-rs/wgpu/pull/9101).
- Added `TextureFormat::channels` method to get some information about which color channels are covered by the texture format. By @TornaxO7 in [#9167](https://github.com/gfx-rs/wgpu/pull/9167)
- BREAKING: Add `V6_8` variant to `DxcShaderModel` and `naga::back::hlsl::ShaderModel`. By @inner-daemons in [#8882](https://github.com/gfx-rs/wgpu/pull/8882) and @ErichDonGubler in [#9083](https://github.com/gfx-rs/wgpu/pull/9083).
- BREAKING: Add `V6_9` variant to `DxcShaderModel` and `naga::back::hlsl::ShaderModel`. By @ErichDonGubler in [#9083](https://github.com/gfx-rs/wgpu/pull/9083).
- `DisplayHandle` is now optional in surface creation if it was passed to `InstanceDescriptor::display`. By @MarijnS95 in [#8782](https://github.com/gfx-rs/wgpu/pull/8782)
#### naga
- Initial wgsl-in ray tracing pipelines. By @Vecvec in [#8570](https://github.com/gfx-rs/wgpu/pull/8570).
- wgsl-out ray tracing pipelines. By @Vecvec in [#8970](https://github.com/gfx-rs/wgpu/pull/8970).
- Allow parsing shaders which make use of `SPV_KHR_non_semantic_info` for debug info. Also removes `naga::front::spv::SUPPORTED_EXT_SETS`. By @inner-daemons in #8827.
- Added memory decorations for storage buffers: `coherent`, supported on all native backends, and `volatile`, only on Vulkan and GL. By @atlv24 in [#9168](https://github.com/gfx-rs/wgpu/pull/9168).
#### GLES
@@ -241,7 +277,7 @@ By @kpreid in [#9042](https://github.com/gfx-rs/wgpu/pull/9042).
#### General
- Tracing now uses the `.metal` extension for metal source files, instead of `.msl`. By @inner-daemons in [#8880](https://github.com/gfx-rs/wgpu/pull/8880).
- BREAKING: Several error APIs were changed by @ErichDonGubler in [#9073](https://github.com/gfx-rs/wgpu/pull/9073) and [#????](https://github.com/gfx-rs/wgpu/pull/????):
- BREAKING: Several error APIs were changed by @ErichDonGubler in [#9073](https://github.com/gfx-rs/wgpu/pull/9073) and [#9205](https://github.com/gfx-rs/wgpu/pull/9205):
- `BufferAccessError`:
- Split the `OutOfBoundsOverrun` variant into new `OutOfBoundsStartOffsetOverrun` and `OutOfBoundsEndOffsetOverrun` variants.
- Removed the `NegativeRange` variant in favor of new `MapStartOffsetUnderrun` and `MapStartOffsetOverrun` variants.
@@ -281,21 +317,20 @@ By @kpreid in [#9042](https://github.com/gfx-rs/wgpu/pull/9042).
#### General
- BREAKING: Migrated from the `maxInterStageShaderComponents` limit to `maxInterStageShaderVariables`, which changes validation in a way that should not affect most programs. This follows the latest changes of the WebGPU spec. By @ErichDonGubler in [#8652](https://github.com/gfx-rs/wgpu/pull/8652), [#8792](https://github.com/gfx-rs/wgpu/pull/8792).
- Tracing support has been restored. By @andyleiserson in [#8429](https://github.com/gfx-rs/wgpu/pull/8429).
- Pipelines using passthrough shaders now correctly require explicit pipeline layout. By @inner-daemons in #8881.
- Pipelines using passthrough shaders now correctly require explicit pipeline layout. By @inner-daemons in [#8881](https://github.com/gfx-rs/wgpu/pull/8881).
- Allow using a shader that defines I/O for dual-source blending in a pipeline that does not make use of it. By @andyleiserson in [#8856](https://github.com/gfx-rs/wgpu/pull/8856).
- Improve validation of dual-source blending, by @andyleiserson in [#9200](https://github.com/gfx-rs/wgpu/pull/9200):
- Validate structs with `@blend_src` members whether or not they are used by an entry point.
- Dual-source blending is not supported when there are multiple color attachments.
- `TypeFlags::IO_SHAREABLE` is not set for structs other than `@blend_src` structs.
- Validate `strip_index_format` isn't None and equals index buffer format for indexed drawing with strip topology. By @beicause in [#8850](https://github.com/gfx-rs/wgpu/pull/8850).
- Renamed `EXPERIMENTAL_PASSTHROUGH_SHADERS` to `PASSTHROUGH_SHADERS` and made this no longer an experimental feature. by @inner-daemons in [#9054](https://github.com/gfx-rs/wgpu/pull/9054).
- BREAKING: End offsets in trace and `player` commands are now represented using `offset` + `size` instead. By @ErichDonGubler in [9073](https://github.com/gfx-rs/wgpu/pull/9073).
- Validate some uncaught cases where buffer transfer operations could overflow when computing an end offset. By @ErichDonGubler in [9073](https://github.com/gfx-rs/wgpu/pull/9073).
- BREAKING: Renamed `EXPERIMENTAL_PASSTHROUGH_SHADERS` to `PASSTHROUGH_SHADERS` and made this no longer an experimental feature. By @inner-daemons in [#9054](https://github.com/gfx-rs/wgpu/pull/9054).
- BREAKING: End offsets in trace and `player` commands are now represented using `offset` + `size` instead. By @ErichDonGubler in [#9073](https://github.com/gfx-rs/wgpu/pull/9073).
- Validate some uncaught cases where buffer transfer operations could overflow when computing an end offset. By @ErichDonGubler in [#9073](https://github.com/gfx-rs/wgpu/pull/9073).
- Fix `local_invocation_id` and `local_invocation_index` being written multiple times in HLSL/MSL backends, and naming conflicts when users name variables `__local_invocation_id` or `__local_invocation_index`. By @inner-daemons in [#9099](https://github.com/gfx-rs/wgpu/pull/9099).
- Added internal labels to validation GPU objects and timestamp normalization code to improve clarity in graphics debuggers. By @szostid in [9094](https://github.com/gfx-rs/wgpu/pull/9094)
- Fix multi-planar texture copying. By @noituri [#9069](https://github.com/gfx-rs/wgpu/pull/9069)
- Added internal labels to validation GPU objects and timestamp normalization code to improve clarity in graphics debuggers. By @szostid in [#9094](https://github.com/gfx-rs/wgpu/pull/9094)
- Fix multi-planar texture copying. By @noituri in [#9069](https://github.com/gfx-rs/wgpu/pull/9069)
#### naga
@@ -330,6 +365,7 @@ By @kpreid in [#9042](https://github.com/gfx-rs/wgpu/pull/9042).
- Fixed a variety of mesh shader SPIR-V writer issues from the original implementation. By @inner-daemons in [#8756](https://github.com/gfx-rs/wgpu/pull/8756)
- Offset the vertex buffer device address when building a BLAS instead of using the `first_vertex` field. By @Vecvec in [#9220](https://github.com/gfx-rs/wgpu/pull/9220)
- Remove incorrect ordered texture uses. By @NiklasEi in [#8924](https://github.com/gfx-rs/wgpu/pull/8924).
#### Metal / macOS
@@ -343,10 +379,6 @@ By @kpreid in [#9042](https://github.com/gfx-rs/wgpu/pull/9042).
Note that the existing workaround to create surfaces before the adapter is no longer valid.
- Changing shader constants now correctly recompiles the shader. By @DerSchmale in [#8291](https://github.com/gfx-rs/wgpu/pull/8291).
#### Vulkan
- Remove incorrect ordered texture uses. By @NiklasEi in [#8924](https://github.com/gfx-rs/wgpu/pull/8924).
### Performance
#### GLES
Generated
+22 -22
View File
@@ -824,7 +824,7 @@ checksum = "52560adf09603e58c9a7ee1fe1dcb95a16927b17c127f0ac02d6e768a0e25bc1"
[[package]]
name = "cts_runner"
version = "28.0.0"
version = "29.0.0"
dependencies = [
"deno_console",
"deno_core",
@@ -1778,7 +1778,7 @@ checksum = "dfa686283ad6dd069f105e5ab091b04c62850d3e4cf5d67debad1933f55023df"
[[package]]
name = "hlsl-snapshots"
version = "28.0.0"
version = "29.0.0"
dependencies = [
"anyhow",
"nanoserde",
@@ -2171,7 +2171,7 @@ checksum = "11d3d7f243d5c5a8b9bb5d6dd2b1602c0cb0b9db1621bafc7ed66e35ff9fe092"
[[package]]
name = "lock-analyzer"
version = "28.0.0"
version = "29.0.0"
dependencies = [
"anyhow",
"ron",
@@ -2301,7 +2301,7 @@ dependencies = [
[[package]]
name = "naga"
version = "28.0.0"
version = "29.0.0"
dependencies = [
"arbitrary",
"arrayvec",
@@ -2338,7 +2338,7 @@ dependencies = [
[[package]]
name = "naga-cli"
version = "28.0.0"
version = "29.0.0"
dependencies = [
"anyhow",
"argh",
@@ -2351,7 +2351,7 @@ dependencies = [
[[package]]
name = "naga-fuzz"
version = "28.0.0"
version = "29.0.0"
dependencies = [
"arbitrary",
"cfg_aliases",
@@ -2361,7 +2361,7 @@ dependencies = [
[[package]]
name = "naga-test"
version = "28.0.0"
version = "29.0.0"
dependencies = [
"bitflags 2.11.0",
"naga",
@@ -3012,7 +3012,7 @@ checksum = "b4596b6d070b27117e987119b4dac604f3c58cfb0b191112e24771b2faeac1a6"
[[package]]
name = "player"
version = "28.0.0"
version = "29.0.0"
dependencies = [
"bytemuck",
"env_logger",
@@ -4546,7 +4546,7 @@ dependencies = [
[[package]]
name = "wgpu"
version = "28.0.0"
version = "29.0.0"
dependencies = [
"arrayvec",
"bitflags 2.11.0",
@@ -4574,7 +4574,7 @@ dependencies = [
[[package]]
name = "wgpu-benchmark"
version = "28.0.0"
version = "29.0.0"
dependencies = [
"anyhow",
"bincode 2.0.1",
@@ -4605,7 +4605,7 @@ dependencies = [
[[package]]
name = "wgpu-core"
version = "28.0.0"
version = "29.0.0"
dependencies = [
"arrayvec",
"bit-set 0.9.1",
@@ -4640,28 +4640,28 @@ dependencies = [
[[package]]
name = "wgpu-core-deps-apple"
version = "28.0.0"
version = "29.0.0"
dependencies = [
"wgpu-hal",
]
[[package]]
name = "wgpu-core-deps-emscripten"
version = "28.0.0"
version = "29.0.0"
dependencies = [
"wgpu-hal",
]
[[package]]
name = "wgpu-core-deps-wasm"
version = "28.0.0"
version = "29.0.0"
dependencies = [
"wgpu-hal",
]
[[package]]
name = "wgpu-core-deps-windows-linux-android"
version = "28.0.0"
version = "29.0.0"
dependencies = [
"wgpu-hal",
]
@@ -4696,7 +4696,7 @@ dependencies = [
[[package]]
name = "wgpu-examples"
version = "28.0.0"
version = "29.0.0"
dependencies = [
"bytemuck",
"cfg-if",
@@ -4727,7 +4727,7 @@ dependencies = [
[[package]]
name = "wgpu-hal"
version = "28.0.0"
version = "29.0.0"
dependencies = [
"android_system_properties",
"arrayvec",
@@ -4784,7 +4784,7 @@ dependencies = [
[[package]]
name = "wgpu-info"
version = "28.0.0"
version = "29.0.0"
dependencies = [
"anyhow",
"bitflags 2.11.0",
@@ -4799,7 +4799,7 @@ dependencies = [
[[package]]
name = "wgpu-macros"
version = "28.0.0"
version = "29.0.0"
dependencies = [
"heck",
"quote",
@@ -4808,7 +4808,7 @@ dependencies = [
[[package]]
name = "wgpu-naga-bridge"
version = "28.0.0"
version = "29.0.0"
dependencies = [
"naga",
"wgpu-types",
@@ -4816,7 +4816,7 @@ dependencies = [
[[package]]
name = "wgpu-test"
version = "28.0.0"
version = "29.0.0"
dependencies = [
"anyhow",
"approx",
@@ -4861,7 +4861,7 @@ dependencies = [
[[package]]
name = "wgpu-types"
version = "28.0.0"
version = "29.0.0"
dependencies = [
"bitflags 2.11.0",
"bytemuck",
+13 -13
View File
@@ -66,13 +66,13 @@ keywords = ["graphics"]
license = "MIT OR Apache-2.0"
homepage = "https://wgpu.rs/"
repository = "https://github.com/gfx-rs/wgpu"
version = "28.0.0"
version = "29.0.0"
authors = ["gfx-rs developers"]
[workspace.dependencies]
naga = { version = "28.0.0", path = "./naga" }
naga = { version = "29.0.0", path = "./naga" }
naga-test = { path = "./naga-test" }
wgpu = { version = "28.0.0", path = "./wgpu", default-features = false, features = [
wgpu = { version = "29.0.0", path = "./wgpu", default-features = false, features = [
"std",
"serde",
"wgsl",
@@ -85,22 +85,22 @@ wgpu = { version = "28.0.0", path = "./wgpu", default-features = false, features
"static-dxc",
"noop", # This should be removed if we ever have non-test crates that depend on wgpu
] }
wgpu-core = { version = "28.0.0", path = "./wgpu-core" }
wgpu-hal = { version = "28.0.0", path = "./wgpu-hal" }
wgpu-macros = { version = "28.0.0", path = "./wgpu-macros" }
wgpu-naga-bridge = { version = "28.0.0", path = "./wgpu-naga-bridge" }
wgpu-test = { version = "28.0.0", path = "./tests" }
wgpu-types = { version = "28.0.0", path = "./wgpu-types", default-features = false }
wgpu-core = { version = "29.0.0", path = "./wgpu-core" }
wgpu-hal = { version = "29.0.0", path = "./wgpu-hal" }
wgpu-macros = { version = "29.0.0", path = "./wgpu-macros" }
wgpu-naga-bridge = { version = "29.0.0", path = "./wgpu-naga-bridge" }
wgpu-test = { version = "29.0.0", path = "./tests" }
wgpu-types = { version = "29.0.0", path = "./wgpu-types", default-features = false }
# These _cannot_ have a version specified. If it does, crates.io will look
# for a version of the package on crates when we publish naga. Path dependencies
# are allowed through though.
hlsl-snapshots = { path = "naga/hlsl-snapshots" }
wgpu-core-deps-windows-linux-android = { version = "28.0.0", path = "./wgpu-core/platform-deps/windows-linux-android" }
wgpu-core-deps-apple = { version = "28.0.0", path = "./wgpu-core/platform-deps/apple" }
wgpu-core-deps-wasm = { version = "28.0.0", path = "./wgpu-core/platform-deps/wasm" }
wgpu-core-deps-emscripten = { version = "28.0.0", path = "./wgpu-core/platform-deps/emscripten" }
wgpu-core-deps-windows-linux-android = { version = "29.0.0", path = "./wgpu-core/platform-deps/windows-linux-android" }
wgpu-core-deps-apple = { version = "29.0.0", path = "./wgpu-core/platform-deps/apple" }
wgpu-core-deps-wasm = { version = "29.0.0", path = "./wgpu-core/platform-deps/wasm" }
wgpu-core-deps-emscripten = { version = "29.0.0", path = "./wgpu-core/platform-deps/emscripten" }
anyhow = { version = "1.0.87", default-features = false }
approx = "0.5"
+2 -2
View File
@@ -49,13 +49,13 @@ To use wgpu in C or dozens of other languages, look at [wgpu-native](https://git
| Docs | Examples | Changelog |
|:---------------------:|:-------------------------:|:-----------------------:|
| [v28][rel-docs] | [v28][rel-examples] | [v28][rel-change] |
| [v29][rel-docs] | [v29][rel-examples] | [v29][rel-change] |
| [`trunk`][trunk-docs] | [`trunk`][trunk-examples] | [`trunk`][trunk-change] |
Contributors are welcome! See [CONTRIBUTING.md][contrib] for more information.
[rel-docs]: https://docs.rs/wgpu/
[rel-examples]: https://github.com/gfx-rs/wgpu/tree/v28/examples#readme
[rel-examples]: https://github.com/gfx-rs/wgpu/tree/v29/examples#readme
[rel-change]: https://github.com/gfx-rs/wgpu/releases
[trunk-docs]: https://wgpu.rs/doc/wgpu/
[trunk-examples]: https://github.com/gfx-rs/wgpu/tree/trunk/examples#readme
+3 -2
View File
@@ -14,7 +14,7 @@ Anyone in the @gfx-rs/wgpu team can perform these steps.
Approx 1 Week Before:
- Determine if `glow` (@groves), `metal-rs` (@gfx-rs/wgpu) or any other dependant crates will need a release. If so, coordinate with their maintainers.
- Determine if `glow` (@groves), `rspirv` (@gfx-rs/wgpu) or any other dependant crates will need a release. If so, coordinate with their maintainers.
- Go through the changelog:
- Re-categorize miscategorized items.
- Edit major changes so a user can easily understand what they need to do.
@@ -27,9 +27,10 @@ Day of Release:
- Bump the wgpu dependency numbers in the following places:
- `Cargo.toml`
- `examples/standalone/*`
- `examples/bug-repro/*`
- Grep for the previous version to ensure various documentation links are updated.
- For example, if the previous version was v24.0.0, grep for `v24` and `24.0`
- Ensure `glow` and `metal` are updated to the latest version if needed.
- Ensure `glow` and `rspirv` are updated to the latest version if needed.
- Add a new header for the changelog with the release version and date.
- Create a PR with all of the version changes and changelog updates.
- Once the PR is CI clean, (force) merge it.
+2 -2
View File
@@ -1,6 +1,6 @@
> [!NOTE]
> These are the examples for the development version of wgpu. If you want to see the examples for the latest crates.io release
> of wgpu, go to the [latest release branch](https://github.com/gfx-rs/wgpu/tree/v28/examples#readme).
> of wgpu, go to the [latest release branch](https://github.com/gfx-rs/wgpu/tree/v29/examples#readme).
# Examples
@@ -23,7 +23,7 @@ be cloned out of the repository to serve as a starting point for your own projec
You can also use [`cargo-generate`](https://github.com/cargo-generate/cargo-generate) to easily use these as a basis for your own projects.
```sh
cargo generate gfx-rs/wgpu --branch v28
cargo generate gfx-rs/wgpu --branch v29
```
## Framework Examples
@@ -7,5 +7,5 @@ publish = false
[dependencies]
env_logger = "0.11"
pollster = "0.4"
wgpu = "28.0.0"
wgpu = "29.0.0"
winit = "0.30.8"
@@ -8,4 +8,4 @@ publish = false
bytemuck = "1.22.0"
env_logger = "0.11"
pollster = "0.4"
wgpu = "28.0.0"
wgpu = "29.0.0"
@@ -7,5 +7,5 @@ publish = false
[dependencies]
env_logger = "0.11"
pollster = "0.4"
wgpu = "28.0.0"
wgpu = "29.0.0"
winit = { version = "0.30.8", features = ["android-native-activity"] }
@@ -9,7 +9,7 @@ default = ["web"]
web = ["wgpu/web"]
[dependencies]
wgpu = { version = "28.0.0", features = [
wgpu = { version = "29.0.0", features = [
"custom",
"wgsl",
], default-features = false }
+5 -5
View File
@@ -17,7 +17,7 @@
//!
//! We have a [wiki](https://github.com/gfx-rs/wgpu/wiki) which has information on useful architecture patterns, debugging tips, and more getting started information.
//!
//! There are examples for this version [available on GitHub](https://github.com/gfx-rs/wgpu/tree/v28/examples#readme).
//! There are examples for this version [available on GitHub](https://github.com/gfx-rs/wgpu/tree/v29/examples#readme).
//!
//! The API is refcounted, so all handles are cloneable, and if you create a resource which references another,
//! it will automatically keep dependent resources alive.
@@ -32,8 +32,8 @@
//!
//! [Learn Wgpu]: https://sotrh.github.io/learn-wgpu/
//! [WebGPU Fundamentals]: https://webgpufundamentals.org/
//! [render_coordinates]: https://raw.githubusercontent.com/gfx-rs/wgpu/refs/heads/v28/docs/render_coordinates.png
//! [texture_coordinates]: https://raw.githubusercontent.com/gfx-rs/wgpu/refs/heads/v28/docs/texture_coordinates.png
//! [render_coordinates]: https://raw.githubusercontent.com/gfx-rs/wgpu/refs/heads/v29/docs/render_coordinates.png
//! [texture_coordinates]: https://raw.githubusercontent.com/gfx-rs/wgpu/refs/heads/v29/docs/texture_coordinates.png
//!
//! ## Extension Specifications
//!
@@ -42,8 +42,8 @@
//!
//! 🧪EXPERIMENTAL🧪 APIs are subject to change and may allow undefined behavior if used incorrectly.
//!
//! - 🧪EXPERIMENTAL🧪 [Ray Tracing](https://github.com/gfx-rs/wgpu/blob/v28/docs/api-specs/ray_tracing.md).
//! - 🧪EXPERIMENTAL🧪 [Mesh Shading](https://github.com/gfx-rs/wgpu/blob/v28/docs/api-specs/mesh_shading.md).
//! - 🧪EXPERIMENTAL🧪 [Ray Tracing](https://github.com/gfx-rs/wgpu/blob/v29/docs/api-specs/ray_tracing.md).
//! - 🧪EXPERIMENTAL🧪 [Mesh Shading](https://github.com/gfx-rs/wgpu/blob/v29/docs/api-specs/mesh_shading.md).
//!
//! ## Shader Support
//!