Csound and CsoundAC API  5.17
Public Types | Public Member Functions | Data Fields | Static Public Attributes
csound::Event Class Reference

Represents an event in music space, such as a note of definite duration, a MIDI-like "note on" or "note off" event, or a MIDI-like control event. More...

#include <Event.hpp>

Public Types

enum  { INDEFINITE = 16384 }
enum  Dimensions {
  TIME = 0, DURATION, STATUS, INSTRUMENT,
  KEY, VELOCITY, PHASE, PAN,
  DEPTH, HEIGHT, PITCHES, HOMOGENEITY,
  ELEMENT_COUNT
}

Public Member Functions

virtual void clearProperties ()
virtual void conformToPitchClassSet ()
virtual void createNoteOffEvent (Event &event) const
virtual void dump (std::ostream &stream)
 Event ()
 Event (const Event &a)
 Event (std::string text)
 Event (const Eigen::VectorXd &a)
 Event (double time, double duration, double status, double instrument, double key, double velocity, double phase, double pan, double depth, double height, double pitches)
 Event (const std::vector< double > &v)
virtual double getAmplitude () const
virtual int getChannel () const
virtual double getDepth () const
virtual double getDuration () const
virtual double getFrequency () const
virtual double getGain () const
virtual double getHeight () const
virtual double getInstrument () const
virtual double getKey () const
virtual double getKey (double tonesPerOctave) const
virtual int getKeyNumber () const
virtual double getLeftGain () const
virtual int getMidiStatus () const
virtual double getOffTime () const
virtual double getPan () const
virtual double getPhase () const
virtual double getPitches () const
virtual std::string getProperty (std::string name)
virtual double getRightGain () const
virtual double getStatus () const
virtual int getStatusNumber () const
virtual double getTime () const
virtual double getVelocity () const
virtual int getVelocityNumber () const
virtual void initialize ()
virtual bool isMatchingEvent (const Event &event) const
virtual bool isMatchingNoteOff (const Event &event) const
virtual bool isMidiEvent () const
virtual bool isNote () const
virtual bool isNoteOff () const
virtual bool isNoteOn () const
virtual Eventoperator= (const Event &a)
virtual Eventoperator= (const Eigen::VectorXd &a)
virtual void removeProperty (std::string nameO)
virtual void set (double time, double duration, double status, double instrument, double key, double velocity, double phase=0, double pan=0, double depth=0, double height=0, double pitches=4095)
virtual void setAmplitude (double amplitude)
virtual void setDepth (double depth)
virtual void setDuration (double duration)
virtual void setFrequency (double frequency)
virtual void setHeight (double height)
virtual void setInstrument (double instrument)
virtual void setKey (double key)
virtual void setMidi (double time, char status, char key, char velocity)
virtual void setOffTime (double offTime)
virtual void setPan (double pan)
virtual void setPhase (double phase)
virtual void setPitches (double pitches)
virtual void setProperty (std::string name, std::string value)
virtual void setStatus (double status)
virtual void setTime (double time)
virtual void setVelocity (double velocity)
virtual void temper (double divisionsPerOctave)
virtual std::string toCsoundIStatement (double tempering=12.0) const
virtual std::string toCsoundIStatementHeld (int tag, double tempering=12.0) const
virtual std::string toCsoundIStatementRelease (int tag, double tempering=12.0) const
virtual std::string toString () const
virtual ~Event ()

Data Fields

std::map< std::string,
std::string > 
properties

Static Public Attributes

static const char * labels []
static int SORT_ORDER []

Detailed Description

Represents an event in music space, such as a note of definite duration, a MIDI-like "note on" or "note off" event, or a MIDI-like control event.

Fields have the same semantics as MIDI with some differences. All fields are floats; status is stored separately from channel; channel can have any positive value; spatial location in X, Y, and Z are stored; phase in radians is stored; and pitch-class set is stored.

Events can be multiplied (matrix dot product) with the local coordinate system of a Node or transform to translate, scale, or rotate them in any or all dimensions of music space.

Events usually are value objects, not references.

Silence Events translate to Csound score statements ("i" statements), but they are always real-time score statements at time 0, suitable for use with Csound's -L or line event option.

Member Enumeration Documentation

anonymous enum
Enumerator:
INDEFINITE 
Enumerator:
TIME 
DURATION 
STATUS 
INSTRUMENT 
KEY 
VELOCITY 
PHASE 
PAN 
DEPTH 
HEIGHT 
PITCHES 
HOMOGENEITY 
ELEMENT_COUNT 

Constructor & Destructor Documentation

csound::Event::Event ( )
csound::Event::Event ( const Event a)
csound::Event::Event ( std::string  text)
csound::Event::Event ( const Eigen::VectorXd &  a)
csound::Event::Event ( double  time,
double  duration,
double  status,
double  instrument,
double  key,
double  velocity,
double  phase,
double  pan,
double  depth,
double  height,
double  pitches 
)
csound::Event::Event ( const std::vector< double > &  v)
virtual csound::Event::~Event ( )
virtual

Member Function Documentation

virtual void csound::Event::clearProperties ( )
virtual
virtual void csound::Event::conformToPitchClassSet ( )
virtual
virtual void csound::Event::createNoteOffEvent ( Event event) const
virtual
virtual void csound::Event::dump ( std::ostream &  stream)
virtual
virtual double csound::Event::getAmplitude ( ) const
virtual
virtual int csound::Event::getChannel ( ) const
virtual
virtual double csound::Event::getDepth ( ) const
virtual
virtual double csound::Event::getDuration ( ) const
virtual
virtual double csound::Event::getFrequency ( ) const
virtual
virtual double csound::Event::getGain ( ) const
virtual
virtual double csound::Event::getHeight ( ) const
virtual
virtual double csound::Event::getInstrument ( ) const
virtual
virtual double csound::Event::getKey ( ) const
virtual
virtual double csound::Event::getKey ( double  tonesPerOctave) const
virtual
virtual int csound::Event::getKeyNumber ( ) const
virtual
virtual double csound::Event::getLeftGain ( ) const
virtual
virtual int csound::Event::getMidiStatus ( ) const
virtual
virtual double csound::Event::getOffTime ( ) const
virtual
virtual double csound::Event::getPan ( ) const
virtual
virtual double csound::Event::getPhase ( ) const
virtual
virtual double csound::Event::getPitches ( ) const
virtual
virtual std::string csound::Event::getProperty ( std::string  name)
virtual
virtual double csound::Event::getRightGain ( ) const
virtual
virtual double csound::Event::getStatus ( ) const
virtual
virtual int csound::Event::getStatusNumber ( ) const
virtual
virtual double csound::Event::getTime ( ) const
virtual
virtual double csound::Event::getVelocity ( ) const
virtual
virtual int csound::Event::getVelocityNumber ( ) const
virtual
virtual void csound::Event::initialize ( )
virtual
virtual bool csound::Event::isMatchingEvent ( const Event event) const
virtual
virtual bool csound::Event::isMatchingNoteOff ( const Event event) const
virtual
virtual bool csound::Event::isMidiEvent ( ) const
virtual
virtual bool csound::Event::isNote ( ) const
virtual
virtual bool csound::Event::isNoteOff ( ) const
virtual
virtual bool csound::Event::isNoteOn ( ) const
virtual
virtual Event& csound::Event::operator= ( const Event a)
virtual
virtual Event& csound::Event::operator= ( const Eigen::VectorXd &  a)
virtual
virtual void csound::Event::removeProperty ( std::string  nameO)
virtual
virtual void csound::Event::set ( double  time,
double  duration,
double  status,
double  instrument,
double  key,
double  velocity,
double  phase = 0,
double  pan = 0,
double  depth = 0,
double  height = 0,
double  pitches = 4095 
)
virtual
virtual void csound::Event::setAmplitude ( double  amplitude)
virtual
virtual void csound::Event::setDepth ( double  depth)
virtual
virtual void csound::Event::setDuration ( double  duration)
virtual
virtual void csound::Event::setFrequency ( double  frequency)
virtual
virtual void csound::Event::setHeight ( double  height)
virtual
virtual void csound::Event::setInstrument ( double  instrument)
virtual
virtual void csound::Event::setKey ( double  key)
virtual
virtual void csound::Event::setMidi ( double  time,
char  status,
char  key,
char  velocity 
)
virtual
virtual void csound::Event::setOffTime ( double  offTime)
virtual
virtual void csound::Event::setPan ( double  pan)
virtual
virtual void csound::Event::setPhase ( double  phase)
virtual
virtual void csound::Event::setPitches ( double  pitches)
virtual
virtual void csound::Event::setProperty ( std::string  name,
std::string  value 
)
virtual
virtual void csound::Event::setStatus ( double  status)
virtual
virtual void csound::Event::setTime ( double  time)
virtual
virtual void csound::Event::setVelocity ( double  velocity)
virtual
virtual void csound::Event::temper ( double  divisionsPerOctave)
virtual
virtual std::string csound::Event::toCsoundIStatement ( double  tempering = 12.0) const
virtual
virtual std::string csound::Event::toCsoundIStatementHeld ( int  tag,
double  tempering = 12.0 
) const
virtual
virtual std::string csound::Event::toCsoundIStatementRelease ( int  tag,
double  tempering = 12.0 
) const
virtual
virtual std::string csound::Event::toString ( ) const
virtual

Referenced by csound::Turtle::__str__().

Field Documentation

const char* csound::Event::labels[]
static
std::map<std::string,std::string> csound::Event::properties
int csound::Event::SORT_ORDER[]
static