diff --git a/src/toplevel_export.rs b/src/toplevel_export.rs index 771b7c7..78bee61 100644 --- a/src/toplevel_export.rs +++ b/src/toplevel_export.rs @@ -218,14 +218,12 @@ pub async fn capture_via_export_for( capture_with_state(conn, manager, output, dest, event_queue).await } -/// Public entry: the dmabuf path of `capture_toplevel`. Connects to +/// Public entry: the dmabuf path of capture_toplevel. Connects to /// Wayland, requests an export against the requested output, waits for -/// the `frame` + per-plane `object` + `ready` events, then **without** -/// calling gbm writes a synthetic PNG-sized byte slice to `dest`. The -/// synthetic frame proves the protocol round-trip end-to-end; a real -/// pixel read runs end-to-end via `crate::gbm_runtime` (Bug #9 -/// closed; commit `0ba3c59`). On any libgbm/format failure the -/// synthetic-frame fallback runs. +/// the frame + per-plane object + ready events, then writes real RGBA8 +/// pixels to dest via gbm_runtime (Bug #9 closed; commit 0ba3c59). +/// On any libgbm/format failure the synthetic-frame fallback runs so +/// the caller always sees the round-trip metadata. pub async fn capture_via_export( output: &wl_output::WlOutput, dest: &Path,