don't run MIDI clock "tick" if session is silent (e.g. due to a locate)
[ardour.git] / libs / ardour / session_process.cc
1 /*
2     Copyright (C) 1999-2002 Paul Davis
3
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.
8
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.
13
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.
17
18 */
19
20 #include <cmath>
21 #include <cerrno>
22 #include <algorithm>
23 #include <unistd.h>
24
25 #include "pbd/error.h"
26 #include "pbd/enumwriter.h"
27
28 #include <glibmm/threads.h>
29
30 #include "ardour/audioengine.h"
31 #include "ardour/auditioner.h"
32 #include "ardour/butler.h"
33 #include "ardour/cycle_timer.h"
34 #include "ardour/debug.h"
35 #include "ardour/graph.h"
36 #include "ardour/port.h"
37 #include "ardour/process_thread.h"
38 #include "ardour/session.h"
39 #include "ardour/slave.h"
40 #include "ardour/ticker.h"
41 #include "ardour/types.h"
42
43 #include "midi++/mmc.h"
44
45 #include "i18n.h"
46
47 using namespace ARDOUR;
48 using namespace PBD;
49 using namespace std;
50
51 /** Called by the audio engine when there is work to be done with JACK.
52  * @param nframes Number of frames to process.
53  */
54
55 void
56 Session::process (pframes_t nframes)
57 {
58         framepos_t transport_at_start = _transport_frame;
59
60         _silent = false;
61
62         if (processing_blocked()) {
63                 _silent = true;
64                 return;
65         }
66
67         if (non_realtime_work_pending()) {
68                 if (!_butler->transport_work_requested ()) {
69                         post_transport ();
70                 }
71         }
72
73         _engine.main_thread()->get_buffers ();
74
75         (this->*process_function) (nframes);
76
77         _engine.main_thread()->drop_buffers ();
78
79         /* deliver MIDI clock. Note that we need to use the transport frame
80          * position at the start of process(), not the value at the end of
81          * it. We may already have ticked() because of a transport state
82          * change, for example.
83          */
84
85         try {
86                 if (!_silent && !_engine.freewheeling() && Config->get_send_midi_clock() && (transport_speed() == 1.0f || transport_speed() == 0.0f) && midi_clock->has_midi_port()) {
87                         midi_clock->tick (transport_at_start, nframes);
88                 }
89         } catch (...) {
90                 /* don't bother with a message */
91         }
92
93         SendFeedback (); /* EMIT SIGNAL */
94 }
95
96 int
97 Session::fail_roll (pframes_t nframes)
98 {
99         return no_roll (nframes);
100 }
101
102 int
103 Session::no_roll (pframes_t nframes)
104 {
105         PT_TIMING_CHECK (4);
106         
107         framepos_t end_frame = _transport_frame + nframes; // FIXME: varispeed + no_roll ??
108         int ret = 0;
109         int declick = get_transport_declick_required();
110         boost::shared_ptr<RouteList> r = routes.reader ();
111
112         if (_click_io) {
113                 _click_io->silence (nframes);
114         }
115
116         ltc_tx_send_time_code_for_cycle (_transport_frame, end_frame, _target_transport_speed, _transport_speed, nframes);
117
118         if (_process_graph) {
119                 DEBUG_TRACE(DEBUG::ProcessThreads,"calling graph/no-roll\n");
120                 _process_graph->routes_no_roll( nframes, _transport_frame, end_frame, non_realtime_work_pending(), declick);
121         } else {
122                 PT_TIMING_CHECK (10);
123                 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
124
125                         if ((*i)->is_auditioner()) {
126                                 continue;
127                         }
128
129                         (*i)->set_pending_declick (declick);
130
131                         if ((*i)->no_roll (nframes, _transport_frame, end_frame, non_realtime_work_pending())) {
132                                 error << string_compose(_("Session: error in no roll for %1"), (*i)->name()) << endmsg;
133                                 ret = -1;
134                                 break;
135                         }
136                 }
137                 PT_TIMING_CHECK (11);
138         }
139
140         PT_TIMING_CHECK (5);
141         return ret;
142 }
143
144 /** @param need_butler to be set to true by this method if it needs the butler,
145  *  otherwise it must be left alone.
146  */
147 int
148 Session::process_routes (pframes_t nframes, bool& need_butler)
149 {
150         int  declick = get_transport_declick_required();
151         boost::shared_ptr<RouteList> r = routes.reader ();
152
153         if (transport_sub_state & StopPendingCapture) {
154                 /* force a declick out */
155                 declick = -1;
156         }
157
158         const framepos_t start_frame = _transport_frame;
159         const framepos_t end_frame = _transport_frame + floor (nframes * _transport_speed);
160         
161         if (_process_graph) {
162                 DEBUG_TRACE(DEBUG::ProcessThreads,"calling graph/process-routes\n");
163                 _process_graph->process_routes (nframes, start_frame, end_frame, declick, need_butler);
164         } else {
165
166                 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
167
168                         int ret;
169
170                         if ((*i)->is_auditioner()) {
171                                 continue;
172                         }
173
174                         (*i)->set_pending_declick (declick);
175
176                         bool b = false;
177
178                         if ((ret = (*i)->roll (nframes, start_frame, end_frame, declick, b)) < 0) {
179                                 stop_transport ();
180                                 return -1;
181                         }
182
183                         if (b) {
184                                 need_butler = true;
185                         }
186                 }
187         }
188
189         return 0;
190 }
191
192 /** @param need_butler to be set to true by this method if it needs the butler,
193  *  otherwise it must be left alone.
194  */
195 int
196 Session::silent_process_routes (pframes_t nframes, bool& need_butler)
197 {
198         boost::shared_ptr<RouteList> r = routes.reader ();
199
200         const framepos_t start_frame = _transport_frame;
201         const framepos_t end_frame = _transport_frame + lrintf(nframes * _transport_speed);
202
203         if (_process_graph) {
204                 _process_graph->silent_process_routes (nframes, start_frame, end_frame, need_butler);
205         } else {
206                 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
207
208                         int ret;
209
210                         if ((*i)->is_auditioner()) {
211                                 continue;
212                         }
213
214                         bool b = false;
215
216                         if ((ret = (*i)->silent_roll (nframes, start_frame, end_frame, b)) < 0) {
217                                 stop_transport ();
218                                 return -1;
219                         }
220
221                         if (b) {
222                                 need_butler = true;
223                         }
224                 }
225         }
226
227         return 0;
228 }
229
230 void
231 Session::get_track_statistics ()
232 {
233         float pworst = 1.0f;
234         float cworst = 1.0f;
235
236         boost::shared_ptr<RouteList> rl = routes.reader();
237         for (RouteList::iterator i = rl->begin(); i != rl->end(); ++i) {
238
239                 boost::shared_ptr<Track> tr = boost::dynamic_pointer_cast<Track> (*i);
240
241                 if (!tr || tr->hidden()) {
242                         continue;
243                 }
244
245                 pworst = min (pworst, tr->playback_buffer_load());
246                 cworst = min (cworst, tr->capture_buffer_load());
247         }
248
249         g_atomic_int_set (&_playback_load, (uint32_t) floor (pworst * 100.0f));
250         g_atomic_int_set (&_capture_load, (uint32_t) floor (cworst * 100.0f));
251
252         if (actively_recording()) {
253                 set_dirty();
254         }
255 }
256
257 /** Process callback used when the auditioner is not active */
258 void
259 Session::process_with_events (pframes_t nframes)
260 {
261         PT_TIMING_CHECK (3);
262         
263         SessionEvent*  ev;
264         pframes_t      this_nframes;
265         framepos_t     end_frame;
266         bool           session_needs_butler = false;
267         framecnt_t     frames_moved;
268
269         /* make sure the auditioner is silent */
270
271         if (auditioner) {
272                 auditioner->silence (nframes);
273         }
274
275         /* handle any pending events */
276
277         while (pending_events.read (&ev, 1) == 1) {
278                 merge_event (ev);
279         }
280
281         /* if we are not in the middle of a state change,
282            and there are immediate events queued up,
283            process them.
284         */
285
286         while (!non_realtime_work_pending() && !immediate_events.empty()) {
287                 SessionEvent *ev = immediate_events.front ();
288                 immediate_events.pop_front ();
289                 process_event (ev);
290         }
291
292         /* Decide on what to do with quarter-frame MTC during this cycle */
293
294         bool const was_sending_qf_mtc = _send_qf_mtc;
295         double const tolerance = Config->get_mtc_qf_speed_tolerance() / 100.0;
296
297         if (_transport_speed != 0) {
298                 _send_qf_mtc = (
299                         Config->get_send_mtc () &&
300                         _transport_speed >= (1 - tolerance) &&
301                         _transport_speed <= (1 + tolerance)
302                         );
303
304                 if (_send_qf_mtc && !was_sending_qf_mtc) {
305                         /* we will re-start quarter-frame MTC this cycle, so send a full update to set things up */
306                         _send_timecode_update = true;
307                 }
308
309                 if (Config->get_send_mtc() && !_send_qf_mtc && _pframes_since_last_mtc > (frame_rate () / 4)) {
310                         /* we're sending MTC, but we're not sending QF MTC at the moment, and it's been
311                            a quarter of a second since we sent anything at all, so send a full MTC update
312                            this cycle.
313                         */
314                         _send_timecode_update = true;
315                 }
316
317                 _pframes_since_last_mtc += nframes;
318         }
319
320         /* Events caused a transport change (or we re-started sending
321          * MTC), so send an MTC Full Frame (Timecode) message.  This
322          * is sent whether rolling or not, to give slaves an idea of
323          * ardour time on locates (and allow slow slaves to position
324          * and prepare for rolling)
325          */
326         if (_send_timecode_update) {
327                 send_full_time_code (_transport_frame, nframes);
328         }
329
330         if (!process_can_proceed()) {
331                 _silent = true;
332                 return;
333         }
334
335         if (events.empty() || next_event == events.end()) {
336                 process_without_events (nframes);
337                 return;
338         }
339
340         if (_transport_speed == 1.0) {
341                 frames_moved = (framecnt_t) nframes;
342         } else {
343                 interpolation.set_target_speed (_target_transport_speed);
344                 interpolation.set_speed (_transport_speed);
345                 frames_moved = (framecnt_t) interpolation.interpolate (0, nframes, 0, 0);
346         }
347
348         end_frame = _transport_frame + frames_moved;
349
350         {
351                 SessionEvent* this_event;
352                 Events::iterator the_next_one;
353
354                 if (!process_can_proceed()) {
355                         _silent = true;
356                         return;
357                 }
358
359                 if (!_exporting && _slave) {
360                         if (!follow_slave (nframes)) {
361                                 return;
362                         }
363                 }
364
365                 if (_transport_speed == 0) {
366                         no_roll (nframes);
367                         return;
368                 }
369
370                 if (!_exporting && !timecode_transmission_suspended()) {
371                         send_midi_time_code_for_cycle (_transport_frame, end_frame, nframes);
372                 }
373
374                 framepos_t stop_limit = compute_stop_limit ();
375
376                 if (maybe_stop (stop_limit)) {
377                         no_roll (nframes);
378                         return;
379                 }
380
381                 this_event = *next_event;
382                 the_next_one = next_event;
383                 ++the_next_one;
384
385                 /* yes folks, here it is, the actual loop where we really truly
386                    process some audio
387                 */
388
389                 while (nframes) {
390
391                         this_nframes = nframes; /* real (jack) time relative */
392                         frames_moved = (framecnt_t) floor (_transport_speed * nframes); /* transport relative */
393
394                         /* running an event, position transport precisely to its time */
395                         if (this_event && this_event->action_frame <= end_frame && this_event->action_frame >= _transport_frame) {
396                                 /* this isn't quite right for reverse play */
397                                 frames_moved = (framecnt_t) (this_event->action_frame - _transport_frame);
398                                 this_nframes = abs (floor(frames_moved / _transport_speed));
399                         }
400
401                         if (this_nframes) {
402
403                                 click (_transport_frame, this_nframes);
404
405                                 if (process_routes (this_nframes, session_needs_butler)) {
406                                         fail_roll (nframes);
407                                         return;
408                                 }
409
410                                 get_track_statistics ();
411
412                                 nframes -= this_nframes;
413
414                                 if (frames_moved < 0) {
415                                         decrement_transport_position (-frames_moved);
416                                 } else {
417                                         increment_transport_position (frames_moved);
418                                 }
419
420                                 maybe_stop (stop_limit);
421                                 check_declick_out ();
422                         }
423
424                         _engine.split_cycle (this_nframes);
425
426                         /* now handle this event and all others scheduled for the same time */
427
428                         while (this_event && this_event->action_frame == _transport_frame) {
429                                 process_event (this_event);
430
431                                 if (the_next_one == events.end()) {
432                                         this_event = 0;
433                                 } else {
434                                         this_event = *the_next_one;
435                                         ++the_next_one;
436                                 }
437                         }
438
439                         /* if an event left our state changing, do the right thing */
440
441                         if (nframes && non_realtime_work_pending()) {
442                                 no_roll (nframes);
443                                 break;
444                         }
445
446                         /* this is necessary to handle the case of seamless looping */
447                         end_frame = _transport_frame + floor (nframes * _transport_speed);
448                 }
449
450                 set_next_event ();
451
452         } /* implicit release of route lock */
453
454         if (session_needs_butler) {
455                 _butler->summon ();
456         }
457 }
458
459 void
460 Session::reset_slave_state ()
461 {
462         average_slave_delta = 1800;
463         delta_accumulator_cnt = 0;
464         have_first_delta_accumulator = false;
465         _slave_state = Stopped;
466 }
467
468 bool
469 Session::transport_locked () const
470 {
471         Slave* sl = _slave;
472
473         if (!locate_pending() && (!config.get_external_sync() || (sl && sl->ok() && sl->locked()))) {
474                 return true;
475         }
476
477         return false;
478 }
479
480 bool
481 Session::follow_slave (pframes_t nframes)
482 {
483         double slave_speed;
484         framepos_t slave_transport_frame;
485         framecnt_t this_delta;
486         int dir;
487
488         if (!_slave->ok()) {
489                 stop_transport ();
490                 config.set_external_sync (false);
491                 goto noroll;
492         }
493
494         _slave->speed_and_position (slave_speed, slave_transport_frame);
495
496         DEBUG_TRACE (DEBUG::Slave, string_compose ("Slave position %1 speed %2\n", slave_transport_frame, slave_speed));
497
498         if (!_slave->locked()) {
499                 DEBUG_TRACE (DEBUG::Slave, "slave not locked\n");
500                 goto noroll;
501         }
502
503         if (slave_transport_frame > _transport_frame) {
504                 this_delta = slave_transport_frame - _transport_frame;
505                 dir = 1;
506         } else {
507                 this_delta = _transport_frame - slave_transport_frame;
508                 dir = -1;
509         }
510
511         if (_slave->starting()) {
512                 slave_speed = 0.0f;
513         }
514
515         if (_slave->is_always_synced() ||
516                         (Config->get_timecode_source_is_synced() && (dynamic_cast<TimecodeSlave*>(_slave)) != 0)
517                         ) {
518
519                 /* if the TC source is synced, then we assume that its
520                    speed is binary: 0.0 or 1.0
521                 */
522
523                 if (slave_speed != 0.0f) {
524                         slave_speed = 1.0f;
525                 }
526
527         } else {
528
529                 /* if we are chasing and the average delta between us and the
530                    master gets too big, we want to switch to silent
531                    motion. so keep track of that here.
532                 */
533
534                 if (_slave_state == Running) {
535                         calculate_moving_average_of_slave_delta(dir, this_delta);
536                 }
537         }
538
539         track_slave_state (slave_speed, slave_transport_frame, this_delta);
540
541         DEBUG_TRACE (DEBUG::Slave, string_compose ("slave state %1 @ %2 speed %3 cur delta %4 avg delta %5\n",
542                                                    _slave_state, slave_transport_frame, slave_speed, this_delta, average_slave_delta));
543
544
545         if (_slave_state == Running && !_slave->is_always_synced() &&
546                         !(Config->get_timecode_source_is_synced() && (dynamic_cast<TimecodeSlave*>(_slave)) != 0)
547                         ) {
548
549                 if (_transport_speed != 0.0f) {
550
551                         /*
552                            note that average_dir is +1 or -1
553                         */
554
555                         float delta;
556
557                         if (average_slave_delta == 0) {
558                                 delta = this_delta;
559                                 delta *= dir;
560                         } else {
561                                 delta = average_slave_delta;
562                                 delta *= average_dir;
563                         }
564
565 #ifndef NDEBUG
566                         if (slave_speed != 0.0) {
567                                 DEBUG_TRACE (DEBUG::Slave, string_compose ("delta = %1 speed = %2 ts = %3 M@%4 S@%5 avgdelta %6\n",
568                                                                            (int) (dir * this_delta),
569                                                                            slave_speed,
570                                                                            _transport_speed,
571                                                                            _transport_frame,
572                                                                            slave_transport_frame,
573                                                                            average_slave_delta));
574                         }
575 #endif
576
577                         if (_slave->give_slave_full_control_over_transport_speed()) {
578                                 set_transport_speed (slave_speed, false, false);
579                                 //std::cout << "set speed = " << slave_speed << "\n";
580                         } else {
581                                 float adjusted_speed = slave_speed + (1.5 * (delta /  float(_current_frame_rate)));
582                                 request_transport_speed (adjusted_speed);
583                                 DEBUG_TRACE (DEBUG::Slave, string_compose ("adjust using %1 towards %2 ratio %3 current %4 slave @ %5\n",
584                                                                            delta, adjusted_speed, adjusted_speed/slave_speed, _transport_speed,
585                                                                            slave_speed));
586                         }
587
588 #if 1
589                         if (!actively_recording() && (framecnt_t) abs(average_slave_delta) > _slave->resolution()) {
590                                 cerr << "average slave delta greater than slave resolution (" << _slave->resolution() << "), going to silent motion\n";
591                                 goto silent_motion;
592                         }
593 #endif
594                 }
595         }
596
597
598         if (_slave_state == Running && !non_realtime_work_pending()) {
599                 /* speed is set, we're locked, and good to go */
600                 return true;
601         }
602
603   silent_motion:
604         DEBUG_TRACE (DEBUG::Slave, "silent motion\n")
605         follow_slave_silently (nframes, slave_speed);
606
607   noroll:
608         /* don't move at all */
609         DEBUG_TRACE (DEBUG::Slave, "no roll\n")
610         no_roll (nframes);
611         return false;
612 }
613
614 void
615 Session::calculate_moving_average_of_slave_delta (int dir, framecnt_t this_delta)
616 {
617         if (delta_accumulator_cnt >= delta_accumulator_size) {
618                 have_first_delta_accumulator = true;
619                 delta_accumulator_cnt = 0;
620         }
621
622         if (delta_accumulator_cnt != 0 || this_delta < _current_frame_rate) {
623                 delta_accumulator[delta_accumulator_cnt++] = (framecnt_t) dir *  (framecnt_t) this_delta;
624         }
625
626         if (have_first_delta_accumulator) {
627                 average_slave_delta = 0L;
628                 for (int i = 0; i < delta_accumulator_size; ++i) {
629                         average_slave_delta += delta_accumulator[i];
630                 }
631                 average_slave_delta /= (int32_t) delta_accumulator_size;
632                 if (average_slave_delta < 0L) {
633                         average_dir = -1;
634                         average_slave_delta = abs(average_slave_delta);
635                 } else {
636                         average_dir = 1;
637                 }
638         }
639 }
640
641 void
642 Session::track_slave_state (float slave_speed, framepos_t slave_transport_frame, framecnt_t /*this_delta*/)
643 {
644         if (slave_speed != 0.0f) {
645
646                 /* slave is running */
647
648                 switch (_slave_state) {
649                 case Stopped:
650                         if (_slave->requires_seekahead()) {
651                                 slave_wait_end = slave_transport_frame + _slave->seekahead_distance ();
652                                 DEBUG_TRACE (DEBUG::Slave, string_compose ("slave stopped, but running, requires seekahead to %1\n", slave_wait_end));
653                                 /* we can call locate() here because we are in process context */
654                                 locate (slave_wait_end, false, false);
655                                 _slave_state = Waiting;
656
657                         } else {
658
659                                 DEBUG_TRACE (DEBUG::Slave, string_compose ("slave stopped -> running at %1\n", slave_transport_frame));
660
661                                 memset (delta_accumulator, 0, sizeof (int32_t) * delta_accumulator_size);
662                                 average_slave_delta = 0L;
663
664                                 Location* al = _locations->auto_loop_location();
665
666                                 if (al && play_loop && (slave_transport_frame < al->start() || slave_transport_frame > al->end())) {
667                                         // cancel looping
668                                         request_play_loop(false);
669                                 }
670
671                                 if (slave_transport_frame != _transport_frame) {
672                                         DEBUG_TRACE (DEBUG::Slave, string_compose ("require locate to run. eng: %1 -> sl: %2\n", _transport_frame, slave_transport_frame));
673                                         locate (slave_transport_frame, false, false);
674                                 }
675                                 _slave_state = Running;
676                         }
677                         break;
678
679                 case Waiting:
680                 default:
681                         break;
682                 }
683
684                 if (_slave_state == Waiting) {
685
686                         DEBUG_TRACE (DEBUG::Slave, string_compose ("slave waiting at %1\n", slave_transport_frame));
687
688                         if (slave_transport_frame >= slave_wait_end) {
689
690                                 DEBUG_TRACE (DEBUG::Slave, string_compose ("slave start at %1 vs %2\n", slave_transport_frame, _transport_frame));
691
692                                 _slave_state = Running;
693
694                                 /* now perform a "micro-seek" within the disk buffers to realign ourselves
695                                    precisely with the master.
696                                 */
697
698
699                                 bool ok = true;
700                                 framecnt_t frame_delta = slave_transport_frame - _transport_frame;
701
702                                 boost::shared_ptr<RouteList> rl = routes.reader();
703                                 for (RouteList::iterator i = rl->begin(); i != rl->end(); ++i) {
704                                         boost::shared_ptr<Track> tr = boost::dynamic_pointer_cast<Track> (*i);
705                                         if (tr && !tr->can_internal_playback_seek (frame_delta)) {
706                                                 ok = false;
707                                                 break;
708                                         }
709                                 }
710
711                                 if (ok) {
712                                         for (RouteList::iterator i = rl->begin(); i != rl->end(); ++i) {
713                                                 boost::shared_ptr<Track> tr = boost::dynamic_pointer_cast<Track> (*i);
714                                                 if (tr) {
715                                                         tr->internal_playback_seek (frame_delta);
716                                                 }
717                                         }
718                                         _transport_frame += frame_delta;
719
720                                 } else {
721                                         cerr << "cannot micro-seek\n";
722                                         /* XXX what? */
723                                 }
724                         }
725                 }
726
727                 if (_slave_state == Running && _transport_speed == 0.0f) {
728                         DEBUG_TRACE (DEBUG::Slave, "slave starts transport\n");
729                         start_transport ();
730                 }
731
732         } else { // slave_speed is 0
733
734                 /* slave has stopped */
735
736                 if (_transport_speed != 0.0f) {
737                         DEBUG_TRACE (DEBUG::Slave, string_compose ("slave stops transport: %1 frame %2 tf %3\n", slave_speed, slave_transport_frame, _transport_frame));
738                         stop_transport ();
739                 }
740
741                 if (slave_transport_frame != _transport_frame) {
742                         DEBUG_TRACE (DEBUG::Slave, string_compose ("slave stopped, move to %1\n", slave_transport_frame));
743                         force_locate (slave_transport_frame, false);
744                 }
745
746                 reset_slave_state();
747         }
748 }
749
750 void
751 Session::follow_slave_silently (pframes_t nframes, float slave_speed)
752 {
753         if (slave_speed && _transport_speed) {
754
755                 /* something isn't right, but we should move with the master
756                    for now.
757                 */
758
759                 bool need_butler;
760
761                 silent_process_routes (nframes, need_butler);
762
763                 get_track_statistics ();
764
765                 if (need_butler) {
766                         _butler->summon ();
767                 }
768
769                 int32_t frames_moved = (int32_t) floor (_transport_speed * nframes);
770
771                 if (frames_moved < 0) {
772                         decrement_transport_position (-frames_moved);
773                 } else {
774                         increment_transport_position (frames_moved);
775                 }
776
777                 framepos_t const stop_limit = compute_stop_limit ();
778                 maybe_stop (stop_limit);
779         }
780 }
781
782 void
783 Session::process_without_events (pframes_t nframes)
784 {
785         bool session_needs_butler = false;
786         framecnt_t frames_moved;
787
788         if (!process_can_proceed()) {
789                 _silent = true;
790                 return;
791         }
792
793         if (!_exporting && _slave) {
794                 if (!follow_slave (nframes)) {
795                         ltc_tx_send_time_code_for_cycle (_transport_frame, _transport_frame, 0, 0 , nframes);
796                         return;
797                 }
798         }
799
800         if (_transport_speed == 0) {
801                 fail_roll (nframes);
802                 return;
803         }
804
805         if (_transport_speed == 1.0) {
806                 frames_moved = (framecnt_t) nframes;
807         } else {
808                 interpolation.set_target_speed (_target_transport_speed);
809                 interpolation.set_speed (_transport_speed);
810                 frames_moved = (framecnt_t) interpolation.interpolate (0, nframes, 0, 0);
811         }
812
813         if (!_exporting && !timecode_transmission_suspended()) {
814                 send_midi_time_code_for_cycle (_transport_frame, _transport_frame + frames_moved, nframes);
815         }
816
817         ltc_tx_send_time_code_for_cycle (_transport_frame, _transport_frame + frames_moved, _target_transport_speed, _transport_speed, nframes);
818
819         framepos_t const stop_limit = compute_stop_limit ();
820
821         if (maybe_stop (stop_limit)) {
822                 fail_roll (nframes);
823                 return;
824         }
825
826         if (maybe_sync_start (nframes)) {
827                 return;
828         }
829
830         click (_transport_frame, nframes);
831
832         if (process_routes (nframes, session_needs_butler)) {
833                 fail_roll (nframes);
834                 return;
835         }
836
837         get_track_statistics ();
838
839         if (frames_moved < 0) {
840                 decrement_transport_position (-frames_moved);
841         } else {
842                 increment_transport_position (frames_moved);
843         }
844
845         maybe_stop (stop_limit);
846         check_declick_out ();
847
848         if (session_needs_butler) {
849                 _butler->summon ();
850         }
851 }
852
853 /** Process callback used when the auditioner is active.
854  * @param nframes number of frames to process.
855  */
856 void
857 Session::process_audition (pframes_t nframes)
858 {
859         SessionEvent* ev;
860         boost::shared_ptr<RouteList> r = routes.reader ();
861
862         for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
863                 if (!(*i)->is_auditioner()) {
864                         (*i)->silence (nframes);
865                 }
866         }
867
868         /* run the auditioner, and if it says we need butler service, ask for it */
869
870         if (auditioner->play_audition (nframes) > 0) {
871                 _butler->summon ();
872         }
873
874         /* if using a monitor section, run it because otherwise we don't hear anything */
875
876         if (auditioner->needs_monitor()) {
877                 _monitor_out->monitor_run (_transport_frame, _transport_frame + nframes, nframes, false);
878         }
879
880         /* handle pending events */
881
882         while (pending_events.read (&ev, 1) == 1) {
883                 merge_event (ev);
884         }
885
886         /* if we are not in the middle of a state change,
887            and there are immediate events queued up,
888            process them.
889         */
890
891         while (!non_realtime_work_pending() && !immediate_events.empty()) {
892                 SessionEvent *ev = immediate_events.front ();
893                 immediate_events.pop_front ();
894                 process_event (ev);
895         }
896
897         if (!auditioner->auditioning()) {
898                 /* auditioner no longer active, so go back to the normal process callback */
899                 process_function = &Session::process_with_events;
900         }
901 }
902
903 bool
904 Session::maybe_sync_start (pframes_t & nframes)
905 {
906         pframes_t sync_offset;
907
908         if (!waiting_for_sync_offset) {
909                 return false;
910         }
911
912         if (_engine.get_sync_offset (sync_offset) && sync_offset < nframes) {
913
914                 /* generate silence up to the sync point, then
915                    adjust nframes + offset to reflect whatever
916                    is left to do.
917                 */
918
919                 no_roll (sync_offset);
920                 nframes -= sync_offset;
921                 Port::increment_global_port_buffer_offset (sync_offset);
922                 waiting_for_sync_offset = false;
923
924                 if (nframes == 0) {
925                         return true; // done, nothing left to process
926                 }
927
928         } else {
929
930                 /* sync offset point is not within this process()
931                    cycle, so just generate silence. and don't bother
932                    with any fancy stuff here, just the minimal silence.
933                 */
934
935                 _silent = true;
936
937                 if (Config->get_locate_while_waiting_for_sync()) {
938                         if (micro_locate (nframes)) {
939                                 /* XXX ERROR !!! XXX */
940                         }
941                 }
942
943                 return true; // done, nothing left to process
944         }
945
946         return false;
947 }
948
949 void
950 Session::queue_event (SessionEvent* ev)
951 {
952         if (_state_of_the_state & Deletion) {
953                 return;
954         } else if (_state_of_the_state & Loading) {
955                 merge_event (ev);
956         } else {
957                 pending_events.write (&ev, 1);
958         }
959 }
960
961 void
962 Session::set_next_event ()
963 {
964         if (events.empty()) {
965                 next_event = events.end();
966                 return;
967         }
968
969         if (next_event == events.end()) {
970                 next_event = events.begin();
971         }
972
973         if ((*next_event)->action_frame > _transport_frame) {
974                 next_event = events.begin();
975         }
976
977         for (; next_event != events.end(); ++next_event) {
978                 if ((*next_event)->action_frame >= _transport_frame) {
979                         break;
980                 }
981         }
982 }
983
984 void
985 Session::process_event (SessionEvent* ev)
986 {
987         bool remove = true;
988         bool del = true;
989
990         /* if we're in the middle of a state change (i.e. waiting
991            for the butler thread to complete the non-realtime
992            part of the change), we'll just have to queue this
993            event for a time when the change is complete.
994         */
995
996         if (non_realtime_work_pending()) {
997
998                 /* except locates, which we have the capability to handle */
999
1000                 if (ev->type != SessionEvent::Locate) {
1001                         immediate_events.insert (immediate_events.end(), ev);
1002                         _remove_event (ev);
1003                         return;
1004                 }
1005         }
1006
1007         DEBUG_TRACE (DEBUG::SessionEvents, string_compose ("Processing event: %1 @ %2\n", enum_2_string (ev->type), _transport_frame));
1008
1009         switch (ev->type) {
1010         case SessionEvent::SetLoop:
1011                 set_play_loop (ev->yes_or_no);
1012                 break;
1013
1014         case SessionEvent::AutoLoop:
1015                 if (play_loop) {
1016                         /* roll after locate, do not flush, set "with loop"
1017                            true only if we are seamless looping
1018                         */
1019                         start_locate (ev->target_frame, true, false, Config->get_seamless_loop());
1020                 }
1021                 remove = false;
1022                 del = false;
1023                 break;
1024
1025         case SessionEvent::AutoLoopDeclick:
1026                 if (play_loop) {
1027                         /* Request a declick fade-out and a fade-in; the fade-out will happen
1028                            at the end of the loop, and the fade-in at the start.
1029                         */
1030                         transport_sub_state |= (PendingLoopDeclickOut | PendingLoopDeclickIn);
1031                 }
1032                 remove = false;
1033                 del = false;
1034                 break;
1035
1036         case SessionEvent::Locate:
1037                 if (ev->yes_or_no) {
1038                         /* args: do not roll after locate, do flush, not with loop */
1039                         locate (ev->target_frame, false, true, false);
1040                 } else {
1041                         /* args: do not roll after locate, do flush, not with loop */
1042                         start_locate (ev->target_frame, false, true, false);
1043                 }
1044                 _send_timecode_update = true;
1045                 break;
1046
1047         case SessionEvent::LocateRoll:
1048                 if (ev->yes_or_no) {
1049                         /* args: roll after locate, do flush, not with loop */
1050                         locate (ev->target_frame, true, true, false);
1051                 } else {
1052                         /* args: roll after locate, do flush, not with loop */
1053                         start_locate (ev->target_frame, true, true, false);
1054                 }
1055                 _send_timecode_update = true;
1056                 break;
1057
1058         case SessionEvent::LocateRollLocate:
1059                 // locate is handled by ::request_roll_at_and_return()
1060                 _requested_return_frame = ev->target_frame;
1061                 request_locate (ev->target2_frame, true);
1062                 break;
1063
1064
1065         case SessionEvent::SetTransportSpeed:
1066                 set_transport_speed (ev->speed, ev->yes_or_no, ev->second_yes_or_no, ev->third_yes_or_no);
1067                 break;
1068
1069         case SessionEvent::PunchIn:
1070                 // cerr << "PunchIN at " << transport_frame() << endl;
1071                 if (config.get_punch_in() && record_status() == Enabled) {
1072                         enable_record ();
1073                 }
1074                 remove = false;
1075                 del = false;
1076                 break;
1077
1078         case SessionEvent::PunchOut:
1079                 // cerr << "PunchOUT at " << transport_frame() << endl;
1080                 if (config.get_punch_out()) {
1081                         step_back_from_record ();
1082                 }
1083                 remove = false;
1084                 del = false;
1085                 break;
1086
1087         case SessionEvent::StopOnce:
1088                 if (!non_realtime_work_pending()) {
1089                         stop_transport (ev->yes_or_no);
1090                         _clear_event_type (SessionEvent::StopOnce);
1091                 }
1092                 remove = false;
1093                 del = false;
1094                 break;
1095
1096         case SessionEvent::RangeStop:
1097                 if (!non_realtime_work_pending()) {
1098                         stop_transport (ev->yes_or_no);
1099                 }
1100                 remove = false;
1101                 del = false;
1102                 break;
1103
1104         case SessionEvent::RangeLocate:
1105                 /* args: roll after locate, do flush, not with loop */
1106                 start_locate (ev->target_frame, true, true, false);
1107                 remove = false;
1108                 del = false;
1109                 break;
1110
1111         case SessionEvent::Overwrite:
1112                 overwrite_some_buffers (static_cast<Track*>(ev->ptr));
1113                 break;
1114
1115         case SessionEvent::SetTrackSpeed:
1116                 set_track_speed (static_cast<Track*> (ev->ptr), ev->speed);
1117                 break;
1118
1119         case SessionEvent::SetSyncSource:
1120                 DEBUG_TRACE (DEBUG::Slave, "seen request for new slave\n");
1121                 use_sync_source (ev->slave);
1122                 break;
1123
1124         case SessionEvent::Audition:
1125                 set_audition (ev->region);
1126                 // drop reference to region
1127                 ev->region.reset ();
1128                 break;
1129
1130         case SessionEvent::InputConfigurationChange:
1131                 add_post_transport_work (PostTransportInputChange);
1132                 _butler->schedule_transport_work ();
1133                 break;
1134
1135         case SessionEvent::SetPlayAudioRange:
1136                 set_play_range (ev->audio_range, (ev->speed == 1.0f));
1137                 break;
1138
1139         case SessionEvent::RealTimeOperation:
1140                 process_rtop (ev);
1141                 del = false; // other side of RT request needs to clean up
1142                 break;
1143
1144         case SessionEvent::AdjustPlaybackBuffering:
1145                 schedule_playback_buffering_adjustment ();
1146                 break;
1147
1148         case SessionEvent::AdjustCaptureBuffering:
1149                 schedule_capture_buffering_adjustment ();
1150                 break;
1151
1152         case SessionEvent::SetTimecodeTransmission:
1153                 g_atomic_int_set (&_suspend_timecode_transmission, ev->yes_or_no ? 0 : 1);
1154                 break;
1155
1156         default:
1157           fatal << string_compose(_("Programming error: illegal event type in process_event (%1)"), ev->type) << endmsg;
1158                 /*NOTREACHED*/
1159                 break;
1160         };
1161
1162         if (remove) {
1163                 del = del && !_remove_event (ev);
1164         }
1165
1166         if (del) {
1167                 delete ev;
1168         }
1169 }
1170
1171 framepos_t
1172 Session::compute_stop_limit () const
1173 {
1174         if (!Config->get_stop_at_session_end ()) {
1175                 return max_framepos;
1176         }
1177
1178         if (_slave) {
1179                 return max_framepos;
1180         }
1181
1182         
1183         bool const punching_in = (config.get_punch_in () && _locations->auto_punch_location());
1184         bool const punching_out = (config.get_punch_out () && _locations->auto_punch_location());
1185
1186         if (actively_recording ()) {
1187                 /* permanently recording */
1188                 return max_framepos;
1189         } else if (punching_in && !punching_out) {
1190                 /* punching in but never out */
1191                 return max_framepos;
1192         } else if (punching_in && punching_out && _locations->auto_punch_location()->end() > current_end_frame()) {
1193                 /* punching in and punching out after session end */
1194                 return max_framepos;
1195         }
1196
1197         return current_end_frame ();
1198 }