此页面由 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 支持。现在，您可以使用 --enable-unsafe-webgpu --use-webgpu-adapter=d3d11 命令行标志在 Windows 上运行 Chrome，从而在本地进行实验。请参阅问题 dawn:1705。

交流电源默认使用独立的 GPU

在 macOS 双 GPU 设备上，如果在未使用 powerPreference 选项的情况下调用 requestAdapter()，当用户的设备使用交流电源供电时，系统会返回独立的 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 进行调试后，您就能在 macOS 上提供更好的调试体验。请参阅问题 dawn:1784

macOS 上“Instruments”应用的屏幕截图，其中包含来自 WebGPU 的自定义标签。 — macOS 上的“Instruments”应用中用户定义的标签。

在编译失败时记录 HLSL

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

黎明动态

取消设置顶点缓冲区

在 wgpu::RenderPassEncoder 或 wgpu::RenderBundleEncoder 上将 nullptr（而非 wgpu::Buffer）传递给 SetVertexBuffer() 可让您取消设置之前在给定槽位中设置的顶点缓冲区。请参阅问题 dawn:1675。

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

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

暂时性附件

您可以创建附件，以允许渲染通道操作保留在图块内存中，从而避免 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。