/[svn]/linuxsampler/trunk/src/engines/common/Event.h
ViewVC logotype

Annotation of /linuxsampler/trunk/src/engines/common/Event.h

Parent Directory Parent Directory | Revision Log Revision Log


Revision 906 - (hide annotations) (download) (as text)
Sun Jul 23 16:44:08 2006 UTC (17 years, 8 months ago) by schoenebeck
File MIME type: text/x-c++hdr
File size: 6439 byte(s)
* MIDI driver API extension for MIDI drivers which already supply exact
  time stamps for events (i.e. for offline rendering based MIDI drivers)

1 schoenebeck 53 /***************************************************************************
2     * *
3     * LinuxSampler - modular, streaming capable sampler *
4     * *
5 schoenebeck 56 * Copyright (C) 2003, 2004 by Benno Senoner and Christian Schoenebeck *
6 schoenebeck 890 * Copyright (C) 2005, 2006 Christian Schoenebeck *
7 schoenebeck 53 * *
8     * This program is free software; you can redistribute it and/or modify *
9     * it under the terms of the GNU General Public License as published by *
10     * the Free Software Foundation; either version 2 of the License, or *
11     * (at your option) any later version. *
12     * *
13     * This program is distributed in the hope that it will be useful, *
14     * but WITHOUT ANY WARRANTY; without even the implied warranty of *
15     * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
16     * GNU General Public License for more details. *
17     * *
18     * You should have received a copy of the GNU General Public License *
19     * along with this program; if not, write to the Free Software *
20     * Foundation, Inc., 59 Temple Place, Suite 330, Boston, *
21     * MA 02111-1307 USA *
22     ***************************************************************************/
23    
24     #ifndef __LS_EVENT_H__
25     #define __LS_EVENT_H__
26    
27     #include "../../common/global.h"
28 schoenebeck 328 #include "../../common/RTMath.h"
29 schoenebeck 890 #include "../EngineChannel.h"
30 schoenebeck 53
31     namespace LinuxSampler {
32    
33     // just symbol prototyping
34     class Event;
35    
36     /**
37     * Generates Event objects and is responsible for resolving the position
38     * in the current audio fragment each Event actually belongs to.
39     */
40     class EventGenerator {
41     public:
42     EventGenerator(uint SampleRate);
43     void UpdateFragmentTime(uint SamplesToProcess);
44     Event CreateEvent();
45 schoenebeck 906 Event CreateEvent(int32_t FragmentPos);
46 schoenebeck 53 protected:
47 schoenebeck 328 typedef RTMath::time_stamp_t time_stamp_t;
48 schoenebeck 293 inline int32_t ToFragmentPos(time_stamp_t TimeStamp) {
49     return int32_t (int32_t(TimeStamp - FragmentTime.begin) * FragmentTime.sample_ratio);
50 schoenebeck 53 }
51     friend class Event;
52     private:
53     uint uiSampleRate;
54     uint uiSamplesProcessed;
55     struct __FragmentTime__ {
56     time_stamp_t begin; ///< Real time stamp of the beginning of this audio fragment cycle.
57     time_stamp_t end; ///< Real time stamp of the end of this audio fragment cycle.
58     float sample_ratio; ///< (Samples per cycle) / (Real time duration of cycle)
59     } FragmentTime;
60     };
61    
62     /**
63     * Events are usually caused by a MIDI source or an internal modulation
64 schoenebeck 906 * controller like LFO or EG. An event should only be created by an
65     * EventGenerator!
66 schoenebeck 53 *
67     * @see EventGenerator
68     */
69     class Event {
70     public:
71     Event(){}
72     enum type_t {
73     type_note_on,
74     type_note_off,
75     type_pitchbend,
76     type_control_change,
77 schoenebeck 244 type_sysex, ///< MIDI system exclusive message
78 schoenebeck 53 type_cancel_release, ///< transformed either from a note-on or sustain-pedal-down event
79     type_release ///< transformed either from a note-off or sustain-pedal-up event
80     } Type;
81     union {
82 schoenebeck 246 /// Note-on and note-off event specifics
83     struct _Note {
84     uint8_t Key; ///< MIDI key number of note-on / note-off event.
85     uint8_t Velocity; ///< Trigger or release velocity of note-on / note-off event.
86 schoenebeck 250 int8_t Layer; ///< Layer index (usually only used if a note-on event has to be postponed, e.g. due to shortage of free voices).
87     int8_t ReleaseTrigger; ///< If new voice should be a release triggered voice (actually boolean field and usually only used if a note-on event has to be postponed, e.g. due to shortage of free voices).
88 schoenebeck 246 } Note;
89     /// Control change event specifics
90     struct _CC {
91     uint8_t Controller; ///< MIDI controller number of control change event.
92     uint8_t Value; ///< Controller Value of control change event.
93     } CC;
94     /// Pitchbend event specifics
95     struct _Pitch {
96     int16_t Pitch; ///< Pitch value of pitchbend event.
97     } Pitch;
98     /// MIDI system exclusive event specifics
99     struct _Sysex {
100     uint Size; ///< Data length (in bytes) of MIDI system exclusive message.
101     } Sysex;
102     } Param;
103 schoenebeck 412 EngineChannel* pEngineChannel; ///< Pointer to the EngineChannel where this event occured on, NULL means Engine global event (e.g. SysEx message).
104 schoenebeck 53
105 schoenebeck 293 inline int32_t FragmentPos() {
106     if (iFragmentPos >= 0) return iFragmentPos;
107     iFragmentPos = pEventGenerator->ToFragmentPos(TimeStamp);
108     if (iFragmentPos < 0) iFragmentPos = 0; // if event arrived shortly before the beginning of current fragment
109     return iFragmentPos;
110 schoenebeck 53 }
111 schoenebeck 293 inline void ResetFragmentPos() {
112     iFragmentPos = -1;
113     }
114 schoenebeck 53 protected:
115     typedef EventGenerator::time_stamp_t time_stamp_t;
116     Event(EventGenerator* pGenerator, EventGenerator::time_stamp_t Time);
117 schoenebeck 906 Event(EventGenerator* pGenerator, int32_t FragmentPos);
118 schoenebeck 53 friend class EventGenerator;
119     private:
120     EventGenerator* pEventGenerator; ///< Creator of the event.
121     time_stamp_t TimeStamp; ///< Time stamp of the event's occurence.
122 schoenebeck 293 int32_t iFragmentPos; ///< Position in the current fragment this event refers to.
123 schoenebeck 53 };
124    
125     } // namespace LinuxSampler
126    
127     #endif // __LS_EVENT_H__

  ViewVC Help
Powered by ViewVC