@motion-script/core / PrecompOptions

Interface: PrecompOptions

Defined in: runtime/precompisition.ts:281

Options controlling how a Precomp runs.

Properties

cache?

optional cache?: PrecompCache

Defined in: runtime/precompisition.ts:285

Optional store of previously-measured passes; see PrecompCache.

globals?

optional globals?: ProjectGlobals

Defined in: runtime/precompisition.ts:292

The project's global audio beds and background/overlay layers. The same instance must be handed to the StateEvaluator that plays the project back (read it off Precomp.globals), so the layers this pass measures assets for are the ones that actually draw.

lifespans?

optional lifespans?: boolean

Defined in: runtime/precompisition.ts:307

Whether to record per-node lifespans. Defaults to true.

recordLifespans walks the whole node tree and allocates a path string per node on every frame, and the only consumer is an editor timeline drawing each node's bar. A render that just wants frame counts and asset windows — an export, a screenshot — pays that for nothing, so it can turn the walk off.

A pass measured with this off is deliberately never offered to the host PrecompCache: its lifespans map is empty, and an editor that later read that entry would show a timeline with no bars and no way to tell it apart from a genuinely empty measurement.

profile?

optional profile?: PrecompProfile

Defined in: runtime/precompisition.ts:283

Optional timing sink; see createPrecompProfile.