Skip to content

v0.13.0
Compare
Choose a tag to compare
@cwfitzgerald cwfitzgerald released this 01 Jul 16:51
· 30 commits to v0.13 since this release
v0.13.0
e125321
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.

This release includes wgpu, wgpu-core, wgpu-hal, and wgpu-types.

Major Changes

WGSL Syntax

WGSL syntax has changed in a couple ways. The new syntax is easier to read and work with.

Attribute declarations are written differently:

- [[group(1), binding(0)]]
+ @group(1) @binding(0)

Stage declarations are now separate attributes rather than part of the stage attribute:

- [[stage(vertex)]]
+ @vertex

Structs now use , as field separator and no longer need semicolons after the declaration:

- struct MyStruct {
-     my_member: u32;
- };
+ struct MyStruct {
+     my_member: u32,
+ }

Surface API

The method of getting the preferred swapchain format has changed to allow viewing all formats supported by the surface.

- let format = surface.get_preferred_format(&adapter).unwrap();
+ let format = surface.get_supported_formats(&adapter)[0];

Presentation modes now need to match exactly what the surface supports. FIFO is always supported,
but all other modes vary from API to API and Device to Device. To get a list of all supported modes,
call the following. The order does not indicate preference.

let modes = surface.get_supported_present_modes(&adapter);

Timestamp Queries

Timestamp queries are now restricted behind multiple features to allow implementation on TBDR (Tile-Based Deferred Rendering)
based GPUs, such as mobile devices and Apple's M chips.

Features::TIMESTAMP_QUERIES now allows for calling write_timestamp only on CommandEncoders.

Features::WRITE_TIMESTAMP_INSIDE_PASSES is needed to call write_timestamp on RenderPassEncoders or ComputePassEncoders.

map_async

The function for mapping buffers no longer returns a future, and instead calls a callback when the buffer is mapped.

This aligns with the use of the API more clearly - you aren't supposed to block and wait on the future to resolve,
you are supposed to keep rendering and wait until the buffer maps on its own. Mapping and the flow of mapping
is an under-documented area that we hope to improve in the future.

- let future = buffer.slice(..).map_async(MapMode::Read);
+ buffer.slice(..).map_async(MapMode::Read, || {
+     // Called when buffer is mapped.  
+ })

Submission Indexes

Calling queue.submit now returns an opaque submission index that can be used as an argument to
device.poll to say which submission to wait to complete.

Other Breaking Changes

Device::create_shader_module now takes the shader descriptor by value:

- device.create_shader_module(&shader_module_descriptor)
+ device.create_shader_module(shader_module_descriptor)

Color attachments can be sparse, so they are now optional:

FragmentState {
-  targets: &[color_target_state]
+  targets: &[Some(color_target_state)]
  // ..
}
RenderPassDescriptor {
-  color_attachments: &[render_pass_color_attachment]
+  color_attachments: &[Some(render_pass_color_attachment)]
  // ..
}
RenderBundleEncoderDescriptor {
-  color_formats: &[texture_format]
+  color_formats: &[Some(texture_format)]
  // ..
}

Extent3d::max_mips now requires you to pass a TextureDimension to specify whether or not depth_or_array_layers should be ignored:

Extent3d {
  width: 1920,
  height: 1080,
  depth_or_array_layers: 6,
- }.max_mips()
+ }.max_mips(wgpu::TextureDimension::D3)

Limits has a new field, max_buffer_size (not an issue if you don't define limits manually):

Limits {
  // ...
+ max_buffer_size: 256 * 1024 * 1024, // adjust as you see fit
}

ComputePass::dispatch has been renamed to ComputePass::dispatch_workgroups

- cpass.dispatch(self.work_group_count, 1, 1)
+ cpass.dispatch_workgroups(self.work_group_count, 1, 1)

Added/New Features

General

Vulkan

  • Re-allow vk backend on Apple platforms via vulkan-portability feature by @jinleili in #2488
  • vulkan: HDR ASTC formats support by @jinleili in #2496

Metal

GLES

DX12

DX11

Hal

  • Adapter and Instance as_hal functions by @i509VCB in #2663
  • expose some underlying types in Vulkan hal by @i509VCB in #2667
  • Add raw_device method for dx12, vulkan hal by @xiaopengli89 in #2360
  • expose egl display in gles Instance hal by @i509VCB in #2670
  • Add raw_adapter method for dx12 hal adapter by @xiaopengli89 in #2714
  • Acquire texture: Option<std::time::Duration> timeouts by @rib in #2724
  • expose vulkan physical device capabilities, enabled device extensions by @i509VCB in #2688

Emscripten

Changes

General

Gles

Metal

  • metal: check if in the main thread when calling create_surface by @jinleili in #2736

Hal

Bug Fixes

General

Metal

  • Fix surface texture clear view by @kvark in #2341
  • Set preserveInvariance for shader options by @scoopr in #2372
  • Properly set msl version to 2.3 if supported by @cwfitzgerald in #2418
  • Identify Apple M1 GPU as integrated by @superdump in #2429
  • Fix M1 in macOS incorrectly reports supported compressed texture formats by @superdump in #2453
  • Msl: support unsized array not in structures by @kvark in #2459
  • Fix Surface::from_uiview can not guarantee set correct contentScaleFactor by @jinleili in #2470
  • Set max_buffer_size by the correct physical device restriction by @jinleili in #2502
  • Refactor PrivateCapabilities creation by @jinleili in #2509
  • Refactor texture_format_capabilities function by @jinleili in #2522
  • Improve push | pop_debug_marker by @jinleili in #2537
  • Fix some supported limits by @jinleili in #2608
  • Don't skip incomplete binding resources. by @dragostis in #2622
  • Fix Rgb9e5Ufloat capabilities and sampler_lod_average support by @jinleili in #2656
  • Fix Depth24Plus | Depth24PlusStencil8 capabilities by @jinleili in #2686
  • Get_supported_formats: sort like the old get_preferred_format and simplify return type by @victorvde in #2786
  • Restrict hal::TextureUses::COLOR_TARGET condition within create_texture by @jinleili in #2818

DX12

Vulkan

GLES

Wayland

  • Search for different versions of libwayland by @sh7dm in #2336

WebGPU

Emscripten

Performance

Documentation

Dependency Updates

deno-webgpu

Examples

Testing/Internal

Contributors

scoopr, davidar, and 54 other contributors
Assets 2
Loading