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 2009,2010,2011 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_ENVELOPE_H_
#define _DSP_ENVELOPE_H_

#include "DspObject.h"

/** [env~], [env~ float], [env~ float float] */
class DspEnvelope : public DspObject {

  public:
    static MessageObject *new_object(PdMessage *init_message, PdGraph *graph);

    /*
     * @param windowSize  The window size in samples of the analysis. Defaults to 1024.
     * @param windowInterval  The window interval in samples of the analysis.
     * The interval must be a multiple of the block size. If not, then it is reset to
     * the nearest multiple. Defaults to windowSize/2, according to the mentioned constraints.
     */
    DspEnvelope(PdMessage *init_message, PdGraph *graph);
    ~DspEnvelope();

    static const char *get_object_label();
    std::string toString();

    connection::Type get_connection_type(int outlet_index) { return MESSAGE; }

  private:
    static void processSignal(DspObject *dspObject, int fromIndex, int toIndex);

    /** Initialise the analysis buffers. */
    void initBuffers();
    void setWindowInterval(int newInterval);

    int windowSize;
    int windowInterval;

    int numSamplesReceived;
    int numSamplesReceivedSinceLastInterval;

    float *signalBuffer;
    float *hanningCoefficients;
};

inline const char *DspEnvelope::get_object_label() {
  return "env~";
}

#endif // _DSP_ENVELOPE_H_