diff --git a/quest/m3/layers/README.md b/quest/m3/layers/README.md index f23a69fda12..1ca9b3f54ff 100644 --- a/quest/m3/layers/README.md +++ b/quest/m3/layers/README.md @@ -10,7 +10,7 @@ its creator composed it, while each source stays its own broadcast that a viewer can toggle and fetch at its own priority. This README's own work is the end-to-end proof: one fixture composition with -a main broadcast, a picture child, and a sound child plays in `moq play` and +a main broadcast, a child shown in a picture, and a child heard as sound plays in `moq play` and `@moq/watch` with the same placement and timing, within a stated tolerance, and with the child's sound mixed in. diff --git a/quest/m3/layers/play.md b/quest/m3/layers/play.md index 81938a7091b..9e85b17df05 100644 --- a/quest/m3/layers/play.md +++ b/quest/m3/layers/play.md @@ -3,15 +3,15 @@ ## Goal `moq play` plays a composition: it opens each child broadcast the -composition lists, places each visible picture child where and when the +composition lists, draws each visible picture where and when the composition says, on the composition's clock through the child's offset, -mixes each sound child in at its gain, mute, pan, and delay, and lets a +mixes each child's sound in at its gain, mute, pan, and delay, and lets a viewer toggle each child the composition marks toggleable. A broadcast without a composition plays as today. ## Plan -Fetch only visible children, at the composition's priorities through moq-lite's +Fetch only children a visible picture or an unmuted sound uses, at the composition's priorities through moq-lite's subscription priorities, and unsubscribe a toggled-off child. Prove placement and timing against the epic's fixture. diff --git a/quest/m3/layers/spec.md b/quest/m3/layers/spec.md index 74fd1af25d0..7a45742d59e 100644 --- a/quest/m3/layers/spec.md +++ b/quest/m3/layers/spec.md @@ -5,9 +5,11 @@ `drafts/draft-lcurley-moq-hang.md`, `rs/hang`, and `js/hang` define a composition: a versioned catalog section that lists child broadcasts, marks one as main, and gives each child its offset from its PTS onto the -composition's clock, its priority, and whether a viewer may toggle it. A -picture child also carries its transform, crop, z-order, opacity, visibility, -and keyframes; a sound child carries its gain, mute, pan, and delay. The +composition's clock, its priority, whether a viewer may toggle it, and, for +sound, its gain, mute, pan, and delay. A separate list of pictures places +children: each picture names a child and carries its transform, crop, +z-order, opacity, visibility, and keyframes, so one child can show in +several places. The composition's catalog also lists the main child's renditions, so a consumer that knows no compositions plays the main alone. @@ -28,6 +30,13 @@ subscribe to it. The composition's clock is the main's, so the main's offset is zero and the catalog lists its renditions by their `broadcast` reference, on the same timeline. +Decided 2026-11-12 (maintainer, moq-dev/studio /quest-complete on +[moq-dev/studio#146](https://github.com/moq-dev/studio/pull/146)): ✅ +placements are a list of pictures that each name a child, apart from the +child entries (rejected: one placement per child). A studio source can show +in several places at once, such as a clone or the top layer, and a player +fetches its broadcast once however many pictures show it. + Decided 2026-11-09 (maintainer, moq-dev/studio /quest-audit): a sound child carries pan and delay as well as gain and mute. The studio's strip has all four (`rs/moq-scene/src/collection.rs` in moq-dev/studio; pan shipped in diff --git a/quest/m3/layers/watch.md b/quest/m3/layers/watch.md index 515afc245bd..d17bcbd4d91 100644 --- a/quest/m3/layers/watch.md +++ b/quest/m3/layers/watch.md @@ -3,15 +3,15 @@ ## Goal `@moq/watch` plays a composition: it opens each child broadcast the -composition lists, places each visible picture child where and when the +composition lists, draws each visible picture where and when the composition says, on the composition's clock through the child's offset, -mixes each sound child in at its gain, mute, pan, and delay, and lets a +mixes each child's sound in at its gain, mute, pan, and delay, and lets a viewer toggle each child the composition marks toggleable. A broadcast without a composition plays as today. ## Plan -Fetch only visible children, at the composition's priorities through moq-lite's +Fetch only children a visible picture or an unmuted sound uses, at the composition's priorities through moq-lite's subscription priorities, and unsubscribe a toggled-off child. Prove placement and timing against the epic's fixture, matching `moq play` within its tolerance.