blob: c23a785b7bd2e50c2bff871897d6120fe37a0e51 (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
|
Single-file codecs, vendored unchanged; `codecs.c` compiles them for the host.
| File | Upstream | Version |
| --- | --- | --- |
| `dr_wav.h` | https://github.com/mackron/dr_libs | 0.14.6 |
| `dr_flac.h` | https://github.com/mackron/dr_libs | 0.13.4 |
| `stb_vorbis.c` | https://github.com/nothings/stb | v1.22 |
| `cgltf.h` | https://github.com/jkuhlmann/cgltf | 1.15, commit `85cd62382dfea638278962690cf515023f33ed00` (MIT, license in header) |
`cgltf.c` compiles the unchanged cgltf header for the optional `gltf` module.
`presentation-time/presentation-time.xml` is the Wayland presentation-time v3
protocol description (the client binds v1; its license is included in the XML).
On Linux, `build.zig` runs `wayland-scanner` to generate a client header and C
protocol tables in the build cache, then translates that header into the existing
Zig `c` module alongside SDL. No generated C/header files are checked in.
All handwritten callbacks, resource ownership, clock conversion, pacing and trace
formatting live in `src/host/Presentation.zig`. Run `zig build test-presentation`
(or `zig build test-timing`) from the project root to test them. Linux builds need
`wayland-scanner` and the `wayland-client` development package.
The trace uses a private event queue dispatched on the SDL thread. Per-frame
feedback objects are owned by libwayland; our pending slots and completed-record
ring are fixed capacity. CSV `commit_ns` timestamps the feedback request before
`SDL_RenderPresent`, rather than intercepting `wl_surface.commit`; the protocol
associates feedback with the next commit of the SDL surface. Presented times,
refresh periods, sequence numbers and flags are supplied by the compositor.
`sample_ms` is the draw sample clock in SDL's epoch; `commit_ns` and `presented_ns` use the
advertised protocol clock. Discarded rows have no presentation timestamp. A
trace snapshot reports pending requests, exhausted slots and its retention limit.
|