Class AudioParamTimeline

include/LabSound/core/AudioParamTimeline.h:15–113

{

class AudioParamTimeline
{

public:
    AudioParamTimeline() {}

    void setValueAtTime(float value, float time);
    void linearRampToValueAtTime(float value, float time);
    void exponentialRampToValueAtTime(float value, float time);
    void setTargetAtTime(float target, float time, float timeConstant);
    void setValueCurveAtTime(std::vector<float> & curve, float time, float duration);
    void cancelScheduledValues(float startTime);

    // hasValue is set to true if a valid timeline value is returned.
    // otherwise defaultValue is returned.
    float valueForContextTime(ContextRenderLock &, float defaultValue, bool & hasValue);

    // Given the time range, calculates parameter values into the values buffer
    // and returns the last parameter value calculated for "values" or the defaultValue if none were calculated.
    // controlRate is the rate (number per second) at which parameter values will be calculated.
    // It should equal sampleRate for sample-accurate parameter changes, and otherwise will usually match
    // the render quantum size such that the parameter value changes once per render quantum.
    float valuesForTimeRange(double startTime, double endTime, float defaultValue,
                             float * values, size_t numberOfValues, double sampleRate, double controlRate);

    bool hasValues() { return m_events.size() > 0; }

private:

    // @tofix - move to implementation file to hide from public API

    class ParamEvent
    {

    public:
        enum Type
        {
            SetValue,
            LinearRampToValue,
            ExponentialRampToValue,
            SetTarget,
            SetValueCurve,
            LastType
        };

        ParamEvent(Type type, float value, float time, float timeConstant, float duration, std::vector<float> curve)
            : m_type(type)
            , m_value(value)
            , m_time(time)
            , m_timeConstant(timeConstant)
            , m_duration(duration)
            , m_curve(curve)
        {
        }

        ParamEvent(const ParamEvent & rhs)
            : m_type(rhs.m_type)
            , m_value(rhs.m_value)