Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion quest/m3/layers/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand Down
6 changes: 3 additions & 3 deletions quest/m3/layers/play.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand Down
15 changes: 12 additions & 3 deletions quest/m3/layers/spec.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand All @@ -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
Expand Down
6 changes: 3 additions & 3 deletions quest/m3/layers/watch.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down