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 2010,2011,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 _ZG_CALLBACK_FUNCTION_H_
#define _ZG_CALLBACK_FUNCTION_H_

/** An enumeration of the different operations available from a context's callback function. */
typedef enum {
  /** Print to standard out. Argument is char* to message buffer. */
  ZG_PRINT_STD,
  
  /** Print to standard error. Argument is char* to message buffer. */
  ZG_PRINT_ERR,
  
  /**
   * Suggestion to turn on or off context signal processing. Argument is int* to 1 or 0.
   * Note that message and signal processing are dependent in ZenGarden. If pd::Context::process()
   * is no longer called, then messages will also stop being processed.
   */
  ZG_PD_DSP,
  
  /**
   * A message is being sent to the callback via a previously registered receiver.
   */
  ZG_RECEIVER_MESSAGE,
  
  /**
   * An object/abstraction/external referenced in the current patch cannot be found. ptr is a
   * char* string to the name of the object. If the path to the object definition can be supplied
   * by the callback then it should be returns as a char*. The memory will be freed by the caller.
   */
  ZG_CANNOT_FIND_OBJECT
} ZGCallbackFunction;

#endif // _ZG_CALLBACK_FUNCTION_H_