purezen 0.0.2

Runtime for the Pure Data (Pd) audio programming language, implemented as an extensible audio library allowing full control over signal processing, message passing, and graph manipulation. Pure Data is a graph-based programming language environment creating interactive music and multimedia works.
Documentation
/*
 *  Copyright 2012 Reality Jockey, Ltd.
 *                 info@rjdj.me
 *                 http://rjdj.me/
 * 
 *  This file is part of ZenGarden.
 *
 *  ZenGarden is free software: you can redistribute it and/or modify
 *  it under the terms of the GNU Lesser General Public License as published by
 *  the Free Software Foundation, either version 3 of the License, or
 *  (at your option) any later version.
 *
 *  ZenGarden is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *  GNU Lesser General Public License for more details.
 *  
 *  You should have received a copy of the GNU Lesser General Public License
 *  along with ZenGarden.  If not, see <http://www.gnu.org/licenses/>.
 *
 */

#ifndef _DSP_VARIABLE_LINE_H_
#define _DSP_VARIABLE_LINE_H_

#include "DspObject.h"

/** [vline~] */
class DspVariableLine : public DspObject {
  
  public:
    static MessageObject *new_object(PdMessage *init_message, PdGraph *graph);
    DspVariableLine(PdMessage *init_message, PdGraph *graph);
    ~DspVariableLine();
    
    static const char *get_object_label();
    std::string toString();
  
    // this implementation assumes that all messages arrive only on the left-most inlet
    bool shouldDistributeMessageToInlets();
  
    // override sendMessage in order to update path
    void sendMessage(int outlet_index, PdMessage *message);
    
  private:
    static void processSignal(DspObject *dspObject, int fromIndex, int toIndex);
  
    void process_message(int inlet_index, PdMessage *message);
  
    void clearAllMessagesAtOrAfter(double timestamp);
  
    void clearAllMessagesFrom(list<PdMessage *>::iterator it);
  
    /** Immediately updates the path variables based on the info in the message. */
    void updatePathWithMessage(PdMessage *message);
  
    float target;
    float slope; // change per sample
    float numSamplesToTarget;
    float lastOutputSample;
  
    // a list of pending path messages
    list<PdMessage *> messageList;
};

inline std::string DspVariableLine::toString() {
  return DspVariableLine::get_object_label();
}

inline const char *DspVariableLine::get_object_label() {
  return "vline~";
}

inline bool DspVariableLine::shouldDistributeMessageToInlets() {
  return false;
}

#endif // _DSP_VARIABLE_LINE_H_