WebGPU 的新变化 (Chrome 116)

François Beaufort

WebCodecs 集成

WebGPU 公开了一个用于创建不透明“外部纹理”的 API从 HTMLVideoElement 到 importExternalTexture() 的对象。您可以使用这些对象高效地对视频帧进行采样，可能以 0 复制的方式直接从源 YUV 颜色模型数据中进行采样。

不过，最初的 WebGPU 规范不允许通过 WebCodecs VideoFrame 对象创建 GPUExternalTexture 对象。对于已使用 WebCodecs 并希望在视频处理流水线中集成 WebGPU 的高级视频处理应用，此功能非常重要。WebCodecs 集成增加了以下支持：将 VideoFrame 用作 GPUExternalTexture 和 copyExternalImageToTexture() 调用的来源。请参阅以下示例以及 chromestatus 条目。

// Access the GPU device.
const adapter = await navigator.gpu.requestAdapter();
const device = await adapter.requestDevice();

// Create VideoFrame from HTMLVideoElement.
const video = document.querySelector("video");
const videoFrame = new VideoFrame(video);

// Create texture from VideoFrame.
const texture = device.importExternalTexture({ source: videoFrame });
// TODO: Use texture in bind group creation.

请查看使用 WebCodecs 上传视频实验性示例。

GPUAdapter requestDevice() 返回丢失的设备

如果 GPUAdapter 上的 requestDevice() 方法因已用于创建 GPUDevice 而失败，那么该方法现在会在执行时立即标记为已丢失，而不是返回在拒绝时返回 null。GPUDevice请参阅问题 chromium:1234617。

const adapter = await navigator.gpu.requestAdapter();
const device1 = await adapter.requestDevice();

// New! The promise is not rejected anymore with null.
const device2 = await adapter.requestDevice();
// And the device is immediately marked as lost.
const info = await device2.lost;

如果调用 importExternalTexture()，则确保视频播放流畅

使用 HTMLVideoElement 调用 importExternalTexture() 时，如果视频在视口中不可见，则关联的视频播放不会再受限。请参阅问题 chromium:1425252。

规范合规性

GPUPipelineError() 构造函数中的 message 参数是可选的。请参阅更改 chromium:4613967。

如果 WGSL 源文件 code 包含 \0，则在调用 createShaderModule() 时会触发错误。请参阅问题 dawn:1345。

使用 createSampler() 对纹理进行采样时使用的默认最大细节级别 (lodMaxClamp) 为 32。请参阅更改 chromium:4608063。

改善开发者体验

当开发者在不受支持的平台上使用 WebGPU 时，开发者工具 JavaScript 控制台中会显示一条消息，提醒开发者。请参阅更改 chromium:4589369。

当 getMappedRange() 失败时，缓冲区验证错误消息会立即显示在开发者工具 JavaScript 控制台中，而不会强制开发者向队列发送命令。请参阅更改 chromium:4597950。

<ph type="x-smartling-placeholder">

</ph> <ph type="x-smartling-placeholder">

</ph> 开发者工具 JavaScript 控制台中的缓冲区验证错误消息。

Dawn 最新动态

disallow_unsafe_apis 调试切换开关已重命名为 allow_unsafe_apis，并默认处于停用状态。此切换开关可抑制尚不安全的 API 入口点或参数组合上的验证错误。它对于调试可能很有用。 请参阅问题 dawn:1685。

移除了 wgpu::ShaderModuleWGSLDescriptor 已弃用的 source 属性，取而代之的是 code。请参阅 change dawn:130321。

已实现缺少的 wgpu::RenderBundle::SetLabel() 方法。请参阅 change dawn:134502。

应用可以在使用 wgpu::RequestAdapterOptionsBackendType 选项获取适配器时请求特定的后端。请参阅下面的示例和issue dawn:1875。

wgpu::RequestAdapterOptionsBackendType backendTypeOptions = {};
backendTypeOptions.backendType = wgpu::BackendType::D3D12;

wgpu::RequestAdapterOptions options = {};
options.nextInChain = &backendTypeOptions;

// Request D3D12 adapter.
myInstance.RequestAdapter(&options, myCallback, myUserData);

添加了新的 SwapChain::GetCurrentTexture() 方法，并为交换链纹理添加了额外的用途，以便在副本中使用返回的 wgpu::Texture。请参阅下面的示例和问题 dawn:1551。

wgpu::SwapChain swapchain = myDevice.CreateSwapChain(mySurface, &myDesc);
swapchain.GetCurrentTexture();
swapchain.Present();

本指南仅涵盖部分重要内容。查看详尽的提交内容列表。

WebGPU 的新变化

WebGPU 新变化系列涵盖的所有内容的列表。

Chrome 128

• 对子群组进行实验
• 不再为线和点设置深度偏差
• 如果 preventDefault，则隐藏开发者工具警告中未捕获的错误
• WGSL 先内插采样，然后执行以下任一操作
• Dawn 最新动态

Chrome 127

• 在 Android 上为 OpenGL ES 提供实验性支持
• GPUAdapter 信息属性
• WebAssembly 互操作性改进
• 改进了命令编码器错误
• Dawn 最新动态

Chrome 126

• 提高 maxTextureArrayLayers 限制
• 针对 Vulkan 后端的缓冲区上传优化
• 着色器编译时间改进
• 提交的命令缓冲区必须是唯一的
• Dawn 最新动态

Chrome 125

• 子群组（功能尚处于开发阶段）
• 渲染到 3D 纹理切片
• Dawn 最新动态

Chrome 124

• 只读和读写存储纹理
• Service Worker 和共享 Worker 支持
• 新的适配器信息属性
• bug 修复
• Dawn 最新动态

Chrome 123

• WGSL 中的 DP4a 内置函数支持
• WGSL 中的无限制指针参数
• WGSL 中用于解引用复合的语法糖
• 单独的模板和深度切面的只读状态
• Dawn 最新动态

Chrome 122

• 利用兼容模式扩大覆盖面（功能尚处于开发阶段）
• 提高 maxVertexAttributes 限制
• Dawn 最新动态

Chrome 121

• 在 Android 上支持 WebGPU
• 在 Windows 上使用 DXC（而非 FXC）进行着色器编译
• 计算通道和渲染通道中的时间戳查询
• 着色器模块的默认入口点
• 支持 display-p3 作为 GPUExternalTexture 颜色空间
• 内存堆信息
• Dawn 最新动态

Chrome 120

• 在 WGSL 中支持 16 位浮点值
• 突破极限
• 对深度模板状态的更改
• 适配器信息更新
• 时间戳查询量化
• 春季大扫除功能

Chrome 119

• 可过滤的 32 位浮点纹理
• unorm10-10-10-2 顶点格式
• rgb10a2uint 纹理格式
• Dawn 最新动态

Chrome 118

• copyExternalImageToTexture() 中的 HTMLImageElement 和 ImageData 支持
• 对读写和只读存储纹理的实验性支持
• Dawn 最新动态

Chrome 117

• 取消设置顶点缓冲区
• 取消设置绑定群组
• 当设备丢失时，让创建异步流水线时出错
• SPIR-V 着色器模块创建更新
• 改善开发者体验
• 使用自动生成的布局缓存流水线
• Dawn 最新动态

Chrome 116

• WebCodecs 集成
• GPUAdapter 返回的设备丢失requestDevice()
• 如果调用 importExternalTexture()，则保持视频播放流畅
• 规范合规性
• 改善开发者体验
• Dawn 最新动态

Chrome 115

• 支持的 WGSL 语言扩展
• 对 Direct3D 11 的实验性支持
• 默认为使用交流电源的独立 GPU
• 改善开发者体验
• Dawn 最新动态

Chrome 114

• 优化 JavaScript
• 未配置的画布上的 getCurrentTexture() 会抛出 InvalidStateError
• WGSL 更新
• Dawn 最新动态

Chrome 113

• 在 importExternalTexture() 中使用 WebCodecs VideoFrame 源代码