diff --git a/docs/reference/audio-effects.mdx b/docs/reference/audio-effects.mdx index d2d60decf0c..7a2f541c1ee 100644 --- a/docs/reference/audio-effects.mdx +++ b/docs/reference/audio-effects.mdx @@ -115,6 +115,14 @@ Preview and render agree on both clocks. which is about `3.981` — the same ceiling `data-volume` uses. A lane that boosts above unity is valid and will play; `1` is unity, not the maximum. +The lane multiplies `data-volume`, the way clip gain offsets volume keyframes in +an editor: `data-volume="0.5"` under a lane at `1` plays at `0.5`. The product +shares the same +12 dB ceiling. This holds on clips and on groups. + +On a clip, `data-volume` is applied **ahead of** its effects, so a compressor or +limiter in its `data-fx-chain` reacts to it; the lane comes after them. A group's +`data-volume` stays after its effects, like a track fader. + A lane holds its first value backwards to the start of its clip and its last value forward to the end. **A bed that begins before the voice therefore needs an explicit "no cut" point at `t: 0`, or it starts out already ducked.** Maximum 512 diff --git a/docs/reference/html-schema.mdx b/docs/reference/html-schema.mdx index 21e43a99a02..d1f5452f95a 100644 --- a/docs/reference/html-schema.mdx +++ b/docs/reference/html-schema.mdx @@ -133,7 +133,7 @@ Audio has no visual lifecycle. | --- | --- | --- | | `data-media-start` / `data-playback-start` | Video, audio, nested composition | Offset into the source file, used by trim and split. Two groups of readers disagree, so the right name depends on the element. **Read only `data-media-start`:** the timing compiler, the HTML parser, `hyperframes validate` (which only inspects `