此页面由 Cloud Translation API 翻译。

WebGPU 的新变化 (Chrome 115)

François Beaufort

支持的 WGSL 语言扩展

GPU 对象的 wgslLanguageFeatures 成员列出了受支持的 WGSL 语言扩展程序的名称。系统会自动启用受支持的 WGSL 语言扩展，因此您无需明确请求。此列表目前为空，但未来会有很多（例如 do-while loops）。请参阅问题 dawn:1777。

if (navigator.gpu.wgslLanguageFeatures?.has("unknown-feature")) {
  // Use unknown-feature in WGSL shader code.
}

对 Direct3D 11 的实验性支持

Chromium 团队正在努力添加对 Direct3D 11 的 WebGPU 支持。现在，您可以在 Windows 上运行 Chrome 并使用 --enable-unsafe-webgpu --use-webgpu-adapter=d3d11 命令行标志，在本地试用该功能。请参阅问题 dawn:1705。

在交流电源供电时默认获取独立 GPU

在双 GPU macOS 设备上，如果调用 requestAdapter() 时未指定 powerPreference 选项，则当用户设备使用交流电源时，系统会返回独立 GPU。否则，返回集成 GPU。请参阅变更 4499307。

改善开发者体验

新的开发者工具警告

如果在 GPUExtend3DDict 中使用 depth 键，开发者工具控制台中会显示警告，因为正确的键是 depthOrArrayLayers。请参阅问题 chromium:1440900。

如果 GPUBlendComponent 同时包含显式成员和默认成员，系统也会发出警告。请参阅问题 dawn:1785。

即使零大小的调度和绘制有效，警告也会鼓励开发者尽可能避免使用它们。请参阅问题 dawn:1786。

改进了错误消息

现在，如果已调用 finish()，则在使用 GPUCommandEncoder 时会提供改进的错误消息。请参阅问题 dawn:1736。

提交包含已销毁对象的命令缓冲区时，submit() 中使用的命令缓冲区的标签现在会显示在错误消息中。请参阅问题 dawn:1747。

现在，验证 depthStencil 时，错误消息中会指定深度模具状态的无效部分。请参阅问题 dawn:1735。

minBindingSize 验证错误消息现在会报告未通过验证的绑定组和编号，以及缓冲区。请参阅问题 dawn:1604。

改进了 GPUBuffer 对象上 mapAsync() 方法返回的错误消息，以帮助开发者进行调试。请参阅下面的示例和问题 chromium:1431622。

// Create a GPU buffer and map it.
const descriptor = { size: 0, usage: GPUBufferUsage.MAP_READ };
const buffer = device.createBuffer(descriptor);
buffer.mapAsync(GPUMapMode.READ);

// Before it has been mapped, request another mapping.
try {
  await buffer.mapAsync(GPUMapMode.READ);
} catch (error) {
  // New! Error message tells you mapping is already pending.
  console.warn(error.message);
}

macOS 调试工具中的标签

借助 use_user_defined_labels_in_backend 调试切换开关，您可以将对象标签转发到后端，以便在 RenderDoc、PIX 或 Instruments 等特定于平台的调试工具中查看这些标签。从现在起，在 macOS 上启用调试功能后，您将获得更好的调试体验。请参阅问题 dawn:1784

macOS 上 Instruments 应用的屏幕截图，其中显示了来自 WebGPU 的自定义标签。 — macOS 上 Instruments 应用中的用户定义标签。

如果编译失败，则记录 HLSL

借助 dump_shaders 调试切换开关，您可以记录输入 WGSL 着色器和已翻译的后端着色器。从现在开始，当您启用此功能进行调试时，如果 HLSL 编译失败，系统会转储 HLSL。请参阅问题 dawn:1681

Dawn 更新

未设置顶点缓冲区

如果向 wgpu::RenderPassEncoder 或 wgpu::RenderBundleEncoder 上的 SetVertexBuffer() 传递 nullptr 而不是 wgpu::Buffer，则可以取消设置给定 slot 中之前设置的顶点缓冲区。请参阅问题 dawn:1675。

// Set vertex buffer in slot 0.
myRenderPassEncoder.SetVertexBuffer(0, myVertexBuffer);

// Then later, unset vertex buffer in slot 0.
myRenderPassEncoder.SetVertexBuffer(0, nullptr);

临时附件

您可以创建附件，使渲染通道操作保留在 tile 内存中，从而避免 VRAM 流量，并可能通过设置 wgpu::TextureUsage::TransientAttachment 用途来避免为纹理分配 VRAM。此功能仅适用于 Metal 和 Vulkan。请参阅问题 dawn: 1695。

wgpu::TextureDescriptor desc;
desc.format = wgpu::TextureFormat::RGBA8Unorm;
desc.size = {1, 1, 1};
desc.usage = wgpu::TextureUsage::RenderAttachment |
             wgpu::TextureUsage::TransientAttachment;

auto transientTexture = device.CreateTexture(&desc);

// You can now create views from the texture to serve as transient
// attachments, e.g. as color attachments in a render pipeline.

不使用 `depot_tools` 进行构建

借助新的 DAWN_FETCH_DEPENDENCIES CMake 选项，您可以使用读取 DEPS 文件的 Python 脚本来获取 Dawn 依赖项，而无需所有依赖于它的项目都安装 depot_tools。请参阅更改 131750。