1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
|
/*
* Copyright (c) 2003-2010 Alexandre Ratchov <alex@caoua.org>
*
* Permission to use, copy, modify, and distribute this software for any
* purpose with or without fee is hereby granted, provided that the above
* copyright notice and this permission notice appear in all copies.
*
* THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
* WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
* MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
* ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
* WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
* ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
* OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
*/
#ifndef MIDISH_EV_H
#define MIDISH_EV_H
#include "defs.h"
/*
* number of user-parametrable sysex patterns
*/
#define EV_NPAT 16
#define EV_NULL 0 /* "null" or end-of-track */
#define EV_TEMPO 0x2 /* tempo change */
#define EV_TIMESIG 0x3 /* time signature change */
#define EV_NRPN 0x4 /* NRPN + data entry */
#define EV_RPN 0x5 /* RPN + data entry */
#define EV_XCTL 0x6 /* 14bit controller */
#define EV_XPC 0x7 /* prog change + bank select */
#define EV_NOFF 0x8 /* MIDI note off */
#define EV_NON 0x9 /* MIDI note on */
#define EV_KAT 0xa /* MIDI key after-toutch */
#define EV_CTL 0xb /* MIDI controller */
#define EV_PC 0xc /* MIDI prog. change */
#define EV_CAT 0xd /* MIDI channel aftertouch */
#define EV_BEND 0xe /* MIDI pitch bend */
#define EV_PAT0 0x10 /* user sysex pattern */
#define EV_NUMCMD (EV_PAT0 + EV_NPAT)
#define EV_ISVOICE(ev) (((ev)->cmd <= EV_BEND) && ((ev)->cmd >= EV_NRPN))
#define EV_ISMETA(ev) (((ev)->cmd <= EV_TIMESIG) && ((ev)->cmd >= EV_TEMPO))
#define EV_ISNOTE(ev) ((ev)->cmd == EV_NON || \
(ev)->cmd == EV_NOFF || \
(ev)->cmd == EV_KAT)
#define EV_ISSX(ev) ((ev)->cmd >= EV_PAT0 && \
(ev)->cmd < EV_PAT0 + EV_NPAT)
/*
* some special values for events
*/
#define EV_NOFF_DEFAULTVEL 100 /* defaul note-off velocity */
#define EV_BEND_DEFAULT 0x2000 /* defaul bender value */
#define EV_CAT_DEFAULT 0 /* default channel aftertouch value */
#define EV_CTL_UNKNOWN 255 /* unknown controller number */
/*
* an event: structure used to store MIDI events and some
* midish-sepcific events (tempo changes, etc...). This structure have
* to be kept as small as possible, because its used to store events
* on tracks, that may contain a lot of events
*/
struct ev {
unsigned char cmd, dev, ch;
#define note_num v0
#define note_vel v1
#define note_kat v1
#define ctl_num v0
#define ctl_val v1
#define pc_prog v1
#define pc_bank v0
#define cat_val v0
#define bend_val v0
#define rpn_num v0
#define rpn_val v1
#define tempo_usec24 v0
#define timesig_beats v0
#define timesig_tics v1
unsigned v0, v1;
#define EV_UNDEF 0xffff
#define EV_MAXDEV (DEFAULT_MAXNDEVS - 1)
#define EV_MAXCH 15
#define EV_MAXCOARSE 0x7f
#define EV_MAXFINE 0x3fff
};
/*
* event phase bitmasks
*/
#define EV_PHASE_FIRST 1
#define EV_PHASE_NEXT 2
#define EV_PHASE_LAST 4
/*
* range of events, the cmd argument is the event type. To facilitate
* matching 'struct ev' agains 'struct evspec', we try (when possible)
* to use the same constants. Currently this works for all events
* except EV_NON, EV_KAT, EV_NOFF, which all correspond to EVSPEC_NOTE
*/
struct evspec {
#define EVSPEC_EMPTY EV_NULL
#define EVSPEC_ANY 1
#define EVSPEC_NOTE EV_NON
#define EVSPEC_CTL EV_CTL
#define EVSPEC_PC EV_PC
#define EVSPEC_CAT EV_CAT
#define EVSPEC_BEND EV_BEND
#define EVSPEC_NRPN EV_NRPN
#define EVSPEC_RPN EV_RPN
#define EVSPEC_XCTL EV_XCTL
#define EVSPEC_XPC EV_XPC
unsigned cmd;
unsigned dev_min, dev_max; /* except for EMPTY */
unsigned ch_min, ch_max; /* except for EMPTY */
unsigned v0_min, v0_max; /* except for EMPTY, ANY */
unsigned v1_min, v1_max; /* except for EMPTY, ANY, CAT, PC */
};
/*
* we use a static array (indexed by 'cmd') of the following
* structures to lookup for events properties
*/
struct evinfo {
char *ev, *spec;
#define EV_HAS_DEV 0x01 /* if ev->dev is used */
#define EV_HAS_CH 0x02 /* if ev->ch is used */
unsigned flags; /* bitmap of above */
unsigned nparams; /* number of params (ie v0, v1) used */
unsigned nranges; /* number of ranges (ie v0, v1) used */
unsigned v0_min; /* min ev->v0 */
unsigned v0_max; /* max ev->v0 */
unsigned v1_min; /* min ev->v1 */
unsigned v1_max; /* max ev->v1 */
/*
* sysex patterns specific
*/
#define EV_PATV0_HI 0x80
#define EV_PATV0_LO 0x81
#define EV_PATV1_HI 0x82
#define EV_PATV1_LO 0x83
#define EV_PATSUM 0x84
#define EV_PATNEGSUM 0x85
#define EV_PATSIZE 32
unsigned char *pattern;
};
extern struct evinfo evinfo[EV_NUMCMD];
void ev_log(struct ev *);
unsigned ev_str2cmd(struct ev *, char *);
unsigned ev_phase(struct ev *);
unsigned ev_eq(struct ev *, struct ev *);
unsigned ev_match(struct ev *, struct ev *);
void ev_map(struct ev *, struct evspec *, struct evspec *, struct ev *);
unsigned evspec_str2cmd(struct evspec *, char *);
void evspec_log(struct evspec *);
void evspec_reset(struct evspec *);
unsigned evspec_matchev(struct evspec *, struct ev *);
unsigned evspec_eq(struct evspec *, struct evspec *);
unsigned evspec_isec(struct evspec *, struct evspec *);
unsigned evspec_in(struct evspec *, struct evspec *);
int evspec_isamap(struct evspec *, struct evspec *);
void evspec_map(struct evspec *, struct evspec *,
struct evspec *, struct evspec *);
/*
* describes a controller number; this structures defines
* how varius other routines bahave when a controller
* event with the same number is found
*/
struct evctl {
char *name; /* controller name or NULL if none */
unsigned defval; /* default value if type == EVCTL_FRAME */
};
extern struct evctl evctl_tab[EV_MAXCOARSE + 1];
#define EV_CTL_ISPARAM(ev) \
(evctl_tab[(ev)->ctl_num].defval == EV_UNDEF)
#define EV_CTL_ISFRAME(ev) \
(evctl_tab[(ev)->ctl_num].defval != EV_UNDEF)
#define EV_CTL_DEFVAL(ev) \
(evctl_tab[(ev)->ctl_num].defval)
/*
* return true if the given controller number is 14bit (fine)
* and false if it is 7bit (coarse). The 'ctlbits' is
* a 32bit bitmap, it is stored in per-device basis in
* mididev structure
*/
#define EVCTL_ISFINE(xctlset, num) ((xctlset) & (1 << (num)))
void evctl_conf(unsigned, char *, unsigned);
void evctl_unconf(unsigned);
unsigned evctl_lookup(char *, unsigned *);
void evctl_init(void);
void evctl_done(void);
unsigned evctl_isreserved(unsigned);
void evpat_unconf(unsigned);
unsigned evpat_lookup(char *, unsigned *);
unsigned evpat_set(unsigned, char *, unsigned char *, unsigned);
void evpat_reset(void);
#endif /* MIDISH_EV_H */
|
