Skip to content

Commit 47be7dc

Browse files
docs(CHANGELOG): polish enumerate_adapters-is-async section
1 parent a8f51f8 commit 47be7dc

File tree

1 file changed

+8
-4
lines changed

1 file changed

+8
-4
lines changed

CHANGELOG.md

Lines changed: 8 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -40,18 +40,22 @@ Bottom level categories:
4040

4141
## Unreleased
4242

43-
#### 'wgpu::Instance::enumerate_adapters` is now `async` & available on WebGPU
43+
### Major changes
4444

45-
Making `enumerate_adapters` async allows custom backends to use it along with eliminating some native/non-native distinctions
45+
#### 'wgpu::Instance::enumerate_adapters` is now `async` & available on WebGPU
4646

47-
This is a breaking change
47+
BREAKING CHANGE: `enumerate_adapters` is now `async`:
4848

4949
```diff
5050
- pub fn enumerate_adapters(&self, backends: Backends) -> Vec<Adapter> {
5151
+ pub fn enumerate_adapters(&self, backends: Backends) -> impl Future<Output = Vec<Adapter>> {
52-
5352
```
5453

54+
This yields two benefits:
55+
56+
- This method is now implemented on non-native using the standard `Adapter::request_adapter(…)`, making `enumerate_adapters` a portable surface. This was previous a nontrivial pain point when an application wanted to do some of its own filtering of adapters.
57+
- This method can now be implemented in custom backends.
58+
5559
By @R-Cramer4 in [#8230](https://github.com/gfx-rs/wgpu/pull/8230)
5660

5761
#### `MipmapFilterMode` is split from `FilterMode`

0 commit comments

Comments
 (0)