2 * Copyright (C) 2014 Robin Gareus <robin@gareus.org>
3 * Copyright (C) 2013 Paul Davis
5 * This program is free software; you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License as published by
7 * the Free Software Foundation; either version 2 of the License, or
8 * (at your option) any later version.
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
15 * You should have received a copy of the GNU General Public License
16 * along with this program; if not, write to the Free Software
17 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
26 #include "dummy_audiobackend.h"
27 #include "dummy_midi_seq.h"
29 #include "pbd/error.h"
30 #include "ardour/port_manager.h"
33 using namespace ARDOUR;
35 static std::string s_instance_name;
36 size_t DummyAudioBackend::_max_buffer_size = 8192;
37 std::vector<std::string> DummyAudioBackend::_midi_options;
38 std::vector<AudioBackend::DeviceStatus> DummyAudioBackend::_device_status;
40 DummyAudioBackend::DummyAudioBackend (AudioEngine& e, AudioBackendInfo& info)
41 : AudioBackend (e, info)
43 , _freewheeling (false)
46 , _samples_per_period (1024)
52 , _enable_midi_generators (false)
53 , _systemic_input_latency (0)
54 , _systemic_output_latency (0)
55 , _processed_samples (0)
56 , _port_change_flag (false)
58 _instance_name = s_instance_name;
59 _device = _("Silence");
60 pthread_mutex_init (&_port_callback_mutex, 0);
63 DummyAudioBackend::~DummyAudioBackend ()
65 pthread_mutex_destroy (&_port_callback_mutex);
68 /* AUDIOBACKEND API */
71 DummyAudioBackend::name () const
77 DummyAudioBackend::is_realtime () const
82 std::vector<AudioBackend::DeviceStatus>
83 DummyAudioBackend::enumerate_devices () const
85 if (_device_status.empty()) {
86 _device_status.push_back (DeviceStatus (_("Silence"), true));
87 _device_status.push_back (DeviceStatus (_("Sine Wave"), true));
88 _device_status.push_back (DeviceStatus (_("Square Wave"), true));
89 _device_status.push_back (DeviceStatus (_("Impulses"), true));
90 _device_status.push_back (DeviceStatus (_("Uniform White Noise"), true));
91 _device_status.push_back (DeviceStatus (_("Gaussian White Noise"), true));
92 _device_status.push_back (DeviceStatus (_("Pink Noise"), true));
93 _device_status.push_back (DeviceStatus (_("Pink Noise (low CPU)"), true));
94 _device_status.push_back (DeviceStatus (_("Sine Sweep"), true));
95 _device_status.push_back (DeviceStatus (_("Sine Sweep Swell"), true));
97 return _device_status;
101 DummyAudioBackend::available_sample_rates (const std::string&) const
103 std::vector<float> sr;
104 sr.push_back (8000.0);
105 sr.push_back (22050.0);
106 sr.push_back (24000.0);
107 sr.push_back (44100.0);
108 sr.push_back (48000.0);
109 sr.push_back (88200.0);
110 sr.push_back (96000.0);
111 sr.push_back (176400.0);
112 sr.push_back (192000.0);
116 std::vector<uint32_t>
117 DummyAudioBackend::available_buffer_sizes (const std::string&) const
119 std::vector<uint32_t> bs;
136 DummyAudioBackend::available_input_channel_count (const std::string&) const
142 DummyAudioBackend::available_output_channel_count (const std::string&) const
148 DummyAudioBackend::can_change_sample_rate_when_running () const
154 DummyAudioBackend::can_change_buffer_size_when_running () const
160 DummyAudioBackend::set_device_name (const std::string& d)
167 DummyAudioBackend::set_sample_rate (float sr)
169 if (sr <= 0) { return -1; }
171 engine.sample_rate_change (sr);
176 DummyAudioBackend::set_buffer_size (uint32_t bs)
178 if (bs <= 0 || bs >= _max_buffer_size) {
181 _samples_per_period = bs;
182 engine.buffer_size_change (bs);
187 DummyAudioBackend::set_interleaved (bool yn)
189 if (!yn) { return 0; }
194 DummyAudioBackend::set_input_channels (uint32_t cc)
201 DummyAudioBackend::set_output_channels (uint32_t cc)
208 DummyAudioBackend::set_systemic_input_latency (uint32_t sl)
210 _systemic_input_latency = sl;
215 DummyAudioBackend::set_systemic_output_latency (uint32_t sl)
217 _systemic_output_latency = sl;
221 /* Retrieving parameters */
223 DummyAudioBackend::device_name () const
229 DummyAudioBackend::sample_rate () const
235 DummyAudioBackend::buffer_size () const
237 return _samples_per_period;
241 DummyAudioBackend::interleaved () const
247 DummyAudioBackend::input_channels () const
253 DummyAudioBackend::output_channels () const
259 DummyAudioBackend::systemic_input_latency () const
261 return _systemic_input_latency;
265 DummyAudioBackend::systemic_output_latency () const
267 return _systemic_output_latency;
272 std::vector<std::string>
273 DummyAudioBackend::enumerate_midi_options () const
275 if (_midi_options.empty()) {
276 _midi_options.push_back (_("No MIDI I/O"));
277 _midi_options.push_back (_("1 in, 1 out, Silence"));
278 _midi_options.push_back (_("2 in, 2 out, Silence"));
279 _midi_options.push_back (_("8 in, 8 out, Silence"));
280 _midi_options.push_back (_("Midi Event Generators"));
282 return _midi_options;
286 DummyAudioBackend::set_midi_option (const std::string& opt)
288 _enable_midi_generators = false;
289 if (opt == _("1 in, 1 out, Silence")) {
290 _n_midi_inputs = _n_midi_outputs = 1;
292 else if (opt == _("2 in, 2 out, Silence")) {
293 _n_midi_inputs = _n_midi_outputs = 2;
295 else if (opt == _("8 in, 8 out, Silence")) {
296 _n_midi_inputs = _n_midi_outputs = 8;
298 else if (opt == _("Midi Event Generators")) {
299 _n_midi_inputs = _n_midi_outputs = NUM_MIDI_EVENT_GENERATORS;
300 _enable_midi_generators = true;
303 _n_midi_inputs = _n_midi_outputs = 0;
309 DummyAudioBackend::midi_option () const
316 static void * pthread_process (void *arg)
318 DummyAudioBackend *d = static_cast<DummyAudioBackend *>(arg);
319 d->main_process_thread ();
325 DummyAudioBackend::_start (bool /*for_latency_measurement*/)
328 PBD::error << _("DummyAudioBackend: already active.") << endmsg;
333 PBD::warning << _("DummyAudioBackend: recovering from unclean shutdown, port registry is not empty.") << endmsg;
334 for (std::vector<DummyPort*>::const_iterator it = _ports.begin (); it != _ports.end (); ++it) {
335 PBD::info << _("DummyAudioBackend: port '") << (*it)->name () << "' exists." << endmsg;
337 _system_inputs.clear();
338 _system_midi_in.clear();
342 if (register_system_ports()) {
343 PBD::error << _("DummyAudioBackend: failed to register system ports.") << endmsg;
347 engine.sample_rate_change (_samplerate);
348 engine.buffer_size_change (_samples_per_period);
350 if (engine.reestablish_ports ()) {
351 PBD::error << _("DummyAudioBackend: Could not re-establish ports.") << endmsg;
356 engine.reconnect_ports ();
357 _port_change_flag = false;
359 if (pthread_create (&_main_thread, NULL, pthread_process, this)) {
360 PBD::error << _("DummyAudioBackend: cannot start.") << endmsg;
364 while (!_running && --timeout > 0) { Glib::usleep (1000); }
366 if (timeout == 0 || !_running) {
367 PBD::error << _("DummyAudioBackend: failed to start process thread.") << endmsg;
375 DummyAudioBackend::stop ()
383 if (pthread_join (_main_thread, &status)) {
384 PBD::error << _("DummyAudioBackend: failed to terminate.") << endmsg;
392 DummyAudioBackend::freewheel (bool onoff)
394 if (onoff == _freewheeling) {
397 _freewheeling = onoff;
398 engine.freewheel_callback (onoff);
403 DummyAudioBackend::dsp_load () const
405 return 100.f * _dsp_load;
409 DummyAudioBackend::raw_buffer_size (DataType t)
412 case DataType::AUDIO:
413 return _samples_per_period * sizeof(Sample);
415 return _max_buffer_size; // XXX not really limited
422 DummyAudioBackend::sample_time ()
424 return _processed_samples;
428 DummyAudioBackend::sample_time_at_cycle_start ()
430 return _processed_samples;
434 DummyAudioBackend::samples_since_cycle_start ()
441 DummyAudioBackend::dummy_process_thread (void *arg)
443 ThreadData* td = reinterpret_cast<ThreadData*> (arg);
444 boost::function<void ()> f = td->f;
451 DummyAudioBackend::create_process_thread (boost::function<void()> func)
455 size_t stacksize = 100000;
457 pthread_attr_init (&attr);
458 pthread_attr_setstacksize (&attr, stacksize);
459 ThreadData* td = new ThreadData (this, func, stacksize);
461 if (pthread_create (&thread_id, &attr, dummy_process_thread, td)) {
462 PBD::error << _("AudioEngine: cannot create process thread.") << endmsg;
463 pthread_attr_destroy (&attr);
466 pthread_attr_destroy (&attr);
468 _threads.push_back (thread_id);
473 DummyAudioBackend::join_process_threads ()
477 for (std::vector<pthread_t>::const_iterator i = _threads.begin (); i != _threads.end (); ++i)
480 if (pthread_join (*i, &status)) {
481 PBD::error << _("AudioEngine: cannot terminate process thread.") << endmsg;
490 DummyAudioBackend::in_process_thread ()
492 for (std::vector<pthread_t>::const_iterator i = _threads.begin (); i != _threads.end (); ++i)
494 if (pthread_equal (*i, pthread_self ()) != 0) {
502 DummyAudioBackend::process_thread_count ()
504 return _threads.size ();
508 DummyAudioBackend::update_latencies ()
510 // trigger latency callback in RT thread (locked graph)
511 port_connect_add_remove_callback();
517 DummyAudioBackend::private_handle () const
523 DummyAudioBackend::my_name () const
525 return _instance_name;
529 DummyAudioBackend::available () const
535 DummyAudioBackend::port_name_size () const
541 DummyAudioBackend::set_port_name (PortEngine::PortHandle port, const std::string& name)
543 if (!valid_port (port)) {
544 PBD::error << _("DummyBackend::set_port_name: Invalid Port(s)") << endmsg;
547 return static_cast<DummyPort*>(port)->set_name (_instance_name + ":" + name);
551 DummyAudioBackend::get_port_name (PortEngine::PortHandle port) const
553 if (!valid_port (port)) {
554 PBD::error << _("DummyBackend::get_port_name: Invalid Port(s)") << endmsg;
555 return std::string ();
557 return static_cast<DummyPort*>(port)->name ();
560 PortEngine::PortHandle
561 DummyAudioBackend::get_port_by_name (const std::string& name) const
563 PortHandle port = (PortHandle) find_port (name);
568 DummyAudioBackend::get_ports (
569 const std::string& port_name_pattern,
570 DataType type, PortFlags flags,
571 std::vector<std::string>& port_names) const
575 bool use_regexp = false;
576 if (port_name_pattern.size () > 0) {
577 if (!regcomp (&port_regex, port_name_pattern.c_str (), REG_EXTENDED|REG_NOSUB)) {
581 for (size_t i = 0; i < _ports.size (); ++i) {
582 DummyPort* port = _ports[i];
583 if ((port->type () == type) && (port->flags () & flags)) {
584 if (!use_regexp || !regexec (&port_regex, port->name ().c_str (), 0, NULL, 0)) {
585 port_names.push_back (port->name ());
591 regfree (&port_regex);
597 DummyAudioBackend::port_data_type (PortEngine::PortHandle port) const
599 if (!valid_port (port)) {
600 return DataType::NIL;
602 return static_cast<DummyPort*>(port)->type ();
605 PortEngine::PortHandle
606 DummyAudioBackend::register_port (
607 const std::string& name,
608 ARDOUR::DataType type,
609 ARDOUR::PortFlags flags)
611 if (name.size () == 0) { return 0; }
612 if (flags & IsPhysical) { return 0; }
614 PBD::info << _("DummyBackend::register_port: Engine is not running.") << endmsg;
616 return add_port (_instance_name + ":" + name, type, flags);
619 PortEngine::PortHandle
620 DummyAudioBackend::add_port (
621 const std::string& name,
622 ARDOUR::DataType type,
623 ARDOUR::PortFlags flags)
625 assert(name.size ());
626 if (find_port (name)) {
627 PBD::error << _("DummyBackend::register_port: Port already exists:")
628 << " (" << name << ")" << endmsg;
631 DummyPort* port = NULL;
633 case DataType::AUDIO:
634 port = new DummyAudioPort (*this, name, flags);
637 port = new DummyMidiPort (*this, name, flags);
640 PBD::error << _("DummyBackend::register_port: Invalid Data Type.") << endmsg;
644 _ports.push_back (port);
650 DummyAudioBackend::unregister_port (PortEngine::PortHandle port_handle)
653 PBD::info << _("DummyBackend::unregister_port: Engine is not running.") << endmsg;
654 assert (!valid_port (port_handle));
657 DummyPort* port = static_cast<DummyPort*>(port_handle);
658 std::vector<DummyPort*>::iterator i = std::find (_ports.begin (), _ports.end (), static_cast<DummyPort*>(port_handle));
659 if (i == _ports.end ()) {
660 PBD::error << _("DummyBackend::unregister_port: Failed to find port") << endmsg;
663 disconnect_all(port_handle);
669 DummyAudioBackend::register_system_ports()
672 enum DummyAudioPort::GeneratorType gt;
673 if (_device == _("Uniform White Noise")) {
674 gt = DummyAudioPort::UniformWhiteNoise;
675 } else if (_device == _("Gaussian White Noise")) {
676 gt = DummyAudioPort::GaussianWhiteNoise;
677 } else if (_device == _("Pink Noise")) {
678 gt = DummyAudioPort::PinkNoise;
679 } else if (_device == _("Pink Noise (low CPU)")) {
680 gt = DummyAudioPort::PonyNoise;
681 } else if (_device == _("Sine Wave")) {
682 gt = DummyAudioPort::SineWave;
683 } else if (_device == _("Square Wave")) {
684 gt = DummyAudioPort::SquareWave;
685 } else if (_device == _("Impulses")) {
686 gt = DummyAudioPort::KronekerDelta;
687 } else if (_device == _("Sine Sweep")) {
688 gt = DummyAudioPort::SineSweep;
689 } else if (_device == _("Sine Sweep Swell")) {
690 gt = DummyAudioPort::SineSweepSwell;
692 gt = DummyAudioPort::Silence;
695 const int a_ins = _n_inputs > 0 ? _n_inputs : 8;
696 const int a_out = _n_outputs > 0 ? _n_outputs : 8;
697 const int m_ins = _n_midi_inputs;
698 const int m_out = _n_midi_outputs;
701 lr.min = lr.max = _samples_per_period + _systemic_input_latency;
702 for (int i = 1; i <= a_ins; ++i) {
704 snprintf(tmp, sizeof(tmp), "system:capture_%d", i);
705 PortHandle p = add_port(std::string(tmp), DataType::AUDIO, static_cast<PortFlags>(IsOutput | IsPhysical | IsTerminal));
707 set_latency_range (p, false, lr);
708 _system_inputs.push_back (static_cast<DummyAudioPort*>(p));
709 static_cast<DummyAudioPort*>(p)->setup_generator (gt, _samplerate);
712 lr.min = lr.max = _samples_per_period + _systemic_output_latency;
713 for (int i = 1; i <= a_out; ++i) {
715 snprintf(tmp, sizeof(tmp), "system:playback_%d", i);
716 PortHandle p = add_port(std::string(tmp), DataType::AUDIO, static_cast<PortFlags>(IsInput | IsPhysical | IsTerminal));
718 set_latency_range (p, true, lr);
722 lr.min = lr.max = _samples_per_period + _systemic_input_latency;
723 for (int i = 1; i <= m_ins; ++i) {
725 snprintf(tmp, sizeof(tmp), "system:midi_capture_%d", i);
726 PortHandle p = add_port(std::string(tmp), DataType::MIDI, static_cast<PortFlags>(IsOutput | IsPhysical | IsTerminal));
728 set_latency_range (p, false, lr);
729 _system_midi_in.push_back (static_cast<DummyMidiPort*>(p));
730 if (_enable_midi_generators) {
731 static_cast<DummyMidiPort*>(p)->setup_generator (i % NUM_MIDI_EVENT_GENERATORS, _samplerate);
735 lr.min = lr.max = _samples_per_period + _systemic_output_latency;
736 for (int i = 1; i <= m_out; ++i) {
738 snprintf(tmp, sizeof(tmp), "system:midi_playback_%d", i);
739 PortHandle p = add_port(std::string(tmp), DataType::MIDI, static_cast<PortFlags>(IsInput | IsPhysical | IsTerminal));
741 set_latency_range (p, true, lr);
747 DummyAudioBackend::unregister_ports (bool system_only)
750 _system_inputs.clear();
751 _system_midi_in.clear();
752 while (i < _ports.size ()) {
753 DummyPort* port = _ports[i];
754 if (! system_only || (port->is_physical () && port->is_terminal ())) {
755 port->disconnect_all ();
757 _ports.erase (_ports.begin() + i);
765 DummyAudioBackend::connect (const std::string& src, const std::string& dst)
767 DummyPort* src_port = find_port (src);
768 DummyPort* dst_port = find_port (dst);
771 PBD::error << _("DummyBackend::connect: Invalid Source port:")
772 << " (" << src <<")" << endmsg;
776 PBD::error << _("DummyBackend::connect: Invalid Destination port:")
777 << " (" << dst <<")" << endmsg;
780 return src_port->connect (dst_port);
784 DummyAudioBackend::disconnect (const std::string& src, const std::string& dst)
786 DummyPort* src_port = find_port (src);
787 DummyPort* dst_port = find_port (dst);
789 if (!src_port || !dst_port) {
790 PBD::error << _("DummyBackend::disconnect: Invalid Port(s)") << endmsg;
793 return src_port->disconnect (dst_port);
797 DummyAudioBackend::connect (PortEngine::PortHandle src, const std::string& dst)
799 DummyPort* dst_port = find_port (dst);
800 if (!valid_port (src)) {
801 PBD::error << _("DummyBackend::connect: Invalid Source Port Handle") << endmsg;
805 PBD::error << _("DummyBackend::connect: Invalid Destination Port")
806 << " (" << dst << ")" << endmsg;
809 return static_cast<DummyPort*>(src)->connect (dst_port);
813 DummyAudioBackend::disconnect (PortEngine::PortHandle src, const std::string& dst)
815 DummyPort* dst_port = find_port (dst);
816 if (!valid_port (src) || !dst_port) {
817 PBD::error << _("DummyBackend::disconnect: Invalid Port(s)") << endmsg;
820 return static_cast<DummyPort*>(src)->disconnect (dst_port);
824 DummyAudioBackend::disconnect_all (PortEngine::PortHandle port)
826 if (!valid_port (port)) {
827 PBD::error << _("DummyBackend::disconnect_all: Invalid Port") << endmsg;
830 static_cast<DummyPort*>(port)->disconnect_all ();
835 DummyAudioBackend::connected (PortEngine::PortHandle port, bool /* process_callback_safe*/)
837 if (!valid_port (port)) {
838 PBD::error << _("DummyBackend::disconnect_all: Invalid Port") << endmsg;
841 return static_cast<DummyPort*>(port)->is_connected ();
845 DummyAudioBackend::connected_to (PortEngine::PortHandle src, const std::string& dst, bool /*process_callback_safe*/)
847 DummyPort* dst_port = find_port (dst);
848 if (!valid_port (src) || !dst_port) {
849 PBD::error << _("DummyBackend::connected_to: Invalid Port") << endmsg;
852 return static_cast<DummyPort*>(src)->is_connected (dst_port);
856 DummyAudioBackend::physically_connected (PortEngine::PortHandle port, bool /*process_callback_safe*/)
858 if (!valid_port (port)) {
859 PBD::error << _("DummyBackend::physically_connected: Invalid Port") << endmsg;
862 return static_cast<DummyPort*>(port)->is_physically_connected ();
866 DummyAudioBackend::get_connections (PortEngine::PortHandle port, std::vector<std::string>& names, bool /*process_callback_safe*/)
868 if (!valid_port (port)) {
869 PBD::error << _("DummyBackend::get_connections: Invalid Port") << endmsg;
873 assert (0 == names.size ());
875 const std::vector<DummyPort*>& connected_ports = static_cast<DummyPort*>(port)->get_connections ();
877 for (std::vector<DummyPort*>::const_iterator i = connected_ports.begin (); i != connected_ports.end (); ++i) {
878 names.push_back ((*i)->name ());
881 return (int)names.size ();
886 DummyAudioBackend::midi_event_get (
887 pframes_t& timestamp,
888 size_t& size, uint8_t** buf, void* port_buffer,
889 uint32_t event_index)
891 assert (buf && port_buffer);
892 DummyMidiBuffer& source = * static_cast<DummyMidiBuffer*>(port_buffer);
893 if (event_index >= source.size ()) {
896 DummyMidiEvent * const event = source[event_index].get ();
898 timestamp = event->timestamp ();
899 size = event->size ();
900 *buf = event->data ();
905 DummyAudioBackend::midi_event_put (
908 const uint8_t* buffer, size_t size)
910 assert (buffer && port_buffer);
911 DummyMidiBuffer& dst = * static_cast<DummyMidiBuffer*>(port_buffer);
912 if (dst.size () && (pframes_t)dst.back ()->timestamp () > timestamp) {
913 fprintf (stderr, "DummyMidiBuffer: it's too late for this event.\n");
916 dst.push_back (boost::shared_ptr<DummyMidiEvent>(new DummyMidiEvent (timestamp, buffer, size)));
921 DummyAudioBackend::get_midi_event_count (void* port_buffer)
923 assert (port_buffer);
924 return static_cast<DummyMidiBuffer*>(port_buffer)->size ();
928 DummyAudioBackend::midi_clear (void* port_buffer)
930 assert (port_buffer);
931 DummyMidiBuffer * buf = static_cast<DummyMidiBuffer*>(port_buffer);
939 DummyAudioBackend::can_monitor_input () const
945 DummyAudioBackend::request_input_monitoring (PortEngine::PortHandle, bool)
951 DummyAudioBackend::ensure_input_monitoring (PortEngine::PortHandle, bool)
957 DummyAudioBackend::monitoring_input (PortEngine::PortHandle)
962 /* Latency management */
965 DummyAudioBackend::set_latency_range (PortEngine::PortHandle port, bool for_playback, LatencyRange latency_range)
967 if (!valid_port (port)) {
968 PBD::error << _("DummyPort::set_latency_range (): invalid port.") << endmsg;
970 static_cast<DummyPort*>(port)->set_latency_range (latency_range, for_playback);
974 DummyAudioBackend::get_latency_range (PortEngine::PortHandle port, bool for_playback)
976 if (!valid_port (port)) {
977 PBD::error << _("DummyPort::get_latency_range (): invalid port.") << endmsg;
983 return static_cast<DummyPort*>(port)->latency_range (for_playback);
986 /* Discovering physical ports */
989 DummyAudioBackend::port_is_physical (PortEngine::PortHandle port) const
991 if (!valid_port (port)) {
992 PBD::error << _("DummyPort::port_is_physical (): invalid port.") << endmsg;
995 return static_cast<DummyPort*>(port)->is_physical ();
999 DummyAudioBackend::get_physical_outputs (DataType type, std::vector<std::string>& port_names)
1001 for (size_t i = 0; i < _ports.size (); ++i) {
1002 DummyPort* port = _ports[i];
1003 if ((port->type () == type) && port->is_input () && port->is_physical ()) {
1004 port_names.push_back (port->name ());
1010 DummyAudioBackend::get_physical_inputs (DataType type, std::vector<std::string>& port_names)
1012 for (size_t i = 0; i < _ports.size (); ++i) {
1013 DummyPort* port = _ports[i];
1014 if ((port->type () == type) && port->is_output () && port->is_physical ()) {
1015 port_names.push_back (port->name ());
1021 DummyAudioBackend::n_physical_outputs () const
1025 for (size_t i = 0; i < _ports.size (); ++i) {
1026 DummyPort* port = _ports[i];
1027 if (port->is_output () && port->is_physical ()) {
1028 switch (port->type ()) {
1029 case DataType::AUDIO: ++n_audio; break;
1030 case DataType::MIDI: ++n_midi; break;
1036 cc.set (DataType::AUDIO, n_audio);
1037 cc.set (DataType::MIDI, n_midi);
1042 DummyAudioBackend::n_physical_inputs () const
1046 for (size_t i = 0; i < _ports.size (); ++i) {
1047 DummyPort* port = _ports[i];
1048 if (port->is_input () && port->is_physical ()) {
1049 switch (port->type ()) {
1050 case DataType::AUDIO: ++n_audio; break;
1051 case DataType::MIDI: ++n_midi; break;
1057 cc.set (DataType::AUDIO, n_audio);
1058 cc.set (DataType::MIDI, n_midi);
1062 /* Getting access to the data buffer for a port */
1065 DummyAudioBackend::get_buffer (PortEngine::PortHandle port, pframes_t nframes)
1068 assert (valid_port (port));
1069 return static_cast<DummyPort*>(port)->get_buffer (nframes);
1072 /* Engine Process */
1074 DummyAudioBackend::main_process_thread ()
1076 AudioEngine::thread_init_callback (this);
1078 _processed_samples = 0;
1080 manager.registration_callback();
1081 manager.graph_order_callback();
1083 uint64_t clock1, clock2;
1084 clock1 = g_get_monotonic_time();
1087 // re-set input buffers, generate on demand.
1088 for (std::vector<DummyAudioPort*>::const_iterator it = _system_inputs.begin (); it != _system_inputs.end (); ++it) {
1089 (*it)->next_period();
1091 for (std::vector<DummyMidiPort*>::const_iterator it = _system_midi_in.begin (); it != _system_midi_in.end (); ++it) {
1092 (*it)->next_period();
1095 if (engine.process_callback (_samples_per_period)) {
1098 _processed_samples += _samples_per_period;
1099 if (!_freewheeling) {
1100 clock2 = g_get_monotonic_time();
1101 const int64_t elapsed_time = clock2 - clock1;
1102 const int64_t nomial_time = 1e6 * _samples_per_period / _samplerate;
1103 _dsp_load = elapsed_time / (float) nomial_time;
1104 if (elapsed_time < nomial_time) {
1105 Glib::usleep (nomial_time - elapsed_time);
1107 Glib::usleep (100); // don't hog cpu
1111 Glib::usleep (100); // don't hog cpu
1113 clock1 = g_get_monotonic_time();
1115 bool connections_changed = false;
1116 bool ports_changed = false;
1117 if (!pthread_mutex_trylock (&_port_callback_mutex)) {
1118 if (_port_change_flag) {
1119 ports_changed = true;
1120 _port_change_flag = false;
1122 if (!_port_connection_queue.empty ()) {
1123 connections_changed = true;
1125 while (!_port_connection_queue.empty ()) {
1126 PortConnectData *c = _port_connection_queue.back ();
1127 manager.connect_callback (c->a, c->b, c->c);
1128 _port_connection_queue.pop_back ();
1131 pthread_mutex_unlock (&_port_callback_mutex);
1133 if (ports_changed) {
1134 manager.registration_callback();
1136 if (connections_changed) {
1137 manager.graph_order_callback();
1139 if (connections_changed || ports_changed) {
1140 engine.latency_callback(false);
1141 engine.latency_callback(true);
1150 /******************************************************************************/
1152 static boost::shared_ptr<DummyAudioBackend> _instance;
1154 static boost::shared_ptr<AudioBackend> backend_factory (AudioEngine& e);
1155 static int instantiate (const std::string& arg1, const std::string& /* arg2 */);
1156 static int deinstantiate ();
1157 static bool already_configured ();
1159 static ARDOUR::AudioBackendInfo _descriptor = {
1167 static boost::shared_ptr<AudioBackend>
1168 backend_factory (AudioEngine& e)
1171 _instance.reset (new DummyAudioBackend (e, _descriptor));
1177 instantiate (const std::string& arg1, const std::string& /* arg2 */)
1179 s_instance_name = arg1;
1191 already_configured ()
1196 extern "C" ARDOURBACKEND_API ARDOUR::AudioBackendInfo* descriptor ()
1198 return &_descriptor;
1202 /******************************************************************************/
1203 DummyPort::DummyPort (DummyAudioBackend &b, const std::string& name, PortFlags flags)
1204 : _dummy_backend (b)
1208 , _gen_cycle (false)
1210 _capture_latency_range.min = 0;
1211 _capture_latency_range.max = 0;
1212 _playback_latency_range.min = 0;
1213 _playback_latency_range.max = 0;
1214 _dummy_backend.port_connect_add_remove_callback();
1217 DummyPort::~DummyPort () {
1219 _dummy_backend.port_connect_add_remove_callback();
1223 int DummyPort::connect (DummyPort *port)
1226 PBD::error << _("DummyPort::connect (): invalid (null) port") << endmsg;
1230 if (type () != port->type ()) {
1231 PBD::error << _("DummyPort::connect (): wrong port-type") << endmsg;
1235 if (is_output () && port->is_output ()) {
1236 PBD::error << _("DummyPort::connect (): cannot inter-connect output ports.") << endmsg;
1240 if (is_input () && port->is_input ()) {
1241 PBD::error << _("DummyPort::connect (): cannot inter-connect input ports.") << endmsg;
1246 PBD::error << _("DummyPort::connect (): cannot self-connect ports.") << endmsg;
1250 if (is_connected (port)) {
1251 #if 0 // don't bother to warn about this for now. just ignore it
1252 PBD::error << _("DummyPort::connect (): ports are already connected:")
1253 << " (" << name () << ") -> (" << port->name () << ")"
1259 _connect (port, true);
1264 void DummyPort::_connect (DummyPort *port, bool callback)
1266 _connections.push_back (port);
1268 port->_connect (this, false);
1269 _dummy_backend.port_connect_callback (name(), port->name(), true);
1273 int DummyPort::disconnect (DummyPort *port)
1276 PBD::error << _("DummyPort::disconnect (): invalid (null) port") << endmsg;
1280 if (!is_connected (port)) {
1281 PBD::error << _("DummyPort::disconnect (): ports are not connected:")
1282 << " (" << name () << ") -> (" << port->name () << ")"
1286 _disconnect (port, true);
1290 void DummyPort::_disconnect (DummyPort *port, bool callback)
1292 std::vector<DummyPort*>::iterator it = std::find (_connections.begin (), _connections.end (), port);
1294 assert (it != _connections.end ());
1296 _connections.erase (it);
1299 port->_disconnect (this, false);
1300 _dummy_backend.port_connect_callback (name(), port->name(), false);
1305 void DummyPort::disconnect_all ()
1307 while (!_connections.empty ()) {
1308 _connections.back ()->_disconnect (this, false);
1309 _dummy_backend.port_connect_callback (name(), _connections.back ()->name(), false);
1310 _connections.pop_back ();
1315 DummyPort::is_connected (const DummyPort *port) const
1317 return std::find (_connections.begin (), _connections.end (), port) != _connections.end ();
1320 bool DummyPort::is_physically_connected () const
1322 for (std::vector<DummyPort*>::const_iterator it = _connections.begin (); it != _connections.end (); ++it) {
1323 if ((*it)->is_physical ()) {
1330 void DummyPort::setup_random_number_generator ()
1332 _rseed = g_get_monotonic_time() % UINT_MAX;
1338 // 31bit Park-Miller-Carta Pseudo-Random Number Generator
1339 // http://www.firstpr.com.au/dsp/rand31/
1341 lo = 16807 * (_rseed & 0xffff);
1342 hi = 16807 * (_rseed >> 16);
1344 lo += (hi & 0x7fff) << 16;
1347 lo = (lo & 0x7fffffff) + (lo >> 31);
1349 if (lo > 0x7fffffff) { lo -= 0x7fffffff; }
1351 return (_rseed = lo);
1357 return (randi() / 1073741824.f) - 1.f;
1360 /******************************************************************************/
1362 DummyAudioPort::DummyAudioPort (DummyAudioBackend &b, const std::string& name, PortFlags flags)
1363 : DummyPort (b, name, flags)
1364 , _gen_type (Silence)
1380 memset (_buffer, 0, sizeof (_buffer));
1383 DummyAudioPort::~DummyAudioPort () {
1388 void DummyAudioPort::setup_generator (GeneratorType const g, float const samplerate)
1390 DummyPort::setup_random_number_generator();
1393 switch (_gen_type) {
1396 case UniformWhiteNoise:
1397 case GaussianWhiteNoise:
1401 _gen_period = (5 + randi() % (int)(samplerate / 20.f));
1404 _gen_period = (5 + randi() % (int)(samplerate / 20.f)) & ~1;
1407 _gen_period = 5 + randi() % (int)(samplerate / 20.f);
1408 _wavetable = (Sample*) malloc (_gen_period * sizeof(Sample));
1409 for (uint32_t i = 0 ; i < _gen_period; ++i) {
1410 _wavetable[i] = .12589f * sinf(2.0f * M_PI * (float)i / (float)_gen_period); // -18dBFS
1414 case SineSweepSwell:
1416 _gen_period = 5 * samplerate + randi() % (int)(samplerate * 10.f);
1417 _wavetable = (Sample*) malloc (_gen_period * sizeof(Sample));
1418 _gen_perio2 = 1 | (int)ceilf (_gen_period * .89f); // Volume Swell period
1419 const double f_min = 20.;
1420 const double f_max = samplerate * .5;
1422 const double b = (f_max - f_min) / (2. * samplerate * _gen_period);
1423 const double a = f_min / samplerate;
1425 const double b = log (f_max / f_min) / _gen_period;
1426 const double a = f_min / (b * samplerate);
1428 for (uint32_t i = 0 ; i < _gen_period; ++i) {
1430 const double phase = i * (a + b * i);
1432 const double phase = a * exp (b * i) - a;
1434 _wavetable[i] = (float)sin (2. * M_PI * (phase - floor (phase)));
1441 float DummyAudioPort::grandf ()
1443 // Gaussian White Noise
1444 // http://www.musicdsp.org/archive.php?classid=0#109
1455 r = x1 * x1 + x2 * x2;
1456 } while ((r >= 1.0f) || (r < 1e-22f));
1458 r = sqrtf (-2.f * logf (r) / r);
1465 void DummyAudioPort::generate (const pframes_t n_samples)
1467 Glib::Threads::Mutex::Lock lm (generator_lock);
1472 switch (_gen_type) {
1474 memset (_buffer, 0, n_samples * sizeof (Sample));
1477 assert(_gen_period > 0);
1478 for (pframes_t i = 0 ; i < n_samples; ++i) {
1479 if (_gen_offset < _gen_period * .5f) {
1480 _buffer[i] = .40709f; // -6dBFS
1482 _buffer[i] = -.40709f;
1484 _gen_offset = (_gen_offset + 1) % _gen_period;
1488 assert(_gen_period > 0);
1489 memset (_buffer, 0, n_samples * sizeof (Sample));
1490 for (pframes_t i = 0; i < n_samples; ++i) {
1491 if (_gen_offset == 0) {
1494 _gen_offset = (_gen_offset + 1) % _gen_period;
1497 case SineSweepSwell:
1498 assert(_wavetable && _gen_period > 0);
1500 const float vols = 2.f / (float)_gen_perio2;
1501 for (pframes_t i = 0; i < n_samples; ++i) {
1502 const float g = fabsf (_gen_count2 * vols - 1.0);
1503 _buffer[i] = g * _wavetable[_gen_offset];
1504 _gen_offset = (_gen_offset + 1) % _gen_period;
1505 _gen_count2 = (_gen_count2 + 1) % _gen_perio2;
1511 assert(_wavetable && _gen_period > 0);
1513 pframes_t written = 0;
1514 while (written < n_samples) {
1515 const uint32_t remain = n_samples - written;
1516 const uint32_t to_copy = std::min(remain, _gen_period - _gen_offset);
1517 memcpy((void*)&_buffer[written],
1518 (void*)&_wavetable[_gen_offset],
1519 to_copy * sizeof(Sample));
1521 _gen_offset = (_gen_offset + to_copy) % _gen_period;
1525 case UniformWhiteNoise:
1526 for (pframes_t i = 0 ; i < n_samples; ++i) {
1527 _buffer[i] = .158489f * randf();
1530 case GaussianWhiteNoise:
1531 for (pframes_t i = 0 ; i < n_samples; ++i) {
1532 _buffer[i] = .089125f * grandf();
1536 for (pframes_t i = 0 ; i < n_samples; ++i) {
1537 // Paul Kellet's refined method
1538 // http://www.musicdsp.org/files/pink.txt
1539 // NB. If 'white' consists of uniform random numbers,
1540 // the pink noise will have an almost gaussian distribution.
1541 const float white = .0498f * randf ();
1542 _b0 = .99886f * _b0 + white * .0555179f;
1543 _b1 = .99332f * _b1 + white * .0750759f;
1544 _b2 = .96900f * _b2 + white * .1538520f;
1545 _b3 = .86650f * _b3 + white * .3104856f;
1546 _b4 = .55000f * _b4 + white * .5329522f;
1547 _b5 = -.7616f * _b5 - white * .0168980f;
1548 _buffer[i] = _b0 + _b1 + _b2 + _b3 + _b4 + _b5 + _b6 + white * 0.5362f;
1549 _b6 = white * 0.115926f;
1553 for (pframes_t i = 0 ; i < n_samples; ++i) {
1554 const float white = 0.0498f * randf ();
1555 // Paul Kellet's economy method
1556 // http://www.musicdsp.org/files/pink.txt
1557 _b0 = 0.99765f * _b0 + white * 0.0990460f;
1558 _b1 = 0.96300f * _b1 + white * 0.2965164f;
1559 _b2 = 0.57000f * _b2 + white * 1.0526913f;
1560 _buffer[i] = _b0 + _b1 + _b2 + white * 0.1848f;
1567 void* DummyAudioPort::get_buffer (pframes_t n_samples)
1570 std::vector<DummyPort*>::const_iterator it = get_connections ().begin ();
1571 if (it == get_connections ().end ()) {
1572 memset (_buffer, 0, n_samples * sizeof (Sample));
1574 DummyAudioPort * source = static_cast<DummyAudioPort*>(*it);
1575 assert (source && source->is_output ());
1576 if (source->is_physical() && source->is_terminal()) {
1577 source->get_buffer(n_samples); // generate signal.
1579 memcpy (_buffer, source->const_buffer (), n_samples * sizeof (Sample));
1580 while (++it != get_connections ().end ()) {
1581 source = static_cast<DummyAudioPort*>(*it);
1582 assert (source && source->is_output ());
1583 Sample* dst = buffer ();
1584 if (source->is_physical() && source->is_terminal()) {
1585 source->get_buffer(n_samples); // generate signal.
1587 const Sample* src = source->const_buffer ();
1588 for (uint32_t s = 0; s < n_samples; ++s, ++dst, ++src) {
1593 } else if (is_output () && is_physical () && is_terminal()) {
1595 generate(n_samples);
1602 DummyMidiPort::DummyMidiPort (DummyAudioBackend &b, const std::string& name, PortFlags flags)
1603 : DummyPort (b, name, flags)
1605 , _midi_seq_time (0)
1611 DummyMidiPort::~DummyMidiPort () { }
1613 struct MidiEventSorter {
1614 bool operator() (const boost::shared_ptr<DummyMidiEvent>& a, const boost::shared_ptr<DummyMidiEvent>& b) {
1619 void DummyMidiPort::setup_generator (int seq_id, const float sr)
1621 DummyPort::setup_random_number_generator();
1624 _midi_seq_dat = DummyMidiData::s1;
1627 _midi_seq_dat = DummyMidiData::s2;
1630 _midi_seq_dat = DummyMidiData::s3;
1633 _midi_seq_dat = DummyMidiData::s0;
1636 _midi_seq_spb = sr * .5f; // 120 BPM, beat_time 1.0 per beat.
1641 void DummyMidiPort::midi_generate (const pframes_t n_samples)
1643 Glib::Threads::Mutex::Lock lm (generator_lock);
1651 if (_midi_seq_spb == 0 || !_midi_seq_dat) {
1656 const int32_t ev_beat_time = _midi_seq_dat[_midi_seq_pos].beat_time * _midi_seq_spb - _midi_seq_time;
1657 if (ev_beat_time < 0) {
1660 if ((pframes_t) ev_beat_time >= n_samples) {
1663 _buffer.push_back (boost::shared_ptr<DummyMidiEvent>(new DummyMidiEvent (
1664 ev_beat_time, _midi_seq_dat[_midi_seq_pos].event, 3
1668 if (_midi_seq_dat[_midi_seq_pos].event[0] == 0xff && _midi_seq_dat[_midi_seq_pos].event[1] == 0xff) {
1669 _midi_seq_time -= _midi_seq_dat[_midi_seq_pos].beat_time * _midi_seq_spb;
1673 _midi_seq_time += n_samples;
1677 void* DummyMidiPort::get_buffer (pframes_t n_samples)
1681 for (std::vector<DummyPort*>::const_iterator i = get_connections ().begin ();
1682 i != get_connections ().end ();
1684 DummyMidiPort * source = static_cast<DummyMidiPort*>(*i);
1685 if (source->is_physical() && source->is_terminal()) {
1686 source->get_buffer(n_samples); // generate signal.
1688 const DummyMidiBuffer src = static_cast<const DummyMidiPort*>(*i)->const_buffer ();
1689 for (DummyMidiBuffer::const_iterator it = src.begin (); it != src.end (); ++it) {
1690 _buffer.push_back (boost::shared_ptr<DummyMidiEvent>(new DummyMidiEvent (**it)));
1693 std::sort (_buffer.begin (), _buffer.end (), MidiEventSorter());
1694 } else if (is_output () && is_physical () && is_terminal()) {
1696 midi_generate(n_samples);
1702 DummyMidiEvent::DummyMidiEvent (const pframes_t timestamp, const uint8_t* data, size_t size)
1704 , _timestamp (timestamp)
1708 _data = (uint8_t*) malloc (size);
1709 memcpy (_data, data, size);
1713 DummyMidiEvent::DummyMidiEvent (const DummyMidiEvent& other)
1714 : _size (other.size ())
1715 , _timestamp (other.timestamp ())
1718 if (other.size () && other.const_data ()) {
1719 _data = (uint8_t*) malloc (other.size ());
1720 memcpy (_data, other.const_data (), other.size ());
1724 DummyMidiEvent::~DummyMidiEvent () {