Pulp 1.88.0
Cross-platform audio plugin framework
Loading...
Searching...
No Matches
pulp::timeline::AutomationLane Class Reference

Immutable ownership of one authored automation curve and its logical target. More...

#include <automation_lane.hpp>

Public Member Functions

ItemId id () const noexcept
 Returns the lane's stable document identity.
const AutomationTarget & target () const noexcept
 Returns the format-neutral target stored by this lane.
const AutomationCurve & curve () const noexcept
 Returns the immutable authored curve.
AutomationLane with_curve (AutomationCurve replacement) const noexcept
 Returns a lane snapshot with replacement, preserving identity and target.

Static Public Member Functions

static runtime::Result< AutomationLane, AutomationLaneError > create (ItemId id, AutomationTarget target, AutomationCurve curve)
 Validates and constructs a lane owning curve for target.

Detailed Description

Immutable ownership of one authored automation curve and its logical target.

Curve values remain in the plugin's plain parameter domain. Document attachment, playback compilation, metadata validation, normalization, and host delivery are separate concerns and intentionally absent from this value. During attachment and remapping, lane and curve-point IDs are owned identities; target placement IDs are references, and parameter IDs stay verbatim.

Member Function Documentation

◆ create()

runtime::Result< AutomationLane, AutomationLaneError > pulp::timeline::AutomationLane::create ( ItemId id,
AutomationTarget target,
AutomationCurve curve )
static

Validates and constructs a lane owning curve for target.

The lane identity and any referenced placement identity must be valid.

◆ curve()

const AutomationCurve & pulp::timeline::AutomationLane::curve ( ) const
inlinenoexcept

Returns the immutable authored curve.

◆ id()

ItemId pulp::timeline::AutomationLane::id ( ) const
inlinenoexcept

Returns the lane's stable document identity.

◆ target()

const AutomationTarget & pulp::timeline::AutomationLane::target ( ) const
inlinenoexcept

Returns the format-neutral target stored by this lane.

◆ with_curve()

AutomationLane pulp::timeline::AutomationLane::with_curve ( AutomationCurve replacement) const
noexcept

Returns a lane snapshot with replacement, preserving identity and target.

The original lane and its curve remain valid and unchanged.


The documentation for this class was generated from the following file: