@@ -1640,22 +1640,26 @@ interface GPU {
16401640
16411641 : <dfn>getPreferredCanvasFormat()</dfn>
16421642 ::
1643- Returns an optimal {{GPUTextureFormat}} to use when calling
1644- {{GPUCanvasContext/configure()}} on a {{GPUCanvasContext}}, for displaying
1645- 8-bit depth, standard dynamic range content to the screen: either
1646- {{GPUTextureFormat/"rgba8unorm"}} or {{GPUTextureFormat/"bgra8unorm"}}.
1643+ Returns an optimal {{GPUTextureFormat}} for displaying 8-bit depth, standard dynamic range
1644+ content on this system. Must only return {{GPUTextureFormat/"rgba8unorm"}} or
1645+ {{GPUTextureFormat/"bgra8unorm"}}.
16471646
1648- Canvases which are not displayed to the screen may or may not benefit from
1649- using this format.
1647+ The returned value can be passed as the {{GPUCanvasConfiguration/format}} to
1648+ {{GPUCanvasContext/configure()}} calls on a {{GPUCanvasContext}} to ensure the associated
1649+ canvas is able to display its contents efficiently.
1650+
1651+ Note: Canvases which are not displayed to the screen may or may not benefit from using this
1652+ format.
16501653
16511654 <div algorithm="GPU.getPreferredCanvasFormat">
16521655 **Called on:** {{GPU}} this.
16531656
16541657 **Returns:** {{GPUTextureFormat}}
16551658
16561659 <div class=content-timeline>
1657- 1. Out of {{GPUTextureFormat/"rgba8unorm"}} and {{GPUTextureFormat/"bgra8unorm"}},
1658- return the format which is optimal for displaying WebGPU canvases on this system.
1660+ 1. Return either {{GPUTextureFormat/"rgba8unorm"}} or
1661+ {{GPUTextureFormat/"bgra8unorm"}}, depending on which format is optimal for
1662+ displaying WebGPU canvases on this system.
16591663 </div>
16601664 </div>
16611665</dl>
0 commit comments