filmstrip-core/dev.jordond.filmstrip.edit/AudioLevel/Envelope

Envelope

class Envelope(val points: List<EnvelopePoint>) : AudioLevel(source)

Contribute at a gain that moves over time.

The gain ramps linearly between neighbouring points, and holds flat before the first and after the last. Two points rising from zero are a fade in, two falling to zero anchored at the end are a fade out, and a dip in the middle is a duck under whatever else is playing. No points at all leaves the enclosing scope's level alone.

A curve that is not a straight line is written as more points. Nothing here is smoothed, so what a backend applies is the polyline as given.

Constructors

Envelope

constructor(points: List<EnvelopePoint>)

Properties

points

val points: List<EnvelopePoint>

Where the gain is pinned. Times are read against the scope this level is set on, which is the trimmed clip for a clip and the whole run a track covers. A looping track covers every pass, so a point anchored to its end lands where the composition ends.