diff --git a/CHANGELOG.md b/CHANGELOG.md index 2398adaae..b2df6c26d 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -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 diff --git a/Cargo.lock b/Cargo.lock index f03d33bfc..21ce570db 100644 --- a/Cargo.lock +++ b/Cargo.lock @@ -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", diff --git a/Cargo.toml b/Cargo.toml index 42e53b42f..c1b3b5a10 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -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" diff --git a/README.md b/README.md index 4a5cf7688..5060ed392 100644 --- a/README.md +++ b/README.md @@ -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 diff --git a/docs/release-checklist.md b/docs/release-checklist.md index 4f8a25c3f..42d0dee16 100644 --- a/docs/release-checklist.md +++ b/docs/release-checklist.md @@ -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. diff --git a/examples/README.md b/examples/README.md index 194c5a945..dbd96278a 100644 --- a/examples/README.md +++ b/examples/README.md @@ -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 diff --git a/examples/bug-repro/01_texture_atomic_bug/Cargo.toml b/examples/bug-repro/01_texture_atomic_bug/Cargo.toml index 7f3f57e91..d06c80a58 100644 --- a/examples/bug-repro/01_texture_atomic_bug/Cargo.toml +++ b/examples/bug-repro/01_texture_atomic_bug/Cargo.toml @@ -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" diff --git a/examples/standalone/01_hello_compute/Cargo.toml b/examples/standalone/01_hello_compute/Cargo.toml index 531cdee08..53e20aa2d 100644 --- a/examples/standalone/01_hello_compute/Cargo.toml +++ b/examples/standalone/01_hello_compute/Cargo.toml @@ -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" diff --git a/examples/standalone/02_hello_window/Cargo.toml b/examples/standalone/02_hello_window/Cargo.toml index bcf0c67dd..d387c0714 100644 --- a/examples/standalone/02_hello_window/Cargo.toml +++ b/examples/standalone/02_hello_window/Cargo.toml @@ -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"] } diff --git a/examples/standalone/custom_backend/Cargo.toml b/examples/standalone/custom_backend/Cargo.toml index b7354dd63..03b1b33ae 100644 --- a/examples/standalone/custom_backend/Cargo.toml +++ b/examples/standalone/custom_backend/Cargo.toml @@ -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 } diff --git a/wgpu/src/lib.rs b/wgpu/src/lib.rs index 5279e884e..313091f58 100644 --- a/wgpu/src/lib.rs +++ b/wgpu/src/lib.rs @@ -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 //!