feat(host,clients): PyroWave ships in default builds; NVIDIA hosts advertise it

Flip the `pyrowave` cargo feature into the default set across punktfunk-host,
pf-client-core, pf-presenter and the session client — every packaged build
(flatpak, arch/rpm/copr, windows x64 client) now carries the codec. Selection
stays strictly per-session opt-in: a client must pick "PyroWave (wired LAN)"
in Settings (or PUNKTFUNK_PREFER_PYROWAVE=1); nothing changes for normal
HEVC/AV1 sessions. The Windows ARM64 client leg builds --no-default-features
and keeps skipping it (decode is Linux-native + Apple Metal today).

Advertisement no longer waits for the PUNKTFUNK_ENCODER=pyrowave lab
override on NVIDIA: host_wire_caps sets the bit whenever the feature is
present and the host isn't the GPU-less software pref, and
SessionPlan::output_format flips a PyroWave session on the NVIDIA-auto
capture path to CPU RGB frames (the EGL→CUDA import only NVENC consumes;
the wavelet backend ingests raw dmabufs or CPU RGB). AMD/Intel keep their
raw-dmabuf zero-copy unchanged; per-session raw-dmabuf passthrough on
NVIDIA (true zero-copy without the env's global capture policy) stays a
follow-up.

On-glass on .21 (RTX 5070 Ti, default-features binaries, NO env overrides):
host advertises + negotiates PyroWave, the CPU-capture fallback engages,
60 fps at e2e 3.2-5.7 ms p50, and a mid-stream 1080p→720p resize rides on
top cleanly. Workspace clippy --locked clean; 33 client + 314 host tests.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
2026-07-15 13:53:15 +02:00
co-authored by Claude Fable 5
parent a40ae49cf8
commit f24379c2f8
7 changed files with 54 additions and 29 deletions
+6 -6
View File
@@ -44,13 +44,13 @@ setting.
## Turning it on
1. **Host** (Linux): build/install a host with the `pyrowave` feature. On an NVIDIA host the
capture path additionally needs `PUNKTFUNK_ENCODER=pyrowave` in `host.env` for the codec to
be advertised; AMD/Intel hosts advertise it automatically when the feature is present.
1. **Host** (Linux): nothing to do — default builds ship the codec and every Linux GPU host
advertises it. AMD/Intel hosts encode from the capture dmabuf zero-copy; on an NVIDIA host
a PyroWave session currently captures via CPU RGB (a modest host-side cost that only
affects sessions that picked this codec — everything else keeps its zero-copy path).
2. **Client**:
- Linux session client (with the `pyrowave` feature): set **Settings → Video codec →
PyroWave (wired LAN)** in the gamepad console, or launch with
`PUNKTFUNK_PREFER_PYROWAVE=1`.
- Linux session client: set **Settings → Video codec → PyroWave (wired LAN)** in the
gamepad console, or launch with `PUNKTFUNK_PREFER_PYROWAVE=1`.
- Apple (Mac, Apple TV 4K, iPad — wired networking strongly recommended): set
**Settings → Codec → PyroWave (wired LAN)**. The option appears only on devices whose
GPU passes the decode probe (Apple Silicon and A13-class or newer); picking it forces