feature: Timestamp queries

CHANGELOG.md

@@ -283,6 +283,15 @@ Some texture format names have changed to get back in line with the spec.
 
 By @cwfitzgerald in [#3671](https://github.com/gfx-rs/wgpu/pull/3671).
 
+#### Pass timestamp queries
+
+Addition of `TimestampWrites` to compute and render passes to allow profiling.
+This brings us in line with the spec.
+
+Added new example to demonstrate the various kinds of timestamps.
+
+By @FL33TW00D & @wumpf in [#3636](https://github.com/gfx-rs/wgpu/pull/3636).
+
 #### Misc Breaking Changes
 
 - Change type of `mip_level_count` and `array_layer_count` (members of `TextureViewDescriptor` and `ImageSubresourceRange`) from `Option<NonZeroU32>` to `Option<u32>`. By @teoxoy in [#3445](https://github.com/gfx-rs/wgpu/pull/3445)

deno_webgpu/command_encoder.rs

@@ -175,6 +175,7 @@ pub fn op_webgpu_command_encoder_begin_render_pass(
         label: label.map(Cow::from),
         color_attachments: Cow::from(color_attachments),
         depth_stencil_attachment: processed_depth_stencil_attachment.as_ref(),
+        timestamp_writes: None,
     };
 
     let render_pass = wgpu_core::command::RenderPass::new(command_encoder_resource.1, &descriptor);
@@ -200,6 +201,7 @@ pub fn op_webgpu_command_encoder_begin_compute_pass(
 
     let descriptor = wgpu_core::command::ComputePassDescriptor {
         label: label.map(Cow::from),
+        timestamp_writes: None,
     };
 
     let compute_pass =

deno_webgpu/error.rs

@@ -104,7 +104,9 @@ impl From<DeviceError> for WebGpuError {
         match err {
             DeviceError::Lost => WebGpuError::Lost,
             DeviceError::OutOfMemory => WebGpuError::OutOfMemory,
-            DeviceError::Invalid => WebGpuError::Validation(fmt_err(&err)),
+            DeviceError::ResourceCreationFailed | DeviceError::Invalid => {
+                WebGpuError::Validation(fmt_err(&err))
+            }
         }
     }
 }

examples/boids/src/main.rs

@@ -283,6 +283,7 @@ impl wgpu_example::framework::Example for Example {
             label: None,
             color_attachments: &color_attachments,
             depth_stencil_attachment: None,
+            timestamp_writes: None,
         };
 
         // get command encoder
@@ -292,8 +293,10 @@ impl wgpu_example::framework::Example for Example {
         command_encoder.push_debug_group("compute boid movement");
         {
             // compute pass
-            let mut cpass =
-                command_encoder.begin_compute_pass(&wgpu::ComputePassDescriptor { label: None });
+            let mut cpass = command_encoder.begin_compute_pass(&wgpu::ComputePassDescriptor {
+                label: None,
+                timestamp_writes: None,
+            });
             cpass.set_pipeline(&self.compute_pipeline);
             cpass.set_bind_group(0, &self.particle_bind_groups[self.frame_num % 2], &[]);
             cpass.dispatch_workgroups(self.work_group_count, 1, 1);

examples/bunnymark/src/main.rs

@@ -336,6 +336,7 @@ impl wgpu_example::framework::Example for Example {
                     },
                 })],
                 depth_stencil_attachment: None,
+                timestamp_writes: None,
             });
             rpass.set_pipeline(&self.pipeline);
             rpass.set_bind_group(0, &self.global_group, &[]);

examples/capture/src/main.rs

@@ -104,6 +104,7 @@ async fn create_red_image_with_dimensions(
                 },
             })],
             depth_stencil_attachment: None,
+            timestamp_writes: None,
         });
 
         // Copy the data from the texture to the buffer

examples/conservative-raster/src/main.rs

@@ -273,6 +273,7 @@ impl wgpu_example::framework::Example for Example {
                     },
                 })],
                 depth_stencil_attachment: None,
+                timestamp_writes: None,
             });
 
             rpass.set_pipeline(&self.pipeline_triangle_conservative);
@@ -292,6 +293,7 @@ impl wgpu_example::framework::Example for Example {
                     },
                 })],
                 depth_stencil_attachment: None,
+                timestamp_writes: None,
             });
 
             rpass.set_pipeline(&self.pipeline_upscale);

examples/cube/src/main.rs

@@ -379,6 +379,7 @@ impl wgpu_example::framework::Example for Example {
                     },
                 })],
                 depth_stencil_attachment: None,
+                timestamp_writes: None,
             });
             rpass.push_debug_group("Prepare data for draw.");
             rpass.set_pipeline(&self.pipeline);

examples/hello-compute/src/main.rs

@@ -131,7 +131,10 @@ async fn execute_gpu_inner(
     let mut encoder =
         device.create_command_encoder(&wgpu::CommandEncoderDescriptor { label: None });
     {
-        let mut cpass = encoder.begin_compute_pass(&wgpu::ComputePassDescriptor { label: None });
+        let mut cpass = encoder.begin_compute_pass(&wgpu::ComputePassDescriptor {
+            label: None,
+            timestamp_writes: None,
+        });
         cpass.set_pipeline(&compute_pipeline);
         cpass.set_bind_group(0, &bind_group, &[]);
         cpass.insert_debug_marker("compute collatz iterations");

examples/hello-compute/src/tests.rs

@@ -12,6 +12,7 @@ fn test_compute_1() {
         TestParameters::default()
             .downlevel_flags(wgpu::DownlevelFlags::COMPUTE_SHADERS)
             .limits(wgpu::Limits::downlevel_defaults())
+            .features(wgpu::Features::TIMESTAMP_QUERY)
             .specific_failure(None, None, Some("V3D"), true),
         |ctx| {
             let input = &[1, 2, 3, 4];
@@ -33,6 +34,7 @@ fn test_compute_2() {
         TestParameters::default()
             .downlevel_flags(wgpu::DownlevelFlags::COMPUTE_SHADERS)
             .limits(wgpu::Limits::downlevel_defaults())
+            .features(wgpu::Features::TIMESTAMP_QUERY)
             .specific_failure(None, None, Some("V3D"), true),
         |ctx| {
             let input = &[5, 23, 10, 9];
@@ -54,6 +56,7 @@ fn test_compute_overflow() {
         TestParameters::default()
             .downlevel_flags(wgpu::DownlevelFlags::COMPUTE_SHADERS)
             .limits(wgpu::Limits::downlevel_defaults())
+            .features(wgpu::Features::TIMESTAMP_QUERY)
             .specific_failure(None, None, Some("V3D"), true),
         |ctx| {
             let input = &[77031, 837799, 8400511, 63728127];
@@ -74,6 +77,7 @@ fn test_multithreaded_compute() {
         TestParameters::default()
             .downlevel_flags(wgpu::DownlevelFlags::COMPUTE_SHADERS)
             .limits(wgpu::Limits::downlevel_defaults())
+            .features(wgpu::Features::TIMESTAMP_QUERY)
             .specific_failure(None, None, Some("V3D"), true)
             // https://github.com/gfx-rs/wgpu/issues/3944
             .specific_failure(

examples/hello-triangle/src/main.rs

@@ -122,6 +122,7 @@ async fn run(event_loop: EventLoop<()>, window: Window) {
                             },
                         })],
                         depth_stencil_attachment: None,
+                        timestamp_writes: None,
                     });
                     rpass.set_pipeline(&render_pipeline);
                     rpass.draw(0..3, 0..1);

examples/hello-windows/src/main.rs

@@ -135,6 +135,7 @@ async fn run(event_loop: EventLoop<()>, viewports: Vec<(Window, wgpu::Color)>) {
                                 },
                             })],
                             depth_stencil_attachment: None,
+                            timestamp_writes: None,
                         });
                     }
 

examples/mipmap/src/main.rs

@@ -167,6 +167,7 @@ impl Example {
                     },
                 })],
                 depth_stencil_attachment: None,
+                timestamp_writes: None,
             });
             if let Some(ref query_sets) = query_sets {
                 rpass.write_timestamp(&query_sets.timestamp, timestamp_query_index_base);
@@ -492,6 +493,7 @@ impl wgpu_example::framework::Example for Example {
                     },
                 })],
                 depth_stencil_attachment: None,
+                timestamp_writes: None,
             });
             rpass.set_pipeline(&self.draw_pipeline);
             rpass.set_bind_group(0, &self.bind_group, &[]);

examples/msaa-line/src/main.rs

@@ -300,6 +300,7 @@ impl wgpu_example::framework::Example for Example {
                     label: None,
                     color_attachments: &[Some(rpass_color_attachment)],
                     depth_stencil_attachment: None,
+                    timestamp_writes: None,
                 })
                 .execute_bundles(iter::once(&self.bundle));
         }

examples/shadow/src/main.rs

@@ -777,6 +777,7 @@ impl wgpu_example::framework::Example for Example {
                         }),
                         stencil_ops: None,
                     }),
+                    timestamp_writes: None,
                 });
                 pass.set_pipeline(&self.shadow_pass.pipeline);
                 pass.set_bind_group(0, &self.shadow_pass.bind_group, &[]);
@@ -819,6 +820,7 @@ impl wgpu_example::framework::Example for Example {
                     }),
                     stencil_ops: None,
                 }),
+                timestamp_writes: None,
             });
             pass.set_pipeline(&self.forward_pass.pipeline);
             pass.set_bind_group(0, &self.forward_pass.bind_group, &[]);

examples/skybox/src/main.rs

@@ -439,6 +439,7 @@ impl wgpu_example::framework::Example for Skybox {
                     }),
                     stencil_ops: None,
                 }),
+                timestamp_writes: None,
             });
 
             rpass.set_bind_group(0, &self.bind_group, &[]);

examples/stencil-triangles/src/main.rs

@@ -211,6 +211,7 @@ impl wgpu_example::framework::Example for Triangles {
                         store: true,
                     }),
                 }),
+                timestamp_writes: None,
             });
 
             rpass.set_stencil_reference(1);

examples/texture-arrays/src/main.rs

@@ -383,6 +383,7 @@ impl wgpu_example::framework::Example for Example {
                 },
             })],
             depth_stencil_attachment: None,
+            timestamp_writes: None,
         });
 
         rpass.set_pipeline(&self.pipeline);

examples/timestamp-queries/Cargo.toml

@@ -0,0 +1,30 @@
+[package]
+name = "wgpu-timestamp-queries-example"
+version.workspace = true
+license.workspace = true
+edition.workspace = true
+description = "wgpu timestamp query example"
+publish = false
+
+[[bin]]
+name = "timestamp-queries"
+path = "src/main.rs"
+
+[dependencies]
+bytemuck.workspace = true
+env_logger.workspace = true
+futures-intrusive.workspace = true
+pollster.workspace = true
+wgpu.workspace = true
+winit.workspace = true
+
+[target.'cfg(target_arch = "wasm32")'.dependencies]
+console_error_panic_hook.workspace = true
+console_log.workspace = true
+log.workspace = true
+wasm-bindgen-futures.workspace = true
+
+[dev-dependencies]
+wasm-bindgen-test.workspace = true
+wgpu-test.workspace = true
+

examples/timestamp-queries/README.md

@@ -0,0 +1,9 @@
+# timestamp-queries
+
+This example shows various ways of querying time when supported.
+
+## To Run
+
+```
+cargo run --bin timestamp-queries
+```