SakulFlee/Orbital
1
0
Fork 0
Code Issues 38 Pull requests 11 Projects Releases 1 Packages Wiki Activity Actions 1

fix(deps): update rust crate wgpu to v29 #635

Open
Renovate wants to merge 1 commit from renovate/wgpu-29.x into main
pull from: renovate/wgpu-29.x
merge into: SakulFlee:main
Conversation 1 Commits 1 Files changed 1 +1 -1
Renovate commented 2026-03-19 14:36:43 +01:00
Collaborator
Copy link

This PR contains the following updates:

Package Type Update Change
wgpu (source) dependencies major 26.0.1 → 29.0.0

⚠️ Warning

Some dependencies could not be looked up. Check the Dependency Dashboard for more information.

Release Notes

gfx-rs/wgpu (wgpu)

v29.0.1

Compare Source

This release includes wgpu-core, wgpu-hal and wgpu-types version 29.0.1. All other crates remain at their previous versions.

Bug Fixes
General
Metal
  • Added guards to avoid calling some feature detection methods that are not implemented on CaptureMTLDevice. By @​andyleiserson in #​9284.
  • Fix a regression where buffer limits were too conservative. This comes at the cost of non-compliant WebGPU limit validation. A future major release will keep the relaxed buffer limits on native while allowing WebGPU-mandated validation to be opted in. See #​9287.
GLES / OpenGL
  • Fix texture height initialized incorrectly in create_texture. By @​umajho in #​9302.
Validation
  • Don't crash in the Display implementation of CreateTextureViewError::TooMany{MipLevels,ArrayLayers} when their base and offset overflow. By @​ErichDonGubler in #​8808.

v29.0.0

Compare Source

Major Changes
Surface::get_current_texture now returns CurrentSurfaceTexture enum

Surface::get_current_texture no longer returns Result<SurfaceTexture, SurfaceError>.
Instead, it returns a single CurrentSurfaceTexture enum that represents all possible outcomes as variants.
SurfaceError has been removed, and the suboptimal field on SurfaceTexture has been replaced by a dedicated Suboptimal variant.

match surface.get_current_texture() {
    wgpu::CurrentSurfaceTexture::Success(frame) => { /* render */ }
    wgpu::CurrentSurfaceTexture::Timeout
      | wgpu::CurrentSurfaceTexture::Occluded => { /* skip frame */ }
    wgpu::CurrentSurfaceTexture::Outdated
      | wgpu::CurrentSurfaceTexture::Suboptimal(frame) => { /* reconfigure surface */ }
    wgpu::CurrentSurfaceTexture::Lost => { /* reconfigure surface, or recreate device if device lost */ }
    wgpu::CurrentSurfaceTexture::Validation => {
        /* Only happens if there is a validation error and you
           have registered a error scope or uncaptured error handler. */
    }
}

By @​cwfitzgerald, @​Wumpf, and @​emilk in #​9141 and #​9257.

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:

  • new_with_display_handle
  • new_with_display_handle_from_env
  • new_without_display_handle
  • new_without_display_handle_from_env

If you are using winit, this can be populated using EventLoop::owned_display_handle.

- 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

Bind group layouts now optional in PipelineLayoutDescriptor

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:

  let pl_desc = wgpu::PipelineLayoutDescriptor {
      label: None,
      bind_group_layouts: &[
-         &bind_group_layout
+         Some(&bind_group_layout)
      ],
      immediate_size: 0,
  });

By @​teoxoy in #​9034.

MSRV update

wgpu now has a new MSRV policy. This release has an MSRV of 1.87. This is lower than v27's 1.88 and v28's 1.92. Going forward, we will only bump wgpu's MSRV if it has tangible benefits for the code, and we will never bump to an MSRV higher than stable - 3. So if stable is at 1.97 and 1.94 brought benefit to our code, we could bump it no higher than 1.94. As before, MSRV bumps will always be breaking changes.

By @​cwfitzgerald in #​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.

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.

depth_write_enabled is applicable, and must be Some, if format has a depth aspect, i.e., is a depth or depth/stencil format. Otherwise, a value of None best reflects that it does not apply, although Some(false) is also accepted.

depth_compare is applicable, and must be Some, if depth_write_enabled is Some(true), or if depth_fail_op for either stencil face is not Keep. Otherwise, a value of None best reflects that it does not apply, although Some(CompareFunction::Always) is also accepted.

There is also a new constructor DepthStencilState::stencil which may be used instead of a struct literal for stencil operations.

Example 1: A configuration that does a depth test and writes updated values:

 depth_stencil: Some(wgpu::DepthStencilState {
     format: wgpu::TextureFormat::Depth32Float,
-    depth_write_enabled: true,
-    depth_compare: wgpu::CompareFunction::Less,
+    depth_write_enabled: Some(true),
+    depth_compare: Some(wgpu::CompareFunction::Less),
     stencil: wgpu::StencilState::default(),
     bias: wgpu::DepthBiasState::default(),
 }),

Example 2: A configuration with only stencil:

 depth_stencil: Some(wgpu::DepthStencilState {
     format: wgpu::TextureFormat::Stencil8,
-    depth_write_enabled: false,
-    depth_compare: wgpu::CompareFunction::Always,
+    depth_write_enabled: None,
+    depth_compare: None,
     stencil: wgpu::StencilState::default(),
     bias: wgpu::DepthBiasState::default(),
 }),

Example 3: The previous example written using the new stencil() constructor:

depth_stencil: Some(wgpu::DepthStencilState::stencil(
    wgpu::TextureFormat::Stencil8,
    wgpu::StencilState::default(),
)),
D3D12 Agility SDK support

Added support for loading a specific DirectX 12 Agility SDK runtime via the Independent Devices API. The Agility SDK lets applications ship a newer D3D12 runtime alongside their binary, unlocking the latest D3D12 features without waiting for an OS update.

Configure it programmatically:

let options = wgpu::Dx12BackendOptions {
    agility_sdk: Some(wgpu::Dx12AgilitySDK {
        sdk_version: 619,
        sdk_path: "path/to/sdk/bin/x64".into(),
    }),
    ..Default::default()
};

Or via environment variables:

WGPU_DX12_AGILITY_SDK_PATH=path/to/sdk/bin/x64
WGPU_DX12_AGILITY_SDK_VERSION=619

The sdk_version must match the version of the D3D12Core.dll in the provided path exactly, or loading will fail.

If the Agility SDK fails to load (e.g. version mismatch, missing DLL, or unsupported OS), wgpu logs a warning and falls back to the system D3D12 runtime.

By @​cwfitzgerald in #​9130.

primitive_index is now a WGSL enable extension

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.

- device.features().contains(wgpu::FeaturesWGPU::SHADER_PRIMITIVE_INDEX)
+ device.features().contains(wgpu::FeaturesWebGPU::PRIMITIVE_INDEX)

// 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, #​8792.

- limits.max_inter_stage_shader_components
+ limits.max_inter_stage_shader_variables
Other Breaking Changes
New Features
General
  • Added TLAS binding array support via ACCELERATION_STRUCTURE_BINDING_ARRAY. By @​kvark in #​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.
  • 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.
  • 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.
  • Added support for no-perspective barycentric coordinates. By @​atlv24 in #​8852.
  • Added support for obtaining AdapterInfo from Device. By @​sagudev in #​8807.
  • Added Limits::or_worse_values_from. By @​atlv24 in #​8870.
  • Added Features::FLOAT32_BLENDABLE on Vulkan and Metal. By @​timokoesters in #​8963 and @​andyleiserson in #​9032.
  • Added Dx12BackendOptions::force_shader_model to allow using advanced features in passthrough shaders without bundling DXC. By @​inner-daemons in #​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.
  • Added support for insert_debug_marker, push_debug_group and pop_debug_group on WebGPU. By @​evilpie in #​9017.
  • Added support for @builtin(draw_index) to the vulkan backend. By @​inner-daemons in #​8883.
  • Added TextureFormat::channels method to get some information about which color channels are covered by the texture format. By @​TornaxO7 in #​9167
  • BREAKING: Add V6_8 variant to DxcShaderModel and naga::back::hlsl::ShaderModel. By @​inner-daemons in #​8882 and @​ErichDonGubler in #​9083.
  • BREAKING: Add V6_9 variant to DxcShaderModel and naga::back::hlsl::ShaderModel. By @​ErichDonGubler in #​9083.
naga
  • Initial wgsl-in ray tracing pipelines. By @​Vecvec in #​8570.
  • wgsl-out ray tracing pipelines. By @​Vecvec in #​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.
  • Made the following available in const contexts; by @​ErichDonGubler in #​8943:
    • naga
      • Arena::len
      • Arena::is_empty
      • Range::first_and_last
      • front::wgsl::Frontend::set_options
      • ir::Block::is_empty
      • ir::Block::len
GLES
  • Added GlDebugFns option in GlBackendOptions to control OpenGL debug functions (glPushDebugGroup, glPopDebugGroup, glObjectLabel, etc.). Automatically disables them on Mali GPUs to work around a driver crash. By @​Xavientois in #​8931.
WebGPU
  • Added support for insert_debug_marker, push_debug_group and pop_debug_group. By @​evilpie in #​9017.
  • Added support for begin_occlusion_query and end_occlusion_query. By @​evilpie in #​9039.
Changes
General
  • Tracing now uses the .metal extension for metal source files, instead of .msl. By @​inner-daemons in #​8880.
  • BREAKING: Several error APIs were changed by @​ErichDonGubler in #​9073 and #​9205:
    • BufferAccessError:
      • Split the OutOfBoundsOverrun variant into new OutOfBoundsStartOffsetOverrun and OutOfBoundsEndOffsetOverrun variants.
      • Removed the NegativeRange variant in favor of new MapStartOffsetUnderrun and MapStartOffsetOverrun variants.
    • Split the TransferError::BufferOverrun variant into new BufferStartOffsetOverrun and BufferEndOffsetOverrun variants.
    • ImmediateUploadError:
      • Removed the TooLarge variant in favor of new StartOffsetOverrun and EndOffsetOverrun variants.
      • Removed the Unaligned variant in favor of new StartOffsetUnaligned and SizeUnaligned variants.
      • Added the ValueStartIndexOverrun and ValueEndIndexOverrun invariants
  • The various "max resources per stage" limits are now capped at 100, so that their total remains below max_bindings_per_bind_group, as required by WebGPU. By @​andyleiserson in #​9118.
  • The max_uniform_buffer_binding_size and max_storage_buffer_binding_size limits are now u64 instead of u32, to match WebGPU. By @​wingertge in #​9146.
  • The main 3 native backends now report their limits properly. By @​teoxoy in #​9196.
naga
Metal
  • Use autogenerated objc2 bindings internally, which should resolve a lot of leaks and unsoundness. By @​madsmtm in #​5641.
  • Implements ray-tracing acceleration structures for metal backend. By @​lichtso in #​8071.
  • Remove mutex for MTLCommandQueue because the Metal object is thread-safe. By @​andyleiserson in #​9217.
deno_webgpu
  • Expose the GPU.wgslLanguageFeatures property. By @​andyleiserson in #​8884.
  • GPUFeatureName now includes all wgpu extensions. Feature names for extensions should be written with a wgpu- prefix, although unprefixed names that were accepted previously are still accepted. By @​andyleiserson in #​9163.
Hal
Bug Fixes
General
  • Tracing support has been restored. By @​andyleiserson in #​8429.
  • Pipelines using passthrough shaders now correctly require explicit pipeline layout. By @​inner-daemons in #​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.
  • Improve validation of dual-source blending, by @​andyleiserson in #​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.
  • BREAKING: Renamed EXPERIMENTAL_PASSTHROUGH_SHADERS to PASSTHROUGH_SHADERS and made this no longer an experimental feature. By @​inner-daemons in #​9054.
  • BREAKING: End offsets in trace and player commands are now represented using offset + size instead. By @​ErichDonGubler in #​9073.
  • Validate some uncaught cases where buffer transfer operations could overflow when computing an end offset. By @​ErichDonGubler in #​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.
  • Added internal labels to validation GPU objects and timestamp normalization code to improve clarity in graphics debuggers. By @​szostid in #​9094
  • Fix multi-planar texture copying. By @​noituri in #​9069
naga
  • The validator checks that override-sized arrays have a positive size, if overrides have been resolved. By @​andyleiserson in #​8822.
  • Fix some cases where f16 constants were not working. By @​andyleiserson in #​8816.
  • Use wrapping arithmetic when evaluating constant expressions involving u32. By @​andyleiserson in #​8912.
  • Fix missing side effects from sequence expressions in GLSL. By @​Vipitis in #​8787.
  • Naga now enforces the @must_use attribute on WGSL built-in functions, when applicable. You can waive the error with a phony assignment, e.g., _ = subgroupElect(). By @​andyleiserson in #​8713.
  • Reject zero-value construction of a runtime-sized array with a validation error. Previously it would crash in the HLSL backend. By @​mooori in #​8741.
  • Reject splat vector construction if the argument type does not match the type of the vector's scalar. Previously it would succeed. By @​mooori in #​8829.
  • Fixed workgroupUniformLoad incorrectly returning an atomic when called on an atomic, it now returns the inner T as per the spec. By @​cryvosh in #​8791.
  • Fixed constant evaluation for sign() builtin to return zero when the argument is zero. By @​mandryskowski in #​8942.
  • Allow array generation to compile with the macOS 10.12 Metal compiler. By @​madsmtm in #​8953
  • Naga now detects bitwise shifts by a constant exceeding the operand bit width at compile time, and disallows scalar-by-vector and vector-by-scalar shifts in constant evaluation. By @​andyleiserson in #​8907.
  • Naga uses wrapping arithmetic when evaluating dot products on concrete integer types (u32 and i32). By @​BKDaugherty in #​9142.
  • Disallow negation of a matrix in WGSL. By @​andyleiserson in #​9157.
  • Fix evaluation order of compound assignment (e.g. +=) LHS and RHS. By @​andyleiserson in #​9181.
  • Fixed invalid MSL when float16-format vertex input data was accessed via an f16-type variable in a vertex shader. By @​andyleiserson in #​9166.
Validation
  • Fixed validation of the texture format in GPUDepthStencilState when neither depth nor stencil is actually enabled. By @​andyleiserson in #​8766.
  • Check that depth bias is not used with non-triangle topologies. By @​andyleiserson in #​8856.
  • Check that if the shader outputs frag_depth, then the pipeline must have a depth attachment. By @​andyleiserson in #​8856.
  • Fix incorrect acceptance of some swizzle selectors that are not valid for their operand, e.g. const v = vec2<i32>(); let r = v.xyz. By @​andyleiserson in #​8949.
  • Fixed calculation of the total number of bindings in a pipeline layout when validating against device limits. By @​andyleiserson in #​8997.
  • Reject non-constructible types (runtime- and override-sized arrays, and structs containing non-constructible types) in more places where they should not be allowed. By @​andyleiserson in #​8873.
  • The query set type for an occlusion query is now validated when opening the render pass, in addition to within the call to beginOcclusionQuery. By @​andyleiserson in #​9086.
  • Require that the blend factor is One when the blend operation is Min or Max. The BlendFactorOnUnsupportedTarget error is now reported within ColorStateError rather than directly in CreateRenderPipelineError. By @​andyleiserson in #​9110.
Vulkan
  • Fixed a variety of mesh shader SPIR-V writer issues from the original implementation. By @​inner-daemons in #​8756
  • Offset the vertex buffer device address when building a BLAS instead of using the first_vertex field. By @​Vecvec in #​9220
  • Remove incorrect ordered texture uses. By @​NiklasEi in #​8924.
Metal / macOS
GLES
  • DisplayHandle should now be passed to InstanceDescriptor for correct EGL initialization on Wayland. By @​MarijnS95 in #​8012
    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.
Performance
GLES
  • The GL backend would now try to take advantage of GL_EXT_multisampled_render_to_texture extension when applicable to skip the multi-sample resolve operation. By @​opstic in #​8536.
Documentation
General
  • Expanded documentation of QuerySet, QueryType, and resolve_query_set() describing how to use queries. By @​kpreid in #​8776.

v28.0.0

Compare Source

Major Changes
Mesh Shaders

This has been a long time coming. See the tracking issue for more information.
They are now fully supported on Vulkan, and supported on Metal and DX12 with passthrough shaders. WGSL parsing and rewriting
is supported, meaning they can be used through WESL or naga_oil.

Mesh shader pipelines replace the standard vertex shader pipelines and allow new ways to render meshes.
They are ideal for meshlet rendering, a form of rendering where small groups of triangles are handled together,
for both culling and rendering.

They are compute-like shaders, and generate primitives which are passed directly to the rasterizer, rather
than having a list of vertices generated individually and then using a static index buffer. This means that certain computations
on nearby groups of triangles can be done together, the relationship between vertices and primitives is more programmable, and
you can even pass non-interpolated per-primitive data to the fragment shader, independent of vertices.

Mesh shaders are very versatile, and are powerful enough to replace vertex shaders, tesselation shaders, and geometry shaders
on their own or with task shaders.

A full example of mesh shaders in use can be seen in the mesh_shader example. For the full specification of mesh shaders in wgpu, go to docs/api-specs/mesh_shading.md. Below is a small snippet of shader code demonstrating their usage:

@&#8203;task
@&#8203;payload(taskPayload)
@&#8203;workgroup_size(1)
fn ts_main() -> @&#8203;builtin(mesh_task_size) vec3<u32> {
    // Task shaders can use workgroup variables like compute shaders
    workgroupData = 1.0;
    // Pass some data to all mesh shaders dispatched by this workgroup
    taskPayload.colorMask = vec4(1.0, 1.0, 0.0, 1.0);
    taskPayload.visible = 1;
    // Dispatch a mesh shader grid with one workgroup
    return vec3(1, 1, 1);
}

@&#8203;mesh(mesh_output)
@&#8203;payload(taskPayload)
@&#8203;workgroup_size(1)
fn ms_main(@&#8203;builtin(local_invocation_index) index: u32, @&#8203;builtin(global_invocation_id) id: vec3<u32>) {
    // Set how many outputs this workgroup will generate
    mesh_output.vertex_count = 3;
    mesh_output.primitive_count = 1;
    // Can also use workgroup variables
    workgroupData = 2.0;

    // Set vertex outputs
    mesh_output.vertices[0].position = positions[0];
    mesh_output.vertices[0].color = colors[0] * taskPayload.colorMask;

    mesh_output.vertices[1].position = positions[1];
    mesh_output.vertices[1].color = colors[1] * taskPayload.colorMask;

    mesh_output.vertices[2].position = positions[2];
    mesh_output.vertices[2].color = colors[2] * taskPayload.colorMask;

    // Set the vertex indices for the only primitive
    mesh_output.primitives[0].indices = vec3<u32>(0, 1, 2);
    // Cull it if the data passed by the task shader says to
    mesh_output.primitives[0].cull = taskPayload.visible == 1;
    // Give a noninterpolated per-primitive vec4 to the fragment shader
    mesh_output.primitives[0].colorMask = vec4<f32>(1.0, 0.0, 1.0, 1.0);
}
Thanks

This was a monumental effort from many different people, but it was championed by @​inner-daemons, without whom it would not have happened.
Thank you @​cwfitzgerald for doing the bulk of the code review. Finally thank you @​ColinTimBarndt for coordinating the testing effort.

Reviewers:

wgpu Contributions:

naga Contributions:

Testing Assistance:

Thank you to everyone to made this happen!

Switch from gpu-alloc to gpu-allocator in the vulkan backend

gpu-allocator is the allocator used in the dx12 backend, allowing to configure
the allocator the same way in those two backends converging their behavior.

This also brings the Device::generate_allocator_report feature to
the vulkan backend.

By @​DeltaEvo in #​8158.

wgpu::Instance::enumerate_adapters is now async & available on WebGPU

BREAKING CHANGE: enumerate_adapters is now async:

- pub fn enumerate_adapters(&self, backends: Backends) -> Vec<Adapter> {
+ pub fn enumerate_adapters(&self, backends: Backends) -> impl Future<Output = Vec<Adapter>> {

This yields two benefits:

  • This method is now implemented on non-native using the standard Adapter::request_adapter(…), making enumerate_adapters a portable surface. This was previously a nontrivial pain point when an application wanted to do some of its own filtering of adapters.
  • This method can now be implemented in custom backends.

By @​R-Cramer4 in #​8230

New LoadOp::DontCare

In the case where a renderpass unconditionally writes to all pixels in the rendertarget,
Load can cause unnecessary memory traffic, and Clear can spend time unnecessarily
clearing the rendertargets. DontCare is a new LoadOp which will leave the contents
of the rendertarget undefined. Because this could lead to undefined behavior, this API
requires that the user gives an unsafe token to use the api.

While you can use this unconditionally, on platforms where DontCare is not available,
it will internally use a different load op.

load: LoadOp::DontCare(unsafe { wgpu::LoadOpDontCare::enabled() })

By @​cwfitzgerald in #​8549

MipmapFilterMode is split from FilterMode

This is a breaking change that aligns wgpu with spec.

SamplerDescriptor {
...
-     mipmap_filter: FilterMode::Nearest
+     mipmap_filter: MipmapFilterMode::Nearest
...
}

By @​sagudev in #​8314.

Multiview on all major platforms and support for multiview bitmasks

Multiview is a feature that allows rendering the same content to multiple layers of a texture.
This is useful primarily in VR where you wish to display almost identical content to 2 views,
just with a different perspective. Instead of using 2 draw calls or 2 instances for each object, you
can use this feature.

Multiview is also called view instancing in DX12 or vertex amplification in Metal.

Multiview has been reworked, adding support for Metal and DX12, and adding testing and validation to wgpu itself.
This change also introduces a view bitmask, a new field in RenderPassDescriptor that allows a render pass to render
to multiple non-adjacent layers when using the SELECTIVE_MULTIVIEW feature. If you don't use multi-view,
you can set this field to none.

- wgpu::RenderPassDescriptor {
-     label: None,
-     color_attachments: &color_attachments,
-     depth_stencil_attachment: None,
-     timestamp_writes: None,
-     occlusion_query_set: None,
- }
+ wgpu::RenderPassDescriptor {
+     label: None,
+     color_attachments: &color_attachments,
+     depth_stencil_attachment: None,
+     timestamp_writes: None,
+     occlusion_query_set: None,
+     multiview_mask: NonZero::new(3),
+ }

One other breaking change worth noting is that in WGSL @builtin(view_index) now requires a type of u32, where previously it required i32.

By @​inner-daemons in #​8206.

Error scopes now use guards and are thread-local.
- device.push_error_scope(wgpu::ErrorFilter::Validation);
+ let scope = device.push_error_scope(wgpu::ErrorFilter::Validation);
  // ... perform operations on the device ...
- let error: Option<Error> = device.pop_error_scope().await;
+ let error: Option<Error> = scope.pop().await;

Device error scopes now operate on a per-thread basis. This allows them to be used easily within multithreaded contexts,
without having the error scope capture errors from other threads.

When the std feature is not enabled, we have no way to differentiate between threads, so error scopes return to be
global operations.

By @​cwfitzgerald in #​8685

Log Levels

We have received complaints about wgpu being way too log spammy at log levels info/warn/error. We have
adjusted our log policy and changed logging such that info and above should be silent unless some exceptional
event happens. Our new log policy is as follows:

  • Error: if we can’t (for some reason, usually a bug) communicate an error any other way.
  • Warning: similar, but there may be one-shot warnings about almost certainly sub-optimal.
  • Info: do not use
  • Debug: Used for interesting events happening inside wgpu.
  • Trace: Used for all events that might be useful to either wgpu or application developers.

By @​cwfitzgerald in #​8579.

Push constants renamed immediates, API brought in line with spec.

As the "immediate data" api is getting close to stabilization in the WebGPU specification,
we're bringing our implementation in line with what the spec dictates.

First, in the PipelineLayoutDescriptor, you now pass a unified size for all stages:

- push_constant_ranges: &[wgpu::PushConstantRange {
-     stages: wgpu::ShaderStages::VERTEX_FRAGMENT,
-     range: 0..12,
- }]
+ immediate_size: 12,

Second, on the command encoder you no longer specify a shader stage, uploads apply
to all shader stages that use immediate data.

- rpass.set_push_constants(wgpu::ShaderStages::FRAGMENT, 0, bytes);
+ rpass.set_immediates(0, bytes);

Third, immediates are now declared with the immediate address space instead of
the push_constant address space. Due to a known issue on DX12
it is advised to always use a structure for your immediates until that issue
is fixed.

- var<push_constant> my_pc: MyPushConstant;
+ var<immediate> my_imm: MyImmediate;

Finally, our implementation currently still zero-initializes the immediate data
range you declared in the pipeline layout. This is not spec compliant and failing
to populate immediate "slots" that are used in the shader will be a validation error
in a future version. See the proposal for details for determining
which slots are populated in a given shader.

By @​cwfitzgerald in #​8724.

subgroup_{min,max}_size renamed and moved from Limits -> AdapterInfo

To bring our code in line with the WebGPU spec, we have moved information about subgroup size
from limits to adapter info. Limits was not the correct place for this anyway, and we had some
code special casing those limits.

Additionally we have renamed the fields to match the spec.

- let min = limits.min_subgroup_size;
+ let min = info.subgroup_min_size;
- let max = limits.max_subgroup_size;
+ let max = info.subgroup_max_size;

By @​cwfitzgerald in #​8609.

New Features
  • Added support for transient textures on Vulkan and Metal. By @​opstic in #​8247
  • Implement shader triangle barycentric coordinate builtins. By @​atlv24 in #​8320.
  • Added support for binding arrays of storage textures on Metal. By @​msvbg in #​8464
  • Added support for multisampled texture arrays on Vulkan through adapter feature MULTISAMPLE_ARRAY. By @​LaylBongers in #​8571.
  • Added get_configuration to wgpu::Surface, that returns the current configuration of wgpu::Surface. By @​sagudev in #​8664.
  • Add wgpu_core::Global::create_bind_group_layout_error. By @​ErichDonGubler in #​8650.
Changes
General
  • Require new enable extensions when using ray queries and position fetch (wgpu_ray_query, wgpu_ray_query_vertex_return). By @​Vecvec in #​8545.
  • Texture now has from_custom. By @​R-Cramer4 in #​8315.
  • Using both the wgpu command encoding APIs and CommandEncoder::as_hal_mut on the same encoder will now result in a panic.
  • Allow include_spirv! and include_spirv_raw! macros to be used in constants and statics. By @​clarfonthey in #​8250.
  • Added support for rendering onto multi-planar textures. By @​noituri in #​8307.
  • Validation errors from CommandEncoder::finish() will report the label of the invalid encoder. By @​kpreid in #​8449.
  • Corrected documentation of the minimum alignment of the end of a mapped range of a buffer (it is 4, not 8). By @​kpreid in #​8450.
  • util::StagingBelt now takes a Device when it is created instead of when it is used. By @​kpreid in #​8462.
  • wgpu_hal::vulkan::Texture API changes to handle externally-created textures and memory more flexibly. By @​s-ol in #​8512, #​8521.
  • Render passes are now validated against the maxColorAttachmentBytesPerSample limit. By @​andyleiserson in #​8697.
Metal
naga
  • Prevent UB with invalid ray query calls on spirv. By @​Vecvec in #​8390.
  • Update the set of binding_array capabilities. In most cases, they are set automatically from wgpu features, and this change should not be user-visible. By @​andyleiserson in #​8671.
  • Naga now accepts the var<function> syntax for declaring local variables. By @​andyleiserson in #​8710.
Bug Fixes
General
  • Fixed a bug where mapping sub-ranges of a buffer on web would fail with OperationError: GPUBuffer.getMappedRange: GetMappedRange range extends beyond buffer's mapped range. By @​ryankaplan in #​8349
  • Reject fragment shader output locations > max_color_attachments limit. By @​ErichDonGubler in #​8316.
  • WebGPU device requests now support the required limits maxColorAttachments and maxColorAttachmentBytesPerSample. By @​evilpie in #​8328
  • Reject binding indices that exceed wgpu_types::Limits::max_bindings_per_bind_group when deriving a bind group layout for a pipeline. By @​jimblandy in #​8325.
  • Removed three features from wgpu-hal which did nothing useful: "cargo-clippy", "gpu-allocator", and "rustc-hash". By @​kpreid in #​8357.
  • wgpu_types::PollError now always implements the Error trait. By @​kpreid in #​8384.
  • The texture subresources used by the color attachments of a render pass are no longer allowed to overlap when accessed via different texture views. By @​andyleiserson in #​8402.
  • The STORAGE_READ_ONLY texture usage is now permitted to coexist with other read-only usages. By @​andyleiserson in #​8490.
  • Validate that buffers are unmapped in write_buffer calls. By @​ErichDonGubler in #​8454.
  • Shorten critical section inside present such that the snatch write lock is no longer held during present, preventing other work happening on other threads. By @​cwfitzgerald in #​8608.
naga
  • The || and && operators now "short circuit", i.e., do not evaluate the RHS if the result can be determined from just the LHS. By @​andyleiserson in #​7339.
  • Fix a bug that resulted in the Metal error program scope variable must reside in constant address space in some cases. By @​teoxoy in #​8311.
  • Handle rayQueryTerminate in spv-out instead of ignoring it. By @​Vecvec in #​8581.
DX12
  • Align copies b/w textures and buffers via a single intermediate buffer per copy when D3D12_FEATURE_DATA_D3D12_OPTIONS13.UnrestrictedBufferTextureCopyPitchSupported is false. By @​ErichDonGubler in #​7721.
  • Fix detection of Int64 Buffer/Texture atomic features. By @​cwfitzgerald in #​8667.
Vulkan
Metal
WebGPU
  • Fixed a bug where the texture aspect was not passed through when calling copy_texture_to_buffer in WebGPU, causing the copy to fail for depth/stencil textures. By @​Tim-Evans-Seequent in #​8445.
GLES
hal

v27.0.1

Compare Source

Bug Fixes

v27.0.0

Compare Source

Major Changes
Deferred command buffer actions: map_buffer_on_submit and on_submitted_work_done

You may schedule buffer mapping and a submission-complete callback to run automatically after you submit, directly from encoders, command buffers, and passes.

// Record some GPU work so the submission isn't empty and touches `buffer`.
encoder.clear_buffer(&buffer, 0, None);

// Defer mapping until this encoder is submitted.
encoder.map_buffer_on_submit(&buffer, wgpu::MapMode::Read, 0..size, |result| { .. });

// Fires after the command buffer's work is finished.
encoder.on_submitted_work_done(|| { .. });

// Automatically calls `map_async` and `on_submitted_work_done` after this submission finishes.
queue.submit([encoder.finish()]);

Available on CommandEncoder, CommandBuffer, RenderPass, and ComputePass.

By @​cwfitzgerald in #​8125.

Builtin Support for DXGI swapchains on top of of DirectComposition Visuals in DX12

By enabling DirectComposition support, the dx12 backend can now support transparent windows.

This creates a single IDCompositionVisual over the entire window that is used by the mfSurface. If a user wants to manage the composition tree themselves, they should create their own device and composition, and pass the relevant visual down into wgpu via SurfaceTargetUnsafe::CompositionVisual.

let instance = wgpu::Instance::new(&wgpu::InstanceDescriptor {
    backend_options: wgpu::BackendOptions {
        dx12: wgpu::Dx12BackendOptions {
            presentation_system: wgpu::Dx12SwapchainKind::DxgiFromVisual,
            ..
        },
        ..
    },
    ..
});

By @​n1ght-hunter in #​7550.

EXPERIMENTAL_RAY_TRACING_ACCELERATION_STRUCTURE has been merged into EXPERIMENTAL_RAY_QUERY

We have merged the acceleration structure feature into the RayQuery feature. This is to help work around an AMD driver bug and reduce the feature complexity of ray tracing. In the future when ray tracing pipelines are implemented, if either feature is enabled, acceleration structures will be available.

- Features::EXPERIMENTAL_RAY_TRACING_ACCELERATION_STRUCTURE
+ Features::EXPERIMENTAL_RAY_QUERY

By @​Vecvec in #​7913.

New EXPERIMENTAL_PRECOMPILED_SHADERS API

We have added Features::EXPERIMENTAL_PRECOMPILED_SHADERS, replacing existing passthrough types with a unified CreateShaderModuleDescriptorPassthrough which allows passing multiple shader codes for different backends. By @​SupaMaggie70Incorporated in #​7834

Difference for SPIR-V passthrough:

- device.create_shader_module_passthrough(wgpu::ShaderModuleDescriptorPassthrough::SpirV(
-     wgpu::ShaderModuleDescriptorSpirV {
-         label: None,
-         source: spirv_code,
-     },
- ))
+ device.create_shader_module_passthrough(wgpu::ShaderModuleDescriptorPassthrough {
+     entry_point: "main".into(),
+     label: None,
+     spirv: Some(spirv_code),
+     ..Default::default()
})

This allows using precompiled shaders without manually checking which backend's code to pass, for example if you have shaders precompiled for both DXIL and SPIR-V.

Buffer mapping apis no longer have lifetimes

Buffer::get_mapped_range(), Buffer::get_mapped_range_mut(), and Queue::write_buffer_with() now return guard objects without any lifetimes. This
makes it significantly easier to store these types in structs, which is useful for building utilities that build the contents of a buffer over time.

- let buffer_mapping_ref: wgpu::BufferView<'_>           = buffer.get_mapped_range(..);
- let buffer_mapping_mut: wgpu::BufferViewMut<'_>        = buffer.get_mapped_range_mut(..);
- let queue_write_with:   wgpu::QueueWriteBufferView<'_> = queue.write_buffer_with(..);
+ let buffer_mapping_ref: wgpu::BufferView               = buffer.get_mapped_range(..);
+ let buffer_mapping_mut: wgpu::BufferViewMut            = buffer.get_mapped_range_mut(..);
+ let queue_write_with:   wgpu::QueueWriteBufferView     = queue.write_buffer_with(..);

By @​sagudev in #​8046 and @​cwfitzgerald in #​8070.

EXPERIMENTAL_* features now require unsafe code to enable

We want to be able to expose potentially experimental features to our users before we have ensured that they are fully sound to use.
As such, we now require any feature that is prefixed with EXPERIMENTAL to have a special unsafe token enabled in the device descriptor
acknowledging that the features may still have bugs in them and to report any they find.

adapter.request_device(&wgpu::DeviceDescriptor {
    features: wgpu::Features::EXPERIMENTAL_MESH_SHADER,
    experimental_features: unsafe { wgpu::ExperimentalFeatures::enabled() }
    ..
})

By @​cwfitzgerald in #​8163.

Multi-draw indirect is now unconditionally supported when indirect draws are supported

We have removed Features::MULTI_DRAW_INDIRECT as it was unconditionally available on all platforms.
RenderPass::multi_draw_indirect is now available if the device supports downlevel flag DownlevelFlags::INDIRECT_EXECUTION.

If you are using spirv-passthrough with multi-draw indirect and gl_DrawID, you can know if MULTI_DRAW_INDIRECT is being emulated
by if the Feature::MULTI_DRAW_INDIRECT_COUNT feature is available on the device, this feature cannot be emulated efficicently.

By @​cwfitzgerald in #​8162.

wgpu::PollType::Wait has now an optional timeout

We removed wgpu::PollType::WaitForSubmissionIndex and added fields to wgpu::PollType::Wait in order to express timeouts.

Before/after for wgpu::PollType::Wait:

-device.poll(wgpu::PollType::Wait).unwrap();
-device.poll(wgpu::PollType::wait_indefinitely()).unwrap();
+device.poll(wgpu::PollType::Wait {
+      submission_index: None, // Wait for most recent submission
+      timeout: Some(std::time::Duration::from_secs(60)), // Previous behavior, but more likely you want `None` instead.
+  })
+  .unwrap();

Before/after for wgpu::PollType::WaitForSubmissionIndex:

-device.poll(wgpu::PollType::WaitForSubmissionIndex(index_to_wait_on))
+device.poll(wgpu::PollType::Wait {
+      submission_index: Some(index_to_wait_on),
+      timeout: Some(std::time::Duration::from_secs(60)), // Previous behavior, but more likely you want `None` instead.
+  })
+  .unwrap();

⚠️ Previously, both wgpu::PollType::WaitForSubmissionIndex and wgpu::PollType::Wait had a hard-coded timeout of 60 seconds.

To wait indefinitely on the latest submission, you can also use the wait_indefinitely convenience function:

device.poll(wgpu::PollType::wait_indefinitely());

By @​wumpf in #​8282, #​8285

New Features
General
  • Added mesh shader support to wgpu, with examples. Requires passthrough. By @​SupaMaggie70Incorporated in #​7345.
  • Added support for external textures based on WebGPU's GPUExternalTexture. These allow shaders to transparently operate on potentially multiplanar source texture data in either RGB or YCbCr formats via WGSL's texture_external type. This is gated behind the Features::EXTERNAL_TEXTURE feature, which is currently only supported on DX12. By @​jamienicol in #​4386.
  • wgpu::Device::poll can now specify a timeout via wgpu::PollType::Wait. By @​wumpf in #​8282 & #​8285
naga
Changes
General
  • Command encoding now happens when CommandEncoder::finish is called, not when the individual operations are requested. This does not affect the API, but may affect performance characteristics. By @​andyleiserson in #​8220.
  • Prevent resources for acceleration structures being created if acceleration structures are not enabled. By @​Vecvec in #​8036.
  • Validate that each push_debug_group pairs with exactly one pop_debug_group. By @​andyleiserson in #​8048.
  • set_viewport now requires that the supplied minimum depth value is less than the maximum depth value. By @​andyleiserson in #​8040.
  • Validation of copy_texture_to_buffer, copy_buffer_to_texture, and copy_texture_to_texture operations more closely follows the WebGPU specification. By @​andyleiserson in various PRs.
    • Copies within the same texture must not overlap.
    • Copies of multisampled or depth/stencil formats must span an entire subresource (layer).
    • Copies of depth/stencil formats must be 4B aligned.
    • For texture-buffer copies, bytes_per_row on the buffer side must be 256B-aligned, even if the transfer is a single row.
  • The offset for set_vertex_buffer and set_index_buffer must be 4B aligned. By @​andyleiserson in #​7929.
  • The offset and size of bindings are validated as fitting within the underlying buffer in more cases. By @​andyleiserson in #​7911.
  • The function you pass to Device::on_uncaptured_error() must now implement Sync in addition to Send, and be wrapped in Arc instead of Box.
    In exchange for this, it is no longer possible for calling wgpu functions while in that callback to cause a deadlock (not that we encourage you to actually do that).
    By @​kpreid in #​8011.
  • Make a compacted hal acceleration structure inherit a label from the base BLAS. By @​Vecvec in #​8103.
  • The limits requested for a device must now satisfy min_subgroup_size <= max_subgroup_size. By @​andyleiserson in #​8085.
  • Improve errors when buffer mapping is done incorrectly. Allow aliasing immutable [BufferViews]. By @​cwfitzgerald in #​8150.
  • Require new F16_IN_F32 downlevel flag for quantizeToF16, pack2x16float, and unpack2x16float in WGSL input. By @​aleiserson in #​8130.
  • The error message for non-copyable depth/stencil formats no longer mentions the aspect when it is not relevant. By @​reima in #​8156.
  • Track the initialization status of buffer memory correctly when copy_texture_to_buffer skips over padding space between rows or layers, or when the start/end of a texture-buffer transfer is not 4B aligned. By @​andyleiserson in #​8099.
naga
  • naga now requires that no type be larger than 1 GB. This limit may be lowered in the future; feedback on an appropriate value for the limit is welcome. By @​andyleiserson in #​7950.
  • If the shader source contains control characters, naga now replaces them with U+FFFD ("replacement character") in diagnostic output. By @​andyleiserson in #​8049.
  • Add f16 IO polyfill on Vulkan backend to enable SHADER_F16 use without requiring storageInputOutput16. By @​cryvosh in #​7884.
  • For custom Naga backend authors: naga::proc::Namer now accepts reserved keywords using two new dedicated types, proc::{KeywordSet, CaseInsensitiveKeywordSet}. By @​kpreid in #​8136.
  • BREAKING: Previously the WGSL storage-texture format rg11b10float was incorrectly accepted and generated by naga, but now only accepts the the correct name rg11b10ufloat instead. By @​ErikWDev in #​8219.
  • The source() method of ShaderError no longer reports the error as its own source. By @​andyleiserson in #​8258.
  • naga correctly ingests SPIR-V that use descriptor runtime indexing, which in turn is correctly converted into WGSLs binding array. By @​hasenbanck in 8256.
  • naga correctly ingests SPIR-V that loads from multi-sampled textures, which in turn is correctly converted into WGSLs texture_multisampled_2d and load operations. By @​hasenbanck in 8270.
  • naga implement OpImageGather and OpImageDrefGather operations when ingesting SPIR-V. By @​hasenbanck in 8280.
DX12
Bug Fixes
General
  • Validate that effective buffer binding size is aligned to 4 when creating bind groups with buffer entries.. By @​ErichDonGubler in 8041.
DX12
  • Create an event per wait to prevent 60 second hangs in certain multithreaded scenarios. By @​Vecvec in #​8273.
  • Fixed a bug where access to matrices with 2 rows would not work in some cases. By @​andyleiserson in #​7438.
EGL
  • Fixed unwrap failed in context creation for some Android devices. By @​uael in #​8024.
Vulkan
  • Fixed wrong color format+space being reported versus what is hardcoded in create_swapchain(). By @​MarijnS95 in #​8226.
naga
Documentation
General
  • Clarify that subgroup barriers require both the SUBGROUP and SUBGROUP_BARRIER features / capabilities. By @​andyleiserson in #​8203.

Configuration

📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).

🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.

♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 Ignore: Close this PR and you won't be reminded about this update again.

  • If you want to rebase/retry this PR, check this box

This PR has been generated by Renovate Bot.

This PR contains the following updates: | Package | Type | Update | Change | |---|---|---|---| | [wgpu](https://wgpu.rs/) ([source](https://github.com/gfx-rs/wgpu)) | dependencies | major | `26.0.1` → `29.0.0` | --- > ⚠️ **Warning** > > Some dependencies could not be looked up. Check the [Dependency Dashboard](issues/535) for more information. --- ### Release Notes <details> <summary>gfx-rs/wgpu (wgpu)</summary> ### [`v29.0.1`](https://github.com/gfx-rs/wgpu/blob/HEAD/CHANGELOG.md#v2901-2026-03-26) [Compare Source](https://github.com/gfx-rs/wgpu/compare/v29.0.0...wgpu-v29.0.1) This release includes `wgpu-core`, `wgpu-hal` and `wgpu-types` version `29.0.1`. All other crates remain at their previous versions. ##### Bug Fixes ##### General - Fix limit comparison logic for `max_inter_stage_shader_variables`. By [@&#8203;ErichDonGubler](https://github.com/ErichDonGubler) in [#&#8203;9264](https://github.com/gfx-rs/wgpu/pull/9264). ##### Metal - Added guards to avoid calling some feature detection methods that are not implemented on `CaptureMTLDevice`. By [@&#8203;andyleiserson](https://github.com/andyleiserson) in [#&#8203;9284](https://github.com/gfx-rs/wgpu/pull/9284). - Fix a regression where buffer limits were too conservative. This comes at the cost of non-compliant WebGPU limit validation. A future major release will keep the relaxed buffer limits on native while allowing WebGPU-mandated validation to be opted in. See [#&#8203;9287](https://github.com/gfx-rs/wgpu/issues/9287). ##### GLES / OpenGL - Fix texture height initialized incorrectly in `create_texture`. By [@&#8203;umajho](https://github.com/umajho) in [#&#8203;9302](https://github.com/gfx-rs/wgpu/pull/9302). ##### Validation - Don't crash in the `Display` implementation of `CreateTextureViewError::TooMany{MipLevels,ArrayLayers}` when their base and offset overflow. By [@&#8203;ErichDonGubler](https://github.com/ErichDonGubler) in [#&#8203;8808](https://github.com/gfx-rs/wgpu/pull/8808). ### [`v29.0.0`](https://github.com/gfx-rs/wgpu/blob/HEAD/CHANGELOG.md#v2900-2026-03-18) [Compare Source](https://github.com/gfx-rs/wgpu/compare/v28.0.0...v29.0.0) ##### Major Changes ##### `Surface::get_current_texture` now returns `CurrentSurfaceTexture` enum `Surface::get_current_texture` no longer returns `Result<SurfaceTexture, SurfaceError>`. Instead, it returns a single `CurrentSurfaceTexture` enum that represents all possible outcomes as variants. `SurfaceError` has been removed, and the `suboptimal` field on `SurfaceTexture` has been replaced by a dedicated `Suboptimal` variant. ```rust match surface.get_current_texture() { wgpu::CurrentSurfaceTexture::Success(frame) => { /* render */ } wgpu::CurrentSurfaceTexture::Timeout | wgpu::CurrentSurfaceTexture::Occluded => { /* skip frame */ } wgpu::CurrentSurfaceTexture::Outdated | wgpu::CurrentSurfaceTexture::Suboptimal(frame) => { /* reconfigure surface */ } wgpu::CurrentSurfaceTexture::Lost => { /* reconfigure surface, or recreate device if device lost */ } wgpu::CurrentSurfaceTexture::Validation => { /* Only happens if there is a validation error and you have registered a error scope or uncaptured error handler. */ } } ``` By [@&#8203;cwfitzgerald](https://github.com/cwfitzgerald), [@&#8203;Wumpf](https://github.com/Wumpf), and [@&#8203;emilk](https://github.com/emilk) in [#&#8203;9141](https://github.com/gfx-rs/wgpu/pull/9141) and [#&#8203;9257](https://github.com/gfx-rs/wgpu/pull/9257). ##### `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: - `new_with_display_handle` - `new_with_display_handle_from_env` - `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 [@&#8203;MarijnS95](https://github.com/MarijnS95) in [#&#8203;8782](https://github.com/gfx-rs/wgpu/pull/8782) ##### Bind group layouts now optional in `PipelineLayoutDescriptor` 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 { label: None, bind_group_layouts: &[ - &bind_group_layout + Some(&bind_group_layout) ], immediate_size: 0, }); ``` By [@&#8203;teoxoy](https://github.com/teoxoy) in [#&#8203;9034](https://github.com/gfx-rs/wgpu/pull/9034). ##### MSRV update `wgpu` now has a new MSRV policy. This release has an MSRV of **1.87**. This is lower than v27's 1.88 and v28's 1.92. Going forward, we will only bump wgpu's MSRV if it has tangible benefits for the code, and we will never bump to an MSRV higher than `stable - 3`. So if stable is at 1.97 and 1.94 brought benefit to our code, we could bump it no higher than 1.94. As before, MSRV bumps will always be breaking changes. By [@&#8203;cwfitzgerald](https://github.com/cwfitzgerald) in [#&#8203;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 [@&#8203;kpreid](https://github.com/kpreid) in [#&#8203;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. `depth_write_enabled` is applicable, and must be `Some`, if `format` has a depth aspect, i.e., is a depth or depth/stencil format. Otherwise, a value of `None` best reflects that it does not apply, although `Some(false)` is also accepted. `depth_compare` is applicable, and must be `Some`, if `depth_write_enabled` is `Some(true)`, or if `depth_fail_op` for either stencil face is not `Keep`. Otherwise, a value of `None` best reflects that it does not apply, although `Some(CompareFunction::Always)` is also accepted. There is also a new constructor `DepthStencilState::stencil` which may be used instead of a struct literal for stencil operations. Example 1: A configuration that does a depth test and writes updated values: ```diff depth_stencil: Some(wgpu::DepthStencilState { format: wgpu::TextureFormat::Depth32Float, - depth_write_enabled: true, - depth_compare: wgpu::CompareFunction::Less, + depth_write_enabled: Some(true), + depth_compare: Some(wgpu::CompareFunction::Less), stencil: wgpu::StencilState::default(), bias: wgpu::DepthBiasState::default(), }), ``` Example 2: A configuration with only stencil: ```diff depth_stencil: Some(wgpu::DepthStencilState { format: wgpu::TextureFormat::Stencil8, - depth_write_enabled: false, - depth_compare: wgpu::CompareFunction::Always, + depth_write_enabled: None, + depth_compare: None, stencil: wgpu::StencilState::default(), bias: wgpu::DepthBiasState::default(), }), ``` Example 3: The previous example written using the new `stencil()` constructor: ```rust depth_stencil: Some(wgpu::DepthStencilState::stencil( wgpu::TextureFormat::Stencil8, wgpu::StencilState::default(), )), ``` ##### D3D12 Agility SDK support Added support for loading a specific [DirectX 12 Agility SDK](https://devblogs.microsoft.com/directx/directx12agility/) runtime via the [Independent Devices API](https://devblogs.microsoft.com/directx/d3d12-independent-devices/). The Agility SDK lets applications ship a newer D3D12 runtime alongside their binary, unlocking the latest D3D12 features without waiting for an OS update. Configure it programmatically: ```rust let options = wgpu::Dx12BackendOptions { agility_sdk: Some(wgpu::Dx12AgilitySDK { sdk_version: 619, sdk_path: "path/to/sdk/bin/x64".into(), }), ..Default::default() }; ``` Or via environment variables: ``` WGPU_DX12_AGILITY_SDK_PATH=path/to/sdk/bin/x64 WGPU_DX12_AGILITY_SDK_VERSION=619 ``` The `sdk_version` must match the version of the `D3D12Core.dll` in the provided path exactly, or loading will fail. If the Agility SDK fails to load (e.g. version mismatch, missing DLL, or unsupported OS), wgpu logs a warning and falls back to the system D3D12 runtime. By [@&#8203;cwfitzgerald](https://github.com/cwfitzgerald) in [#&#8203;9130](https://github.com/gfx-rs/wgpu/pull/9130). ##### `primitive_index` is now a WGSL `enable` extension 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 [@&#8203;inner-daemons](https://github.com/inner-daemons) in [#&#8203;8879](https://github.com/gfx-rs/wgpu/pull/8879) and [@&#8203;andyleiserson](https://github.com/andyleiserson) in [#&#8203;9101](https://github.com/gfx-rs/wgpu/pull/9101). ```diff - device.features().contains(wgpu::FeaturesWGPU::SHADER_PRIMITIVE_INDEX) + device.features().contains(wgpu::FeaturesWebGPU::PRIMITIVE_INDEX) ``` ```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 [@&#8203;ErichDonGubler](https://github.com/ErichDonGubler) in [#&#8203;8652](https://github.com/gfx-rs/wgpu/pull/8652), [#&#8203;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 - Use clearer field names for `StageError::InvalidWorkgroupSize`. By [@&#8203;ErichDonGubler](https://github.com/ErichDonGubler) in [#&#8203;9192](https://github.com/gfx-rs/wgpu/pull/9192). ##### New Features ##### General - Added TLAS binding array support via `ACCELERATION_STRUCTURE_BINDING_ARRAY`. By [@&#8203;kvark](https://github.com/kvark) in [#&#8203;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 [@&#8203;atlv24](https://github.com/atlv24) in [#&#8203;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 [@&#8203;kvark](https://github.com/kvark) in [#&#8203;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 [@&#8203;atlv24](https://github.com/atlv24) in [#&#8203;8821](https://github.com/gfx-rs/wgpu/issues/8821). - Added support for no-perspective barycentric coordinates. By [@&#8203;atlv24](https://github.com/atlv24) in [#&#8203;8852](https://github.com/gfx-rs/wgpu/issues/8852). - Added support for obtaining `AdapterInfo` from `Device`. By [@&#8203;sagudev](https://github.com/sagudev) in [#&#8203;8807](https://github.com/gfx-rs/wgpu/pull/8807). - Added `Limits::or_worse_values_from`. By [@&#8203;atlv24](https://github.com/atlv24) in [#&#8203;8870](https://github.com/gfx-rs/wgpu/pull/8870). - Added `Features::FLOAT32_BLENDABLE` on Vulkan and Metal. By [@&#8203;timokoesters](https://github.com/timokoesters) in [#&#8203;8963](https://github.com/gfx-rs/wgpu/pull/8963) and [@&#8203;andyleiserson](https://github.com/andyleiserson) in [#&#8203;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 [@&#8203;inner-daemons](https://github.com/inner-daemons) in [#&#8203;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 [@&#8203;inner-daemons](https://github.com/inner-daemons) in [#&#8203;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 [@&#8203;inner-daemons](https://github.com/inner-daemons) in [#&#8203;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 [@&#8203;evilpie](https://github.com/evilpie) in [#&#8203;9017](https://github.com/gfx-rs/wgpu/pull/9017). - Added support for `@builtin(draw_index)` to the vulkan backend. By [@&#8203;inner-daemons](https://github.com/inner-daemons) in [#&#8203;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 [@&#8203;TornaxO7](https://github.com/TornaxO7) in [#&#8203;9167](https://github.com/gfx-rs/wgpu/pull/9167) - BREAKING: Add `V6_8` variant to `DxcShaderModel` and `naga::back::hlsl::ShaderModel`. By [@&#8203;inner-daemons](https://github.com/inner-daemons) in [#&#8203;8882](https://github.com/gfx-rs/wgpu/pull/8882) and [@&#8203;ErichDonGubler](https://github.com/ErichDonGubler) in [#&#8203;9083](https://github.com/gfx-rs/wgpu/pull/9083). - BREAKING: Add `V6_9` variant to `DxcShaderModel` and `naga::back::hlsl::ShaderModel`. By [@&#8203;ErichDonGubler](https://github.com/ErichDonGubler) in [#&#8203;9083](https://github.com/gfx-rs/wgpu/pull/9083). ##### naga - Initial wgsl-in ray tracing pipelines. By [@&#8203;Vecvec](https://github.com/Vecvec) in [#&#8203;8570](https://github.com/gfx-rs/wgpu/pull/8570). - wgsl-out ray tracing pipelines. By [@&#8203;Vecvec](https://github.com/Vecvec) in [#&#8203;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 [@&#8203;inner-daemons](https://github.com/inner-daemons) in [#&#8203;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 [@&#8203;atlv24](https://github.com/atlv24) in [#&#8203;9168](https://github.com/gfx-rs/wgpu/pull/9168). - Made the following available in `const` contexts; by [@&#8203;ErichDonGubler](https://github.com/ErichDonGubler) in [#&#8203;8943](https://github.com/gfx-rs/wgpu/pull/8943): - `naga` - `Arena::len` - `Arena::is_empty` - `Range::first_and_last` - `front::wgsl::Frontend::set_options` - `ir::Block::is_empty` - `ir::Block::len` ##### GLES - Added `GlDebugFns` option in `GlBackendOptions` to control OpenGL debug functions (`glPushDebugGroup`, `glPopDebugGroup`, `glObjectLabel`, etc.). Automatically disables them on Mali GPUs to work around a driver crash. By [@&#8203;Xavientois](https://github.com/Xavientois) in [#&#8203;8931](https://github.com/gfx-rs/wgpu/pull/8931). ##### WebGPU - Added support for `insert_debug_marker`, `push_debug_group` and `pop_debug_group`. By [@&#8203;evilpie](https://github.com/evilpie) in [#&#8203;9017](https://github.com/gfx-rs/wgpu/pull/9017). - Added support for `begin_occlusion_query` and `end_occlusion_query`. By [@&#8203;evilpie](https://github.com/evilpie) in [#&#8203;9039](https://github.com/gfx-rs/wgpu/pull/9039). ##### Changes ##### General - Tracing now uses the `.metal` extension for metal source files, instead of `.msl`. By [@&#8203;inner-daemons](https://github.com/inner-daemons) in [#&#8203;8880](https://github.com/gfx-rs/wgpu/pull/8880). - BREAKING: Several error APIs were changed by [@&#8203;ErichDonGubler](https://github.com/ErichDonGubler) in [#&#8203;9073](https://github.com/gfx-rs/wgpu/pull/9073) and [#&#8203;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. - Split the `TransferError::BufferOverrun` variant into new `BufferStartOffsetOverrun` and `BufferEndOffsetOverrun` variants. - `ImmediateUploadError`: - Removed the `TooLarge` variant in favor of new `StartOffsetOverrun` and `EndOffsetOverrun` variants. - Removed the `Unaligned` variant in favor of new `StartOffsetUnaligned` and `SizeUnaligned` variants. - Added the `ValueStartIndexOverrun` and `ValueEndIndexOverrun` invariants - The various "max resources per stage" limits are now capped at 100, so that their total remains below `max_bindings_per_bind_group`, as required by WebGPU. By [@&#8203;andyleiserson](https://github.com/andyleiserson) in [#&#8203;9118](https://github.com/gfx-rs/wgpu/pull/9118). - The `max_uniform_buffer_binding_size` and `max_storage_buffer_binding_size` limits are now `u64` instead of `u32`, to match WebGPU. By [@&#8203;wingertge](https://github.com/wingertge) in [#&#8203;9146](https://github.com/gfx-rs/wgpu/pull/9146). - The main 3 native backends now report their limits properly. By [@&#8203;teoxoy](https://github.com/teoxoy) in [#&#8203;9196](https://github.com/gfx-rs/wgpu/pull/9196). ##### naga - Naga and `wgpu` now reject shaders with an `enable` directive for functionality that is not available, even if that functionality is not used by the shader. By [@&#8203;andyleiserson](https://github.com/andyleiserson) in [#&#8203;8913](https://github.com/gfx-rs/wgpu/pull/8913). - Prevent UB from incorrectly using ray queries on HLSL. By [@&#8203;Vecvec](https://github.com/Vecvec) in [#&#8203;8763](https://github.com/gfx-rs/wgpu/pull/8763). - Added support for dual-source blending in SPIR-V shaders. By [@&#8203;andyleiserson](https://github.com/andyleiserson) in [#&#8203;8865](https://github.com/gfx-rs/wgpu/pull/8865). - Added `supported_capabilities` to all backends. By [@&#8203;inner-daemons](https://github.com/inner-daemons) in [#&#8203;9068](https://github.com/gfx-rs/wgpu/pull/9068). - Updated codespan-reporting to 0.13. By [@&#8203;cwfitzgerald](https://github.com/cwfitzgerald) in [#&#8203;9243](https://github.com/gfx-rs/wgpu/pull/9243). ##### Metal - Use autogenerated `objc2` bindings internally, which should resolve a lot of leaks and unsoundness. By [@&#8203;madsmtm](https://github.com/madsmtm) in [#&#8203;5641](https://github.com/gfx-rs/wgpu/pull/5641). - Implements ray-tracing acceleration structures for metal backend. By [@&#8203;lichtso](https://github.com/lichtso) in [#&#8203;8071](https://github.com/gfx-rs/wgpu/pull/8071). - Remove mutex for `MTLCommandQueue` because the Metal object is thread-safe. By [@&#8203;andyleiserson](https://github.com/andyleiserson) in [#&#8203;9217](https://github.com/gfx-rs/wgpu/pull/9217). ##### deno\_webgpu - Expose the `GPU.wgslLanguageFeatures` property. By [@&#8203;andyleiserson](https://github.com/andyleiserson) in [#&#8203;8884](https://github.com/gfx-rs/wgpu/pull/8884). - `GPUFeatureName` now includes all `wgpu` extensions. Feature names for extensions should be written with a `wgpu-` prefix, although unprefixed names that were accepted previously are still accepted. By [@&#8203;andyleiserson](https://github.com/andyleiserson) in [#&#8203;9163](https://github.com/gfx-rs/wgpu/pull/9163). ##### Hal - Make ordered texture and buffer uses hal specific. By [@&#8203;NiklasEi](https://github.com/NiklasEi) in [#&#8203;8924](https://github.com/gfx-rs/wgpu/pull/8924). ##### Bug Fixes ##### General - Tracing support has been restored. By [@&#8203;andyleiserson](https://github.com/andyleiserson) in [#&#8203;8429](https://github.com/gfx-rs/wgpu/pull/8429). - Pipelines using passthrough shaders now correctly require explicit pipeline layout. By [@&#8203;inner-daemons](https://github.com/inner-daemons) in [#&#8203;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 [@&#8203;andyleiserson](https://github.com/andyleiserson) in [#&#8203;8856](https://github.com/gfx-rs/wgpu/pull/8856). - Improve validation of dual-source blending, by [@&#8203;andyleiserson](https://github.com/andyleiserson) in [#&#8203;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 [@&#8203;beicause](https://github.com/beicause) in [#&#8203;8850](https://github.com/gfx-rs/wgpu/pull/8850). - BREAKING: Renamed `EXPERIMENTAL_PASSTHROUGH_SHADERS` to `PASSTHROUGH_SHADERS` and made this no longer an experimental feature. By [@&#8203;inner-daemons](https://github.com/inner-daemons) in [#&#8203;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 [@&#8203;ErichDonGubler](https://github.com/ErichDonGubler) in [#&#8203;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 [@&#8203;ErichDonGubler](https://github.com/ErichDonGubler) in [#&#8203;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 [@&#8203;inner-daemons](https://github.com/inner-daemons) in [#&#8203;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 [@&#8203;szostid](https://github.com/szostid) in [#&#8203;9094](https://github.com/gfx-rs/wgpu/pull/9094) - Fix multi-planar texture copying. By [@&#8203;noituri](https://github.com/noituri) in [#&#8203;9069](https://github.com/gfx-rs/wgpu/pull/9069) ##### naga - The validator checks that override-sized arrays have a positive size, if overrides have been resolved. By [@&#8203;andyleiserson](https://github.com/andyleiserson) in [#&#8203;8822](https://github.com/gfx-rs/wgpu/pull/8822). - Fix some cases where f16 constants were not working. By [@&#8203;andyleiserson](https://github.com/andyleiserson) in [#&#8203;8816](https://github.com/gfx-rs/wgpu/pull/8816). - Use wrapping arithmetic when evaluating constant expressions involving `u32`. By [@&#8203;andyleiserson](https://github.com/andyleiserson) in [#&#8203;8912](https://github.com/gfx-rs/wgpu/pull/8912). - Fix missing side effects from sequence expressions in GLSL. By [@&#8203;Vipitis](https://github.com/Vipitis) in [#&#8203;8787](https://github.com/gfx-rs/wgpu/pull/8787). - Naga now enforces the `@must_use` attribute on WGSL built-in functions, when applicable. You can waive the error with a phony assignment, e.g., `_ = subgroupElect()`. By [@&#8203;andyleiserson](https://github.com/andyleiserson) in [#&#8203;8713](https://github.com/gfx-rs/wgpu/pull/8713). - Reject zero-value construction of a runtime-sized array with a validation error. Previously it would crash in the HLSL backend. By [@&#8203;mooori](https://github.com/mooori) in [#&#8203;8741](https://github.com/gfx-rs/wgpu/pull/8741). - Reject splat vector construction if the argument type does not match the type of the vector's scalar. Previously it would succeed. By [@&#8203;mooori](https://github.com/mooori) in [#&#8203;8829](https://github.com/gfx-rs/wgpu/pull/8829). - Fixed `workgroupUniformLoad` incorrectly returning an atomic when called on an atomic, it now returns the inner `T` as per the spec. By [@&#8203;cryvosh](https://github.com/cryvosh) in [#&#8203;8791](https://github.com/gfx-rs/wgpu/pull/8791). - Fixed constant evaluation for `sign()` builtin to return zero when the argument is zero. By [@&#8203;mandryskowski](https://github.com/mandryskowski) in [#&#8203;8942](https://github.com/gfx-rs/wgpu/pull/8942). - Allow array generation to compile with the macOS 10.12 Metal compiler. By [@&#8203;madsmtm](https://github.com/madsmtm) in [#&#8203;8953](https://github.com/gfx-rs/wgpu/pull/8953) - Naga now detects bitwise shifts by a constant exceeding the operand bit width at compile time, and disallows scalar-by-vector and vector-by-scalar shifts in constant evaluation. By [@&#8203;andyleiserson](https://github.com/andyleiserson) in [#&#8203;8907](https://github.com/gfx-rs/wgpu/pull/8907). - Naga uses wrapping arithmetic when evaluating dot products on concrete integer types (`u32` and `i32`). By [@&#8203;BKDaugherty](https://github.com/BKDaugherty) in [#&#8203;9142](https://github.com/gfx-rs/wgpu/pull/9142). - Disallow negation of a matrix in WGSL. By [@&#8203;andyleiserson](https://github.com/andyleiserson) in [#&#8203;9157](https://github.com/gfx-rs/wgpu/pull/9157). - Fix evaluation order of compound assignment (e.g. `+=`) LHS and RHS. By [@&#8203;andyleiserson](https://github.com/andyleiserson) in [#&#8203;9181](https://github.com/gfx-rs/wgpu/pull/9181). - Fixed invalid MSL when `float16`-format vertex input data was accessed via an `f16`-type variable in a vertex shader. By [@&#8203;andyleiserson](https://github.com/andyleiserson) in [#&#8203;9166](https://github.com/gfx-rs/wgpu/pull/9166). ##### Validation - Fixed validation of the texture format in GPUDepthStencilState when neither depth nor stencil is actually enabled. By [@&#8203;andyleiserson](https://github.com/andyleiserson) in [#&#8203;8766](https://github.com/gfx-rs/wgpu/pull/8766). - Check that depth bias is not used with non-triangle topologies. By [@&#8203;andyleiserson](https://github.com/andyleiserson) in [#&#8203;8856](https://github.com/gfx-rs/wgpu/pull/8856). - Check that if the shader outputs `frag_depth`, then the pipeline must have a depth attachment. By [@&#8203;andyleiserson](https://github.com/andyleiserson) in [#&#8203;8856](https://github.com/gfx-rs/wgpu/pull/8856). - Fix incorrect acceptance of some swizzle selectors that are not valid for their operand, e.g. `const v = vec2<i32>(); let r = v.xyz`. By [@&#8203;andyleiserson](https://github.com/andyleiserson) in [#&#8203;8949](https://github.com/gfx-rs/wgpu/pull/8949). - Fixed calculation of the total number of bindings in a pipeline layout when validating against device limits. By [@&#8203;andyleiserson](https://github.com/andyleiserson) in [#&#8203;8997](https://github.com/gfx-rs/wgpu/pull/8997). - Reject non-constructible types (runtime- and override-sized arrays, and structs containing non-constructible types) in more places where they should not be allowed. By [@&#8203;andyleiserson](https://github.com/andyleiserson) in [#&#8203;8873](https://github.com/gfx-rs/wgpu/pull/8873). - The query set type for an occlusion query is now validated when opening the render pass, in addition to within the call to `beginOcclusionQuery`. By [@&#8203;andyleiserson](https://github.com/andyleiserson) in [#&#8203;9086](https://github.com/gfx-rs/wgpu/pull/9086). - Require that the blend factor is `One` when the blend operation is `Min` or `Max`. The `BlendFactorOnUnsupportedTarget` error is now reported within `ColorStateError` rather than directly in `CreateRenderPipelineError`. By [@&#8203;andyleiserson](https://github.com/andyleiserson) in [#&#8203;9110](https://github.com/gfx-rs/wgpu/pull/9110). ##### Vulkan - Fixed a variety of mesh shader SPIR-V writer issues from the original implementation. By [@&#8203;inner-daemons](https://github.com/inner-daemons) in [#&#8203;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 [@&#8203;Vecvec](https://github.com/Vecvec) in [#&#8203;9220](https://github.com/gfx-rs/wgpu/pull/9220) - Remove incorrect ordered texture uses. By [@&#8203;NiklasEi](https://github.com/NiklasEi) in [#&#8203;8924](https://github.com/gfx-rs/wgpu/pull/8924). ##### Metal / macOS - Fix one-second delay when switching a wgpu app to the foreground. By [@&#8203;emilk](https://github.com/emilk) in [#&#8203;9141](https://github.com/gfx-rs/wgpu/pull/9141) - Work around Metal driver bug with atomic textures. By [@&#8203;atlv24](https://github.com/atlv24) in [#&#8203;9185](https://github.com/gfx-rs/wgpu/pull/9185) - Fix setting an immediate for a Mesh shader. By [@&#8203;waywardmonkeys](https://github.com/waywardmonkeys) in [#&#8203;9254](https://github.com/gfx-rs/wgpu/pull/9254) ##### GLES - `DisplayHandle` should now be passed to `InstanceDescriptor` for correct EGL initialization on Wayland. By [@&#8203;MarijnS95](https://github.com/MarijnS95) in [#&#8203;8012](https://github.com/gfx-rs/wgpu/pull/8012) Note that the existing workaround to create surfaces before the adapter is no longer valid. - Changing shader constants now correctly recompiles the shader. By [@&#8203;DerSchmale](https://github.com/DerSchmale) in [#&#8203;8291](https://github.com/gfx-rs/wgpu/pull/8291). ##### Performance ##### GLES - The GL backend would now try to take advantage of `GL_EXT_multisampled_render_to_texture` extension when applicable to skip the multi-sample resolve operation. By [@&#8203;opstic](https://github.com/opstic) in [#&#8203;8536](https://github.com/gfx-rs/wgpu/pull/8536). ##### Documentation ##### General - Expanded documentation of `QuerySet`, `QueryType`, and `resolve_query_set()` describing how to use queries. By [@&#8203;kpreid](https://github.com/kpreid) in [#&#8203;8776](https://github.com/gfx-rs/wgpu/pull/8776). ### [`v28.0.0`](https://github.com/gfx-rs/wgpu/blob/HEAD/CHANGELOG.md#v2800-2025-12-17) [Compare Source](https://github.com/gfx-rs/wgpu/compare/wgpu-v27.0.1...v28.0.0) ##### Major Changes ##### Mesh Shaders This has been a long time coming. See [the tracking issue](https://github.com/gfx-rs/wgpu/issues/7197) for more information. They are now fully supported on Vulkan, and supported on Metal and DX12 with passthrough shaders. WGSL parsing and rewriting is supported, meaning they can be used through WESL or naga\_oil. Mesh shader pipelines replace the standard vertex shader pipelines and allow new ways to render meshes. They are ideal for meshlet rendering, a form of rendering where small groups of triangles are handled together, for both culling and rendering. They are compute-like shaders, and generate primitives which are passed directly to the rasterizer, rather than having a list of vertices generated individually and then using a static index buffer. This means that certain computations on nearby groups of triangles can be done together, the relationship between vertices and primitives is more programmable, and you can even pass non-interpolated per-primitive data to the fragment shader, independent of vertices. Mesh shaders are very versatile, and are powerful enough to replace vertex shaders, tesselation shaders, and geometry shaders on their own or with task shaders. A full example of mesh shaders in use can be seen in the `mesh_shader` example. For the full specification of mesh shaders in wgpu, go to [docs/api-specs/mesh\_shading.md](docs/api-specs/mesh_shading.md). Below is a small snippet of shader code demonstrating their usage: ```wgsl @&#8203;task @&#8203;payload(taskPayload) @&#8203;workgroup_size(1) fn ts_main() -> @&#8203;builtin(mesh_task_size) vec3<u32> { // Task shaders can use workgroup variables like compute shaders workgroupData = 1.0; // Pass some data to all mesh shaders dispatched by this workgroup taskPayload.colorMask = vec4(1.0, 1.0, 0.0, 1.0); taskPayload.visible = 1; // Dispatch a mesh shader grid with one workgroup return vec3(1, 1, 1); } @&#8203;mesh(mesh_output) @&#8203;payload(taskPayload) @&#8203;workgroup_size(1) fn ms_main(@&#8203;builtin(local_invocation_index) index: u32, @&#8203;builtin(global_invocation_id) id: vec3<u32>) { // Set how many outputs this workgroup will generate mesh_output.vertex_count = 3; mesh_output.primitive_count = 1; // Can also use workgroup variables workgroupData = 2.0; // Set vertex outputs mesh_output.vertices[0].position = positions[0]; mesh_output.vertices[0].color = colors[0] * taskPayload.colorMask; mesh_output.vertices[1].position = positions[1]; mesh_output.vertices[1].color = colors[1] * taskPayload.colorMask; mesh_output.vertices[2].position = positions[2]; mesh_output.vertices[2].color = colors[2] * taskPayload.colorMask; // Set the vertex indices for the only primitive mesh_output.primitives[0].indices = vec3<u32>(0, 1, 2); // Cull it if the data passed by the task shader says to mesh_output.primitives[0].cull = taskPayload.visible == 1; // Give a noninterpolated per-primitive vec4 to the fragment shader mesh_output.primitives[0].colorMask = vec4<f32>(1.0, 0.0, 1.0, 1.0); } ``` ##### Thanks This was a monumental effort from many different people, but it was championed by [@&#8203;inner-daemons](https://github.com/inner-daemons), without whom it would not have happened. Thank you [@&#8203;cwfitzgerald](https://github.com/cwfitzgerald) for doing the bulk of the code review. Finally thank you [@&#8203;ColinTimBarndt](https://github.com/ColinTimBarndt) for coordinating the testing effort. Reviewers: - [@&#8203;cwfitzgerald](https://github.com/cwfitzgerald) - [@&#8203;jimblandy](https://github.com/jimblandy) - [@&#8203;ErichDonGubler](https://github.com/ErichDonGubler) `wgpu` Contributions: - Metal implementation in wgpu-hal. By [@&#8203;inner-daemons](https://github.com/inner-daemons) in [#&#8203;8139](https://github.com/gfx-rs/wgpu/pull/8139). - DX12 implementation in wgpu-hal. By [@&#8203;inner-daemons](https://github.com/inner-daemons) in [#&#8203;8110](https://github.com/gfx-rs/wgpu/pull/8110). - Vulkan implementation in wgpu-hal. By [@&#8203;inner-daemons](https://github.com/inner-daemons) in [#&#8203;7089](https://github.com/gfx-rs/wgpu/pull/7089). - wgpu/wgpu-core implementation. By [@&#8203;inner-daemons](https://github.com/inner-daemons) in [#&#8203;7345](https://github.com/gfx-rs/wgpu/pull/7345). - New mesh shader limits and validation. By [@&#8203;inner-daemons](https://github.com/inner-daemons) in [#&#8203;8507](https://github.com/gfx-rs/wgpu/pull/8507). `naga` Contributions: - Naga IR implementation. By [@&#8203;inner-daemons](https://github.com/inner-daemons) in [#&#8203;8104](https://github.com/gfx-rs/wgpu/pull/8104). - `wgsl-in` implementation in naga. By [@&#8203;inner-daemons](https://github.com/inner-daemons) in [#&#8203;8370](https://github.com/gfx-rs/wgpu/pull/8370). - `spv-out` implementation in naga. By [@&#8203;inner-daemons](https://github.com/inner-daemons) in [#&#8203;8456](https://github.com/gfx-rs/wgpu/pull/8456). - `wgsl-out` implementation in naga. By [@&#8203;Slightlyclueless](https://github.com/Slightlyclueless) in [#&#8203;8481](https://github.com/gfx-rs/wgpu/pull/8481). - Allow barriers in mesh/task shaders. By [@&#8203;inner-daemons](https://github.com/inner-daemons) in [#&#8203;8749](https://github.com/gfx-rs/wgpu/pull/8749) Testing Assistance: - [@&#8203;ColinTimBarndt](https://github.com/ColinTimBarndt) - [@&#8203;AdamK2003](https://github.com/AdamK2003) - [@&#8203;Mhowser](https://github.com/Mhowser) - [@&#8203;9291Sam](https://github.com/9291Sam) - 3 more testers who wished to remain anonymous. Thank you to everyone to made this happen! ##### Switch from `gpu-alloc` to `gpu-allocator` in the `vulkan` backend `gpu-allocator` is the allocator used in the `dx12` backend, allowing to configure the allocator the same way in those two backends converging their behavior. This also brings the `Device::generate_allocator_report` feature to the vulkan backend. By [@&#8203;DeltaEvo](https://github.com/DeltaEvo) in [#&#8203;8158](https://github.com/gfx-rs/wgpu/pull/8158). ##### `wgpu::Instance::enumerate_adapters` is now `async` & available on WebGPU BREAKING CHANGE: `enumerate_adapters` is now `async`: ```diff - pub fn enumerate_adapters(&self, backends: Backends) -> Vec<Adapter> { + pub fn enumerate_adapters(&self, backends: Backends) -> impl Future<Output = Vec<Adapter>> { ``` This yields two benefits: - This method is now implemented on non-native using the standard `Adapter::request_adapter(…)`, making `enumerate_adapters` a portable surface. This was previously a nontrivial pain point when an application wanted to do some of its own filtering of adapters. - This method can now be implemented in custom backends. By [@&#8203;R-Cramer4](https://github.com/R-Cramer4) in [#&#8203;8230](https://github.com/gfx-rs/wgpu/pull/8230) ##### New `LoadOp::DontCare` In the case where a renderpass unconditionally writes to all pixels in the rendertarget, `Load` can cause unnecessary memory traffic, and `Clear` can spend time unnecessarily clearing the rendertargets. `DontCare` is a new `LoadOp` which will leave the contents of the rendertarget undefined. Because this could lead to undefined behavior, this API requires that the user gives an unsafe token to use the api. While you can use this unconditionally, on platforms where `DontCare` is not available, it will internally use a different load op. ```rust load: LoadOp::DontCare(unsafe { wgpu::LoadOpDontCare::enabled() }) ``` By [@&#8203;cwfitzgerald](https://github.com/cwfitzgerald) in [#&#8203;8549](https://github.com/gfx-rs/wgpu/pull/8549) ##### `MipmapFilterMode` is split from `FilterMode` This is a breaking change that aligns wgpu with spec. ```diff SamplerDescriptor { ... - mipmap_filter: FilterMode::Nearest + mipmap_filter: MipmapFilterMode::Nearest ... } ``` By [@&#8203;sagudev](https://github.com/sagudev) in [#&#8203;8314](https://github.com/gfx-rs/wgpu/pull/8314). ##### Multiview on all major platforms and support for multiview bitmasks Multiview is a feature that allows rendering the same content to multiple layers of a texture. This is useful primarily in VR where you wish to display almost identical content to 2 views, just with a different perspective. Instead of using 2 draw calls or 2 instances for each object, you can use this feature. Multiview is also called view instancing in DX12 or vertex amplification in Metal. Multiview has been reworked, adding support for Metal and DX12, and adding testing and validation to wgpu itself. This change also introduces a view bitmask, a new field in `RenderPassDescriptor` that allows a render pass to render to multiple non-adjacent layers when using the `SELECTIVE_MULTIVIEW` feature. If you don't use multi-view, you can set this field to none. ```diff - wgpu::RenderPassDescriptor { - label: None, - color_attachments: &color_attachments, - depth_stencil_attachment: None, - timestamp_writes: None, - occlusion_query_set: None, - } + wgpu::RenderPassDescriptor { + label: None, + color_attachments: &color_attachments, + depth_stencil_attachment: None, + timestamp_writes: None, + occlusion_query_set: None, + multiview_mask: NonZero::new(3), + } ``` One other breaking change worth noting is that in WGSL `@builtin(view_index)` now requires a type of `u32`, where previously it required `i32`. By [@&#8203;inner-daemons](https://github.com/inner-daemons) in [#&#8203;8206](https://github.com/gfx-rs/wgpu/pull/8206). ##### Error scopes now use guards and are thread-local. ```diff - device.push_error_scope(wgpu::ErrorFilter::Validation); + let scope = device.push_error_scope(wgpu::ErrorFilter::Validation); // ... perform operations on the device ... - let error: Option<Error> = device.pop_error_scope().await; + let error: Option<Error> = scope.pop().await; ``` Device error scopes now operate on a per-thread basis. This allows them to be used easily within multithreaded contexts, without having the error scope capture errors from other threads. When the `std` feature is **not** enabled, we have no way to differentiate between threads, so error scopes return to be global operations. By [@&#8203;cwfitzgerald](https://github.com/cwfitzgerald) in [#&#8203;8685](https://github.com/gfx-rs/wgpu/pull/8685) ##### Log Levels We have received complaints about wgpu being way too log spammy at log levels `info`/`warn`/`error`. We have adjusted our log policy and changed logging such that `info` and above should be silent unless some exceptional event happens. Our new log policy is as follows: - Error: if we can’t (for some reason, usually a bug) communicate an error any other way. - Warning: similar, but there may be one-shot warnings about almost certainly sub-optimal. - Info: do not use - Debug: Used for interesting events happening inside wgpu. - Trace: Used for all events that might be useful to either `wgpu` or application developers. By [@&#8203;cwfitzgerald](https://github.com/cwfitzgerald) in [#&#8203;8579](https://github.com/gfx-rs/wgpu/pull/8579). ##### Push constants renamed immediates, API brought in line with spec. As the "immediate data" api is getting close to stabilization in the WebGPU specification, we're bringing our implementation in line with what the spec dictates. First, in the `PipelineLayoutDescriptor`, you now pass a unified size for all stages: ```diff - push_constant_ranges: &[wgpu::PushConstantRange { - stages: wgpu::ShaderStages::VERTEX_FRAGMENT, - range: 0..12, - }] + immediate_size: 12, ``` Second, on the command encoder you no longer specify a shader stage, uploads apply to all shader stages that use immediate data. ```diff - rpass.set_push_constants(wgpu::ShaderStages::FRAGMENT, 0, bytes); + rpass.set_immediates(0, bytes); ``` Third, immediates are now declared with the `immediate` address space instead of the `push_constant` address space. Due to a [known issue on DX12](https://github.com/gfx-rs/wgpu/issues/5683) it is advised to always use a structure for your immediates until that issue is fixed. ```diff - var<push_constant> my_pc: MyPushConstant; + var<immediate> my_imm: MyImmediate; ``` Finally, our implementation currently still zero-initializes the immediate data range you declared in the pipeline layout. This is not spec compliant and failing to populate immediate "slots" that are used in the shader will be a validation error in a future version. See [the proposal][immediate-data-spec] for details for determining which slots are populated in a given shader. By [@&#8203;cwfitzgerald](https://github.com/cwfitzgerald) in [#&#8203;8724](https://github.com/gfx-rs/wgpu/pull/8724). [immediate-data-spec]: https://github.com/gpuweb/gpuweb/blob/main/proposals/immediate-data.md#immediate-slots ##### `subgroup_{min,max}_size` renamed and moved from `Limits` -> `AdapterInfo` To bring our code in line with the WebGPU spec, we have moved information about subgroup size from limits to adapter info. Limits was not the correct place for this anyway, and we had some code special casing those limits. Additionally we have renamed the fields to match the spec. ```diff - let min = limits.min_subgroup_size; + let min = info.subgroup_min_size; - let max = limits.max_subgroup_size; + let max = info.subgroup_max_size; ``` By [@&#8203;cwfitzgerald](https://github.com/cwfitzgerald) in [#&#8203;8609](https://github.com/gfx-rs/wgpu/pull/8609). ##### New Features - Added support for transient textures on Vulkan and Metal. By [@&#8203;opstic](https://github.com/opstic) in [#&#8203;8247](https://github.com/gfx-rs/wgpu/pull/8247) - Implement shader triangle barycentric coordinate builtins. By [@&#8203;atlv24](https://github.com/atlv24) in [#&#8203;8320](https://github.com/gfx-rs/wgpu/pull/8320). - Added support for binding arrays of storage textures on Metal. By [@&#8203;msvbg](https://github.com/msvbg) in [#&#8203;8464](https://github.com/gfx-rs/wgpu/pull/8464) - Added support for multisampled texture arrays on Vulkan through adapter feature `MULTISAMPLE_ARRAY`. By [@&#8203;LaylBongers](https://github.com/LaylBongers) in [#&#8203;8571](https://github.com/gfx-rs/wgpu/pull/8571). - Added `get_configuration` to `wgpu::Surface`, that returns the current configuration of `wgpu::Surface`. By [@&#8203;sagudev](https://github.com/sagudev) in [#&#8203;8664](https://github.com/gfx-rs/wgpu/pull/8664). - Add `wgpu_core::Global::create_bind_group_layout_error`. By [@&#8203;ErichDonGubler](https://github.com/ErichDonGubler) in [#&#8203;8650](https://github.com/gfx-rs/wgpu/pull/8650). ##### Changes ##### General - Require new enable extensions when using ray queries and position fetch (`wgpu_ray_query`, `wgpu_ray_query_vertex_return`). By [@&#8203;Vecvec](https://github.com/Vecvec) in [#&#8203;8545](https://github.com/gfx-rs/wgpu/pull/8545). - Texture now has `from_custom`. By [@&#8203;R-Cramer4](https://github.com/R-Cramer4) in [#&#8203;8315](https://github.com/gfx-rs/wgpu/pull/8315). - Using both the wgpu command encoding APIs and `CommandEncoder::as_hal_mut` on the same encoder will now result in a panic. - Allow `include_spirv!` and `include_spirv_raw!` macros to be used in constants and statics. By [@&#8203;clarfonthey](https://github.com/clarfonthey) in [#&#8203;8250](https://github.com/gfx-rs/wgpu/pull/8250). - Added support for rendering onto multi-planar textures. By [@&#8203;noituri](https://github.com/noituri) in [#&#8203;8307](https://github.com/gfx-rs/wgpu/pull/8307). - Validation errors from `CommandEncoder::finish()` will report the label of the invalid encoder. By [@&#8203;kpreid](https://github.com/kpreid) in [#&#8203;8449](https://github.com/gfx-rs/wgpu/pull/8449). - Corrected documentation of the minimum alignment of the *end* of a mapped range of a buffer (it is 4, not 8). By [@&#8203;kpreid](https://github.com/kpreid) in [#&#8203;8450](https://github.com/gfx-rs/wgpu/pull/8450). - `util::StagingBelt` now takes a `Device` when it is created instead of when it is used. By [@&#8203;kpreid](https://github.com/kpreid) in [#&#8203;8462](https://github.com/gfx-rs/wgpu/pull/8462). - `wgpu_hal::vulkan::Texture` API changes to handle externally-created textures and memory more flexibly. By [@&#8203;s-ol](https://github.com/s-ol) in [#&#8203;8512](https://github.com/gfx-rs/wgpu/pull/8512), [#&#8203;8521](https://github.com/gfx-rs/wgpu/pull/8521). - Render passes are now validated against the `maxColorAttachmentBytesPerSample` limit. By [@&#8203;andyleiserson](https://github.com/andyleiserson) in [#&#8203;8697](https://github.com/gfx-rs/wgpu/pull/8697). ##### Metal - Expose render layer. By [@&#8203;xiaopengli89](https://github.com/xiaopengli89) in [#&#8203;8707](https://github.com/gfx-rs/wgpu/pull/8707) - `MTLDevice` is thread-safe. By [@&#8203;uael](https://github.com/uael) in [#&#8203;8168](https://github.com/gfx-rs/wgpu/pull/8168) ##### naga - Prevent UB with invalid ray query calls on spirv. By [@&#8203;Vecvec](https://github.com/Vecvec) in [#&#8203;8390](https://github.com/gfx-rs/wgpu/pull/8390). - Update the set of binding\_array capabilities. In most cases, they are set automatically from `wgpu` features, and this change should not be user-visible. By [@&#8203;andyleiserson](https://github.com/andyleiserson) in [#&#8203;8671](https://github.com/gfx-rs/wgpu/pull/8671). - Naga now accepts the `var<function>` syntax for declaring local variables. By [@&#8203;andyleiserson](https://github.com/andyleiserson) in [#&#8203;8710](https://github.com/gfx-rs/wgpu/pull/8710). ##### Bug Fixes ##### General - Fixed a bug where mapping sub-ranges of a buffer on web would fail with `OperationError: GPUBuffer.getMappedRange: GetMappedRange range extends beyond buffer's mapped range`. By [@&#8203;ryankaplan](https://github.com/ryankaplan) in [#&#8203;8349](https://github.com/gfx-rs/wgpu/pull/8349) - Reject fragment shader output `location`s > `max_color_attachments` limit. By [@&#8203;ErichDonGubler](https://github.com/ErichDonGubler) in [#&#8203;8316](https://github.com/gfx-rs/wgpu/pull/8316). - WebGPU device requests now support the required limits `maxColorAttachments` and `maxColorAttachmentBytesPerSample`. By [@&#8203;evilpie](https://github.com/evilpie) in [#&#8203;8328](https://github.com/gfx-rs/wgpu/pull/8328) - Reject binding indices that exceed `wgpu_types::Limits::max_bindings_per_bind_group` when deriving a bind group layout for a pipeline. By [@&#8203;jimblandy](https://github.com/jimblandy) in [#&#8203;8325](https://github.com/gfx-rs/wgpu/pull/8325). - Removed three features from `wgpu-hal` which did nothing useful: `"cargo-clippy"`, `"gpu-allocator"`, and `"rustc-hash"`. By [@&#8203;kpreid](https://github.com/kpreid) in [#&#8203;8357](https://github.com/gfx-rs/wgpu/pull/8357). - `wgpu_types::PollError` now always implements the `Error` trait. By [@&#8203;kpreid](https://github.com/kpreid) in [#&#8203;8384](https://github.com/gfx-rs/wgpu/pull/8384). - The texture subresources used by the color attachments of a render pass are no longer allowed to overlap when accessed via different texture views. By [@&#8203;andyleiserson](https://github.com/andyleiserson) in [#&#8203;8402](https://github.com/gfx-rs/wgpu/pull/8402). - The `STORAGE_READ_ONLY` texture usage is now permitted to coexist with other read-only usages. By [@&#8203;andyleiserson](https://github.com/andyleiserson) in [#&#8203;8490](https://github.com/gfx-rs/wgpu/pull/8490). - Validate that buffers are unmapped in `write_buffer` calls. By [@&#8203;ErichDonGubler](https://github.com/ErichDonGubler) in [#&#8203;8454](https://github.com/gfx-rs/wgpu/pull/8454). - Shorten critical section inside present such that the snatch write lock is no longer held during present, preventing other work happening on other threads. By [@&#8203;cwfitzgerald](https://github.com/cwfitzgerald) in [#&#8203;8608](https://github.com/gfx-rs/wgpu/pull/8608). ##### naga - The `||` and `&&` operators now "short circuit", i.e., do not evaluate the RHS if the result can be determined from just the LHS. By [@&#8203;andyleiserson](https://github.com/andyleiserson) in [#&#8203;7339](https://github.com/gfx-rs/wgpu/pull/7339). - Fix a bug that resulted in the Metal error `program scope variable must reside in constant address space` in some cases. By [@&#8203;teoxoy](https://github.com/teoxoy) in [#&#8203;8311](https://github.com/gfx-rs/wgpu/pull/8311). - Handle `rayQueryTerminate` in spv-out instead of ignoring it. By [@&#8203;Vecvec](https://github.com/Vecvec) in [#&#8203;8581](https://github.com/gfx-rs/wgpu/pull/8581). ##### DX12 - Align copies b/w textures and buffers via a single intermediate buffer per copy when `D3D12_FEATURE_DATA_D3D12_OPTIONS13.UnrestrictedBufferTextureCopyPitchSupported` is `false`. By [@&#8203;ErichDonGubler](https://github.com/ErichDonGubler) in [#&#8203;7721](https://github.com/gfx-rs/wgpu/pull/7721). - Fix detection of Int64 Buffer/Texture atomic features. By [@&#8203;cwfitzgerald](https://github.com/cwfitzgerald) in [#&#8203;8667](https://github.com/gfx-rs/wgpu/pull/8667). ##### Vulkan - Fixed a validation error regarding atomic memory semantics. By [@&#8203;atlv24](https://github.com/atlv24) in [#&#8203;8391](https://github.com/gfx-rs/wgpu/pull/8391). ##### Metal - Fixed a variety of feature detection related bugs. By [@&#8203;inner-daemons](https://github.com/inner-daemons) in [#&#8203;8439](https://github.com/gfx-rs/wgpu/pull/8439). ##### WebGPU - Fixed a bug where the texture aspect was not passed through when calling `copy_texture_to_buffer` in WebGPU, causing the copy to fail for depth/stencil textures. By [@&#8203;Tim-Evans-Seequent](https://github.com/Tim-Evans-Seequent) in [#&#8203;8445](https://github.com/gfx-rs/wgpu/pull/8445). ##### GLES - Fix race when downloading texture from compute shader pass. By [@&#8203;SpeedCrash100](https://github.com/SpeedCrash100) in [#&#8203;8527](https://github.com/gfx-rs/wgpu/pull/8527) - Fix double window class registration when dynamic libraries are used. By [@&#8203;Azorlogh](https://github.com/Azorlogh) in [#&#8203;8548](https://github.com/gfx-rs/wgpu/pull/8548) - Fix context loss on device initialization on GL3.3-4.1 contexts. By [@&#8203;cwfitzgerald](https://github.com/cwfitzgerald) in [#&#8203;8674](https://github.com/gfx-rs/wgpu/pull/8674). - `VertexFormat::Unorm10_10_10_2` can now be used on `gl` backends. By [@&#8203;mooori](https://github.com/mooori) in [#&#8203;8717](https://github.com/gfx-rs/wgpu/pull/8717). ##### hal - `DropCallback`s are now called after dropping all other fields of their parent structs. By [@&#8203;jerzywilczek](https://github.com/jerzywilczek) in [#&#8203;8353](https://github.com/gfx-rs/wgpu/pull/8353) ### [`v27.0.1`](https://github.com/gfx-rs/wgpu/blob/HEAD/CHANGELOG.md#v2701-2025-10-02) [Compare Source](https://github.com/gfx-rs/wgpu/compare/wgpu-v27.0.0...wgpu-v27.0.1) ##### Bug Fixes - Fixed the build on docs.rs. By [@&#8203;cwfitzgerald](https://github.com/cwfitzgerald) in [#&#8203;8292](https://github.com/gfx-rs/wgpu/pull/8292). ### [`v27.0.0`](https://github.com/gfx-rs/wgpu/blob/HEAD/CHANGELOG.md#v2700-2025-10-01) [Compare Source](https://github.com/gfx-rs/wgpu/compare/wgpu-v26.0.1...wgpu-v27.0.0) ##### Major Changes ##### Deferred command buffer actions: `map_buffer_on_submit` and `on_submitted_work_done` You may schedule buffer mapping and a submission-complete callback to run automatically after you submit, directly from encoders, command buffers, and passes. ```rust // Record some GPU work so the submission isn't empty and touches `buffer`. encoder.clear_buffer(&buffer, 0, None); // Defer mapping until this encoder is submitted. encoder.map_buffer_on_submit(&buffer, wgpu::MapMode::Read, 0..size, |result| { .. }); // Fires after the command buffer's work is finished. encoder.on_submitted_work_done(|| { .. }); // Automatically calls `map_async` and `on_submitted_work_done` after this submission finishes. queue.submit([encoder.finish()]); ``` Available on `CommandEncoder`, `CommandBuffer`, `RenderPass`, and `ComputePass`. By [@&#8203;cwfitzgerald](https://github.com/cwfitzgerald) in [#&#8203;8125](https://github.com/gfx-rs/wgpu/pull/8125). ##### Builtin Support for DXGI swapchains on top of of DirectComposition Visuals in DX12 By enabling DirectComposition support, the dx12 backend can now support transparent windows. This creates a single `IDCompositionVisual` over the entire window that is used by the mf`Surface`. If a user wants to manage the composition tree themselves, they should create their own device and composition, and pass the relevant visual down into `wgpu` via `SurfaceTargetUnsafe::CompositionVisual`. ```rust let instance = wgpu::Instance::new(&wgpu::InstanceDescriptor { backend_options: wgpu::BackendOptions { dx12: wgpu::Dx12BackendOptions { presentation_system: wgpu::Dx12SwapchainKind::DxgiFromVisual, .. }, .. }, .. }); ``` By [@&#8203;n1ght-hunter](https://github.com/n1ght-hunter) in [#&#8203;7550](https://github.com/gfx-rs/wgpu/pull/7550). ##### `EXPERIMENTAL_RAY_TRACING_ACCELERATION_STRUCTURE` has been merged into `EXPERIMENTAL_RAY_QUERY` We have merged the acceleration structure feature into the `RayQuery` feature. This is to help work around an AMD driver bug and reduce the feature complexity of ray tracing. In the future when ray tracing pipelines are implemented, if either feature is enabled, acceleration structures will be available. ```diff - Features::EXPERIMENTAL_RAY_TRACING_ACCELERATION_STRUCTURE + Features::EXPERIMENTAL_RAY_QUERY ``` By [@&#8203;Vecvec](https://github.com/Vecvec) in [#&#8203;7913](https://github.com/gfx-rs/wgpu/pull/7913). ##### New `EXPERIMENTAL_PRECOMPILED_SHADERS` API We have added `Features::EXPERIMENTAL_PRECOMPILED_SHADERS`, replacing existing passthrough types with a unified `CreateShaderModuleDescriptorPassthrough` which allows passing multiple shader codes for different backends. By [@&#8203;SupaMaggie70Incorporated](https://github.com/SupaMaggie70Incorporated) in [#&#8203;7834](https://github.com/gfx-rs/wgpu/pull/7834) Difference for SPIR-V passthrough: ```diff - device.create_shader_module_passthrough(wgpu::ShaderModuleDescriptorPassthrough::SpirV( - wgpu::ShaderModuleDescriptorSpirV { - label: None, - source: spirv_code, - }, - )) + device.create_shader_module_passthrough(wgpu::ShaderModuleDescriptorPassthrough { + entry_point: "main".into(), + label: None, + spirv: Some(spirv_code), + ..Default::default() }) ``` This allows using precompiled shaders without manually checking which backend's code to pass, for example if you have shaders precompiled for both DXIL and SPIR-V. ##### Buffer mapping apis no longer have lifetimes `Buffer::get_mapped_range()`, `Buffer::get_mapped_range_mut()`, and `Queue::write_buffer_with()` now return guard objects without any lifetimes. This makes it significantly easier to store these types in structs, which is useful for building utilities that build the contents of a buffer over time. ```diff - let buffer_mapping_ref: wgpu::BufferView<'_> = buffer.get_mapped_range(..); - let buffer_mapping_mut: wgpu::BufferViewMut<'_> = buffer.get_mapped_range_mut(..); - let queue_write_with: wgpu::QueueWriteBufferView<'_> = queue.write_buffer_with(..); + let buffer_mapping_ref: wgpu::BufferView = buffer.get_mapped_range(..); + let buffer_mapping_mut: wgpu::BufferViewMut = buffer.get_mapped_range_mut(..); + let queue_write_with: wgpu::QueueWriteBufferView = queue.write_buffer_with(..); ``` By [@&#8203;sagudev](https://github.com/sagudev) in [#&#8203;8046](https://github.com/gfx-rs/wgpu/pull/8046) and [@&#8203;cwfitzgerald](https://github.com/cwfitzgerald) in [#&#8203;8070](https://github.com/gfx-rs/wgpu/pull/8161). ##### `EXPERIMENTAL_*` features now require unsafe code to enable We want to be able to expose potentially experimental features to our users before we have ensured that they are fully sound to use. As such, we now require any feature that is prefixed with `EXPERIMENTAL` to have a special unsafe token enabled in the device descriptor acknowledging that the features may still have bugs in them and to report any they find. ```rust adapter.request_device(&wgpu::DeviceDescriptor { features: wgpu::Features::EXPERIMENTAL_MESH_SHADER, experimental_features: unsafe { wgpu::ExperimentalFeatures::enabled() } .. }) ``` By [@&#8203;cwfitzgerald](https://github.com/cwfitzgerald) in [#&#8203;8163](https://github.com/gfx-rs/wgpu/pull/8163). ##### Multi-draw indirect is now unconditionally supported when indirect draws are supported We have removed `Features::MULTI_DRAW_INDIRECT` as it was unconditionally available on all platforms. `RenderPass::multi_draw_indirect` is now available if the device supports downlevel flag `DownlevelFlags::INDIRECT_EXECUTION`. If you are using spirv-passthrough with multi-draw indirect and `gl_DrawID`, you can know if `MULTI_DRAW_INDIRECT` is being emulated by if the `Feature::MULTI_DRAW_INDIRECT_COUNT` feature is available on the device, this feature cannot be emulated efficicently. By [@&#8203;cwfitzgerald](https://github.com/cwfitzgerald) in [#&#8203;8162](https://github.com/gfx-rs/wgpu/pull/8162). ##### `wgpu::PollType::Wait` has now an optional timeout We removed `wgpu::PollType::WaitForSubmissionIndex` and added fields to `wgpu::PollType::Wait` in order to express timeouts. Before/after for `wgpu::PollType::Wait`: ```diff -device.poll(wgpu::PollType::Wait).unwrap(); -device.poll(wgpu::PollType::wait_indefinitely()).unwrap(); +device.poll(wgpu::PollType::Wait { + submission_index: None, // Wait for most recent submission + timeout: Some(std::time::Duration::from_secs(60)), // Previous behavior, but more likely you want `None` instead. + }) + .unwrap(); ``` Before/after for `wgpu::PollType::WaitForSubmissionIndex`: ```diff -device.poll(wgpu::PollType::WaitForSubmissionIndex(index_to_wait_on)) +device.poll(wgpu::PollType::Wait { + submission_index: Some(index_to_wait_on), + timeout: Some(std::time::Duration::from_secs(60)), // Previous behavior, but more likely you want `None` instead. + }) + .unwrap(); ``` ⚠️ Previously, both `wgpu::PollType::WaitForSubmissionIndex` and `wgpu::PollType::Wait` had a hard-coded timeout of 60 seconds. To wait indefinitely on the latest submission, you can also use the `wait_indefinitely` convenience function: ```rust device.poll(wgpu::PollType::wait_indefinitely()); ``` By [@&#8203;wumpf](https://github.com/wumpf) in [#&#8203;8282](https://github.com/gfx-rs/wgpu/pull/8282), [#&#8203;8285](https://github.com/gfx-rs/wgpu/pull/8285) ##### New Features ##### General - Added mesh shader support to `wgpu`, with examples. Requires passthrough. By [@&#8203;SupaMaggie70Incorporated](https://github.com/SupaMaggie70Incorporated) in [#&#8203;7345](https://github.com/gfx-rs/wgpu/pull/7345). - Added support for external textures based on WebGPU's [`GPUExternalTexture`](https://www.w3.org/TR/webgpu/#gpuexternaltexture). These allow shaders to transparently operate on potentially multiplanar source texture data in either RGB or YCbCr formats via WGSL's `texture_external` type. This is gated behind the `Features::EXTERNAL_TEXTURE` feature, which is currently only supported on DX12. By [@&#8203;jamienicol](https://github.com/jamienicol) in [#&#8203;4386](https://github.com/gfx-rs/wgpu/issues/4386). - `wgpu::Device::poll` can now specify a timeout via `wgpu::PollType::Wait`. By [@&#8203;wumpf](https://github.com/wumpf) in [#&#8203;8282](https://github.com/gfx-rs/wgpu/pull/8282) & [#&#8203;8285](https://github.com/gfx-rs/wgpu/pull/8285) ##### naga - Expose `naga::front::wgsl::UnimplementedEnableExtension`. By [@&#8203;ErichDonGubler](https://github.com/ErichDonGubler) in [#&#8203;8237](https://github.com/gfx-rs/wgpu/pull/8237). ##### Changes ##### General - Command encoding now happens when `CommandEncoder::finish` is called, not when the individual operations are requested. This does not affect the API, but may affect performance characteristics. By [@&#8203;andyleiserson](https://github.com/andyleiserson) in [#&#8203;8220](https://github.com/gfx-rs/wgpu/pull/8220). - Prevent resources for acceleration structures being created if acceleration structures are not enabled. By [@&#8203;Vecvec](https://github.com/Vecvec) in [#&#8203;8036](https://github.com/gfx-rs/wgpu/pull/8036). - Validate that each `push_debug_group` pairs with exactly one `pop_debug_group`. By [@&#8203;andyleiserson](https://github.com/andyleiserson) in [#&#8203;8048](https://github.com/gfx-rs/wgpu/pull/8048). - `set_viewport` now requires that the supplied minimum depth value is less than the maximum depth value. By [@&#8203;andyleiserson](https://github.com/andyleiserson) in [#&#8203;8040](https://github.com/gfx-rs/wgpu/pull/8040). - Validation of `copy_texture_to_buffer`, `copy_buffer_to_texture`, and `copy_texture_to_texture` operations more closely follows the WebGPU specification. By [@&#8203;andyleiserson](https://github.com/andyleiserson) in various PRs. - Copies within the same texture must not overlap. - Copies of multisampled or depth/stencil formats must span an entire subresource (layer). - Copies of depth/stencil formats must be 4B aligned. - For texture-buffer copies, `bytes_per_row` on the buffer side must be 256B-aligned, even if the transfer is a single row. - The offset for `set_vertex_buffer` and `set_index_buffer` must be 4B aligned. By [@&#8203;andyleiserson](https://github.com/andyleiserson) in [#&#8203;7929](https://github.com/gfx-rs/wgpu/pull/7929). - The offset and size of bindings are validated as fitting within the underlying buffer in more cases. By [@&#8203;andyleiserson](https://github.com/andyleiserson) in [#&#8203;7911](https://github.com/gfx-rs/wgpu/pull/7911). - The function you pass to `Device::on_uncaptured_error()` must now implement `Sync` in addition to `Send`, and be wrapped in `Arc` instead of `Box`. In exchange for this, it is no longer possible for calling `wgpu` functions while in that callback to cause a deadlock (not that we encourage you to actually do that). By [@&#8203;kpreid](https://github.com/kpreid) in [#&#8203;8011](https://github.com/gfx-rs/wgpu/pull/8011). - Make a compacted hal acceleration structure inherit a label from the base BLAS. By [@&#8203;Vecvec](https://github.com/Vecvec) in [#&#8203;8103](https://github.com/gfx-rs/wgpu/pull/8103). - The limits requested for a device must now satisfy `min_subgroup_size <= max_subgroup_size`. By [@&#8203;andyleiserson](https://github.com/andyleiserson) in [#&#8203;8085](https://github.com/gfx-rs/wgpu/pull/8085). - Improve errors when buffer mapping is done incorrectly. Allow aliasing immutable \[`BufferViews`]. By [@&#8203;cwfitzgerald](https://github.com/cwfitzgerald) in [#&#8203;8150](https://github.com/gfx-rs/wgpu/pull/8150). - Require new `F16_IN_F32` downlevel flag for `quantizeToF16`, `pack2x16float`, and `unpack2x16float` in WGSL input. By [@&#8203;aleiserson](https://github.com/aleiserson) in [#&#8203;8130](https://github.com/gfx-rs/wgpu/pull/8130). - The error message for non-copyable depth/stencil formats no longer mentions the aspect when it is not relevant. By [@&#8203;reima](https://github.com/reima) in [#&#8203;8156](https://github.com/gfx-rs/wgpu/pull/8156). - Track the initialization status of buffer memory correctly when `copy_texture_to_buffer` skips over padding space between rows or layers, or when the start/end of a texture-buffer transfer is not 4B aligned. By [@&#8203;andyleiserson](https://github.com/andyleiserson) in [#&#8203;8099](https://github.com/gfx-rs/wgpu/pull/8099). ##### naga - naga now requires that no type be larger than 1 GB. This limit may be lowered in the future; feedback on an appropriate value for the limit is welcome. By [@&#8203;andyleiserson](https://github.com/andyleiserson) in [#&#8203;7950](https://github.com/gfx-rs/wgpu/pull/7950). - If the shader source contains control characters, naga now replaces them with U+FFFD ("replacement character") in diagnostic output. By [@&#8203;andyleiserson](https://github.com/andyleiserson) in [#&#8203;8049](https://github.com/gfx-rs/wgpu/pull/8049). - Add f16 IO polyfill on Vulkan backend to enable SHADER\_F16 use without requiring `storageInputOutput16`. By [@&#8203;cryvosh](https://github.com/cryvosh) in [#&#8203;7884](https://github.com/gfx-rs/wgpu/pull/7884). - For custom Naga backend authors: `naga::proc::Namer` now accepts reserved keywords using two new dedicated types, `proc::{KeywordSet, CaseInsensitiveKeywordSet}`. By [@&#8203;kpreid](https://github.com/kpreid) in [#&#8203;8136](https://github.com/gfx-rs/wgpu/pull/8136). - **BREAKING**: Previously the WGSL storage-texture format `rg11b10float` was incorrectly accepted and generated by naga, but now only accepts the the correct name `rg11b10ufloat` instead. By [@&#8203;ErikWDev](https://github.com/ErikWDev) in [#&#8203;8219](https://github.com/gfx-rs/wgpu/pull/8219). - The [`source()`](https://doc.rust-lang.org/std/error/trait.Error.html#method.source) method of `ShaderError` no longer reports the error as its own source. By [@&#8203;andyleiserson](https://github.com/andyleiserson) in [#&#8203;8258](https://github.com/gfx-rs/wgpu/pull/8258). - naga correctly ingests SPIR-V that use descriptor runtime indexing, which in turn is correctly converted into WGSLs binding array. By [@&#8203;hasenbanck](https://github.com/hasenbanck) in [8256](https://github.com/gfx-rs/wgpu/pull/8256). - naga correctly ingests SPIR-V that loads from multi-sampled textures, which in turn is correctly converted into WGSLs texture\_multisampled\_2d and load operations. By [@&#8203;hasenbanck](https://github.com/hasenbanck) in [8270](https://github.com/gfx-rs/wgpu/pull/8270). - naga implement OpImageGather and OpImageDrefGather operations when ingesting SPIR-V. By [@&#8203;hasenbanck](https://github.com/hasenbanck) in [8280](https://github.com/gfx-rs/wgpu/pull/8280). ##### DX12 - Allow disabling waiting for latency waitable object. By [@&#8203;marcpabst](https://github.com/marcpabst) in [#&#8203;7400](https://github.com/gfx-rs/wgpu/pull/7400) - Add mesh shader support, including to the example. By [@&#8203;SupaMaggie70Incorporated](https://github.com/SupaMaggie70Incorporated) in [#&#8203;8110](https://github.com/gfx-rs/wgpu/issues/8110) ##### Bug Fixes ##### General - Validate that effective buffer binding size is aligned to 4 when creating bind groups with buffer entries.. By [@&#8203;ErichDonGubler](https://github.com/ErichDonGubler) in [8041](https://github.com/gfx-rs/wgpu/pull/8041). ##### DX12 - Create an event per wait to prevent 60 second hangs in certain multithreaded scenarios. By [@&#8203;Vecvec](https://github.com/Vecvec) in [#&#8203;8273](https://github.com/gfx-rs/wgpu/pull/8273). - Fixed a bug where access to matrices with 2 rows would not work in some cases. By [@&#8203;andyleiserson](https://github.com/andyleiserson) in [#&#8203;7438](https://github.com/gfx-rs/wgpu/pull/7438). ##### EGL - Fixed unwrap failed in context creation for some Android devices. By [@&#8203;uael](https://github.com/uael) in [#&#8203;8024](https://github.com/gfx-rs/wgpu/pull/8024). ##### Vulkan - Fixed wrong color format+space being reported versus what is hardcoded in `create_swapchain()`. By [@&#8203;MarijnS95](https://github.com/MarijnS95) in [#&#8203;8226](https://github.com/gfx-rs/wgpu/pull/8226). ##### naga - \[wgsl-in] Allow a trailing comma in `@blend_src(…)` attributes. By [@&#8203;ErichDonGubler](https://github.com/ErichDonGubler) in [#&#8203;8137](https://github.com/gfx-rs/wgpu/pull/8137). - \[wgsl-in] Allow a trailing comma in the list of `case` values inside a `switch`. By [@&#8203;reima](https://github.com/reima) in [#&#8203;8165](https://github.com/gfx-rs/wgpu/pull/8165). - Escape, rather than strip, identifiers with Unicode. By [@&#8203;ErichDonGubler](https://github.com/ErichDonGubler) in [7995](https://github.com/gfx-rs/wgpu/pull/7995). ##### Documentation ##### General - Clarify that subgroup barriers require both the `SUBGROUP` and `SUBGROUP_BARRIER` features / capabilities. By [@&#8203;andyleiserson](https://github.com/andyleiserson) in [#&#8203;8203](https://github.com/gfx-rs/wgpu/pull/8203). </details> --- ### Configuration 📅 **Schedule**: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined). 🚦 **Automerge**: Disabled by config. Please merge this manually once you are satisfied. ♻ **Rebasing**: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox. 🔕 **Ignore**: Close this PR and you won't be reminded about this update again. --- - [ ] <!-- rebase-check -->If you want to rebase/retry this PR, check this box --- This PR has been generated by [Renovate Bot](https://github.com/renovatebot/renovate). <!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiI0My4zMS4xIiwidXBkYXRlZEluVmVyIjoiNDMuODQuMiIsInRhcmdldEJyYW5jaCI6Im1haW4iLCJsYWJlbHMiOltdfQ==-->
fix(deps): update rust crate wgpu to v29
Some checks failed
renovate/artifacts Artifact file update failure
Main / clippy (pull_request) Has been cancelled
Details
Main / rustfmt (pull_request) Has been cancelled
Details
Main / test (pull_request) Has been cancelled
Details
Main / check (pull_request) Has been cancelled
Details
Main / build (pull_request) Has been cancelled
Details
Main / release (pull_request) Has been cancelled
Details
420b3fd2f7
Renovate commented 2026-03-19 14:36:43 +01:00
Author
Collaborator
Copy link

⚠️ Artifact update problem

Renovate failed to update an artifact related to this branch. You probably do not want to merge this PR as-is.

♻ Renovate will retry this branch, including artifacts, only when one of the following happens:

  • any of the package files in this branch needs updating, or
  • the branch becomes conflicted, or
  • you click the rebase/retry checkbox if found above, or
  • you rename this PR's title to start with "rebase!" to trigger it manually

The artifact failure details are included below:

File name: Cargo.lock
spawn cargo ENOENT
### ⚠️ Artifact update problem Renovate failed to update an artifact related to this branch. You probably do not want to merge this PR as-is. ♻ Renovate will retry this branch, including artifacts, only when one of the following happens: - any of the package files in this branch needs updating, or - the branch becomes conflicted, or - you click the rebase/retry checkbox if found above, or - you rename this PR's title to start with "rebase!" to trigger it manually The artifact failure details are included below: ##### File name: Cargo.lock ``` spawn cargo ENOENT ```
Some checks are pending
renovate/artifacts Artifact file update failure
Main / clippy (pull_request) Has been cancelled
Details
Main / rustfmt (pull_request) Has been cancelled
Details
Main / test (pull_request) Has been cancelled
Details
Main / check (pull_request) Has been cancelled
Details
Main / build (pull_request) Has been cancelled
Details
Main / release (pull_request) Has been cancelled
Details
Forgejo-SakulFlee/Orbital/pipeline/*
Required
Some required checks are missing.
You are not authorized to merge this pull request.
View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u origin renovate/wgpu-29.x:renovate/wgpu-29.x
git switch renovate/wgpu-29.x
Sign in to join this conversation.
Reviewers
No reviewers
Labels
Clear labels   
Context: Async

Async specific, be it bug or feature

  
Context: Bug

Something isn't working as intended

  
Context: CI

GitHub Actions / CI related tasks

  
Context: Dependencies

Pull requests that update a dependency file

  
Context: Documentation

Improvements or additions to documentation

  
Context: Enhancement

New feature or request

  
Context: Example

Example related issues

  
Context: Macro

   
Context: Runtime

Runtime related issues

  
Difficulty: Easy

   
Difficulty: Hard

   
Difficulty: Medium

   
Platform: Android

ONLY if this is platform specific!

  
Platform: Linux

ONLY if this is platform specific!

  
Platform: Web

ONLY if this is platform specific!

  
Platform: Windows

ONLY if this is platform specific!

  
Platform: iOS

ONLY if this is platform specific!

  
Platform: macOS

ONLY if this is platform specific!

  
Type: Discussion

   
Type: Evaluation

Further evaluation is needed

  
Type: Tracker

Issues acting as trackers; I.e. a combination of issues of the same overall topic.

No labels
Context: Async
Context: Bug
Context: CI
Context: Dependencies
Context: Documentation
Context: Enhancement
Context: Example
Context: Macro
Context: Runtime
Difficulty: Easy
Difficulty: Hard
Difficulty: Medium
Platform: Android
Platform: Linux
Platform: Web
Platform: Windows
Platform: iOS
Platform: macOS
Type: Discussion
Type: Evaluation
Type: Tracker
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
SakulFlee/Orbital!635
No description provided.