Module profiler 

Available on crate feature preview only.

In-app profiler panel for the preview app (CPU + GPU + uploads).

The main view is a progress chart: the X axis is scene progress (0..total_sec, one bucket per logic frame) and every rendered frame writes its sample into the bucket at the current timeline position — playing, seeking or dragging the chart progressively fills (and on revisit, refreshes) the samples, so performance variation across the animation becomes visible. The chart can be clicked/dragged to seek.

CPU spans (crate::render::cpu_probe) and upload stats (crate::render::upload_probe) work in any build; GPU pass scopes need the profiling feature and a device with timestamp query support. Upload strategy modes can be switched live.

Structs

ProgressSample 🔒

One sampled rendering of the scene at a specific timeline position.

Enums

ProfilerMetric 🔒

Metric drawn in the progress chart. Stackable metrics (GpuPasses, CpuSpans) render as a stacked color chart when the panel’s profiler_stacked toggle is on, and as a plain total otherwise.

Constants

PASS_PALETTE 🔒

Fixed palette for per-pass stacked bars, keyed by pass-label order.

Functions

flatten_scopes 🔒

Flatten a wgpu-profiler scope tree into (label, μs) pairs.

gpu_timer_features 🔒

GPU timer features requested from eframe’s device so wgpu-profiler scopes produce results (intersected with adapter support at the call site, so device creation can never fail because of them).

pass_color 🔒

record_sample 🔒

Record the just-rendered frame into the progress-sample bucket at the current timeline position. Called from render_animation.

share_bar 🔒

ui_cpu_spans 🔒

ui_gpu_passes 🔒

ui_profiler_window 🔒

ui_progress_chart 🔒

X axis = scene progress; click/drag to seek, hover for the sample values.

ui_stacked_legend 🔒

Legend for the stacked pass/span colors.

ui_summary 🔒

ui_uploads 🔒

x_to_sec 🔒