2 Copyright (C) 1998-2006 Paul Davis
4 This program is free software; you can redistribute it and/or modify
5 it under the terms of the GNU General Public License as published by
6 the Free Software Foundation; either version 2 of the License, or
7 (at your option) any later version.
9 This program is distributed in the hope that it will be useful,
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 GNU General Public License for more details.
14 You should have received a copy of the GNU General Public License
15 along with this program; if not, write to the Free Software
16 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
25 #include "pbd/error.h"
26 #include "pbd/controllable_descriptor.h"
27 #include "pbd/xml++.h"
28 #include "pbd/stacktrace.h"
30 #include "midi++/port.h"
31 #include "midi++/channel.h"
33 #include "ardour/automation_control.h"
34 #include "ardour/midi_ui.h"
35 #include "ardour/utils.h"
37 #include "midicontrollable.h"
38 #include "generic_midi_control_protocol.h"
43 using namespace ARDOUR;
45 MIDIControllable::MIDIControllable (GenericMidiControlProtocol* s, Port& p, bool m)
52 _learned = false; /* from URI */
54 last_value = 0; // got a better idea ?
55 last_controllable_value = 0.0f;
57 _control_description = "MIDI Control: none";
58 control_additional = (byte) -1;
59 feedback = true; // for now
62 MIDIControllable::MIDIControllable (GenericMidiControlProtocol* s, Port& p, Controllable& c, bool m)
68 set_controllable (&c);
70 _learned = true; /* from controllable */
72 last_value = 0; // got a better idea ?
73 last_controllable_value = 0.0f;
75 _control_description = "MIDI Control: none";
76 control_additional = (byte) -1;
77 feedback = true; // for now
80 MIDIControllable::~MIDIControllable ()
82 drop_external_control ();
86 MIDIControllable::init (const std::string& s)
90 _descriptor = new ControllableDescriptor;
91 return _descriptor->set (s);
95 MIDIControllable::midi_forget ()
97 /* stop listening for incoming messages, but retain
98 our existing event + type information.
101 midi_sense_connection[0].disconnect ();
102 midi_sense_connection[1].disconnect ();
103 midi_learn_connection.disconnect ();
107 MIDIControllable::drop_external_control ()
111 control_additional = (byte) -1;
115 MIDIControllable::set_controllable (Controllable* c)
117 if (c == controllable) {
121 controllable_death_connection.disconnect ();
126 controllable->Destroyed.connect (controllable_death_connection, MISSING_INVALIDATOR,
127 boost::bind (&MIDIControllable::drop_controllable, this),
128 MidiControlUI::instance());
133 MIDIControllable::midi_rebind (channel_t c)
136 bind_midi (c, control_type, control_additional);
143 MIDIControllable::learn_about_external_control ()
145 drop_external_control ();
146 _port.parser()->any.connect_same_thread (midi_learn_connection, boost::bind (&MIDIControllable::midi_receiver, this, _1, _2, _3));
150 MIDIControllable::stop_learning ()
152 midi_learn_connection.disconnect ();
156 MIDIControllable::control_to_midi (float val)
158 if (controllable->is_gain_like()) {
159 return gain_to_slider_position (val) * max_value_for_type ();
162 float control_min = controllable->lower ();
163 float control_max = controllable->upper ();
164 const float control_range = control_max - control_min;
166 return (val - control_min) / control_range * max_value_for_type ();
170 MIDIControllable::midi_to_control (int val)
172 /* fiddle with MIDI value so that we get an odd number of integer steps
173 and can thus represent "middle" precisely as 0.5. this maps to
177 float fv = (val == 0 ? 0 : float (val - 1) / (max_value_for_type() - 1));
179 if (controllable->is_gain_like()) {
180 return slider_position_to_gain (fv);
183 float control_min = controllable->lower ();
184 float control_max = controllable->upper ();
185 const float control_range = control_max - control_min;
187 return (fv * control_range) + control_min;
191 MIDIControllable::midi_sense_note_on (Parser &p, EventTwoBytes *tb)
193 midi_sense_note (p, tb, true);
197 MIDIControllable::midi_sense_note_off (Parser &p, EventTwoBytes *tb)
199 midi_sense_note (p, tb, false);
203 MIDIControllable::lookup_controllable()
209 boost::shared_ptr<Controllable> c = _surface->lookup_controllable (*_descriptor);
215 set_controllable (c.get ());
221 MIDIControllable::drop_controllable ()
223 cerr << "removed controllable " << controllable << "\n";
224 set_controllable (0);
228 MIDIControllable::midi_sense_note (Parser &, EventTwoBytes *msg, bool /*is_on*/)
231 if (lookup_controllable()) {
236 if (!controllable->is_toggle()) {
237 if (control_additional == msg->note_number) {
238 controllable->set_value (midi_to_control (msg->velocity));
241 if (control_additional == msg->note_number) {
242 controllable->set_value (controllable->get_value() > 0.5f ? 0.0f : 1.0f);
246 last_value = (MIDI::byte) (controllable->get_value() * 127.0); // to prevent feedback fights
250 MIDIControllable::midi_sense_controller (Parser &, EventTwoBytes *msg)
253 if (lookup_controllable ()) {
258 assert (controllable);
260 if (controllable->touching()) {
261 return; // to prevent feedback fights when e.g. dragging a UI slider
264 if (control_additional == msg->controller_number) {
266 if (!controllable->is_toggle()) {
267 float new_value = msg->value;
268 float max_value = max(last_controllable_value, new_value);
269 float min_value = min(last_controllable_value, new_value);
270 float range = max_value - min_value;
271 float threshold = (float) _surface->threshold ();
273 bool const in_sync = (
275 controllable->get_value() <= midi_to_control(max_value) &&
276 controllable->get_value() >= midi_to_control(min_value)
279 /* If the surface is not motorised, we try to prevent jumps when
280 the MIDI controller and controllable are out of sync.
281 There might be a better way of doing this.
284 if (in_sync || _surface->motorised ()) {
285 controllable->set_value (midi_to_control (new_value));
288 last_controllable_value = new_value;
290 if (msg->value > 64.0f) {
291 controllable->set_value (1);
293 controllable->set_value (0);
297 last_value = (MIDI::byte) (control_to_midi(controllable->get_value())); // to prevent feedback fights
302 MIDIControllable::midi_sense_program_change (Parser &, byte msg)
305 if (lookup_controllable ()) {
310 if (!controllable->is_toggle()) {
311 controllable->set_value (midi_to_control (msg));
312 } else if (msg == control_additional) {
313 controllable->set_value (controllable->get_value() > 0.5f ? 0.0f : 1.0f);
316 last_value = (MIDI::byte) (controllable->get_value() * 127.0); // to prevent feedback fights
320 MIDIControllable::midi_sense_pitchbend (Parser &, pitchbend_t pb)
323 if (lookup_controllable ()) {
328 if (!controllable->is_toggle()) {
329 controllable->set_value (midi_to_control (pb));
331 controllable->set_value (controllable->get_value() > 0.5f ? 0.0f : 1.0f);
334 last_value = control_to_midi (controllable->get_value ());
338 MIDIControllable::midi_receiver (Parser &, byte *msg, size_t /*len*/)
340 /* we only respond to channel messages */
342 if ((msg[0] & 0xF0) < 0x80 || (msg[0] & 0xF0) > 0xE0) {
346 /* if the our port doesn't do input anymore, forget it ... */
348 if (!_port.parser()) {
352 bind_midi ((channel_t) (msg[0] & 0xf), eventType (msg[0] & 0xF0), msg[1]);
355 controllable->LearningFinished ();
360 MIDIControllable::bind_midi (channel_t chn, eventType ev, MIDI::byte additional)
364 drop_external_control ();
367 control_channel = chn;
368 control_additional = additional;
370 if (_port.parser() == 0) {
374 Parser& p = *_port.parser();
379 p.channel_note_off[chn_i].connect_same_thread (midi_sense_connection[0], boost::bind (&MIDIControllable::midi_sense_note_off, this, _1, _2));
381 /* if this is a togglee, connect to noteOn as well,
382 and we'll toggle back and forth between the two.
386 p.channel_note_on[chn_i].connect_same_thread (midi_sense_connection[1], boost::bind (&MIDIControllable::midi_sense_note_on, this, _1, _2));
389 _control_description = "MIDI control: NoteOff";
393 p.channel_note_on[chn_i].connect_same_thread (midi_sense_connection[0], boost::bind (&MIDIControllable::midi_sense_note_on, this, _1, _2));
395 p.channel_note_off[chn_i].connect_same_thread (midi_sense_connection[1], boost::bind (&MIDIControllable::midi_sense_note_off, this, _1, _2));
397 _control_description = "MIDI control: NoteOn";
400 case MIDI::controller:
401 p.channel_controller[chn_i].connect_same_thread (midi_sense_connection[0], boost::bind (&MIDIControllable::midi_sense_controller, this, _1, _2));
402 snprintf (buf, sizeof (buf), "MIDI control: Controller %d", control_additional);
403 _control_description = buf;
407 p.channel_program_change[chn_i].connect_same_thread (midi_sense_connection[0], boost::bind (&MIDIControllable::midi_sense_program_change, this, _1, _2));
408 _control_description = "MIDI control: ProgramChange";
411 case MIDI::pitchbend:
412 p.channel_pitchbend[chn_i].connect_same_thread (midi_sense_connection[0], boost::bind (&MIDIControllable::midi_sense_pitchbend, this, _1, _2));
413 _control_description = "MIDI control: Pitchbend";
422 MIDIControllable::write_feedback (MIDI::byte* buf, int32_t& bufsize, bool /*force*/)
424 if (!controllable || control_type == none || !feedback || bufsize <= 2) {
428 int const gm = control_to_midi (controllable->get_value());
430 if (gm == last_value) {
434 *buf++ = (0xF0 & control_type) | (0xF & control_channel);
436 switch (control_type) {
437 case MIDI::pitchbend:
438 *buf++ = int (gm) & 127;
439 *buf++ = (int (gm) >> 7) & 127;
442 *buf++ = control_additional; /* controller number */
454 MIDIControllable::set_state (const XMLNode& node, int /*version*/)
456 const XMLProperty* prop;
459 if ((prop = node.property ("event")) != 0) {
460 sscanf (prop->value().c_str(), "0x%x", &xx);
461 control_type = (MIDI::eventType) xx;
466 if ((prop = node.property ("channel")) != 0) {
467 sscanf (prop->value().c_str(), "%d", &xx);
468 control_channel = (MIDI::channel_t) xx;
473 if ((prop = node.property ("additional")) != 0) {
474 sscanf (prop->value().c_str(), "0x%x", &xx);
475 control_additional = (MIDI::byte) xx;
480 if ((prop = node.property ("feedback")) != 0) {
481 feedback = (prop->value() == "yes");
483 feedback = true; // default
486 bind_midi (control_channel, control_type, control_additional);
492 MIDIControllable::get_state ()
496 XMLNode* node = new XMLNode ("MIDIControllable");
498 if (_current_uri.empty()) {
499 node->add_property ("id", controllable->id().to_s());
501 node->add_property ("uri", _current_uri);
505 snprintf (buf, sizeof(buf), "0x%x", (int) control_type);
506 node->add_property ("event", buf);
507 snprintf (buf, sizeof(buf), "%d", (int) control_channel);
508 node->add_property ("channel", buf);
509 snprintf (buf, sizeof(buf), "0x%x", (int) control_additional);
510 node->add_property ("additional", buf);
511 node->add_property ("feedback", (feedback ? "yes" : "no"));
517 /** @return the maximum value for a control value transmitted
518 * using a given MIDI::eventType.
521 MIDIControllable::max_value_for_type () const
523 /* XXX: this is not complete */
525 if (control_type == MIDI::pitchbend) {